activiti6.0(二)节点处理人

1. 候选人和处理人

候选人：candidateUser 处理人，指派人：assignee

一个task可以有多个候选人，但是只能有一个处理人

activiti6.0的数据库表结构中，identityLink表保存用户和task之间一对多的候选关系。处理人assignee直接是task表中的一个字段

通常情况下，系统根据流程的定义，自动为一个task指定候选人。比如有一个taskA，分配了A，B, C三个候选人，一开始A, B, C都可以在“我的待办”中看到taskA这个任务，如果A认领了taskA，后台会将taskA的处理人设置为A，然后B，C在“我的待办”中就没有taskA这个任务了，A在没处理taskA前，A仍然可以在“我的待办”中看到taskA

2. 一个节点对应一个task

节点和task并不是同一个概念，节点是流程图中的一个节点，当会签的时候，一个节点有多个task。一个task有多个候选人，但是最终只会有一个处理人。

节点候选人可以用下面的方法设置：

先在定义一个spring组件，组件的作用是定义task的候选人，其实就是获取一个项目的项目经理，一个部门的部门经理，代码如下:

@Component
public class UserService {//获取项目经理节点的候选人public List<String> getProjectManger(String projectId){List<String> result = new ArrayList<>();if(projectId.equals("projectA")){result = Arrays.asList(new String[]{"projectA_项目经理1", "projectA_项目经理2"});}else{result = Arrays.asList(new String[]{"projectB_项目经理1", "projectB_项目经理2"});}return result;}//获取部门经理节点的候选人public List<String> getDepartmentMnager(String departmentId){List<String> result = new ArrayList<>();if(departmentId.equals("departmentA")){result = Arrays.asList(new String[]{"departmentA_部门经理1", "departmentA_部门经理2", "departmentA_部门经理3"});}else{result = Arrays.asList(new String[]{"departmentB_部门经理1", "departmentB_部门经理2"});}return result;}
}

设计这样一个简单的流程

选中第一个节点，点击下方的 Assignments，设置 Candidate users

测试代码：

public void testEntrance3(){//构造流程变量Map<String, Object> processInstanceVars = new HashMap<String, Object>();processInstanceVars.put("projectId", "projectA");processInstanceVars.put("departmentId", "departmentA");//启动流程ProcessInstance processInstance = runtimeService.startProcessInstanceByKey("testProcess_20190119_1", processInstanceVars);//获取任务Task taskForProjectManager = taskService.createTaskQuery().processInstanceId(processInstance.getProcessInstanceId()).singleResult();//查询这个taskForProjectManager这个任务的候选处理人List<IdentityLink> projectManagerCandidateUsers = taskService.getIdentityLinksForTask(taskForProjectManager.getId());//查询待办queryNeedDealTask(projectManagerCandidateUsers);//分配处理人给  projectA_项目经理1taskForProjectManager.setAssignee("projectA_项目经理1");taskService.saveTask(taskForProjectManager);System.out.println("#############再次查询待办");//再次查询待办queryNeedDealTask(projectManagerCandidateUsers);//将任务完成taskService.complete(taskForProjectManager.getId());System.out.println("################完成后再查询待办");//再次查询待办queryNeedDealTask(projectManagerCandidateUsers);}//抽取查询待办的方法public void queryNeedDealTask(List<IdentityLink> identityLinks){for(IdentityLink identityLink : identityLinks){System.out.println("部门经理审批的候选人: " + identityLink.getUserId());//查出当前用户的待办List<Task> currentUserNeedDealTasks = taskService.createTaskQuery().taskCandidateOrAssigned(identityLink.getUserId()).list();for(Task task : currentUserNeedDealTasks){System.out.println("待办: " + task.getName() + " 流程id: " + task.getProcessInstanceId());}}}

运行结果:

部门经理审批的候选人: projectA_项目经理1
待办: 项目经理审批流程id: 11
部门经理审批的候选人: projectA_项目经理2
待办: 项目经理审批流程id: 11
#############再次查询待办
部门经理审批的候选人: projectA_项目经理1
待办: 项目经理审批流程id: 11
部门经理审批的候选人: projectA_项目经理2
################完成后再查询待办
部门经理审批的候选人: projectA_项目经理1
部门经理审批的候选人: projectA_项目经理2

先定义查询一个项目的项目经理的方法，然后定义流程的时候将处理人定义为 ${userService.getProjectManger(projectId)}

方法的变量projectId在启动流程的时候通过流程变量传值。测试方法中也证实了1中关于候选人和处理人的描述

3. 会签

会签指的是一个节点有多个任务，会签通常用于一个节点需要进行投票，根据投票的结果来决定接下来的业务流程场景。activiti6.0是支持会签的，并且支持串行和并行。

3.1串行会签

选中部门经理审批这个节点，做如下设置，其中collection为 ${userService.getDepartmentMnager(departmentId)}，Muti-instance Type的下拉框有 Sequential（串行）, Parallel（并行）, None三个选项，这里选择Sequential表示串行

其中Assignments点击后，在弹出的模态框中选择Fixed values, Assignee中填写 ${manager}

代码如下：

public void testEntrance4(){//构造流程变量Map<String, Object> processInstanceVars = new HashMap<String, Object>();processInstanceVars.put("projectId", "projectA");processInstanceVars.put("departmentId", "departmentA");//启动流程ProcessInstance processInstance = runtimeService.startProcessInstanceByKey("testProcess_20190119_1", processInstanceVars);//查询第一个任务，并完成Task taskForProjectManager =  taskService.createTaskQuery().processInstanceId(processInstance.getProcessInstanceId()).singleResult();taskService.complete(taskForProjectManager.getId());//遍历所有task，完成第二个节点while(true){Task taskForDepartmentManger =  taskService.createTaskQuery().processInstanceId(processInstance.getProcessInstanceId()).singleResult();if(taskForDepartmentManger == null){break;}taskService.complete(taskForDepartmentManger.getId());System.out.println("任务id: " + taskForDepartmentManger.getId() + " 处理人: " +taskForDepartmentManger.getAssignee());}}

输出结果:

任务id: 5019 处理人: departmentA_部门经理1
任务id: 5022 处理人: departmentA_部门经理2
任务id: 5025 处理人: departmentA_部门经理3

可以看到部门经理审批这个节点有三个任务。

3.2并行会签

在3.1的基础上，将Muti-instance Type改成Parallel即可。

运行代码

public void testEntrance4(){//构造流程变量Map<String, Object> processInstanceVars = new HashMap<String, Object>();processInstanceVars.put("projectId", "projectA");processInstanceVars.put("departmentId", "departmentA");//启动流程ProcessInstance processInstance = runtimeService.startProcessInstanceByKey("testProcess_20190119_1", processInstanceVars);//查询第一个任务，并完成Task taskForProjectManager =  taskService.createTaskQuery().processInstanceId(processInstance.getProcessInstanceId()).singleResult();taskService.complete(taskForProjectManager.getId());//由于是并行的，这里可能会返回多个任务List<Task> taskForDepartmentMangers =  taskService.createTaskQuery().processInstanceId(processInstance.getProcessInstanceId()).list();for(Task taskForDepartmentManger : taskForDepartmentMangers){taskService.complete(taskForDepartmentManger.getId());System.out.println("任务id: " + taskForDepartmentManger.getId() + " 处理人: " +taskForDepartmentManger.getAssignee());}}

串行的时候，部门经理_1完成任务后才会生成生成部门经理_2的任务，所以查询任务的时候用singleResult，并行的时候会直接生成所有的任务，所以需要改成list

运行结果和3.1完全一样

3.3 设置节点结束条件

Completion Condition(Multi-instance)节点完成条件（多任务情况下）。在3.2的基础上设置 Completion Condition为${approvedCount>=2}，approvedCount表示审批通过的个数，意思是审批通过的数量大于等于2这个节点就算完成了，即使还有其它人没有审批也直接跳过。

代码如下：

public void testEntrance4(){//构造流程变量Map<String, Object> processInstanceVars = new HashMap<String, Object>();processInstanceVars.put("projectId", "projectA");processInstanceVars.put("departmentId", "departmentA");processInstanceVars.put("approvedCount", 0);//启动流程ProcessInstance processInstance = runtimeService.startProcessInstanceByKey("testProcess_20190119_1", processInstanceVars);//查询第一个任务，并完成Task taskForProjectManager =  taskService.createTaskQuery().processInstanceId(processInstance.getProcessInstanceId()).singleResult();taskService.complete(taskForProjectManager.getId());//由于是并行的，这里可能会返回多个任务List<Task> taskForDepartmentMangers =  taskService.createTaskQuery().processInstanceId(processInstance.getProcessInstanceId()).list();for(Task taskForDepartmentManger : taskForDepartmentMangers){try{//获取approvedCount的流程变量Integer value=(Integer)taskService.getVariable(taskForDepartmentManger.getId(), "approvedCount");taskService.setVariable(taskForDepartmentManger.getId(), "approvedCount", ++value);taskService.complete(taskForDepartmentManger.getId());System.out.println("任务id: " + taskForDepartmentManger.getId() + " 处理人: " +taskForDepartmentManger.getAssignee());}catch(ActivitiObjectNotFoundException exception){System.out.println("任务id: " + taskForDepartmentManger.getId() + " 处理人: " +taskForDepartmentManger.getAssignee() + " 这个任务不存在");}}}

在循环中修改流程变量approvedCount的值，当approvedCount大于等于2的时候，剩下的task就会被销毁了，由于代码中直接查出了三个节点，第三次循环的时候，最后一个task已经销毁了，所以会抛出异常。