本文主要是介绍activiti学习(十七)——多实例任务的使用(会签功能),希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!
概述
会签在中国式流程中是非常常见的需求。例如部门领导下发一个文件,需要部门里面每个员工看完之后提交流程以表示已阅。这时候需要使用activiti中的多实例任务。
多实例任务的图标如下:
左边的userTask下方是三条竖线,代表并行多实例,右边的userTask下方是三条横线,代表串行多实例。多实例任务,可以理解为该环节要提交多次才会通过,串行多实例一次只有个任务可提交,并行多实例多个任务可并行提交。
串行多实例举例
下面进行串行多实例举例,流程图如下,在员工互评环节为串行多实例
Assignee属性设置为表达式${assignee}
Sequential设置为true,代表串行多实例。loop cardinality设置数量3,代表需要循环提交3次。Collection设置为Assignee的集合,Element variable设置为集合中变量名称,Element variable与Assignee的表达式变量是关联的。Element variable与Collection的关系,类似java中for(String assignee in assigneeList)这样的关系。因此这个流程需要设置多实例任务的Assignee时,我们实际上需要传入流程变量assigneeList。
具体的bpmn文件如下:
<?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="串行多实例任务" name="串行多实例任务" isExecutable="true"><startEvent id="startevent1" name="Start"></startEvent><userTask id="员工互评" name="员工互评" activiti:assignee="${assignee}"><multiInstanceLoopCharacteristics isSequential="true" activiti:collection="assigneeList" activiti:elementVariable="assignee"><loopCardinality>3</loopCardinality></multiInstanceLoopCharacteristics></userTask><sequenceFlow id="flow1" sourceRef="startevent1" targetRef="员工互评"></sequenceFlow><userTask id="领导审核" name="领导审核" activiti:assignee="丁总"></userTask><sequenceFlow id="flow2" sourceRef="员工互评" targetRef="领导审核"></sequenceFlow><endEvent id="endevent1" name="End"></endEvent><sequenceFlow id="flow3" sourceRef="领导审核" targetRef="endevent1"></sequenceFlow></process><bpmndi:BPMNDiagram id="BPMNDiagram_串行多实例任务"><bpmndi:BPMNPlane bpmnElement="串行多实例任务" id="BPMNPlane_串行多实例任务"><bpmndi:BPMNShape bpmnElement="startevent1" id="BPMNShape_startevent1"><omgdc:Bounds height="35.0" width="35.0" x="150.0" y="320.0"></omgdc:Bounds></bpmndi:BPMNShape><bpmndi:BPMNShape bpmnElement="员工互评" id="BPMNShape_员工互评"><omgdc:Bounds height="55.0" width="105.0" x="230.0" y="310.0"></omgdc:Bounds></bpmndi:BPMNShape><bpmndi:BPMNShape bpmnElement="领导审核" id="BPMNShape_领导审核"><omgdc:Bounds height="55.0" width="105.0" x="380.0" y="310.0"></omgdc:Bounds></bpmndi:BPMNShape><bpmndi:BPMNShape bpmnElement="endevent1" id="BPMNShape_endevent1"><omgdc:Bounds height="35.0" width="35.0" x="530.0" y="320.0"></omgdc:Bounds></bpmndi:BPMNShape><bpmndi:BPMNEdge bpmnElement="flow1" id="BPMNEdge_flow1"><omgdi:waypoint x="185.0" y="337.0"></omgdi:waypoint><omgdi:waypoint x="230.0" y="337.0"></omgdi:waypoint></bpmndi:BPMNEdge><bpmndi:BPMNEdge bpmnElement="flow2" id="BPMNEdge_flow2"><omgdi:waypoint x="335.0" y="337.0"></omgdi:waypoint><omgdi:waypoint x="380.0" y="337.0"></omgdi:waypoint></bpmndi:BPMNEdge><bpmndi:BPMNEdge bpmnElement="flow3" id="BPMNEdge_flow3"><omgdi:waypoint x="485.0" y="337.0"></omgdi:waypoint><omgdi:waypoint x="530.0" y="337.0"></omgdi:waypoint></bpmndi:BPMNEdge></bpmndi:BPMNPlane></bpmndi:BPMNDiagram>
</definitions>
接下来我们启动流程,并配置assigneeList变量:
public void startProcessByIdWithVar() {RuntimeService runtimeService = pe.getRuntimeService();List<String> assigneeList = new ArrayList<String>();assigneeList.add("张三");assigneeList.add("李四");assigneeList.add("王五");Map<String, Object> vars = new HashMap<String, Object>();vars.put("assigneeList", assigneeList);ProcessInstance pi = runtimeService.startProcessInstanceById("串行多实例任务:2:5004", vars);System.out.println("流程定义ID:" + pi.getProcessInstanceId());System.out.println("流程实例ID:" + pi.getId());
}
启动流程后查看act_ru_execution表,会有两个execution,一个是父execution 2501,其IS_ACTIVE值为0,表示非活动状态。其子execution 2506为活动状态,为子execution,处于员工互评环节。
由于是串行多实例任务,act_ru_task表同时只会有一个任务。此时任务处理人为张三。提交了该任务后会到李四,然后再提交就到王五。串行多实例任务是一个接一个的处理方式。
act_ru_variable变量表比较多记录,在流程处于多实例任务时,系统会有几个内置的变量,其中几个变量的含义分别是:
nrOfInstances:多实例任务总数;
nrOfCompletedInstances:当前已完成实例数;
loopCounter:循环计数;
nrOfActiveInstances:当前活动状态的实例数。像串行多实例,自然当前活动状态的实例数就是1了。
并行多实例举例
并行多实例与串行多实例差不多,仅在Sequential
<?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="并行多实例" name="并行多实例" isExecutable="true"><startEvent id="startevent1" name="Start"></startEvent><userTask id="员工互评" name="员工互评" activiti:assignee="${assignee}"><multiInstanceLoopCharacteristics isSequential="false" activiti:collection="assigneeList" activiti:elementVariable="assignee"><loopCardinality>3</loopCardinality></multiInstanceLoopCharacteristics></userTask><userTask id="领导审批" name="领导审批"></userTask><sequenceFlow id="flow3" sourceRef="员工互评" targetRef="领导审批"></sequenceFlow><endEvent id="endevent1" name="End"></endEvent><sequenceFlow id="flow4" sourceRef="领导审批" targetRef="endevent1"></sequenceFlow><sequenceFlow id="flow5" sourceRef="startevent1" targetRef="员工互评"></sequenceFlow></process><bpmndi:BPMNDiagram id="BPMNDiagram_并行多实例"><bpmndi:BPMNPlane bpmnElement="并行多实例" id="BPMNPlane_并行多实例"><bpmndi:BPMNShape bpmnElement="startevent1" id="BPMNShape_startevent1"><omgdc:Bounds height="35.0" width="35.0" x="200.0" y="390.0"></omgdc:Bounds></bpmndi:BPMNShape><bpmndi:BPMNShape bpmnElement="员工互评" id="BPMNShape_员工互评"><omgdc:Bounds height="55.0" width="105.0" x="310.0" y="380.0"></omgdc:Bounds></bpmndi:BPMNShape><bpmndi:BPMNShape bpmnElement="领导审批" id="BPMNShape_领导审批"><omgdc:Bounds height="55.0" width="105.0" x="460.0" y="380.0"></omgdc:Bounds></bpmndi:BPMNShape><bpmndi:BPMNShape bpmnElement="endevent1" id="BPMNShape_endevent1"><omgdc:Bounds height="35.0" width="35.0" x="610.0" y="390.0"></omgdc:Bounds></bpmndi:BPMNShape><bpmndi:BPMNEdge bpmnElement="flow3" id="BPMNEdge_flow3"><omgdi:waypoint x="415.0" y="407.0"></omgdi:waypoint><omgdi:waypoint x="460.0" y="407.0"></omgdi:waypoint></bpmndi:BPMNEdge><bpmndi:BPMNEdge bpmnElement="flow4" id="BPMNEdge_flow4"><omgdi:waypoint x="565.0" y="407.0"></omgdi:waypoint><omgdi:waypoint x="610.0" y="407.0"></omgdi:waypoint></bpmndi:BPMNEdge><bpmndi:BPMNEdge bpmnElement="flow5" id="BPMNEdge_flow5"><omgdi:waypoint x="235.0" y="407.0"></omgdi:waypoint><omgdi:waypoint x="310.0" y="407.0"></omgdi:waypoint></bpmndi:BPMNEdge></bpmndi:BPMNPlane></bpmndi:BPMNDiagram>
</definitions>
接下来我们启动流程,和之前串行的时候一样,也是把assigneeList作为流程变量,传递处理人信息
public void startProcessByIdWithVar() {RuntimeService runtimeService = pe.getRuntimeService();List<String> assigneeList = new ArrayList<String>();assigneeList.add("张三");assigneeList.add("李四");assigneeList.add("王五");Map<String, Object> vars = new HashMap<String, Object>();vars.put("assigneeList", assigneeList);ProcessInstance pi = runtimeService.startProcessInstanceById("并行多实例:1:4", vars);System.out.println("流程定义ID:" + pi.getProcessInstanceId());System.out.println("流程实例ID:" + pi.getId());
}
启动流程后,观察act_ru_execution表,看到当前有5条记录。其中第一条为父execution,第二条为标识分支的execution,3-5条为具体的并行execution,。其在执行表中的表现与并行网关很相似。
再看act_ru_task表,同时有三条task记录,即张三、李四、王五可并行提交各自的任务。
当我们把张三、李四的记录提交之后,再看act_ru_execution表:
与并行网关不同的是,提交后对应的execution仍在,只是IS_ACTIVE置0。
动态配置
上面两个例子中,我们已经通过设置Collection和Element variable来实现动态配置assignee了。还有一个疑问,loop cardinality如果是一个固定值,那么进行员工互评时,员工的数量不可能一直是一个固定值,而且每个部门进行互评时,部门的人数也各不相同,总不可能为每个部门配置一个流程,并且实时维护多实例循环次数。其实只要我们设置了Collection并且不设置loop cardinality的话,那么activiti就会把Collection的长度作为loop cardinality的值,实现了动态配置多实例任务循环次数。
条件配置
在上面例子中,还有一个遗漏的属性没讲,就是Completion condition。这个属性表示当其值为true时,多实例流程就完成了。例如部门里项目评估小组进行决策,小组中成员超过60%的人同意,那么该环节就通过。这样我们就要使用Completion condition。
我们现在就以项目专家评估小组为例。假设项目需要先由一个专家评估小组进行评估,超过60%的人提交了,那环节就通过。我们设计流程图,在Completion condition中设置${nrOfCompletedInstances/nrOfInstances>=0.6},即当任务完成数大于等于任务总数的60%时,多实例任务完成。
下来我们启动流程,这次我们在assigneeList中加入五个人。那么按照条件,当有三人提交后,流程就会走到下一个节点。
public void startProcessByIdWithVar() {RuntimeService runtimeService = pe.getRuntimeService();List<String> assigneeList = new ArrayList<String>();assigneeList.add("张三");assigneeList.add("李四");assigneeList.add("王五");assigneeList.add("赵六");assigneeList.add("孙七");Map<String, Object> vars = new HashMap<String, Object>();vars.put("assigneeList", assigneeList);ProcessInstance pi = runtimeService.startProcessInstanceById("条件配置多实例:1:4", vars);System.out.println("流程定义ID:" + pi.getProcessInstanceId());System.out.println("流程实例ID:" + pi.getId());
}
看下执行表act_ru_execution表
任务表act_ru_task表
根据设置的 Completion condition,我们只要完成3个task,该节点就会通过。我们尝试提交张三、李四、王五这三人的task看看结果。
当提交了三人的任务后,看看此时act_ru_execution表,已经到了项目实施环节:
而act_ru_task表,之前赵六、孙七未提交的任务,会被删除。
可以看看历史任务表act_hi_task,在DELETE_REASON一栏,赵六、孙七是以“deleted”原因而删除的,张三、李四、王五则是以 “completed”原因删除的。
上面的例子只是条件配置比较简单的用法。实际中可以配合不同的流程变量进行判断,再配合流程分支和网关,实现不同的走向,例如超过30%的人提交反对意见,则流程退回到上一个节点。
小结
本文主要讲解了流程的会签功能如何通过activiti的多实例任务进行实现,以及多实例任务的基本用法。实际项目中,还常常会用到加签、减签等等,这个留到后面再研究。
这篇关于activiti学习(十七)——多实例任务的使用(会签功能)的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!