变量与数据映射

先选择正确的变量来源

• wf$：工作流元素与版本属性，如 wf$code、wf$name、wf$version。

• wfp$：当前流程实例属性，如 wfp$proc_id、wfp$initiator_id、wfp$start_time、wfp$due_time。

• wfi$：启动参数，如 wfi$contract_id，在流程启动时传入。

• wfv$：可更新的全局变量，如 wfv$approved_amount，供当前实例后续节点使用。

• acp$：当前活动属性；人工任务中常用 acp$task_id、acp$assignee_user_id、acp$task_link。

• acr$：当前节点的执行结果，如人工任务的 acr$outcome、acr$extra_res。

• macp$：多实例整体计数，如 macp$nr_of_instances、macp$nr_of_completed_instances。

• macr$：多实例整体输出，如多人任务汇总结果 macr$outcome。

不是每个字段都在所有节点和所有时点存在。以当前配置项的变量选择器为准：任务创建前没有该任务 ID；任务完成前没有完成结果；子流程未返回时不能读取其输出。

创建启动参数

在设计器变量区域新增启动参数，填写编码、名称、类型、是否数组及是否允许为空。保存并发布后，由 UX 或其他发起端按参数编码传值。

示例：contract_id 使用字符串且不可为空；发起后通过 wfi$contract_id 读取。需要保留前导零的业务编号不要定义成整数。

启动参数用于保留本次发起的输入。需要在运行中更新的数据，另建全局变量，不要把启动参数当作可反复改写的业务状态。

创建全局变量

全局变量可以设置初始值，并在节点数据映射等位置更新。例如初始核准金额为空，审批完成后再写入。

初始值可按配置选择静态值、置空或表达式；数组可使用空数组。初始表达式引用其他全局变量时，注意初始化顺序，不要依赖尚未初始化的后序变量。

把节点输出交给后续节点

以 UX 回传核准金额为例：

1. UX 完成任务参数的名称为 approved_amount。

2. 当前人工任务的来源表达式为 acr$extra_res.approved_amount。

3. 数据映射的目标为全局变量 approved_amount。

4. 后续节点读取 wfv$approved_amount。

节点局部输出不会因为在某个节点出现，就自动成为所有后续节点的输入。应在输出可用的时点完成数据映射，并核对目标变量类型。

完整页面配置见 任务处理与结果回传。

常见节点输出

• 单人任务：acr$outcome 为任务结果；acr$extra_res.参数名 为 UX 完成任务时的补充数据。

• 多人任务：单个任务仍使用 acr$；整个多人节点的汇总结果使用 macr$outcome。

• 同步 Python：按 Python 定义的输出结构读取，例如输出字段 approvers 对应 acr$approvers。

• DeepModel、财务模型等服务：按节点提供的响应结构读取，例如 acr$response，不要假定每个服务都返回相同字段。

• 调用子流程：按所选输出变量读取 acr$变量编码；多实例子流程的汇总输出按面板提供的 macr$ 字段使用。

• 启动工作流：可取得 acr$started_proc_id；批量启动为 macr$started_proc_ids。

• 更新数据表：可通过 acr$num_of_updated 检查更新条数。

字段可用性与具体节点、调用方式有关。异步 Python 调起后不会同步返回脚本业务输出。

类型、数组与对象

常见基础类型有字符串、布尔值、整数、小数和日期时间，并可按配置使用对应数组。对于节点返回的对象或业务对象，应按当前配置支持的结构访问字段。

acr$extra_res 是对象，但这不表示任何输入框都允许任意 JSON。传递对象前要确认双方定义；需要一个字段时优先取出该字段，再映射到匹配类型的变量。

字符串数组 ['user_a', 'user_b'] 与字符串 'user_a,user_b' 不同。人员指派必须使用实际用户或用户组 ID，详细示例见 任务指派配置。

业务键

启用业务键唯一后，系统按所选启动参数的顺序，用竖线 | 连接各值。例如依次选择公司 C01 和合同 HT-2026-001，生成 C01|HT-2026-001。

UX 按业务键查询时，要使用同一顺序和组合值。只选择合同主键作为来源时，业务键才与该主键相同。业务键不是流程实例 ID。

当前重复检查与空间、应用、流程定义版本和存活实例有关。跨版本重复发起控制如有更严格的业务要求，需要额外设计，不能把业务键唯一理解为业务表层面的永久唯一约束。

表达式与排错

工作流表达式使用 wfi$、wfv$ 等变量；UX 用外部变量承接工作流传参，并通过 $var.变量编码 引用，也可从页面控件和数据源取值。两端变量不会自动互通，需配置同名参数及其赋值。详见 表达式。

出现空值时依次核对：来源是否已生成、参数编码是否一致、当前节点能否读取、是否配置数据映射、类型是否匹配、实例是否使用目标版本。更多问题见 常见问题与排查。