Activiti工作流分配组任务的三种方式

本实例的流程图如下图所示:

Activiti工作流分配组任务的三种方式_第1张图片

1.分配组任务方式一(直接指定办理人)

1.1 该方式为默认方式,流程启动方式和其他流程的启动方式一致

String processDefinitionKey = "receiveTask";                                                            //流程定义的key
		ProcessInstance pi = processEngine.getRuntimeService()                                                  //与正在执行的流程实例和执行对象相关的Service
				        .startProcessInstanceByKey(processDefinitionKey);

1.2 流程图中任务节点的配置如下:

Activiti工作流分配组任务的三种方式_第2张图片

1.3 说明

  1. 小A,小B,小C,小D是组任务的办理人
  2. 但是这样分配组任务的办理人不够灵活,因为项目开发中任务的办理人不要放置XML文件中。
  3. act_ru_identitylink表存放任务的办理人,包括个人任务和组任务,表示正在执行的任务
  4. 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 流程图中任务节点的配置

Activiti工作流分配组任务的三种方式_第3张图片

2.3 说明

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

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 流程图中任务节点的配置

Activiti工作流分配组任务的三种方式_第4张图片

Activiti工作流分配组任务的三种方式_第5张图片

3.3 说明

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

 

你可能感兴趣的:(Activiti工作流框架,Activiti工作流框架)