这篇主要记录多实例节点的实现,也就是常说的会签、或签、加减签等等。camunda对这类一个节点多个任务的情况称为multiInstance,就像下面这个,左上角代表这是用户任务UserTask,正下方的竖线意味着这个节点的任务是并行的,有多少审批人就会同时出现多少个任务。当然这些在之前提到的文档和教程都有介绍,就不仔细回顾了。
camunda的多实例节点创建后会在流程中生成几个固定变量我们可以用这些变量配置流程图的节点完成条件,从而达到实现不同的多实例节点功能。
- nrOfActiviteInstances:当前活动的实例数量,即还没有完成的实例数量
- loopCounter :循环计数器,办理人在列表中的索引
- nrOfInstances:会签中总共的实例数
- nrOfCompletedInstances:已经完成的实例数量
会签
常见会签主要的规则就是每个人都得审批,如果有退回则节点退回也就是一票否决,所以整理成以下两个需求。
- 当前节点任务数全部完成继续流转
- 如果有任一不同意则节点回退
所以这个节点的完成条件是${ nrOfCompletedInstances == nrOfInstances || !approve }
这个approve是我自定义的boolean类型审批意见,当然也可以取任何你想要的名字,这样就能实现提前回退节点而不需要等所有人审批完,这部分我看其他大部分教程都提及。从我自己的实践来看如果不带 || !approve条件的话流程就根据最后一个人的审批意见决定走向,这显然是不对的。很烦那些复制来复制去的教程,甚至不能实现常见的会签!
当然也有解决办法,我的解决办法是通过监听事件在节点开始时设置一个叫multiApprove的变量,在节点完成且nrOfCompletedInstances == nrOfInstances这个条件触发时判断是否有节点不同意,最后通过multiApprove决定整体的走向。当然这只是我初步探究的解决办法,后来发现 || !approve这个条件符合我的项目业务逻辑就优化了这部分。
或签
- 当前节点任务只要有一个完成就继续流转,这个任务的审批意见决定走向
所以或签的需求更加简单,只需要${nrOfCompletedInstances == 1}就完成了,也不用在意上述的意见冲突。
这里放一个示例,介绍一下MultiInstance的变量
- Loop Cardinality:这个变量我没用到,循环功能对我来说不需要,并且网上的描述也看不懂
- Collection:审批人的集合,通常为list<String>如图assigneeList,在添加变量时名字要对应上
- Element Variable:审批人集合转换成的子变量,这个要和下图的assignee内容对应上
- Completion Condition:节点的完成条件,这里是${nrOfCompletedInstances == 1}
要注意的是,用api调用complete()进行节点流转时,我们一般会附带variable也就是变量的集合,这里不带${}的地方是在声明、设入变量,而User assignment里是从流程实例里取变量,比较难描述,大家尝试一下应该就能理解。
加签
如果上述两种你都尝试并且能理解,很自然加签的实现你会想到直接在assigneeList里添加审批人。其实仔细想想还是不对的,因为加签需要在已有的节点添加审批人,而assigneeList里的assignee们在节点创建时就生成了,只添加assignee是不会有新任务出现的。要实现加签得用到camunda另一个功能,任一节点的回退,也叫补偿机制,有兴趣可以了解一下我打算在之后单独写这个功能,先一笔带过吧。
减签
只需要根据审批人用taskService找到对应task,再删掉就完成了,非常简单。
最后说一个有意思的坑吧,如果某个节点的assigneeList为空,找不到对应审批人也就没法生成task,流程就会在那个节点直接结束走向EndEvnet,这也不符合大部分国内公司的需求。这方面我做了审批人为空的判断,如果根据流转逻辑下个节点的审批人为空,给它设置一个默认[系统自动]的人进行流转,也就实现了空节点自动审批通过功能。