Activiti 开发案例之多实例并行子流程

概念

Activiti 提供了两种基于子流程的实现：

一种是内嵌子流程：子流程元素<subProcess>内嵌在主流程元素<process>之内，只能在该流程中使用该子流程，外部是无法访问到的。这种子流程一般作为局部通用逻辑处理，或者因为特定业务需要，使得比较复杂的单个主流程设计清晰直观。
另一种是调用子流程：首先实现一个流程，在另一个流程中可以调用该流程，通常可以定义一些通用的流程作为这种调用子流程，供其他多个流程定义复用。这种子流程使用<callActivity>元素来进行调用，间接地嵌入到主流程中，用起来比较方便。

流程图

以上是一个公司内部合同评审的内嵌子流程流程图，一个合同的通过是需要经过多个部门的层层审核，最终才得以通过。

销售发起合同评审流程
进入子流程，各个部门根据实际情况进行多级审批
各个部门审批通过，流程结束

生成子流程

XML部分代码

/**
 * 博客 https://blog.52itstyle.vip
 */
<subProcess id="subprocess" name="合同评审">
      <multiInstanceLoopCharacteristics isSequential="false" activiti:collection="assigneeList" activiti:elementVariable="assignee">
        <completionCondition>${nrOfCompletedInstances/nrOfInstances==1}</completionCondition>
      </multiInstanceLoopCharacteristics>
      <!--省略相关任务节点代码-->
</subProcess>

collection：存放集合，集合中可以存任意值，工作流会根据你集合里的值个数，去生成对应的子流程，这里我们存放一级审批的用户ID。
elementVariable：节点流程变量，用于在流程图中代替集合中表示当前子流程的变量，对应子流程中第一个任务节点的变量名。
completionCondition：完成条件，这里写的表达式如果满足即可流转到下一步。

发起

成功发起之后，系统会自动生成集合数量的任务(子流程)，然后在每个子流程中设置与业务流程相关的局部变量。

/**
 * 博客 https://blog.52itstyle.vip
 */
Map<String, Object> variables = new HashMap<>();
//4个部门审核，生成4个流程，集合中获取并存放的是一级评审人
List<String> assigneeList= Arrays.asList(new String[] {"1","2","3","4"});
variables.put("assigneeList", assigneeList);
ProcessInstance in =  runtimeService.startProcessInstanceByKey("contract_review", variables);
List<Task> list = taskService.createTaskQuery().processInstanceId(in.getId()).list();
System.out.println("任务数量:"+list.size());
list.forEach(task -> {
    /**
     * 模拟几级审批(正式环境要从配置或者数据库读取)，因为这里要清楚每个部门走几级审批逻辑
     * 变量存放到每个任务节点的全局任务变量中
     */
    Random r = new Random();//创建随机种子，Random对象
    int rank = r.nextInt(3)+1;
    System.out.println("任务ID："+task.getId());
    System.out.println("指派人ID："+task.getAssignee());
   //保存在整个子流程中
    runtimeService.setVariableLocal(task.getExecutionId(),"rank",rank);
});

审核

这里只说几个比较重要的点，大家可以根据自身业务场景处理。

/**
 * 博客 https://blog.52itstyle.vip
 */
//获取当前任务
Task task = taskService.createTaskQuery().taskId(taskId).singleResult();
//获取当前任务Code
String taskCode = task.getTaskDefinitionKey();
//获取当前任务流转唯一ID
String executionId = task.getExecutionId();
//获取当前子流程任务变量
Object rank = runtimeService.getVariableLocal(task.getExecutionId(),"rank");
//认领任务
variables.put("approve",rank);
taskService.claim(taskId, userId);
taskService.complete(taskId, variables);
//这里要判断当前子流程是一级审批、如果是二级审批或者三级审批还需要获取下级任务节点
task = taskService.createTaskQuery().executionId(executionId).active().singleResult();
//指派任务
taskService.addCandidateUser(task.getId(),reviewUserId);

小结

子流程的概念用途还是比较广泛的，基本上企业内部涉及到多部门合作的流程都有可能用到，这里需要注意的是，由于业务类型不同，每个子流程的相关逻辑判断也可能不同，这就需要在每个子流程中存储流程变量，用于各级流程逻辑判断。