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

2023-10-25 03:32

本文主要是介绍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学习(十七)——多实例任务的使用(会签功能)的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/279745

相关文章

Python 字典 (Dictionary)使用详解

《Python字典(Dictionary)使用详解》字典是python中最重要,最常用的数据结构之一,它提供了高效的键值对存储和查找能力,:本文主要介绍Python字典(Dictionary)... 目录字典1.基本特性2.创建字典3.访问元素4.修改字典5.删除元素6.字典遍历7.字典的高级特性默认字典

使用Python构建一个高效的日志处理系统

《使用Python构建一个高效的日志处理系统》这篇文章主要为大家详细讲解了如何使用Python开发一个专业的日志分析工具,能够自动化处理、分析和可视化各类日志文件,大幅提升运维效率,需要的可以了解下... 目录环境准备工具功能概述完整代码实现代码深度解析1. 类设计与初始化2. 日志解析核心逻辑3. 文件处

一文详解如何使用Java获取PDF页面信息

《一文详解如何使用Java获取PDF页面信息》了解PDF页面属性是我们在处理文档、内容提取、打印设置或页面重组等任务时不可或缺的一环,下面我们就来看看如何使用Java语言获取这些信息吧... 目录引言一、安装和引入PDF处理库引入依赖二、获取 PDF 页数三、获取页面尺寸(宽高)四、获取页面旋转角度五、判断

C++中assign函数的使用

《C++中assign函数的使用》在C++标准模板库中,std::list等容器都提供了assign成员函数,它比操作符更灵活,支持多种初始化方式,下面就来介绍一下assign的用法,具有一定的参考价... 目录​1.assign的基本功能​​语法​2. 具体用法示例​​​(1) 填充n个相同值​​(2)

Spring StateMachine实现状态机使用示例详解

《SpringStateMachine实现状态机使用示例详解》本文介绍SpringStateMachine实现状态机的步骤,包括依赖导入、枚举定义、状态转移规则配置、上下文管理及服务调用示例,重点解... 目录什么是状态机使用示例什么是状态机状态机是计算机科学中的​​核心建模工具​​,用于描述对象在其生命

JSONArray在Java中的应用操作实例

《JSONArray在Java中的应用操作实例》JSONArray是org.json库用于处理JSON数组的类,可将Java对象(Map/List)转换为JSON格式,提供增删改查等操作,适用于前后端... 目录1. jsONArray定义与功能1.1 JSONArray概念阐释1.1.1 什么是JSONA

使用Python删除Excel中的行列和单元格示例详解

《使用Python删除Excel中的行列和单元格示例详解》在处理Excel数据时,删除不需要的行、列或单元格是一项常见且必要的操作,本文将使用Python脚本实现对Excel表格的高效自动化处理,感兴... 目录开发环境准备使用 python 删除 Excphpel 表格中的行删除特定行删除空白行删除含指定

深入理解Go语言中二维切片的使用

《深入理解Go语言中二维切片的使用》本文深入讲解了Go语言中二维切片的概念与应用,用于表示矩阵、表格等二维数据结构,文中通过示例代码介绍的非常详细,需要的朋友们下面随着小编来一起学习学习吧... 目录引言二维切片的基本概念定义创建二维切片二维切片的操作访问元素修改元素遍历二维切片二维切片的动态调整追加行动态

MySQL中的LENGTH()函数用法详解与实例分析

《MySQL中的LENGTH()函数用法详解与实例分析》MySQLLENGTH()函数用于计算字符串的字节长度,区别于CHAR_LENGTH()的字符长度,适用于多字节字符集(如UTF-8)的数据验证... 目录1. LENGTH()函数的基本语法2. LENGTH()函数的返回值2.1 示例1:计算字符串

prometheus如何使用pushgateway监控网路丢包

《prometheus如何使用pushgateway监控网路丢包》:本文主要介绍prometheus如何使用pushgateway监控网路丢包问题,具有很好的参考价值,希望对大家有所帮助,如有错误... 目录监控网路丢包脚本数据图表总结监控网路丢包脚本[root@gtcq-gt-monitor-prome