Activiti 学习笔记13：分配组任务

来源：互联网发布：php 读取文件夹图片编辑：程序博客网时间：2024/05/16 12:14

一、流程图

这里写图片描述

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

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 启动流程        ProcessInstance pi = processEngine.getRuntimeService()//                            .startProcessInstanceByKey("taskProcess");        System.out.println("pid:" + pi.getId());    }    //3 查询我的个人任务列表    @Test    public void findMyTaskList(){        String userId = "小A";        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());        }    }    //4 查询组任务列表    @Test    public void findGroupList(){        String userId = "小A";        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("createTime ="+task.getCreateTime());            System.out.println("executionId="+task.getExecutionId());            System.out.println("##################################");        }    }    //5 查询组任务成员列表    @Test    public void findGroupUser(){        String taskId = "3709";        List<IdentityLink> list = processEngine.getTaskService()//                        .getIdentityLinksForTask(taskId);         //List<IdentityLink> list = processEngine.getRuntimeService()//        //              .getIdentityLinksForProcessInstance(instanceId);        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("######################");        }    }    //6 查询组任务成员历史列表    @Test    public void findGroupHisUser(){        String taskId = "3709";        List<HistoricIdentityLink> list = processEngine.getHistoryService()//                        .getHistoricIdentityLinksForTask(taskId);        // List<HistoricIdentityLink> list = processEngine.getHistoryService()//          // .getHistoricIdentityLinksForProcessInstance(processInstanceId);        for(HistoricIdentityLink 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 = "3709";        processEngine.getTaskService()//                    .complete(taskId);//        System.out.println("完成任务");    }     /**将组任务分配给个人任务，拾取任务*/    //由1个人去完成任务    @Test    public void claim(){        //任务ID        String taskId = "5908";        //分配的办理人        String userId = "小B";        processEngine.getTaskService()//                    .claim(taskId, userId);    }

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

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

1：流程图中任务节点的配置
这里写图片描述
2、测试代码

ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();    /**部署流程定义（从inputStream）*/    @Test    public void deploymentProcessDefinition_inputStream(){        InputStream inputStreamBpmn = this.getClass().getResourceAsStream("task.bpmn");        InputStream inputStreamPng = this.getClass().getResourceAsStream("task.png");        Deployment deployment = processEngine.getRepositoryService()//与流程定义和部署对象相关的Service                        .createDeployment()//创建一个部署对象                        .name("任务")//添加部署的名称                        .addInputStream("task.bpmn", inputStreamBpmn)//                        .addInputStream("task.png", inputStreamPng)//                        .deploy();//完成部署        System.out.println("部署ID："+deployment.getId());//        System.out.println("部署名称："+deployment.getName());//    }    /**启动流程实例*/    @Test    public void startProcessInstance(){        //流程定义的key        String processDefinitionKey = "task";        /**启动流程实例的同时，设置流程变量，使用流程变量用来指定任务的办理人，对应task.pbmn文件中#{userIDs}*/        Map<String, Object> variables = new HashMap<String, Object>();        variables.put("userIDs", "大大,中中,小小");        ProcessInstance pi = processEngine.getRuntimeService()//与正在执行的流程实例和执行对象相关的Service                        .startProcessInstanceByKey(processDefinitionKey,variables);//使用流程定义的key启动流程实例，key对应helloworld.bpmn文件中id的属性值，使用key值启动，默认是按照最新版本的流程定义启动        System.out.println("流程实例ID:"+pi.getId());//流程实例ID          System.out.println("流程定义ID:"+pi.getProcessDefinitionId());//流程定义ID       }    /**查询当前人的个人任务*/    @Test    public void findMyPersonalTask(){        String assignee = "小A";        List<Task> list = processEngine.getTaskService()//与正在执行的任务管理相关的Service                        .createTaskQuery()//创建任务查询对象                        /**查询条件（where部分）*/                        .taskAssignee(assignee)//指定个人任务查询，指定办理人//                      .taskCandidateUser(candidateUser)//组任务的办理人查询                        /**排序*/                        .orderByTaskCreateTime().asc()//使用创建时间的升序排列                        /**返回结果集*/                        .list();//返回列表        if(list!=null && list.size()>0){            for(Task task:list){                System.out.println("任务ID:"+task.getId());                System.out.println("任务名称:"+task.getName());                System.out.println("任务的创建时间:"+task.getCreateTime());                System.out.println("任务的办理人:"+task.getAssignee());                System.out.println("流程实例ID："+task.getProcessInstanceId());                System.out.println("执行对象ID:"+task.getExecutionId());                System.out.println("流程定义ID:"+task.getProcessDefinitionId());                System.out.println("########################################################");            }        }    }    /**查询当前人的组任务*/    @Test    public void findMyGroupTask(){        String candidateUser = "大大";        List<Task> list = processEngine.getTaskService()//与正在执行的任务管理相关的Service                        .createTaskQuery()//创建任务查询对象                        /**查询条件（where部分）*/                        .taskCandidateUser(candidateUser)//组任务的办理人查询                        /**排序*/                        .orderByTaskCreateTime().asc()//使用创建时间的升序排列                        /**返回结果集*/                        .list();//返回列表        if(list!=null && list.size()>0){            for(Task task:list){                System.out.println("任务ID:"+task.getId());                System.out.println("任务名称:"+task.getName());                System.out.println("任务的创建时间:"+task.getCreateTime());                System.out.println("任务的办理人:"+task.getAssignee());                System.out.println("流程实例ID："+task.getProcessInstanceId());                System.out.println("执行对象ID:"+task.getExecutionId());                System.out.println("流程定义ID:"+task.getProcessDefinitionId());                System.out.println("########################################################");            }        }    }    /**完成我的任务*/    @Test    public void completeMyPersonalTask(){        //任务ID        String taskId = "6905";        processEngine.getTaskService()//与正在执行的任务管理相关的Service                    .complete(taskId);        System.out.println("完成任务：任务ID："+taskId);    }    /**查询正在执行的任务办理人表*/    @Test    public void findRunPersonTask(){        //任务ID        String taskId = "6204";        List<IdentityLink> list = processEngine.getTaskService()//                    .getIdentityLinksForTask(taskId);        if(list!=null && list.size()>0){            for(IdentityLink identityLink:list){                System.out.println(identityLink.getTaskId()+"   "+identityLink.getType()+"   "+identityLink.getProcessInstanceId()+"   "+identityLink.getUserId());            }        }    }    /**查询历史任务的办理人表*/    @Test    public void findHistoryPersonTask(){        //流程实例ID        String processInstanceId = "6201";        List<HistoricIdentityLink> list = processEngine.getHistoryService()//                        .getHistoricIdentityLinksForProcessInstance(processInstanceId);        if(list!=null && list.size()>0){            for(HistoricIdentityLink identityLink:list){                System.out.println(identityLink.getTaskId()+"   "+identityLink.getType()+"   "+identityLink.getProcessInstanceId()+"   "+identityLink.getUserId());            }        }    }    /**拾取任务，将组任务分给个人任务，指定任务的办理人字段*/    @Test    public void claim(){        //将组任务分配给个人任务        //任务ID        String taskId = "6905";        //分配的个人任务（可以是组任务中的成员，也可以是非组任务的成员）        String userId = "大大";        processEngine.getTaskService()//                    .claim(taskId, userId);    }    /**将个人任务回退到组任务，前提，之前一定是个组任务*/    @Test    public void setAssigee(){        //任务ID        String taskId = "6204";        processEngine.getTaskService()//                    .setAssignee(taskId, null);    }    /**向组任务中添加成员*/    @Test    public void addGroupUser(){        //任务ID        String taskId = "6204";        //成员办理人        String userId = "大H";        processEngine.getTaskService()//                    .addCandidateUser(taskId, userId);    }    /**从组任务中删除成员*/    @Test    public void deleteGroupUser(){        //任务ID        String taskId = "6204";        //成员办理人        String userId = "小B";        processEngine.getTaskService()//                    .deleteCandidateUser(taskId, userId);    }

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

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

1：流程图中任务节点的配置
这里写图片描述

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

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

@SuppressWarnings("serial")public class TaskListenerImpl implements TaskListener {    /**用来指定任务的办理人*/    @Override    public void notify(DelegateTask delegateTask) {        //指定个人任务的办理人，也可以指定组任务的办理人        //个人任务：通过类去查询数据库，将下一个任务的办理人查询获取，然后通过setAssignee()的方法指定任务的办理人        //delegateTask.setAssignee("灭绝师太");        //组任务：        delegateTask.addCandidateUser("郭靖");        delegateTask.addCandidateUser("黄蓉");    }}

3：测试代码

ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();    /**部署流程定义（从inputStream）*/    @Test    public void deploymentProcessDefinition_inputStream(){        InputStream inputStreamBpmn = this.getClass().getResourceAsStream("task.bpmn");        InputStream inputStreamPng = this.getClass().getResourceAsStream("task.png");        Deployment deployment = processEngine.getRepositoryService()//与流程定义和部署对象相关的Service                        .createDeployment()//创建一个部署对象                        .name("任务")//添加部署的名称                        .addInputStream("task.bpmn", inputStreamBpmn)//                        .addInputStream("task.png", inputStreamPng)//                        .deploy();//完成部署        System.out.println("部署ID："+deployment.getId());//        System.out.println("部署名称："+deployment.getName());//    }    /**启动流程实例*/    @Test    public void startProcessInstance(){        //流程定义的key        String processDefinitionKey = "task";        ProcessInstance pi = processEngine.getRuntimeService()//与正在执行的流程实例和执行对象相关的Service                        .startProcessInstanceByKey(processDefinitionKey);//使用流程定义的key启动流程实例，key对应helloworld.bpmn文件中id的属性值，使用key值启动，默认是按照最新版本的流程定义启动        System.out.println("流程实例ID:"+pi.getId());//流程实例ID          System.out.println("流程定义ID:"+pi.getProcessDefinitionId());//流程定义ID       }    /**查询当前人的个人任务*/    @Test    public void findMyPersonalTask(){        String assignee = "郭靖";        List<Task> list = processEngine.getTaskService()//与正在执行的任务管理相关的Service                        .createTaskQuery()//创建任务查询对象                        /**查询条件（where部分）*/                        .taskAssignee(assignee)//指定个人任务查询，指定办理人//                      .taskCandidateUser(candidateUser)//组任务的办理人查询                        /**排序*/                        .orderByTaskCreateTime().asc()//使用创建时间的升序排列                        /**返回结果集*/                        .list();//返回列表        if(list!=null && list.size()>0){            for(Task task:list){                System.out.println("任务ID:"+task.getId());                System.out.println("任务名称:"+task.getName());                System.out.println("任务的创建时间:"+task.getCreateTime());                System.out.println("任务的办理人:"+task.getAssignee());                System.out.println("流程实例ID："+task.getProcessInstanceId());                System.out.println("执行对象ID:"+task.getExecutionId());                System.out.println("流程定义ID:"+task.getProcessDefinitionId());                System.out.println("########################################################");            }        }    }    /**查询当前人的组任务*/    @Test    public void findMyGroupTask(){        String candidateUser = "郭靖";        List<Task> list = processEngine.getTaskService()//与正在执行的任务管理相关的Service                        .createTaskQuery()//创建任务查询对象                        /**查询条件（where部分）*/                        .taskCandidateUser(candidateUser)//组任务的办理人查询                        /**排序*/                        .orderByTaskCreateTime().asc()//使用创建时间的升序排列                        /**返回结果集*/                        .list();//返回列表        if(list!=null && list.size()>0){            for(Task task:list){                System.out.println("任务ID:"+task.getId());                System.out.println("任务名称:"+task.getName());                System.out.println("任务的创建时间:"+task.getCreateTime());                System.out.println("任务的办理人:"+task.getAssignee());                System.out.println("流程实例ID："+task.getProcessInstanceId());                System.out.println("执行对象ID:"+task.getExecutionId());                System.out.println("流程定义ID:"+task.getProcessDefinitionId());                System.out.println("########################################################");            }        }    }    /**完成我的任务*/    @Test    public void completeMyPersonalTask(){        //任务ID        String taskId = "7204";        processEngine.getTaskService()//与正在执行的任务管理相关的Service                    .complete(taskId);        System.out.println("完成任务：任务ID："+taskId);    }    /**查询正在执行的任务办理人表*/    @Test    public void findRunPersonTask(){        //任务ID        String taskId = "6204";        List<IdentityLink> list = processEngine.getTaskService()//                    .getIdentityLinksForTask(taskId);        if(list!=null && list.size()>0){            for(IdentityLink identityLink:list){                System.out.println(identityLink.getTaskId()+"   "+identityLink.getType()+"   "+identityLink.getProcessInstanceId()+"   "+identityLink.getUserId());            }        }    }    /**查询历史任务的办理人表*/    @Test    public void findHistoryPersonTask(){        //流程实例ID        String processInstanceId = "6201";        List<HistoricIdentityLink> list = processEngine.getHistoryService()//                        .getHistoricIdentityLinksForProcessInstance(processInstanceId);        if(list!=null && list.size()>0){            for(HistoricIdentityLink identityLink:list){                System.out.println(identityLink.getTaskId()+"   "+identityLink.getType()+"   "+identityLink.getProcessInstanceId()+"   "+identityLink.getUserId());            }        }    }    /**拾取任务，将组任务分给个人任务，指定任务的办理人字段*/    @Test    public void claim(){        //将组任务分配给个人任务        //任务ID        String taskId = "7204";        //分配的个人任务（可以是组任务中的成员，也可以是非组任务的成员）        String userId = "郭靖";        processEngine.getTaskService()//                    .claim(taskId, userId);    }    /**将个人任务回退到组任务，前提，之前一定是个组任务*/    @Test    public void setAssigee(){        //任务ID        String taskId = "6204";        processEngine.getTaskService()//                    .setAssignee(taskId, null);    }    /**向组任务中添加成员*/    @Test    public void addGroupUser(){        //任务ID        String taskId = "6204";        //成员办理人        String userId = "大H";        processEngine.getTaskService()//                    .addCandidateUser(taskId, userId);    }    /**从组任务中删除成员*/    @Test    public void deleteGroupUser(){        //任务ID        String taskId = "6204";        //成员办理人        String userId = "小B";        processEngine.getTaskService()//                    .deleteCandidateUser(taskId, userId);    }

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

五、总结

组任务及三种分配方式：
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（参与者）

演示代码下载：http://download.csdn.net/detail/xunzaosiyecao/9629901

本文部分内容整理自itcast讲义，在此表示感谢。
作者：jiankunking 出处：http://blog.csdn.net/jiankunking

0 0