activiti学习（十七）——多实例任务的使用（会签功能）

最新推荐文章于 2024-04-18 17:28:13 发布
最新推荐文章于 2024-04-18 17:28:13 发布
阅读量8k 收藏 33
点赞数 8
分类专栏： Activiti
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/sadoshi/article/details/105920620
版权

概述

会签在中国式流程中是非常常见的需求。例如部门领导下发一个文件，需要部门里面每个员工看完之后提交流程以表示已阅。这时候需要使用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的多实例任务进行实现，以及多实例任务的基本用法。实际项目中，还常常会用到加签、减签等等，这个留到后面再研究。

sadoshi
关注
专栏目录
activiti 多实例实现会签
u010924288的博客
11-23 4340
来实现任务的会签
activiti并发多实例子流程任务处理
dkwrl82404的专栏
03-22 2967
一直在搞工作流(activiti)，总结一下关于工作流(activiti)中同时并发处理多个子流程的操作方法。 先说下我要实现的业务： 1、办公室发通知（在系统申报页面上，勾选科室，被选中的科室执行第二步） 2、科室科员填报数据 3、科室科长做审核（注意这里的科长审核是对应第二步的科室，本科科长去审核本单位填报完的任务） 4、办公室编制立项书，汇总数据 好，需求就先这样，这里...
Activiti——顺序流、网关、多实例及补偿处理详解
吴声子夜歌的博客
09-09 1692
目录Activiti顺序流、网关、多实例及补偿处理详解1、顺序流1.1、条件顺序流1.2、默认顺序流2、流程网关2.1、单向网关2.2、并行网关2.3、兼容网关2.4、事件网关3、流程活动特性3.1、多实例活动3.2、设置循环数据3.3、获取循环元素3.4、循环的内置参数3.5、循环结束条件3.6、补偿处理者 Activiti顺序流、网关、多实例及补偿处理详解 1、顺序流 顺序流主要用于连接流程中的两个元素，在流程图中，其主要用来展示流程的走向。BPMN规范对关于顺序流的连接也提供了连接规则，例如顺序流不能
Activiti多实例任务实现会签
12-09
Activiti多实例任务实现会签.
activiti学习-使用activiti多实例任务实现会签
06-23
activiti学习-使用activiti多实例任务实现会签
camunda 工作流学习笔记2 - 任务的多实例特性(Multiple Instance)
张云飞Vir的专栏
08-19 3159
1. 背景 在工作流中会有遇到这样一个"多个人处理同一个任务“的情形，在 camunda 中可以使用“任务的多实例”来实现。 2.知识 场景 比如遇到下面的场景： 一个审批任务可由 经理或者副经理 其中的一个人审批即可通过。 一个填报任务，要由组员A填报一半的内容，且组员B填报一半的内容，都填完了才算完成。 这时，可考虑使用“任务的多实例” 任务的多实例( Multiple Instance...
Activiti6.0（十一）多实例节点（会签）
清茶的博客
02-11 6234
目录 一、前言 二、多实例功能 1、多实例特殊变量 2、多实例配置 3、验证 一、前言 在实际业务流程中，多实例节点是非常常见的一种场景，常用在多人审批环节，简单说就是某个环节的处理人指派给了多个人，需要这些人全部审批完或部分审批完流程能自动流转的功能。以我们开发人员的角度看，其本质就是给定一个处理人员范围集合，然后循环该集合，为每一个集合中的元素都执行一遍当前环节，既可以顺序依次执...
activiti多实例设置(会签/或签)
白猿的博客
12-01 2万+
activiti多实例设置(会签/或签) 在审批流中会遇到会签/或签的情况，activiti本身就已经支持，通过多实例来实现。 本文通过流程画布和Java代码两中方式来作实现。 1.流程画布设置多实例 设置如图，会计这个节点是会签节点。 参数说明： Multi-instance-type:多人审批方式 paraller 并行，Sequential 串行，多实例需设置未并行 Executi...
工作流-多实例会签条件设置
weixin_45189665的博客
01-12 1014
工作流-多实例会签条件设置
戏(细)说工作流——activiti
feifeixiongxiong的博客
12-11 1406
持续坚持不偷懒，立个标题先，内容待续。。。。。
Activiti工作流框架学习（十三）
u012426327的专栏
03-23 713
Activiti设置会签 正好有两个人问道：支持会签吗？ 也有人也问道：什么是会签？ 如果从process engine的角度上讲呢？ 可以说一个task节点下有多个task instance。 而不是一个从task节点执行到多个task节点（这样就是ParallelGateway了）。 如何让一个Task节点创建出多个instance？官网是这样说的：
Activiti进阶（五）——流程执行历史记录
周江霄
12-20 4万+
之前的几篇文章，为大家简单的介绍了部署流程定义、启动流程实例、查看和办理个人任务以及如何设置和获取流程变量，这一系列的活动组成了一个完整的执行流程，那么一个执行完的流程我们如何查看相关的定义呢，这篇博文就为大家简单的介绍一下流程执行的历史记录查询。     一、查询历史流程实例 /**查询历史流程实例*/ @Test public void findHisProces
Activiti进阶（八）——并行网关（ParallelGateWay）
热门推荐
周江霄
12-22 4万+
上一篇博客我们讲到了排他网管，这篇博文简单介绍一下他的兄弟，并行网关。      一、流程图                                                                       图一   并行网关网购流程图      在这里，我们模拟网上购物流程，四个用户任务，分别是付款、发货、收款、收货，其中付款和收货的办理
Activiti会签
bobozai86的博客
03-03 2916
1.什么是会签 a)在流程业务管理中，任务是通常都是由一个人去处理的，而多个人同时处理一个任务，这种任务我们称之为会签任务。 2.会签的种类 a)按数量通过：达到一定数量的通过表决后，会签通过。 b)按比例通过：达到一定比例的通过表决后，会签通过。 c)一票否决：只要有一个表决时否定的，会签通过。 d)一票通过：只要有一个表决通过的，会签通过...
SpringBoot整合Activiti7——实战之放假流程(会签)
最新发布
weixin_51833408的博客
04-18 976
将启动流程后的流程实例ID更换到下面。将启动流程后的流程实例ID更换到下面。
Activiti7工作流引擎：进阶篇(十一) 会签、或签
人不风流枉少年
12-19 1万+
之前的任务负责人Assignee都是一个，而任务可以有多个人有权限审批，只要其中有一部分人完成审批任务就算整个任务完成。 同一个任务需要多个负责人来完成被称之为“会签”。 会签就是一种投票，满足投票人数就过。 会签是通过多实例Multi Instance来设置的： Sequential：执行顺序，true表示多实例顺序执行，false表示多实例并行。 Loop Cardinality：循环基数，选填，会签人数。 Completion Condition：完成条件，Activiti预定义了3个.
Activiti之多实例任务
qiuxinfa123的博客
08-11 6988
所谓多实例任务，就是一个任务，需要多个人协作完成，大致可以分为两种： （1）并行多实例：完成任务没有先后顺序的要求，并行执行 （2）串行多实例：完成任务有先后顺序，也就是说，必须等待前一个人完成了任务，下一个人的 任务才开始 在流程图中也可以体现出并行多实例与串行多实例的区别，注意看领导审批节点，多了3条线，如果3条线是竖直的，那就是并行多实例，如下所示： 如果3条线是水平的，那就是串行多实例，如下所示： bpmn文件的流程图，本质就是一个xml文件，普通的用户任务...
springboot整合Activiti-多实例任务串行并行配置
会走的鱼
08-31 1950
上面的程序已经解决了常用的问题，关于会签、加签、减签、退签、权重配置、自定义通过条件配置(条件自定义通过)< completionCondition > ${nrOfCompletedInstances/nrOfInstances >= 0.25} 完成条件的配置。
activit工作流-会签流程（多实例）
tt094534的博客
08-22 2万+
使用工作流的时候有时会遇到这样的一种情况就是一个任务需要几个人一起审批，人数不定。这时常规的用户任务就无法满足要求，我们称这种任务为会签任务。 下面是我开发中的遇到的一个业务好遇到这种情况，记录一下，以便小白参考。 流程图： 说明：这是一个公文流转（收文）流程，先是“公文管理”提交收文文件，然后综合部长审批，然后主要领导审批，然后主要领导指派几个分管领导会签，会签完成后交由部
会签多实例任务退回 java flowable 实现
08-31
在 Flowable 中，要实现会签多实例任务的退回，可以通过以下步骤进行操作： 1. 首先，创建一个实现了 MultiInstanceActivityBehavior 接口的自定义活动行为类。这个类将负责处理会签多实例任务的具体逻辑。 ```java public class MyMultiInstanceActivityBehavior implements MultiInstanceActivityBehavior { // 实现 MultiInstanceActivityBehavior 接口的方法 // ... } ``` 2. 在该类中，实现 `leave` 方法，该方法负责处理会签任务每个实例完成后的操作。在这个方法中，可以判断每个实例的完成情况，并根据需要进行退回操作。 ```java @Override public void leave(ActivityExecution execution) { // 判断当前实例是否需要退回 if (shouldReject(execution)) { // 获取会签任务的执行实例 ExecutionEntity multiInstanceExecution = (ExecutionEntity) execution.getParent(); // 将当前实例退回到上一步 CommandContext commandContext = Context.getCommandContext(); commandContext.getExecutionEntityManager().deleteChildExecutions(execution.getParent()); commandContext.getAgenda().planContinueMultiInstanceOperation(multiInstanceExecution); } else { // 正常离开会签任务 super.leave(execution); } } ``` 3. 将自定义的活动行为类应用到会签多实例任务的流程定义中。在 BPMN 文件中，使用 `class` 属性指定自定义类的全限定名。 ```xml <userTask id="multiInstanceTask" name="Multi-Instance Task" flowable:activiti:class="com.example.MyMultiInstanceActivityBehavior" /> ``` 通过以上步骤，就可以在 Flowable 中实现会签多实例任务的退回功能。自定义的活动行为类中的 `leave` 方法可以根据业务逻辑判断是否需要退回，并执行相应的操作。
评论 4
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值