relaysh/servicenow-step-query

servicenow-step-query

此ServiceNow步骤容器用于运行查询操作。

镜像概述和主要用途

servicenow-step-query是一个专门用于在工作流中执行ServiceNow查询的Docker镜像。它允许用户通过配置ServiceNow连接信息、指定查询资源和条件，从ServiceNow中检索数据，并输出查询结果及相关统计信息，适用于需要集成ServiceNow数据的自动化工作流场景。

核心功能和特性

• 支持配置ServiceNow连接信息，确保安全访问ServiceNow实例
• 允许指定要查询的资源路径，灵活定位目标数据
• 支持https://pysnow.readthedocs.io/en/latest/usage/query.html#sn-pass-through%E6%A0%BC%E5%BC%8F%E7%9A%84%E6%9F%A5%E8%AF%A2%E8%AF%AD%E5%8F%A5%EF%BC%8C%E5%85%BC%E5%AE%B9ServiceNow%E6%9F%A5%E8%AF%A2%E8%AF%AD%E6%B3%95
• 提供可选参数配置，可自定义查询行为（如限制返回记录数、指定返回字段等）
• 支持实验性Python lambda过滤器，可进一步筛选查询结果，减少输出数据量

规范说明

使用此步骤的工作流步骤定义中，spec部分需包含以下字段：

输出说明

此步骤提供以下输出：

使用方法和配置示例

工作流步骤配置示例

yaml
step:
  name: query-servicenow
  image: docker.xuanyuan.run/relaysh/servicenow-step-query
  spec:
    servicenow:
      connection: ${connections.servicenow.my-servicenow-connection}  # ServiceNow连接信息引用
    resource: '/table/mytable'  # 要查询的资源路径
    query: 'os=Linux Red Hat^ORos=Windows'  # SN Pass-through格式的查询条件
    filter: 'lambda x: x["hostname"].startswith("host-")'  # 筛选主机名以"host-"开头的记录
    arguments:
      limit: 30  # 限制返回30条记录
      fields: ["hostname", "os"]  # 仅返回"hostname"和"os"字段

配置说明

• connection: 必须配置，指向已定义的ServiceNow连接信息，包含访问ServiceNow所需的认证信息（如URL、用户名、密码等）
• resource: 必须配置，指定ServiceNow中要查询的资源路径，通常格式为/table/{table_name}
• query: 可选，使用ServiceNow的SN Pass-through格式定义查询条件，支持逻辑运算符（如^OR、^AND等）
• arguments: 可选，用于自定义查询行为，常见参数包括limit（限制返回记录数）、fields（指定返回字段列表）等
• filter: 可选，实验性功能，使用Python lambda表达式对查询结果进行二次筛选，进一步减少输出数据量