用途:为连接外部服务生成 ServiceNow Integration Hub spoke,把可复用的集成逻辑封装成可跨实例部署的 spoke。
主要能力:创建组织相关集成动作的 spoke 容器;构建含 REST、SOAP 和脚本步骤的 spoke 动作;配置连接别名以安全管理凭据;定义带数据类型和标签的动作输入输出;在 ServiceNow 与外部格式之间做数据转换;加入错误处理与重试逻辑;打包 spoke 以供部署。
适用场景:构建对接外部 API 的可复用集成、为第三方服务创建自定义连接器、把集成逻辑打包为可部署的 spoke。
前置条件:角色为 integration_admin、flow_designer 或 admin;插件 com.glide.hub.flow_designer(Flow Designer)、com.glide.hub.integration(Integration Hub);可访问 sys_spoke、sys_hub_action_type_definition、sys_connection_alias 等表;了解 REST/SOAP API、JSON/XML、OAuth 与基础认证。相关技能为 genai/flow-generation。
使用方式:先分析集成需求(服务、操作、认证方式、数据格式、错误行为);再用 SN-Query-Table 查询已有 spoke 与动作作为模式参考;用 SN-Create-Record 在 sys_spoke 建 spoke 记录;在 sys_connection_alias 建连接别名并配置 basic_auth 或 oauth2 凭据;在 sys_hub_action_type_definition 建动作,在 sys_hub_action_input/output 定义输入输出,在 sys_hub_rest_step 定义 HTTP 调用(如 POST /api/v2/contacts、GET /api/v2/contacts/${inputs.contact_id}),用 sys_hub_script_step 处理状态码与异常;最后用 SN-Update-Record 激活并校验。也可通过 REST 接口 /api/now/table/… 完成同类操作。
限制与注意:资料未提供收费、价格或平台相关信息;官方文档未给出具体配额、超时上限与完整版本兼容说明。实践中应一个 spoke 对应一个外部服务,凭据统一走连接别名而非硬编码,为瞬态失败(429、503)加入重试,对列表动作使用分页,并在生产对接前先用模拟数据测试。