工作流与 UX 配合使用

先看完整过程

1. 发起人在 UX 填写并保存合同，取得合同主键。

2. UX 的“发起流程”动作把合同主键、金额等交给工作流启动参数。

3. 工作流生成审批任务，给任务配置关联的 UX 和跳转参数。

4. 审批人从待办打开 UX；UX 根据合同主键加载业务数据，根据任务 ID 显示任务处理按钮。

5. 审批人完成任务；UX 可同时向当前任务回传额外参数。

6. 工作流将任务结果映射到全局变量，供后续判断、通知或其他节点使用。

普通使用者主要操作第 1、4、5 步。实施人员需要配置两端；技术人员可继续查看表达式、Python 与接口相关章节。

分清四种传参

分清四种标识

• 工作流元素：流程模板，例如“合同审批”。用于选择发起哪个工作流。

• 流程实例 ID：某一次发起产生的实例，工作流中为 wfp$proc_id。用于查看整次审批的记录和流程图。

• 任务实例 ID：某个人工任务，工作流中为 acp$task_id。用于定位并办理该任务。同一流程可能生成多条任务。

• 业务主键与业务键：业务主键定位合同数据；工作流业务键用于流程与业务关联、重复发起控制。两者可以按规则关联，但不会因为名字相似自动相等。

不要将合同编号填入“任务实例 ID”，也不要把流程实例 ID 当作工作流元素编码。

推荐页面组合

业务发起页：业务表单、保存动作、发起流程动作。先保证业务记录保存成功，再发起。

待办页：使用“待办页面”控件集中显示任务，供使用者打开任务详情。

业务处理页：业务表单、任务处理、流程记录。需要时增加流程备注和流程图。

同一 UX 可以按业务需要复用为发起页和处理页，但要区分“尚未发起”“正在处理”“仅查看历史”的状态；没有任务 ID 时，不应让用户误以为可以办理任务。

配置顺序

先确定业务主键和工作流启动参数，再配置 UX 数据源与控件；保存 UX 后，在工作流选择它并补齐跳转参数。完成流程发布后，从真实发起入口启动一笔测试业务，使用实际处理人的账号完成验证。

建议按下面顺序阅读：

1. 从 UX 发起流程

2. 工作流打开 UX 与传参

3. 任务处理与结果回传

4. 流程记录、备注与流程图

5. 合同审批完整示例

6. 常见问题与排查

已有控件配置与截图见 工作流相关控件说明，统计卡片、自定义列表等进阶用法见 参考案例。