手动运行工作流

手动运行允许已登录且可访问工作流管理页面的用户,直接执行选中的工作流版本。它适合受控验证或明确的运营操作,不替代应用开发者把流程接入真实业务事件。

什么时候使用手动运行

典型用途包括:

  • 新版本部署后,用可识别的测试数据验证路径;
  • 业务明确允许由管理员发起一次处理;
  • 开发者完成故障修复后,授权管理员执行一次新的业务操作。

手动运行不是无副作用预览,也不应被当作任意重试按钮。

运行前检查

提交前确认:

  1. 工作流标题和说明与目标业务一致;
  2. 当前查看的是预期版本,包括历史或未启用版本;
  3. 输入对应正确的业务记录;
  4. 本次运行是否会写库、发送消息、扣减库存或调用外部系统;
  5. 是否已经存在同一业务操作的运行记录;
  6. 在生产环境执行是否获得授权。

系统会为手动运行生成调用标识,但这不能保证业务写入或外部调用不会重复。页面结果不明确时先查看执行记录,不要立即再次提交。

填写输入并提交

在工作流详情页打开“更多操作 → 手动运行”。表单来自该版本的 inputSchema:

  • 布尔值显示为勾选项;
  • 数字和整数使用数值输入;
  • 字符串使用文本输入;
  • 字段标题和说明由应用开发者定义。

当前管理表单主要面向顶层标量字段。需要复杂对象或数组输入的工作流,通常应通过应用业务入口触发;不要把 JSON 文本填入普通文本框并假设会自动解析。

提交后,页面会进入本次执行详情。输入无效、缺少必填字段或包含未声明字段时,服务端会拒绝运行。

查看提交结果

工作流由队列异步执行,进入执行详情时可能仍显示“排队中”或“运行中”。继续观察直到进入终态:成功、失败、错误或已中止。

确认实际执行路径和节点结果,而不仅是 HTTP 请求成功。需要判断业务数据是否正确时,还应核对对应业务记录或外部系统证据。

常见问题

手动运行与业务事件触发有什么区别

正常业务事件由应用代码完成认证、校验、输入构造和重复事件处理;手动运行由管理员选择具体工作流版本并提交表单。两者都会执行真实节点代码。

为什么停用或历史版本仍可能被手动运行

手动运行是有意选择某个具体修订的管理操作,不要求该修订是当前或已启用版本。运行前必须再次确认版本和影响。

手动运行是否会启用所选版本

不会。运行和版本启用是两个独立操作。

提交成功是否表示业务已经完成

不表示。提交成功只说明运行已创建;最终结果以执行详情和业务数据为准。

输入错误后能否修改本次运行

不能修改已经创建的运行及其输入快照。如果运行尚未产生副作用且业务允许,可以更正输入后创建新运行;不确定时先联系开发者。