Activiti工作流分配组任务的三种方式 |
您所在的位置：网站首页 › participant和participate › Activiti工作流分配组任务的三种方式 |
Activiti工作流分配组任务的三种方式
|
本实例的流程图如下图所示:
1.1 该方式为默认方式,流程启动方式和其他流程的启动方式一致 String processDefinitionKey = "receiveTask"; //流程定义的key ProcessInstance pi = processEngine.getRuntimeService() //与正在执行的流程实例和执行对象相关的Service .startProcessInstanceByKey(processDefinitionKey);1.2 流程图中任务节点的配置如下: 1.3 说明 小A，小B，小C，小D是组任务的办理人但是这样分配组任务的办理人不够灵活，因为项目开发中任务的办理人不要放置XML文件中。act_ru_identitylink表存放任务的办理人，包括个人任务和组任务，表示正在执行的任务act_hi_identitylink表存放任务的办理人，包括个人任务和组任务，表示历史任务 区别在于：如果是个人任务TYPE的类型表示participant（参与者） 如果是组任务TYPE的类型表示candidate（候选者）和participant（参与者）2.分配个人任务方式二（使用流程变量） 2.1 该流程在启动流程实例时,通过HashMap设置流程变量,赋值给执行的流程实例 package com.ytdx.groupTask; import java.io.InputStream; import java.util.HashMap; import java.util.List; import java.util.Map; import org.activiti.engine.ProcessEngine; import org.activiti.engine.ProcessEngines; import org.activiti.engine.history.HistoricIdentityLink; import org.activiti.engine.repository.Deployment; import org.activiti.engine.runtime.ProcessInstance; import org.activiti.engine.task.IdentityLink; import org.activiti.engine.task.Task; import org.junit.Test; /** * 分配个人任务方式二（使用流程变量） * @author lhy * */ public class TaskTest { ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine(); /** * 部署流程定义（从inputStream） */ @Test public void deploymentProcess_inputStream(){ InputStream inputStreamBpmn = this.getClass().getClassLoader().getResourceAsStream("GroupTask.bpmn"); InputStream inputStreamPng = this.getClass().getClassLoader().getResourceAsStream("GroupTask.png"); Deployment deployment = processEngine.getRepositoryService() //与流程定义和部署对象相关的Service .createDeployment() //创建一个部署对象 .name("组任务一") //添加部署的名称 .addInputStream("GroupTask.bpmn", inputStreamBpmn) .addInputStream("GroupTask.png", inputStreamPng) .deploy(); //完成部署 System.out.println("部署ID："+deployment.getId()); System.out.println("部署名称："+deployment.getName()); } /** * 启动流程实例 */ @Test public void startProcessInstance(){ String processDefinitionKey = "GroupTask"; //流程定义的key /**启动流程实例的同时，设置流程变量，使用流程变量用来指定任务的办理人，对应GroupTask.bpmn文件中#{userIDs}*/ Map variables = new HashMap(); variables.put("userIDs", "大大,中中,小小"); ProcessInstance pi = processEngine.getRuntimeService() //与正在执行的流程实例和执行对象相关的Service .startProcessInstanceByKey(processDefinitionKey,variables); //使用流程定义的key启动流程实例，key对应task.bpmn文件中id的属性值，使用key值启动，默认是按照最新版本的流程定义启动 System.out.println("流程实例ID:"+pi.getId()); System.out.println("流程定义ID:"+pi.getProcessDefinitionId()); } /** * 查询当前人的个人任务 */ @Test public void findPersonalTask(){ String assignee = "海哥"; List 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 findGroupTask(){ String candidateUser = "小小"; List 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 completePersonalTask(){ String taskId = "4905"; processEngine.getTaskService() //与正在执行的任务管理相关的Service .complete(taskId); System.out.println("完成任务：任务ID："+taskId); } /** * 查询正在执行的任务办理人表 */ @Test public void findRunPersonTask(){ String taskId = "5205"; List 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(){ String processInstanceId = "101"; //PROC_INST_ID_ 字段 List 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(){ String taskId = "2203"; //任务ID String userId = "大大"; //分配的个人任务（可以是组任务中的成员，也可以是非组任务的成员）,给字段ASSIGNEE_赋值 processEngine.getTaskService() .claim(taskId, userId); } /** * 将个人任务回退到组任务，前提，之前一定是个组任务 */ @Test public void setAssigee(){ String taskId = "2203"; processEngine.getTaskService() .setAssignee(taskId, null); } /** * 向组任务中添加成员(act_hi_identitylink表中查) */ @Test public void addGroupUser(){ String taskId = "2203"; String userId = "小Y"; //成员办理人 processEngine.getTaskService() .addCandidateUser(taskId, userId); } /** * 从组任务中删除成员 */ @Test public void deleteGroupUser(){ String taskId = "2203"; String userId = "小Y"; //成员办理人 processEngine.getTaskService() .deleteCandidateUser(taskId, userId); } }2.2 流程图中任务节点的配置 2.3 说明 大大，中中，小小是组任务的办理人在开发中，可以在页面中指定下一个组任务的办理人，通过流程变量设置下一个任务的办理人 3.分配个人任务方式三（使用类）3.1 该流程实例在启动时,通过调用监听的TaskListenerImpl类,分配组任务的办理人 package com.ytdx.groupTask; import org.activiti.engine.delegate.DelegateTask; import org.activiti.engine.delegate.TaskListener; @SuppressWarnings("serial") public class TaskListenerImpl implements TaskListener { /** * 用来指定任务的办理人 */ @Override public void notify(DelegateTask delegateTask) { //指定个人任务的办理人，也可以指定组任务的办理人 //个人任务：通过类去查询数据库，将下一个任务的办理人查询获取，然后通过setAssignee()的方法指定任务的办理人 //delegateTask.setAssignee("海哥"); //组任务： delegateTask.addCandidateUser("郭靖"); delegateTask.addCandidateUser("黄蓉"); } } package com.ytdx.groupTask; import java.io.InputStream; import java.util.List; import org.activiti.engine.ProcessEngine; import org.activiti.engine.ProcessEngines; import org.activiti.engine.history.HistoricIdentityLink; import org.activiti.engine.repository.Deployment; import org.activiti.engine.runtime.ProcessInstance; import org.activiti.engine.task.IdentityLink; import org.activiti.engine.task.Task; import org.junit.Test; /** * 分配个人任务方式二（使用类） * @author lhy * */ public class GroupTaskTest { ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine(); /** * 部署流程定义（从inputStream） */ @Test public void deploymentProcess_inputStream(){ InputStream inputStreamBpmn = this.getClass().getClassLoader().getResourceAsStream("GroupTasks.bpmn"); InputStream inputStreamPng = this.getClass().getClassLoader().getResourceAsStream("GroupTasks.png"); Deployment deployment = processEngine.getRepositoryService() //与流程定义和部署对象相关的Service .createDeployment() //创建一个部署对象 .name("组任务二") //添加部署的名称 .addInputStream("GroupTasks.bpmn", inputStreamBpmn) .addInputStream("GroupTasks.png", inputStreamPng) .deploy(); //完成部署 System.out.println("部署ID："+deployment.getId()); System.out.println("部署名称："+deployment.getName()); } /** * 启动流程实例 */ @Test public void startProcessInstance(){ String processDefinitionKey = "GroupTasks"; //流程定义的key ProcessInstance pi = processEngine.getRuntimeService() //与正在执行的流程实例和执行对象相关的Service .startProcessInstanceByKey(processDefinitionKey); //使用流程定义的key启动流程实例，key对应task.bpmn文件中id的属性值，使用key值启动，默认是按照最新版本的流程定义启动 System.out.println("流程实例ID:"+pi.getId()); System.out.println("流程定义ID:"+pi.getProcessDefinitionId()); } /** * 查询当前人的个人任务 */ @Test public void findPersonalTask(){ String assignee = "郭靖"; List 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 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 completePersonalTask(){ String taskId = "6404"; processEngine.getTaskService() //与正在执行的任务管理相关的Service .complete(taskId); System.out.println("完成任务：任务ID："+taskId); } /** * 查询正在执行的任务办理人表 */ @Test public void findRunPersonTask() { String taskId = "6704"; List 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(){ String processInstanceId = "6704"; List 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(){ String taskId = "6704"; //分配的个人任务（可以是组任务中的成员，也可以是非组任务的成员） String userId = "郭靖"; processEngine.getTaskService() .claim(taskId, userId); } /** * 将个人任务回退到组任务，前提，之前一定是个组任务 */ @Test public void setAssigee(){ String taskId = "6704"; processEngine.getTaskService() .setAssignee(taskId, null); } /** * 向组任务中添加成员(在表act_ru_identitylink中添加) */ @Test public void addGroupUser(){ //任务ID String taskId = "6704"; String userId = "大H"; processEngine.getTaskService() .addCandidateUser(taskId, userId); } /** * 从组任务中删除成员 */ @Test public void deleteGroupUser(){ String taskId = "6704"; String userId = "大H"; processEngine.getTaskService() .deleteCandidateUser(taskId, userId); } }3.2 流程图中任务节点的配置 3.3 说明 在类中使用delegateTask.addCandidateUser (userId);的方式分配组任务的办理人，此时孙悟空和猪八戒是下一个任务的办理人。通过processEngine.getTaskService().claim (taskId, userId);将组任务分配给个人任务，也叫认领任务，即指定某个人去办理这个任务，此时由如来去办理任务。addCandidateUser()即向组任务添加成员，deleteCandidateUser()即删除组任务的成员。在开发中，可以将每一个任务的办理人规定好，例如张三的领导是李四和王五，这样张三提交任务，由李四或者王五去查询组任务，可以看到对应张三的申请，李四或王五再通过认领任务（claim）的方式，由某个人去完成这个任务。注意：认领任务的时候，可以是组任务成员中的人，也可以不是组任务成员的人，此时通过Type的类型为participant来指定任务的办理人 4.总结 组任务及三种分配方式： 1：在taskProcess.bpmn中直接写 candidate-users=“小A,小B,小C,小D" 2：在taskProcess.bpmn中写 candidate-users =“#{userIDs}”，变量的值要是String的。 使用流程变量指定办理人 Map variables = new HashMap(); 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（参与者）
|
【本文地址】