Activiti之多实例任务

所谓多实例任务，就是一个任务，需要多个人协作完成，大致可以分为两种：（1）并行多实例：完成任务没有先后顺序的要求，并行执行（2）串行多实例：完成任务有先后顺序，也就是说，必须等待前一个人完成了任务，下一个人的任务才开始在流程图中也可以体现出并行多实例与串行多实例的区别，注意看领导审批节点，多了3条线，如果3条线是竖直的，那就是并行多实例，如下所示：如果3条线是水平的，那就是串行多实例，如下所示：b

qiuxinfa123

7547人浏览 · 2021-08-11 22:45:44

qiuxinfa123 · 2021-08-11 22:45:44 发布

所谓多实例任务，就是一个任务，需要多个人协作完成，大致可以分为两种：

（1）并行多实例：完成任务没有先后顺序的要求，并行执行

（2）串行多实例：完成任务有先后顺序，也就是说，必须等待前一个人完成了任务，下一个人的任务才开始

在流程图中也可以体现出并行多实例与串行多实例的区别，注意看领导审批节点，多了3条线，如果3条线是竖直的，那就是并行多实例，如下所示：

如果3条线是水平的，那就是串行多实例，如下所示：

bpmn文件的流程图，本质就是一个xml文件，普通的用户任务和多实例的任务区别如下：

    <userTask activiti:exclusive="true" id="_3" name="请假申请"/>
    <userTask activiti:assignee="${leader}" activiti:exclusive="true" id="_4" name="领导审批">
      <multiInstanceLoopCharacteristics activiti:collection="${leaderList}" activiti:elementVariable="leader" isSequential="true">
        <completionCondition><![CDATA[${nrOfInstances == nrOfCompletedInstances}]]></completionCondition>
      </multiInstanceLoopCharacteristics>
    </userTask>

区别就在于多实例任务里面多了一个multiInstanceLoopCharacteristics 节点

下面简单解释一些其含义：

isSequential，为true表示是串行多实例，false表示是并行多实例
activiti:collection，表示多实例的人员集合，${leaderList}是取变量leaderList的值
activiti:elementVariable，人员集合中的元素变量，这里要UserTask中activiti:assignee的值对应，这里变量名称都是leader
nrOfInstances，实例总数（nr是number的简写）
nrOfCompletedInstances，已完成的实例数
completionCondition，表示多实例任务的完成条件

下面以并行多实例为例，看看多实例任务的流转过程，下面是本次示例的流程图

主要的xml如下：

  <process id="test_huiqian_2" isClosed="false" isExecutable="true" name="测试多实例会签" processType="None">
    <startEvent id="_2" name="StartEvent"/>
    <userTask activiti:assignee="${applyUser}" activiti:exclusive="true" id="_3" name="申请人确认">
      <extensionElements>
        <activiti:taskListener delegateExpression="${huiQianTaskListener}" event="complete"/>
      </extensionElements>
      <multiInstanceLoopCharacteristics activiti:collection="${applyUserList}" activiti:elementVariable="applyUser" isSequential="false">
        <completionCondition><![CDATA[${agreeCnt/nrOfInstances>=0.5}]]></completionCondition>
      </multiInstanceLoopCharacteristics>
    </userTask>
    <exclusiveGateway gatewayDirection="Unspecified" id="_4" name="ExclusiveGateway"/>
    <userTask activiti:assignee="${leader}" activiti:exclusive="true" id="_5" name="领导审批"/>
    <exclusiveGateway gatewayDirection="Unspecified" id="_6" name="ExclusiveGateway"/>
    <endEvent id="_7" name="EndEvent"/>
    <sequenceFlow id="_8" sourceRef="_2" targetRef="_3"/>
    <sequenceFlow id="_9" sourceRef="_3" targetRef="_4"/>
    <sequenceFlow id="_10" name="确认申请" sourceRef="_4" targetRef="_5">
      <conditionExpression xsi:type="tFormalExpression"><![CDATA[${isApply == 'true'}]]></conditionExpression>
    </sequenceFlow>
    <sequenceFlow id="_11" sourceRef="_5" targetRef="_6"/>
    <sequenceFlow id="_12" name="领导审批通过" sourceRef="_6" targetRef="_7">
      <conditionExpression xsi:type="tFormalExpression"><![CDATA[${leaderAudit == 'true'}]]></conditionExpression>
    </sequenceFlow>
    <sequenceFlow id="_13" name="放弃申请" sourceRef="_4" targetRef="_7">
      <conditionExpression xsi:type="tFormalExpression"><![CDATA[${isApply == 'false'}]]></conditionExpression>
    </sequenceFlow>
    <sequenceFlow id="_14" name="领导审批不通过" sourceRef="_6" targetRef="_3">
      <conditionExpression xsi:type="tFormalExpression"><![CDATA[${leaderAudit == 'false'}]]></conditionExpression>
    </sequenceFlow>
  </process>

注意到：

<completionCondition><![CDATA[${agreeCnt/nrOfInstances>=0.5}]]></completionCondition>

说明只要有一半的人同意了，多实例任务就完成了，进入到下一个节点

启动流程

启动流程，设置多实例任务的参与者：张三、李四、王五

       String key = "test_huiqian_2";
        // 申请人列表
        List<String> applyUserList = new ArrayList<>(3);
        applyUserList.add("张三");
        applyUserList.add("李四");
        applyUserList.add("王五");
        Map<String,Object> variables = new HashMap<>(1);
        variables.put("applyUserList",applyUserList);
        // 申请人同意的数量
        variables.put("agreeCnt",0);
        variables.put("isApply","false");
        // 启动流程
        runtimeService.startProcessInstanceByKey(key, variables);

启动流程后，进入到多实例任务，留意以下几张表的数据变化：