Activiti7之组任务

Candidate-users 候选人

 

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

 

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

设置任务候选人

 

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

 

 

 

改成xml形式查看

 

 

 

 

可以看到总经理的审核人已经设置为 wangwu,qingqi这样的一组候选人，可以使用

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

 

组任务办理流程

 

• 第一步：查询组任务
  • 指定候选人，查询该候选人当前的待办任务。候选人不能办理任务。
• 第二步：拾取(claim)任务
  • 该组任务的所有候选人都能拾取。
  • 将候选人的组任务，变成个人任务。原来候选人就变成了该任务的负责人。
  • 如果拾取后不想办理该任务？
    • 需要将已经拾取的个人任务归还到组里边，将个人任务变成了组任务。
• 第三步：查询个人任务第四步：办理个人任务
  • 查询方式同个人任务部分，根据assignee 查询用户负责的个人任务。

用户查询组任务

 

根据候选人查询组任务，前提是你到这一步了，如我的到‘总经理审批’这一步才能查到

 

 

 @Test  2     public void findGroupTaskList() {  3 
        ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();  5         // 流程定义key
        String processDefinitionKey = "groupTask";  7         // 任务候选人
        String candidateUser = "wangwu";  9         // 创建TaskService
        TaskService taskService = processEngine.getTaskService(); 11         //查询组任务
        List<Task> list = taskService.createTaskQuery()// 13                 .processDefinitionKey(processDefinitionKey)// 14                 .taskCandidateUser(candidateUser)//根据候选人查询
 .list(); 16         for (Task task : list) { 17             System.out.println("    "); 18             System.out.println("流程实例id：" + task.getProcessInstanceId()); System.out.println(" 任 务 id：" + task.getId()); System.out.println(" 任 务 负 责 人 ：" + task.getAssignee()); System.out.println("任务名称：" + task.getName()); 19 
 } 21     }

 

 

 

 

 

 

用户拾取组任务

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

 @Test  2     public void claimTask(){  3         ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();  4         TaskService taskService = processEngine.getTaskService();  5         //要拾取的任务id
        String taskId = "5002";  7         //任务候选人id
        String userId = "qingqi";  9         //拾取任务 10         //即使该用户不是候选人也能拾取(建议拾取时校验是否有资格) 11 
        //校验该用户有没有拾取任务的资格
        Task task = taskService.createTaskQuery()// 14  .taskId(taskId) 15                 .taskCandidateUser(userId)//根据候选人查询
 .singleResult(); 17         if(task!=null){ taskService.claim(taskId, userId); System.out.println("任务拾取成功"); 18  } 19     }

 

 

 

查看数据库的任务，可以看到总经理审批这个任务的负责人就是qingqi了

 

 

说明：即使该用户不是候选人也能拾取，建议拾取时校验是否有资格组任务拾取后，该任务已有负责人，通过候选人将查询不到该任务

 

 

用户查询个人待办任务

查询方式同个人任务查询

 

@Test  2     public void findPersonalTaskList() {  3         ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();  4         // 流程定义key
        String processDefinitionKey = "groupTask";  6         // 任务负责人
        String assignee = "qingqi";  8         // 创建TaskService
        TaskService taskService = processEngine.getTaskService(); 10         List<Task> list = taskService.createTaskQuery()// 11                 .processDefinitionKey(processDefinitionKey)// 12  .taskAssignee(assignee).list(); 13 
        for (Task task : list) { 15             System.out.println("--------------"); 16             System.out.println("流程实例ID:"+task.getProcessInstanceId()); 17             System.out.println("任务id：" + task.getId()); 18             System.out.println("任务负责人：" + task.getAssignee()); System.out.println("任务名称：" + task.getName()); 19  } 20     }

 

 

查询可以看到总经理审批这个任务的负责人是qingqi

 

 

用户办理个人任务

   /**完成任务*/ 
 @Test 3     public void completeTask(){ 4         ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();; 5         //任务ID
        String taskId = "5002"; 7         processEngine.getTaskService().complete(taskId); System.out.println("完成任务："+taskId); 8     }

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

 

归还组任务

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

 

    // 归还组任务，由个人任务变为组任务，还可以进行任务交接
 @Test  3     public void setAssigneeToGroupTask() {  4         ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();  5         // 查询任务使用TaskService
        TaskService taskService = processEngine.getTaskService();  7         // 当前待办任务
        String taskId = "5002";  9         // 任务负责人
        String userId = "qingqi"; 11 
        // 校验userId是否是taskId的负责人，如果是负责人才可以归还组任务
        Task task = taskService.createTaskQuery().taskId(taskId) 14  .taskAssignee(userId).singleResult(); 15 
        if (task != null) { 17             // 如果设置为null，归还组任务,该 任务没有负责人
            taskService.setAssignee(taskId, null); 19 
 } 21 
    }

 

 

程序没有报错

 

 

查看数据库的总经理审批的负责人还是不是qingqi

 

可以看到总经理审批的负责人已经变为空了，说明归还任务成功，这个时候就可以从新选择负责人

 

任务交接

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

可以看到现在是qingqi，我现在想把这个任务交接个wangwu

 

 

 

    /**
     * 任务交接
     */
    @Test
    public void taskReturn(){
        //获取ProcessEngine对象
        ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
        //获取TaskService对象
        TaskService taskService = processEngine.getTaskService();
        //查询到自己的任务，然后通过任务ID进行提交
        Task task = taskService.createTaskQuery().processDefinitionKey("groupTask").taskAssignee("qingqi").singleResult();

        if(task!=null){
            //任务退回  任务ID    null代表没有处理人执行，需要后续再次拾取任务
            //任务交接 任务ID     如果第二个参数，处理人不为空代表将该任务交给次处理人
            taskService.setAssignee(task.getId(),"wangnan");
            System.out.println("任务退回");
        }
    }