Activiti进阶02:Activiti组任务实战

Posted 2022-05-25 黑马程序员官方

Activiti进阶

更多Java从0-1的笔记均在专栏中～
🍬Activiti基础01：从认识Activiti7开始，到环境配置
🍬Activiti基础02：手把手带你来创建一个Activiti工作流
🍬Activiti进阶01:流程实例以及个人任务
🍬Activiti进阶02:流程变量实战

一、组任务

1.1、需求

在流程定义中在任务结点的 assignee 固定设置任务负责人，在流程定义时将参与者固定设置在.bpmn 文件中，如果临时任务负责人变更则需要修改流程定义，系统可扩展性差。

针对这种情况可以给任务设置多个候选人，可以从候选人中选择参与者来完成任务。

1.2、设置任务候选人

在流程图中任务节点的配置中设置 candidate-users(候选人)，多个候选人之间用逗号分开。

查看bpmn文件

<userTask activiti:candidateUsers="lisi,wangwu" activiti:exclusive="true" id="_3" name="经理审批"/>

我们可以看到部门经理的审核人已经设置为 lisi,wangwu 这样的一组候选人，可以使用

activiti:candiateUsers=”用户 1,用户 2,用户 3”的这种方式来实现设置一组候选人

1.3、组任务

1.3.1、组任务办理流程

a、查询组任务

指定候选人，查询该候选人当前的待办任务。

候选人不能立即办理任务。

b、拾取(claim)任务

该组任务的所有候选人都能拾取。

将候选人的组任务，变成个人任务。原来候选人就变成了该任务的负责人。

如果拾取后不想办理该任务？

需要将已经拾取的个人任务归还到组里边，将个人任务变成了组任务。

c、查询个人任务

查询方式同个人任务部分，根据assignee查询用户负责的个人任务。

d、办理个人任务

1.3.2、 查询组任务

根据候选人查询组任务

@Test
   public void findGroupTaskList() 
      // 流程定义key
      String processDefinitionKey = "evection3";
      // 任务候选人
      String candidateUser = "lisi";
       //  获取processEngine
      ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
      // 创建TaskService
      TaskService taskService = processEngine.getTaskService();
      //查询组任务
      List<Task> list = taskService.createTaskQuery()
             .processDefinitionKey(processDefinitionKey)
             .taskCandidateUser(candidateUser)//根据候选人查询
             .list();
      for (Task task : list) 
          System.out.println("----------------------------");
          System.out.println("流程实例id：" + task.getProcessInstanceId());
          System.out.println("任务id：" + task.getId());
          System.out.println("任务负责人：" + task.getAssignee());
          System.out.println("任务名称：" + task.getName());
      
   

4.3.3 、 拾取组任务

候选人员拾取组任务后该任务变为自己的个人任务。

@Test
   public void claimTask()
        //  获取processEngine
      ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
      TaskService taskService = processEngine.getTaskService();
      //要拾取的任务id
      String taskId = "6302";
      //任务候选人id
      String userId = "lisi";
      //拾取任务
      //即使该用户不是候选人也能拾取(建议拾取时校验是否有资格)    
      //校验该用户有没有拾取任务的资格
      Task task = taskService.createTaskQuery()
             .taskId(taskId)
             .taskCandidateUser(userId)//根据候选人查询
             .singleResult();
      if(task!=null)
        //拾取任务
          taskService.claim(taskId, userId);
          System.out.println("任务拾取成功");
      
   

说明：即使该用户不是候选人也能拾取，建议拾取时校验是否有资格

组任务拾取后，该任务已有负责人，通过候选人将查询不到该任务

1.3.4、 查询个人待办任务

查询方式同个人任务查询

@Test
public void findPersonalTaskList() 
   // 流程定义key
   String processDefinitionKey = "evection1";
   // 任务负责人
   String assignee = "zhangsan";
    //  获取processEngine
      ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
   // 创建TaskService
   TaskService taskService = processEngine.getTaskService();
   List<Task> list = taskService.createTaskQuery()
       .processDefinitionKey(processDefinitionKey)
       .taskAssignee(assignee)
       .list();
   for (Task task : list) 
       System.out.println("----------------------------");
       System.out.println("流程实例id：" + task.getProcessInstanceId());
       System.out.println("任务id：" + task.getId());
       System.out.println("任务负责人：" + task.getAssignee());
       System.out.println("任务名称：" + task.getName());
   

1.3.5、 办理个人任务

同个人任务办理

 /*完成任务*/
   @Test
   public void completeTask()
//     任务ID
      String taskId = "12304";
//     获取processEngine
      ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
      processEngine.getTaskService()
                   .complete(taskId);
      System.out.println("完成任务："+taskId);
   

说明：建议完成任务前校验该用户是否是该任务的负责人。

1.3.6、 归还组任务

如果个人不想办理该组任务，可以归还组任务，归还后该用户不再是该任务的负责人

/*
*归还组任务，由个人任务变为组任务，还可以进行任务交接
*/
@Test
public void setAssigneeToGroupTask() 
    //  获取processEngine
       ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
   // 查询任务使用TaskService
   TaskService taskService = processEngine.getTaskService();
   // 当前待办任务
   String taskId = "6004";
   // 任务负责人
   String userId = "zhangsan2";
    // 校验userId是否是taskId的负责人，如果是负责人才可以归还组任务
   Task task = taskService
       .createTaskQuery()
       .taskId(taskId)
       .taskAssignee(userId)
       .singleResult();
    if (task != null) 
       // 如果设置为null，归还组任务,该 任务没有负责人
       taskService.setAssignee(taskId, null);
    

说明：建议归还任务前校验该用户是否是该任务的负责人

也可以通过setAssignee方法将任务委托给其它用户负责，注意被委托的用户可以不是候选人（建议不要这样使用）

1.3.7、 任务交接

任务交接,任务负责人将任务交给其它候选人办理该任务

@Test
   public void setAssigneeToCandidateUser() 
       //  获取processEngine
      ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
      // 查询任务使用TaskService
      TaskService taskService = processEngine.getTaskService();
      // 当前待办任务
      String taskId = "6004";
      // 任务负责人
      String userId = "zhangsan2";
// 将此任务交给其它候选人办理该 任务
          String candidateuser = "zhangsan";
      // 校验userId是否是taskId的负责人，如果是负责人才可以归还组任务
      Task task = taskService
          .createTaskQuery()
          .taskId(taskId)
          .taskAssignee(userId)
          .singleResult();
      if (task != null) 
          taskService.setAssignee(taskId, candidateuser);
      
   

1.3.8、 数据库表操作

查询当前任务执行表

SELECT * FROM act_ru_task 

任务执行表，记录当前执行的任务，由于该任务当前是组任务，所有assignee为空，当拾取任务后该字段就是拾取用户的id

查询任务参与者

SELECT * FROM act_ru_identitylink

任务参与者，记录当前参考任务用户或组，当前任务如果设置了候选人，会向该表插入候选人记录，有几个候选就插入几个

与act_ru_identitylink对应的还有一张历史表act_hi_identitylink，向act_ru_identitylink插入记录的同时也会向历史表插入记录。任务完成