SuperAPI AI 工具集

flow-designer

部署与运维

查看项目

更新于 10-16 02:11

技能介绍

用途

Flow Designer 是 ServiceNow 中替代旧版 Workflow 的现代自动化引擎,官方建议新开发使用 Flow Designer。本技能用于通过 Flow Designer 专用工具以编程方式创建和管理流程(flows),而非通过后台脚本、GlideRecord 或对 sys_hub_* 表的 REST 调用。

使用方式

首先通过 tool_search({query: "flow designer"}) 发现 Flow Designer 工具。该工具处理完整的流程生命周期所需的全部 GraphQL 变更操作。

文档强调:不要通过后台脚本、GlideRecord 或 REST 调用 sys_hub_* 表来创建流程;后台脚本方式会静默产生损坏的流程。始终通过 tool_search 发现并使用 Flow Designer 工具。

关键摆放规则

IF/ELSE/ELSEIF

  • IF 分支内的动作:parent_ui_id = IF 的 uiUniqueIdentifier
  • ELSE/ELSEIF 块:必须与 IF 处于同一层级,不能嵌套在 IF 内部;parent_ui_id 使用与 IF 块相同的父级;connected_to = IF 的 logicId(创建 IF 时返回的 sysId)
  • 摆放错误会在保存流程时导致 "Unsupported flowLogic type" 错误

TRY/CATCH

  • 添加 TRY 块时,工具会自动创建配套的 CATCH
  • TRY 与 CATCH 都是容器,动作要放在它们内部,而不是旁边
  • TRY 内的动作(可能失败的步骤):parent_ui_id = TRY 的 uiUniqueIdentifier,顺序为 1、2、3……
  • CATCH 内的动作(错误处理):parent_ui_id = CATCH 的 uiUniqueIdentifier(由 TRY 创建响应返回为 catch_ui_id),顺序为 1、2、3……
  • 创建 TRY/CATCH 对时返回的 next_order 是该对之后的下一个同级动作的顺序,而不是它们内部子动作的顺序

组件

  • Flow:主自动化流程,不可复用
  • Subflow:可复用的流程逻辑
  • Action:单个操作(脚本、REST 等),可复用
  • Spoke:一组相关动作的集合,可复用

触发器类型

文档给出三类示例:

  • 基于记录的触发器:如 Table=incident、Trigger=Created、Condition=Priority = 1;或 State 变为 Resolved;或 change_request 的 Risk = High
  • 计划触发器:如每日 02:00 AM、时区 America/New_York;每周一 08:00 AM
  • 服务目录触发器:如目录项 Request New Laptop

主要能力与模式

  • 使用子流程实现复用(如 P1 事件处理流程中调用 "Notify On-Call Team"、"Create Major Incident" 子流程)
  • 错误处理:Try / Catch(所有错误)/ Always 结构
  • 流程变量:输入变量(来自触发器,如 fd_data.trigger.current.sys_id)、临时变量(fd_data.scratch.*)、输出变量(fd_data.output.*)
  • 条件与分支:If / Else If / Else
  • 自定义脚本动作:(function execute(inputs, outputs) {...})(inputs, outputs),含输入输出定义与错误处理(可 throw 让 Flow Designer 路由到错误处理器)
  • REST 动作:连接别名、HTTP 方法、端点、请求头(含鉴权)、JSON 请求体与响应解析
  • 子流程模式:通知子流程(含输入参数与默认值)、审批子流程(创建审批、等待状态变更、返回 approve/reject)
  • 调试:fd_log.info/debug/warn/error;通过 Flow Designer > Executions 按流程名、状态、日期范围过滤查看执行历史
  • 常见模式:SLA 升级流程、审批路由、集成同步(定时每 15 分钟)

性能建议

  • 尽早使用条件,在昂贵操作前过滤
  • 限制循环,为 For Each 设置最大迭代次数
  • 尽可能异步,不要阻塞在慢操作上
  • 缓存查询,把重复查询存入临时变量
  • 批量操作,将相似更新分组

流程对比

文档列出 Flow Designer 相比 Workflow 的优势:现代化可视化界面、子流程与动作带来的复用性、内置测试、版本控制、支持 Integration Hub、性能更好。建议新开发使用 Flow Designer,Workflow 仅维护存量。

限制

文档未提供该技能的收费、价格、安装方式或平台支持信息;相关事实暂未提供。