Camunda 7工作流中多实例任务配置实战：会签、或签与比例签的深度解析

在OA审批系统开发中，我们经常遇到需要多人参与决策的场景。Camunda作为业界领先的工作流引擎，其多实例任务功能（Multi-Instance Task）为这类需求提供了优雅的解决方案。但实际开发中，许多团队对"会签"、"或签"和"比例签"等不同决策模式的理解和配置存在混淆，导致流程无法按预期执行。

1. 多实例任务核心概念解析

多实例任务是BPMN 2.0规范中的重要特性，它允许我们将一个任务节点配置为可重复执行的模式。在Camunda中，这通过 multiInstanceLoopCharacteristics 元素实现，主要涉及以下核心参数：

• Collection ：参与者集合，通常是一个用户ID列表
• Element Variable ：每次迭代时当前元素的变量名
• Completion Condition ：决定何时完成整个多实例任务的表达式

理解这些参数是正确配置各种审批模式的基础。例如，在采购审批流程中，当金额超过一定阈值时，可能需要财务部、法务部和相关VP共同审批，这就是典型的多实例任务应用场景。

2. 三种典型审批模式对比

2.1 会签（全体通过）

会签要求所有参与者都必须同意才能继续流程。这在需要集体决策的重要事项中很常见，如董事会决议、高风险合同审批等。

配置要点：

<multiInstanceLoopCharacteristics 
    camunda:collection="${approvers}" 
    camunda:elementVariable="approver">
    <completionCondition>
        ${nrOfCompletedInstances == nrOfInstances}
    </completionCondition>
</multiInstanceLoopCharacteristics>

关键变量说明：

• nrOfInstances ：总实例数（等于集合大小）
• nrOfCompletedInstances ：已完成的实例数

2.2 或签（一人通过）

或签模式只需任意一位参与者同意即可继续流程，适用于紧急审批或简单确认场景。

配置示例：

<completionCondition>
    ${nrOfCompletedInstances >= 1}
</completionCondition>

常见陷阱：

• 变量名不一致：确保 elementVariable 与任务assignee使用的变量名一致
• 表达式错误：使用 ==1 而非 >=1 会导致必须恰好一人同意

2.3 比例签（按比例通过）

比例签模式要求达到特定比例的参与者同意，常见于民主决策场景，如需要2/3多数通过的投票。

典型配置：

<completionCondition>
    ${nrOfCompletedInstances/nrOfInstances > 0.67}
</completionCondition>

注意事项：

• 确保除法运算至少有一个操作数是浮点数，避免整数除法问题
• 考虑边界情况，如计算结果正好等于阈值时的处理

3. 实战配置与调试技巧

3.1 在Camunda Modeler中配置多实例任务

1. 右键点击用户任务，选择"转换为多实例"
2. 在"多实例"选项卡中设置集合和元素变量
3. 在"完成条件"中输入相应表达式

3.2 常见问题排查

问题1 ：多实例任务无法正常完成

• 检查 completionCondition 表达式语法
• 确认 nrOfCompletedInstances 是否按预期增长

问题2 ：参与者无法看到任务

• 验证集合变量是否正确传递
• 检查任务assignee是否使用了正确的元素变量

问题3 ：流程卡在网关处

• 确认网关条件与多实例结果匹配
• 检查是否所有必要变量都已设置

3.3 性能优化建议

• 对于大型审批组，考虑使用异步执行
• 合理设置历史记录级别，减少不必要的审计数据
• 使用缓存减少重复查询参与者列表的开销

4. 高级应用场景

4.1 动态审批人配置

通过JavaDelegate动态设置审批人集合：

public class DynamicApproversDelegate implements JavaDelegate {
    @Override
    public void execute(DelegateExecution execution) {
        List<String> approvers = calculateApprovers(execution);
        execution.setVariable("approvers", approvers);
    }
}

4.2 混合审批模式

某些复杂场景可能需要组合多种审批模式。例如，先进行或签快速响应，再对重要事项进行会签确认。这可以通过顺序流和网关组合实现。

4.3 审批意见收集

扩展多实例任务以收集每位参与者的意见：

<userTask id="reviewTask" name="审批任务">
    <extensionElements>
        <camunda:formData>
            <camunda:formField id="comment" label="审批意见" type="string"/>
        </camunda:formData>
    </extensionElements>
    <!-- 多实例配置 -->
</userTask>

在流程变量中，这些意见可以按参与者ID进行组织和存储，为后续分析提供数据支持。