选择审批人、发起人自选

相关视频：

08、[如何实现流程模型的分配规则？](http://https://wx.zsxq.com/dweb2/index/topic_detail/812815541444422 "如何实现流程模型的分配规则？")
14、[如何实现流程的任务分配？](http://https://wx.zsxq.com/dweb2/index/topic_detail/212815852482111 "如何实现流程的任务分配？")

当用户发起流程（审批）时，会根据【流程定义】创建对应的审批任务，审批任务会根据【审批人规则】，自动分配给对应的审批人。

审批人可以是固定的角色（比如上级、HR 等），也可以是发起人自选。

## 1. 审批人配置
在 BPMN 流程设计器重，每个任务节点，有个 [任务（审批人）] 配置项，用于配置任务审批时，审批人的分配。如下图所示：

![](/media/202408/2024-08-28_085419_194889.png)

在 BPMN 的 UserTask 节点上，没有合适的内置属性存储“规则类型”、“规则参数”的属性，所以是我们拓展了 candidateStrategy 和 candidateParam 属性，用于存储审批人的规则类型和参数。如下图所示：

![](/media/202408/2024-08-28_085440_120048.png)
> <span style="font-family:楷体">拓展知识：BPMN 的 UserTask 节点，是如何拓展 `candidateStrategy` 和 `candidateParam` 属性的呢？
参见 feadd02 、797fddf提交的代码。

</span>

### 2. 选择审批人
在上图中，我们可以看到 8 种审批人规则类型，它们都是 BpmTaskCandidateStrategy)的一种实现，如下图所示：

![](/media/202408/2024-08-28_085527_668080.png)

> <span style="font-family:楷体">public interface BpmTaskCandidateStrategy {
    /**
     * 对应策略
     *
     * @return 策略
     */
    BpmTaskCandidateStrategyEnum getStrategy();

/**
     * 校验参数
     *
     * @param param 参数
     */
    void validateParam(String param);
    /**
     * 基于执行任务，获得任务的候选用户们
     *
     * @param execution 执行任务
     * @return 用户编号集合
     */
    Set<Long> calculateUsers(DelegateExecution execution, String param);
    /**
     * 是否一定要输入参数
     *
     * @return 是否
     */
    default boolean isParamRequired() {
        return true;
    }

}
</span>

- 关键是 calculateUsers 方法，用于计算候选的审批人。
最终，Flowable 在创建审批任务，分配审批人时，会通过 BpmUserTaskActivityBehavior => BpmTaskCandidateInvoker => BpmTaskCandidateStrategy ，时序图如下：

![](/media/202408/2024-08-28_085647_933527.png)

3. 自定义 BpmTaskCandidateStrategy 策略
① 第一步，在 BpmTaskCandidateStrategyEnum (opens new window)中，自定义一个枚举值。然后，在 bpm_task_candidate_strategy 数据字典中，配置对应的枚举值。
② 第二步，创建一个 BpmTaskCandidateStrategy 的实现类，实现对应的逻辑，并注册成 Spring Bean 即可。

## 3. 发起人自选
上述的 8 种审批人规则类型中，有一种是【发起人自选】，它是一种特殊的审批人规则类型。在发起流程时，发起人需要选择对应任务的发起人。
下面，我们分别来看看在【流程表单】、【业务表单】下的例子。

### 3.1 【流程表单】示例
① 第一步，设置在 《审批接入（流程表单）》 的“部门领导审批”任务的审批人规则为【发起人自选】。如下图所示：

![](/media/202408/2024-08-28_085746_555583.png)

注意，需要保存流程，并进行发布流程。

② 选择该流程，进行发起流程，则可以看到“指定审批人”的表单。如下图所示：

![](/media/202408/2024-08-28_085811_668707.png)

选择“指定审批人”为“源码”，然后进行提交。
③ 查看发起流程的详情，可以看到审批人为“源码”。如下图所示：

![](/media/202408/2024-08-28_085838_551950.png)

3.2 【业务表单】示例
① 第一步，设置在 《审批接入（业务表单）》 的“领导审批”任务的审批人规则为【发起人自选】。如下图所示：

![](/media/202408/2024-08-28_085906_990713.png)

注意，需要保存流程，并进行发布流程。
② 选择该流程，进行发起流程，则可以看到“指定审批人”的表单。如下图所示：

![](/media/202408/2024-08-28_085952_228435.png)

选择“指定审批人”为“源码”，然后进行提交。
③ 查看发起流程的详情，可以看到审批人为“源码”。如下图所示：

![](/media/202408/2024-08-28_090015_480439.png)

### 3.3 【流程表单】实现原理
① 在【流程表单】的流程发起界面 views/bpm/processInstance/create/index.vue (opens new window)中，从后端读取【流程定义】时，发现有任务节点的审批人规则是【发起人自选】，则会增加一个“指定审批人”表单项。如下图所示：

![](/media/202408/2024-08-28_090034_656183.png)

![](/media/202408/2024-08-28_090039_800057.png)
② 在提交流程时，会将选择的审批人，存储到 Flowable 的流程的 variables 中。如下图所示：

![](/media/202408/2024-08-28_090049_754693.png)
③ 最终审批任务在分配审批人时，会读取这个 variables，然后分配给对应的审批人。如下图所示：

![](/media/202408/2024-08-28_090100_534091.png)

3.4 【业务表单】实现原理
① 在【业务表单】的流程发起界面 views/bpm/oa/leave/create.vue

![](/media/202408/2024-08-28_090146_121410.png)

![](/media/202408/2024-08-28_090150_002803.png)

② 在提交流程时，会将选择的审批人，存储到 Flowable 的流程的 variables 中。如下图所示：

![](/media/202408/2024-08-28_090158_343737.png)

后续的流程，和「3.3 【流程表单】实现原理」就是一致的！总结来说，就是创建流程指定审批人，创建任务使用指定审批人。

## 4. 流程表达式
除了自定义 BpmTaskCandidateStrategy 策略外，还可以使用流程表达式，实现审批人的动态分配。

![](/media/202408/2024-08-28_090233_874415.png)