06-用户任务（userTask）

版权声明：本文为博主原创文章，未经博主允许不得转载。 https://blog.csdn.net/huangjun0210/article/details/84937975

1. 个人任务

流程中的某个任务由指定的user来执行，流程图

1.1 分配个人任务方式一（直接指定办理人）

流程图中任务节点的配置

测试代码

ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
//部署流程定义，启动流程实例
    @Test
    public void testTask() throws Exception {

        // 1 发布流程
        InputStream inputStreamBpmn = this.getClass().getResourceAsStream("taskProcess.bpmn");
        InputStream inputStreamPng = this.getClass().getResourceAsStream("taskProcess.png");
        processEngine.getRepositoryService()//
                        .createDeployment()//
                        .addInputStream("userTask.bpmn", inputStreamBpmn)//
                        .addInputStream("userTask.png", inputStreamPng)//
                        .deploy();

        // 2 启动流程
        //启动流程实例的同时，设置流程变量
        ProcessInstance pi = processEngine.getRuntimeService()//
                            .startProcessInstanceByKey("taskProcess");
        System.out.println("pid:" + pi.getId());
    }

//查询我的个人任务列表
    @Test
    public void findMyTaskList(){
        String userId = "张三丰";
        List<Task> list = processEngine.getTaskService()//
                        .createTaskQuery()//
                        .taskAssignee(userId)//指定个人任务查询
                        .list();
        for(Task task:list ){
            System.out.println("id="+task.getId());
            System.out.println("name="+task.getName());
            System.out.println("assinee="+task.getAssignee());
            System.out.println("createTime="+task.getCreateTime());
            System.out.println("executionId="+task.getExecutionId());

        }
    }

//完成任务
    @Test
    public void completeTask(){
        String taskId = "3209";
        processEngine.getTaskService()//
                    .complete(taskId);//
        System.out.println("完成任务");
    }

说明：
1）张三丰是个人任务的办理人
2）但是这样分配任务的办理人不够灵活，因为项目开发中任务的办理人不要放置XML文件中。

1.2 分配个人任务方式二（使用流程变量）

流程图中任务节点的配置

测试代码

ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
//部署流程定义，启动流程实例
    @Test
    public void testTask() throws Exception {

        // 1 发布流程
        InputStream inputStreamBpmn = this.getClass().getResourceAsStream("taskProcess.bpmn");
        InputStream inputStreamPng = this.getClass().getResourceAsStream("taskProcess.png");
        processEngine.getRepositoryService()//
                        .createDeployment()//
                        .addInputStream("userTask.bpmn", inputStreamBpmn)//
                        .addInputStream("userTask.png", inputStreamPng)//
                        .deploy();

    // 2 启动流程
    //启动流程实例的同时，设置流程变量
        Map<String, Object> variables = new HashMap<String, Object>();
        variables.put("userID", "张翠三");
        ProcessInstance pi = processEngine.getRuntimeService()//
                            .startProcessInstanceByKey("taskProcess",variables);
        System.out.println("pid:" + pi.getId());
    }

    //查询我的个人任务列表
    @Test
    public void findMyTaskList(){
        String userId = "张翠三";
        List<Task> list = processEngine.getTaskService()//
                        .createTaskQuery()//
                        .taskAssignee(userId)//指定个人任务查询
                        .list();
        for(Task task:list ){
            System.out.println("id="+task.getId());
            System.out.println("name="+task.getName());
            System.out.println("assinee="+task.getAssignee());
            System.out.println("createTime="+task.getCreateTime());
            System.out.println("executionId="+task.getExecutionId());

        }
    }

    //完成任务
    @Test
    public void completeTask(){
        String taskId = "3209";
        processEngine.getTaskService()//
                    .complete(taskId);//
        System.out.println("完成任务");
    }

说明：
1）张翠山是个人任务的办理人
2）在开发中，可以在页面中指定下一个任务的办理人，通过流程变量设置下一个任务的办理人

1.3 分配个人任务方式三（使用类）

流程图中任务节点的配置


TaskListenerImpl类，用来设置任务的办理人

public class TaskListenerImpl implements TaskListener {

    /**指定个人任务和组任务的办理人*/
    @Override
    public void notify(DelegateTask delegateTask) {
        String assignee = "张无忌";
        //指定个人任务
        delegateTask.setAssignee(assignee);
    }

}

测试代码

ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
//部署流程定义，启动流程实例
    @Test
    public void testTask() throws Exception {

        // 1 发布流程
        InputStream inputStreamBpmn = this.getClass().getResourceAsStream("taskProcess.bpmn");
        InputStream inputStreamPng = this.getClass().getResourceAsStream("taskProcess.png");
        processEngine.getRepositoryService()//
                        .createDeployment()//
                        .addInputStream("userTask.bpmn", inputStreamBpmn)//
                        .addInputStream("userTask.png", inputStreamPng)//
                        .deploy();

        // 2 启动流程
        ProcessInstance pi = processEngine.getRuntimeService()//
                            .startProcessInstanceByKey("taskProcess");
        System.out.println("pid:" + pi.getId());
    }

    //查询我的个人任务列表
    @Test
    public void findMyTaskList(){
        String userId = "张无忌";
        List<Task> list = processEngine.getTaskService()//
                        .createTaskQuery()//
                        .taskAssignee(userId)//指定个人任务查询
                        .list();
        for(Task task:list ){
            System.out.println("id="+task.getId());
            System.out.println("name="+task.getName());
            System.out.println("assinee="+task.getAssignee());
            System.out.println("createTime="+task.getCreateTime());
            System.out.println("executionId="+task.getExecutionId());

        }
    }

    //完成任务
    @Test
    public void completeTask(){
        String taskId = "3408";
        processEngine.getTaskService()//
                    .complete(taskId);//
        System.out.println("完成任务");
    }

    //可以分配个人任务从一个人到另一个人（认领任务）
    @Test
    public void setAssigneeTask(){
        //任务ID
        String taskId = "3408";
        //指定认领的办理者
        String userId = "周芷若";
        processEngine.getTaskService()//
                    .setAssignee(taskId, userId);
    }

说明：
1）在类中使用delegateTask.setAssignee(assignee)的方式分配个人任务的办理人，此时张无忌是下一个任务的办理人；
2）通过processEngine.getTaskService().setAssignee(taskId, userId)将个人任务从一个人分配给另一个人，此时张无忌不再是下一个任务的办理人，而换成了周芷若；
3）在开发中，可以将每一个任务的办理人规定好，例如张三的领导是李四，李四的领导是王五，这样张三提交任务，就可以查询出张三的领导是李四，通过类的方式设置下一个任务的办理人。

1.4 个人任务总结

个人任务及三种分配方式：

• 1）在taskProcess.bpmn中直接写 assignee=“张三丰” ；
• 2）在taskProcess.bpmn中写assignee=“#{userID}”，变量的值要是String的。 使用流程变量指定办理人 ；
• 3）使用TaskListener接口，要使类实现该接口，在类中定义：delegateTask.setAssignee(assignee) 指定个人任务的办理人，使用任务ID和办理人重新指定办理人：
  processEngine.getTaskService().setAssignee(taskId, userId)。

2. 组任务

流程中的某个任务由指定的group来完成，其中group由多个user组成。

2.1 分配组任务方式一（直接指定办理人）

流程图中任务节点的配置

测试代码：略

说明：
1）小A，小B，小C，小D是组任务的办理人
2）但是这样分配组任务的办理人不够灵活，因为项目开发中任务的办理人不要放置XML文件中。
3）act_ru_identitylink表存放任务的办理人，包括个人任务和组任务，表示正在执行的任务
4）act_hi_identitylink表存放任务的办理人，包括个人任务和组任务，表示历史任务
区别在于：如果是个人任务TYPE的类型表示participant（参与者）
如果是组任务TYPE的类型表示candidate（候选者）和participant（参与者）

2.2 分配个人任务方式二（使用流程变量）

流程图中任务节点的配置

测试代码：略

2.3 分配个人任务方式三（使用类）

流程图中任务节点的配置


此时流程图的XML文件，如图：

TaskListenerImpl类，用来设置任务的办理人

public class TaskListenerImpl implements TaskListener {

    /**指定个人任务和组任务的办理人*/
    @Override
    public void notify(DelegateTask delegateTask) {
        String userId1 = "孙悟空";
        String userId2 = "猪八戒";
        //指定组任务
        delegateTask.addCandidateUser(userId1);
        delegateTask.addCandidateUser(userId2);
    }

}

测试代码：略
说明：
1）在类中使用delegateTask.addCandidateUser (userId);的方式分配组任务的办理人，此时孙悟空和猪八戒是下一个任务的办理人。
2）通过processEngine.getTaskService().claim (taskId, userId);将组任务分配给个人任务，也叫认领任务，即指定某个人去办理这个任务，此时由如来去办理任务。
注意：认领任务的时候，可以是组任务成员中的人，也可以不是组任务成员的人，此时通过Type的类型为participant来指定任务的办理人
3）addCandidateUser()即向组任务添加成员，deleteCandidateUser()即删除组任务的成员。
4）在开发中，可以将每一个任务的办理人规定好，例如张三的领导是李四和王五，这样张三提交任务，由李四或者王五去查询组任务，可以看到对应张三的申请，李四或王五再通过认领任务（claim）的方式，由某个人去完成这个任务。

24 组任务总结

组任务及三种分配方式：
1：在taskProcess.bpmn中直接写 candidate-users=“小A,小B,小C,小D"
2：在taskProcess.bpmn中写 candidate-users =“#{userIDs}”，变量的值要是String的。
使用流程变量指定办理人
Map<String, Object> variables = new HashMap<String, Object>();
variables.put(“userIDs”, “大大,小小,中中”);
3，使用TaskListener接口，使用类实现该接口，在类中定义：
//添加组任务的用户
delegateTask.addCandidateUser(userId1);
delegateTask.addCandidateUser(userId2);
组任务分配给个人任务（认领任务）：
processEngine.getTaskService().claim(taskId, userId);
个人任务分配给组任务：
processEngine.getTaskService(). setAssignee(taskId, null);
向组任务添加人员：
processEngine.getTaskService().addCandidateUser(taskId, userId);
向组任务删除人员：
processEngine.getTaskService().deleteCandidateUser(taskId, userId);
个人任务和组任务存放办理人对应的表：
act_ru_identitylink表存放任务的办理人，包括个人任务和组任务，表示正在执行的任务
act_hi_identitylink表存放任务的办理人，包括个人任务和组任务，表示历史任务
区别在于：如果是个人任务TYPE的类型表示participant（参与者）
如果是组任务TYPE的类型表示candidate（候选者）和participant（参与者）

3. 角色任务

流程图中任务节点的配置：

测试代码

ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();

    //部署流程定义，启动流程实例
    @Test
    public void testTask() throws Exception {
        // 1 发布流程
        InputStream inputStreamBpmn = this.getClass().getResourceAsStream("taskProcess.bpmn");
        InputStream inputStreamPng = this.getClass().getResourceAsStream("taskProcess.png");
        processEngine.getRepositoryService()//
                        .createDeployment()//
                        .addInputStream("userTask.bpmn", inputStreamBpmn)//
                        .addInputStream("userTask.png", inputStreamPng)//
                        .deploy();

        /**在部署流程定义和启动流程实例的中间，设置组任务的办理人，向Activity表中存放组和用户的信息*/
        IdentityService identityService = processEngine.getIdentityService();//认证：保存组和用户信息
        identityService.saveGroup(new GroupEntity("部门经理"));//建立组
        identityService.saveGroup(new GroupEntity("总经理"));//建立组
        identityService.saveUser(new UserEntity("小张"));
        identityService.saveUser(new UserEntity("小李"));
        identityService.saveUser(new UserEntity("小王"));
        identityService.createMembership("小张", "部门经理");//建立组和用户关系
        identityService.createMembership("小李", "部门经理");//建立组和用户关系
        identityService.createMembership("小王", "总经理");//建立组和用户关系


        // 2 启动流程
        ProcessInstance pi = processEngine.getRuntimeService()//
                            .startProcessInstanceByKey("taskProcess");
        System.out.println("pid:" + pi.getId());
    }

    //查询我的个人任务列表
    @Test
    public void findMyTaskList(){
        String userId = "唐僧";
        List<Task> list = processEngine.getTaskService()//
                        .createTaskQuery()//
                        .taskAssignee(userId)//指定个人任务查询
                        .list();
        for(Task task:list ){
            System.out.println("id="+task.getId());
            System.out.println("name="+task.getName());
            System.out.println("assinee="+task.getAssignee());
            System.out.println("assinee="+task.getCreateTime());
            System.out.println("executionId="+task.getExecutionId());

        }
    }

    //查询组任务列表
    @Test
    public void findGroupList(){
        String userId = "小李";//小张，小李可以查询结果，小王不可以，因为他不是部门经理
        List<Task> list = processEngine.getTaskService()//
                        .createTaskQuery()//
                        .taskCandidateUser(userId)//指定组任务查询
                        .list();
        for(Task task:list ){
            System.out.println("id="+task.getId());
            System.out.println("name="+task.getName());
            System.out.println("assinee="+task.getAssignee());
            System.out.println("assinee="+task.getCreateTime());
            System.out.println("executionId="+task.getExecutionId());
            System.out.println("##################################");

        }
    }

    //查询组任务成员列表
    @Test
    public void findGroupUser(){
        String taskId = "4408";
        List<IdentityLink> list = processEngine.getTaskService()//
                        .getIdentityLinksForTask(taskId);
        for(IdentityLink identityLink:list ){
            System.out.println("userId="+identityLink.getUserId());
            System.out.println("taskId="+identityLink.getTaskId());
            System.out.println("piId="+identityLink.getProcessInstanceId());
            System.out.println("######################");
        }
    }

    //完成任务
    @Test
    public void completeTask(){
        String taskId = "5108";
        processEngine.getTaskService()//
                    .complete(taskId);//
        System.out.println("完成任务");
    }
}