Activiti - 设置会签

清疚 2022-08-21 04:50 140阅读 0赞

正好有两个人问道：支持会签吗？ 也有人也问道：什么是会签？

如果从process engine的角度上讲呢？  
可以说一个task节点下有多个task instance。  
而不是一个从task节点执行到多个task节点（这样就是ParallelGateway了）。

如何让一个Task节点创建出多个instance？官网是这样说的：

> To make an activity multi-instance, the activity xml element must have a multiInstanceLoopCharacteristics child element.

既然是创建多个实例，我们就需要用一个集合去存放。  
我们可以在`multiInstanceLoopCharacteristics`标签中加入一个attribute —— activiti:collection=""。  
该attribute的值是当前流程实例的变量名，也就是启动该引擎实例时传入的Map的key。  
而这个Map的value必须是`java.util.List`类型的。但我们无需在意这个List的泛型是什么。  
假如泛型是String的话，`act_ru_variable`中变量的`TYPE_`字段值是string。  
也许我可以让泛型是Map，那么该变量的TYPE\_字段值是serialize，仅此而已。  
本文中`activiti:collection="assigneeList"`

我们在数据库里记录了这个集合，但我们也需要记录这个记录中的每一个元素。  
记录每一个元素时他们的名字应该是什么？  
我们可以用`activiti:elementVariable=""` 比如我设置：

activiti:elementVariable="assignee"

假设我们现在要的效果是：有三个人可以会签，但只要两个人签署便可通过。  
我们需要设置特定的条件来结束当前这个task。  
这时我们需要在multiInstanceLoopCharacteristics下增加一个子节点——`completionCondition`。  
比如我是这样设置的：

<completionCondition>
            ${signCount >= 2 }
        </completionCondition>

好了，这样就是整个Task的定义了。（事实上我完全可以不用signCount实现这个效果。）

<userTask id="counterTask_1" name="COUNTERTASK">
        <multiInstanceLoopCharacteristics isSequential="false" activiti:collection="assigneeList" activiti:elementVariable="assignee">
            <completionCondition>${signCount >= 2 }</completionCondition>
        </multiInstanceLoopCharacteristics>
    </userTask>

![261821005208961.jpg][]

部署后的结果如下：

![261821147087428.jpg][]

此处省略部署流程的操作，我们来看一下如何申请该流程。  
如下我在页面中定义了三个审核人员：

然后在java中接收并start：

private String[] assigneeList;
    Map<String, Object> processInstVar = new HashMap<String, Object>();
    //必须是List
    processInstVar.put("assigneeList", Arrays.asList(assigneeList));
    processInstVar.put("signCount", 0);
    runtimeService.startProcessInstanceById(processId, processInstVar);

启动结果如下:

![261821324112970.jpg][]

![点击查看原始大小图片][261821452395922.jpg]

![点击查看原始大小图片][261821563337844.jpg]

![点击查看原始大小图片][261822045529521.jpg]

然后是执行，method只接收一个taskId：

List<Task> taskResultList = taskService.createTaskQuery().taskId(taskId) .list(); //当前executionId String currentExecutionId = taskResultList.get(0).getExecutionId(); //当前签署总数 String currentSignCount = StringUtils.defaultString(runtimeService .getVariable(currentExecutionId, "signCount").toString(), "0"); //签署数+1 runtimeService.setVariable(currentExecutionId, "signCount", Integer.parseInt(currentSignCount) + 1); //完成 taskService.complete(taskId);

我们执行了刚才创建的三个实例之一，结果是：

![点击查看原始大小图片][261822176615261.jpg]

再执行一次，会签节点的实例已经不存在于act*ru*task表了，因为我设置的是“有两个人签署便通过”。  
如下图，当前task已经不是会签的task了，相关的变量也消失不见了。  
![点击查看原始大小图片][261822274118439.jpg]

![点击查看原始大小图片][261822343028143.jpg]

最后说我之前为什么说道‘事实上我完全可以不用signCount实现这个效果’，因为我们有：

![点击查看原始大小图片][261822437862009.jpg]

所以我完全没有必要自己去定义一个变量去记录执行了多少次

[261821005208961.jpg]: /images/20220731/69070bb1374d465784feb2d6000f2139.png
[261821147087428.jpg]: /images/20220731/e1b786739a8d49c8b71d46433991305d.png
[261821324112970.jpg]: /images/20220731/ec0fa3c6d3c14d76af17479893a45d43.png
[261821452395922.jpg]: /images/20220731/79063ab5940447abaa81bf006a028e76.png
[261821563337844.jpg]: /images/20220731/fc7fe703246a44b6bfb8eea86803cd70.png
[261822045529521.jpg]: /images/20220731/b8079e158ffa4926b7c8c70d1da592d5.png
[261822176615261.jpg]: /images/20220731/9e1c587b68d644f49988d7e8dd988ad5.png
[261822274118439.jpg]: /images/20220731/f255ceff0ad4423e8c8705a8a5aa0827.png
[261822343028143.jpg]: /images/20220731/331ee6403d3b45db9dbf262f03e0a278.png
[261822437862009.jpg]: /images/20220731/1bf618cafeb64e93a4b9130d815915af.png