第十八篇Flowable之多人会签

Posted 2022-08-03 波波烤鸭

一、多人会签

1.流程图绘制

  多人会签是指一个任务需要多个人来处理，案例讲解

完整的xml内容

<?xml version="1.0" encoding="UTF-8"?>
<definitions xmlns="http://www.omg.org/spec/BPMN/20100524/MODEL" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:activiti="http://activiti.org/bpmn" xmlns:bpmndi="http://www.omg.org/spec/BPMN/20100524/DI" xmlns:omgdc="http://www.omg.org/spec/DD/20100524/DC" xmlns:omgdi="http://www.omg.org/spec/DD/20100524/DI" typeLanguage="http://www.w3.org/2001/XMLSchema" expressionLanguage="http://www.w3.org/1999/XPath" targetNamespace="http://www.activiti.org/test">
    <process id="myProcess" name="My process" isExecutable="true">
        <startEvent id="startevent1" name="Start"></startEvent>
        <userTask id="usertask1" name="User Task">
            <extensionElements>
                <activiti:taskListener event="create" expression="$mulitiInstanceTaskListener.completeListener(execution)"></activiti:taskListener>
            </extensionElements>
            <multiInstanceLoopCharacteristics isSequential="false" activiti:collection="persons" activiti:elementVariable="person">
                <loopCardinality>3</loopCardinality>
                <completionCondition>$mulitiInstanceCompleteTask.completeTask(execution)</completionCondition>
            </multiInstanceLoopCharacteristics>
        </userTask>
        <sequenceFlow id="flow1" sourceRef="startevent1" targetRef="usertask1"></sequenceFlow>
        <endEvent id="endevent1" name="End"></endEvent>
        <sequenceFlow id="flow2" sourceRef="usertask1" targetRef="endevent1"></sequenceFlow>
    </process>
    <bpmndi:BPMNDiagram id="BPMNDiagram_myProcess">
        <bpmndi:BPMNPlane bpmnElement="myProcess" id="BPMNPlane_myProcess">
            <bpmndi:BPMNShape bpmnElement="startevent1" id="BPMNShape_startevent1">
                <omgdc:Bounds height="35.0" width="35.0" x="420.0" y="310.0"></omgdc:Bounds>
            </bpmndi:BPMNShape>
            <bpmndi:BPMNShape bpmnElement="usertask1" id="BPMNShape_usertask1">
                <omgdc:Bounds height="55.0" width="105.0" x="700.0" y="300.0"></omgdc:Bounds>
            </bpmndi:BPMNShape>
            <bpmndi:BPMNShape bpmnElement="endevent1" id="BPMNShape_endevent1">
                <omgdc:Bounds height="35.0" width="35.0" x="950.0" y="310.0"></omgdc:Bounds>
            </bpmndi:BPMNShape>
            <bpmndi:BPMNEdge bpmnElement="flow1" id="BPMNEdge_flow1">
                <omgdi:waypoint x="455.0" y="327.0"></omgdi:waypoint>
                <omgdi:waypoint x="700.0" y="327.0"></omgdi:waypoint>
            </bpmndi:BPMNEdge>
            <bpmndi:BPMNEdge bpmnElement="flow2" id="BPMNEdge_flow2">
                <omgdi:waypoint x="805.0" y="327.0"></omgdi:waypoint>
                <omgdi:waypoint x="950.0" y="327.0"></omgdi:waypoint>
            </bpmndi:BPMNEdge>
        </bpmndi:BPMNPlane>
    </bpmndi:BPMNDiagram>
</definitions>

2. 流程说明

1.在用户任务节点绑定了一个监听器，监听create行为，该监听器我们是通过UEL表达式来实现的，mulitiInstanceTaskListener是我们注入到Spring容器中的对象

对应的监听的代码如下：

@Component("mulitiInstanceTaskListener")
public class MulitiInstanceTaskListener implements Serializable 
    
    /**
     * Deploy 加V【boge3306】获取代码 
     */

2.在Multi instance中的配置

• Loop cardinality:设置为3表示只循环3次，也就是三个人会签
• Collection：表示要循环的集合，我们给的是persons，后面需要在流程变量中赋值
• Element variable：表示循环的变量
• Completion condition：表示任务结束的条件，也就是多人会签的结束条件，在此处我们用的是UEL表达式，mulitiInstanceCompleteTask表示的是我们注入到Spring容器中的对象

mulitiInstanceCompleteTask对象的完整代码为：

@Component("mulitiInstanceCompleteTask")
public class MulitiInstanceCompleteTask implements Serializable 
/**
     * Deploy 加V【boge3306】获取代码 
     */

上面的三个变量是Flowable中自带的可用变量

1. nrOfInstances:该会签环节中总共有多少个实例

2. nrOfActiveInstances:当前活动的实例的数量，即还没有完成的实例数量。

3. nrOfCompletedInstances:已经完成的实例的数量

3.案例演示

3.1 部署流程

/**
     * Deploy 加V【boge3306】获取代码 
     */

3.2 启动流程

  在启动流程实例的时候，我们需要设置相关的参数，在流程定义的时候设置的persons在此处我们就需要设置了，设置为Arrays.asList(“张三”,“李四”,“王五”,“赵六”)，这里设置了4个元素，在流程定义里定义了3个，表示只会循环3次，启动流程后，在Task中可以看到只有3个任务

/**
     * Deploy 加V【boge3306】获取代码 
     */

同时控制也有对应的输出，触发了Task的创建事件

3.3 会签处理任务

  启动流程后我们发下在Task中产生了3条任务，我们先通过TaskService来完成其中一个任务，设置一个标志flag为false，来控制会签还没有结束，同时Task中另外两个任务还在

/**
     * Deploy 加V【boge3306】获取代码 
     */

当任务执行完成时会同步触发会签完成表达式中对象方法。有如下的输出

同时Task表中的记录还有两条

然后当我们在完成一个任务，这时设置flag为true，会发现在这个多人处理中，最多3个人处理在第二个人处理后就结束了

/**
     * Deploy 加V【boge3306】获取代码 
     */

同时来看看表结构中的记录，发现没有了

搞定~