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 getProjectManger(String projectId){
        List 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 getDepartmentMnager(String departmentId){
        List 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 processInstanceVars = new HashMap();
        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 projectManagerCandidateUsers = taskService.
                getIdentityLinksForTask(taskForProjectManager.getId());
        //查询待办
        queryNeedDealTask(projectManagerCandidateUsers);
        //分配处理人给  projectA_项目经理1
        taskForProjectManager.setAssignee("projectA_项目经理1");
        taskService.saveTask(taskForProjectManager);
        System.out.println("#############再次查询待办");
        //再次查询待办
        queryNeedDealTask(projectManagerCandidateUsers);
        //将任务完成
        taskService.complete(taskForProjectManager.getId());
        System.out.println("################完成后再查询待办");
        //再次查询待办
        queryNeedDealTask(projectManagerCandidateUsers);
    }

    //抽取查询待办的方法
    public void queryNeedDealTask(List identityLinks){
        for(IdentityLink identityLink : identityLinks){
            System.out.println("部门经理审批的候选人: " + identityLink.getUserId());
            //查出当前用户的待办
            List 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 processInstanceVars = new HashMap();
        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 processInstanceVars = new HashMap();
        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 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 processInstanceVars = new HashMap();
        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 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已经销毁了，所以会抛出异常。