第 5 章 · 参与人：任务派给谁

这是流程能不能跑通的分水岭。配错了不报错，只是没人收到待办。 入口：设计器 → 点节点 → 常规配置 → 人员配置。

1. 引擎按什么顺序找人

① 指定下一节点处理人（办理时临时指定）   最高优先
② 参与人 / 参与人处理类
     参与人填了 → 用参与人，处理类不生效
     参与人空着 → 用处理类算
③ 都没有 → 不生成任务（流程直接往下走）

所以不要同时填参与人和参与人处理类，填了参与人那一栏，处理类就是摆设。

2. 参与人（固定）

多选用户，也可以直接写 applicant 表示发起人本人。演示数据里"发起申请"节点的参与人就是 applicant。

适合：审批人固定不变的小团队。人一走就要改流程，规模大了请改用处理类。

3. 参与人处理类（动态取人，7 个内置）

下拉里就这 7 项，按界面显示名对照：

界面显示名	取谁	依赖的数据	典型用法
流程发起人	发起人本人	无	提交后再确认一次、申请人签收
发起人所属部门经理	发起人所在部门的部门负责人	部门的负责人	无论流程走到哪，都由发起人的经理审批
发起人所属部门分管领导	发起人所在部门的分管领导	部门的分管领导	超过权限额度时升级到分管领导
当前用户所属部门经理	上一个节点办理人所在部门的部门负责人	部门的负责人	逐级上报：谁批的，就由谁的经理接着批
当前用户所属部门分管领导	上一个节点办理人所在部门的分管领导	部门的分管领导	同上，但要分管
根据表单字段值分配参与者	表单里某个字段填的人	表单有对应人员字段	申请人自己指定审批人、指定会签名单
根据任务节点唯一编码关联角色分配参与者	节点编码 = 角色编码 的那个工作流角色的成员	工作流角色 + 成员	财务角色审、总经理角色审

三条最容易混的：

• "发起人"和"当前用户"不是一回事。 转交、代理、跨部门会签之后，办理人可能已经不是发起人，这时"当前用户所属部门经理"取的是新办理人的经理。要始终跟着发起人走，就选带"发起人"字样的那两项。
• 按角色取人靠节点编码。 节点唯一编码写成 manager，处理类选"根据任务节点唯一编码关联角色分配参与者"，则角色编码为 manager 的成员收到待办。改节点编码等于换角色。
• 表单字段取人要求字段名精确匹配。 字段值支持逗号分隔的字符串或数组；节点编码以 _数字 结尾时会去掉后缀再匹配（task_01 找 task）。

每个处理类背后的取人链路（SPI 怎么调、返回空会怎样）见 用户指南 07 · 参与者解析。

4. 候选用户 / 候选用户组 / 候选用户处理类

这三项不决定任务派给谁，只决定办理时"指定下一节点处理人"下拉里能选谁。

字段	内容
候选用户	手选若干用户
候选用户组	选工作流角色，取该角色成员
候选用户处理类	净装镜像里没有注册项，下拉为空属正常；需要自定义候选逻辑见 用户指南 04

三项都不填时，"指定下一节点处理人"会开放全部用户供搜索。

5. 会签：一个节点多个人

在 常规配置 → 基础信息 里把参与类型改成 会签参与，会出现会签类型与完成条件：

配置	取值	效果
参与类型	普通参与 / 会签参与	普通参与时任一人办理即通过；会签要求多人
会签类型	并行会签 / 顺序会签	并行=同时给所有人建任务；顺序=一个一个来
会签完成条件	表达式，如 ${nrOfCompletedInstances} >= 3	达到条件才往下走；留空即全部完成

会签节点的办理按钮与普通节点不同：只有 同意、不同意、加签，没有退回上一步和跳转。

6. 临时改道：三种方式

场景	怎么做	位置
发起时就指定第一个审批人	流程属性里 是否发起时选人 打开，发起抽屉里选人	发起页
办理时指定下一步由谁办	办理弹窗勾 指定下一节点处理人 再选人	我的待办 → 办理
我要休假，单子交给别人	我的委托 建一条委托代理	工作流程 → 我的委托

委托代理按流程授权，有生效时间段：

授权时间段内，该流程落到你名下的任务会转给代理人；关掉 是否启用 立刻停止委托。

7. 卡住了看这里

现象	原因	处理
提交后没有任何待办	参与人为空，或处理类取不到人	先看第 2 章部门/角色数据，再看参与人是否填了个不存在的用户名
配了处理类没生效	同时填了参与人	清空参与人
部门经理节点派给了别的部门的人	选成了"当前用户所属部门经理"	要跟发起人走就换"发起人所属部门经理"
按角色取人取不到	节点编码与角色编码不一致，或角色无成员	对齐编码（区分大小写）；确认是工作流角色
会签只来了一个人	参与类型还是普通参与	改成会签参与并重新部署
指定下一节点处理人时可选名单为空	候选用户/候选用户组没配，且用户搜索未开放	配候选，或不勾选该项用默认处理人