从 UX 发起流程

准备工作流启动参数

1. 打开工作流设计器，在变量配置中新增启动参数。

2. 创建 contract_id，类型为字符串，设置为不可为空。

3. 创建 amount，根据金额精度选择数字类型，并按业务需要设置不可为空。

4. 完成开始、人工任务、结束等必要节点，以及任务指派与连线配置。

5. 保存并发布工作流。UX 发起时使用可启动的已发布流程配置。

启动参数在流程内分别通过 wfi$contract_id、wfi$amount 读取。参数编码是两端关联依据，显示名称用于帮助用户理解。

在 UX 配置发起动作

1. 选择页面上的业务按钮，在点击事件中添加“发起流程”动作。

2. 选择目标工作流元素，选择单次发起方式。

3. 为所需参数赋值：contract_id 取已保存业务记录的主键，amount 取页面当前业务金额。

4. 用 UX 表达式编辑器选择实际的数据源字段或控件值。页面中的控件编码不同，应使用当前页面的表达式选择结果。

5. 根据业务需要配置发起备注、执行条件和成功提示。

6. 保存 UX，从使用态运行一次。

可用于验证连通性的固定值：合同主键填 HT-2026-001，金额填数字 1200.50。确认流程收到后，再替换为动态取值。固定值仅用于测试，不能作为正式页面上所有合同的统一入参。

先保存业务，再发起流程

发起流程不会自动保存页面表单。推荐事件顺序为“表单校验 → 保存业务数据 → 保存成功后发起流程 → 刷新状态”。

如果业务主键在保存时才生成，启动参数要读取保存后的主键。不能使用空值，也不能把保存前尚未生成的编号传给工作流。

保存失败时应停止后续发起动作；发起失败时，已保存的业务数据可能仍然存在。用户重试前，应确认该业务是否已经产生流程，避免重复发起。

参数类型和空值

工作流会按参数定义接收数据。请区分：

• 字符串 "00123" 与数字 123 不同；合同号等标识通常保留字符串。

• 数字应传数字值，不能直接传带千分位或货币符号的显示文本。

• 数组参数需要实际数组，"甲,乙" 不是两个元素的数组。

• null、空字符串和 0 含义不同；不要用“有值”的判断把合法的 0 丢掉。

必填参数缺失时先修正页面数据或参数映射，不要通过取消必填绕过业务规则。

业务键与重复发起

需要限制同一笔业务重复发起时，在工作流全局配置中按业务规则设置“业务键唯一”及其来源。多个来源参数按所选顺序用竖线 | 连接。例如公司 C01 与合同 HT-2026-001 组合为 C01|HT-2026-001；后续按业务键查询应使用相同值。

不要假定“业务键等于合同主键”。如果配置用了“公司 + 合同主键”，UX 查询时也必须提供同一组合规则生成的值。流程实例 ID 则由系统生成，是另一种标识。

遇到重复业务键提示，先确认已有进行中的实例和页面是否重复触发。业务需要允许重新发起时，应结合原流程状态和全局规则处理。

如何验收

发起一笔已保存的测试合同，在流程监控中找到新实例，核对启动参数的值与类型；确认任务分配给预期处理人，并能从待办打开该合同。

还应验证一次缺失必填参数、一次保存失败和一次重复点击，确认页面不会在业务数据无效时继续发起。

下一步配置 工作流打开 UX 与传参。多笔业务批量发起见 消息交互与批量发起。