您当前的位置: 首页 > 

36activiti - 用户任务(组任务)

杨林伟 发布时间:2019-07-31 17:12:27 ,浏览量:3

1.流程图

在这里插入图片描述

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

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 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 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 list = processEngine.getTaskService()//
		                .getIdentityLinksForTask(taskId);
         //List 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 list = processEngine.getHistoryService()//
						.getHistoricIdentityLinksForTask(taskId);
        // List 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);
	}
/**将个人任务回退到组任务(前提:之前组任务)*/
	@Test
	public void assignee(){
		//任务ID
		String taskId = "5508";
		processEngine.getTaskService()//
					.setAssignee(taskId, null);
	}
	
/**向组任务中添加成员*/
	@Test
	public void addCadidateUser(){
		//任务ID
		String taskId = "5508";
		//添加的成员
		String userId = "小E";
		processEngine.getTaskService()//
					.addCandidateUser(taskId, userId);
	}
	
/**从组任务中删除成员*/
	@Test
	public void deleteCadidateUser(){
		//任务ID
		String taskId = "5508";
		//添加的成员
		String userId = "小D";
		processEngine.getTaskService()//
					.deleteCandidateUser(taskId, userId);
	}

分析:

  1. 小A,小B,小C,小D是组任务的办理人
  2. 但是这样分配组任务的办理人不够灵活,因为项目开发中任务的办理人不要放置XML文件中。
  3. act_ru_identitylink表存放任务的办理人,包括个人任务和组任务,表示正在执行的任务
  4. act_hi_identitylink表存放任务的办理人,包括个人任务和组任务,表示历史任务区别在于: 如果是个人任务TYPE的类型表示participant(参与者) 如果是组任务TYPE的类型表示candidate(候选者)和participant(参与者) 在这里插入图片描述
3.分配个人任务方式二(使用流程变量)

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 variables = new HashMap();
		variables.put("userIDs", "大大,小小,中中");
		ProcessInstance pi = processEngine.getRuntimeService()//
						.startProcessInstanceByKey("taskProcess",variables);
		System.out.println("pid:" + pi.getId());
	}
	
	//查询我的个人任务列表
	@Test
	public void findMyTaskList(){
		String userId = "大大";
		List 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 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 = "3709";
		List 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 findGroupHisUser(){
		String taskId = "3709";
		List list = processEngine.getHistoryService()//
						.getHistoricIdentityLinksForTask(taskId);
		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. 大大,中中,小小是组任务的办理人
  2. 在开发中,可以在页面中指定下一个组任务的办理人,通过流程变量设置下一个任务的办理人
4.分配个人任务方式三(使用类)

1:流程图中任务节点的配置 在这里插入图片描述 此时流程图的XML文件,如图: 在这里插入图片描述 2:TaskListenerImpl类,用来设置任务的办理人

public class TaskListenerImpl implements TaskListener {

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

}

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();
		// 2 启动流程
		ProcessInstance pi = processEngine.getRuntimeService()//
							.startProcessInstanceByKey("taskProcess");
		System.out.println("pid:" + pi.getId());
	}
	
	//查询我的个人任务列表
	@Test
	public void findMyTaskList(){
		String userId = "孙悟空";
		List 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 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 = "4008";
		List 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 findGroupHisUser(){
		String taskId = "4008";
		List list = processEngine.getHistoryService()//
						.getHistoricIdentityLinksForTask(taskId);
		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 = "4008";
		processEngine.getTaskService()//
					.complete(taskId);//
		System.out.println("完成任务");
	}
	
	//将组任务分配给个人任务(认领任务)
	@Test
	public void claimTask(){
		String taskId = "4008";
		//个人任务的办理人
		String userId = "如来";
		processEngine.getTaskService().claim(taskId, userId);
	}

	//可以分配个人任务回退到组任务,(前提之前是个组任务)
	@Test
	public void setAssigneeTask(){
		//任务ID
		String taskId = "4008";
		processEngine.getTaskService()//
					.setAssignee(taskId, null);
	}
	
	//向组任务中添加成员
	@Test
	public void addUser(){
		String taskId = "4008";
		String userId = "沙和尚";
		processEngine.getTaskService().addCandidateUser(taskId, userId);
	}

	//向组任务中删除成员
	@Test
	public void removeUser(){
		String taskId = "4008";
		String userId = "沙和尚";
		processEngine.getTaskService().deleteCandidateUser(taskId, userId);
	}

分析:

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

组任务及三种分配方式:

  1. taskProcess.bpmn中直接写 candidate-users=“小A,小B,小C,小D"

  2. taskProcess.bpmn中写 candidate-users =“#{userIDs}”,变量的值要是String的。 使用流程变量指定办理人

Map variables = new HashMap();
              variables.put("userIDs", "大大,小小,中中");
  1. 使用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(参与者)

注意: 组任务在项目中最好的处理方式是先拾取(claim())任务,即指定某个人去办理任务。这样就可以在正在执行(历史的)任务表中可以跟着当前任务的办理人,否则该字段(ASSIGNEE)为null,就无法跟踪当前办理人。

  • 第一种方式是固定的组任务的执行人

  • 第二种方式是在代码中通过流程变量的形式给组任务的执行人赋值,这样做的缺点是在进入该节点之前,必须给组任务赋值候选人

  • 第三种方式可以在进入该组任务的时候,执行TaskListener,从而给组任务的候选人赋值。 缺点1: 如果在TaskListener中操作了数据库,这意味着只要进入该节点就得操作数据库一次。 缺点2: 这个类不能放入到spring容器中,所以该类中的方法不能使用spring的声明式事务处理 优点: 可以在方法中引入servletConetxt或者ApplicationContext

关注
打赏
1688896170
查看更多评论

杨林伟

暂无认证

  • 3浏览

    0关注

    3183博文

    0收益

  • 0浏览

    0点赞

    0打赏

    0留言

私信
关注
热门博文
立即登录/注册

微信扫码登录

0.1413s