工作流 - 组任务

1. 组任务处理流程

（1）查询组任务

指定候选人，查询该候选人当前的待办任务，候选人不能立即办理任务

（2）拾取(claim)任务

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

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

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

需要将已经拾取的个人任务归还到组里边，将个人任务变成了组任务（即设置assignee为null）

（3）查询个人任务

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

（4）办理个人任务

同理任务处理

2. 查询组任务

根据候选人查询组任务

@Test
public void queryGroupTask() {
    String key = "evection1";
    String candidateUser = "zhangsan";
    ProcessEngine engine = ProcessEngines.getDefaultProcessEngine();
    TaskService taskService = engine.getTaskService();
    List<Task> list = taskService.createTaskQuery()
        .processDefinitionKey(key)
        .taskCandidateUser(candidateUser)
        //.taskCandidateOrAssigned(candidateUser)
        .list();
    for (Task task : list) {
        System.out.println("流程实例id：" + task.getProcessInstanceId());
        System.out.println("任务id：" + task.getId());
        System.out.println("任务名称：" + task.getName());
        System.out.println("负责人：" + task.getAssignee());
    }
}

3. 拾取组任务

候选人员拾取组任务后该任务变为自己（即指定候选人）的个人任务

@Test
public void claimTask() {
    String taskId = "45002";
    String userId = "zhangsan";

    ProcessEngine engine = ProcessEngines.getDefaultProcessEngine();
    TaskService taskService = engine.getTaskService();
    Task task = taskService.createTaskQuery().taskId(taskId).taskCandidateUser(userId).singleResult();
    if (task != null) {
        taskService.claim(taskId, userId);
        System.out.println("任务拾取成功");
    }
}

4. 查询个人待办任务

查询方式同理个人任务查询

@Test
public void queryGroupTask() {
    String key = "evection1";
    String candidateUser = "zhangsan";
    ProcessEngine engine = ProcessEngines.getDefaultProcessEngine();
    TaskService taskService = engine.getTaskService();
    List<Task> list = taskService.createTaskQuery()
        .processDefinitionKey(key)
        //.taskCandidateUser(candidateUser)
        //.taskCandidateOrAssigned(candidateUser)
        .taskAssignee(candidateUser)
        .list();
    for (Task task : list) {
        System.out.println("流程实例id：" + task.getProcessInstanceId());
        System.out.println("任务id：" + task.getId());
        System.out.println("任务名称：" + task.getName());
        System.out.println("负责人：" + task.getAssignee());
    }
}

5. 办理个人任务

@Test
public void completeTask() {
    ProcessEngine engine = ProcessEngines.getDefaultProcessEngine();
    TaskService taskService = engine.getTaskService();
    taskService.complete("42505");
    System.out.println("任务完成");
}

6. 归还组任务

设置 assignee 为 null 即可

@Test
public void taskBack() {
    String taskId = "45002";
    String userId = "zhangsan";
    ProcessEngine engine = ProcessEngines.getDefaultProcessEngine();
    TaskService taskService = engine.getTaskService();
    Task task = taskService.createTaskQuery().taskId(taskId).taskAssignee(userId).singleResult();
    if (task != null) {
        //设置userId为null，则归还组任务
        taskService.setAssignee(taskId, null);
        System.out.println("归还任务成功");
    }
}

7. 任务交接

将任务负责人设置为其他用户

@Test
public void setOtherUserId() {
    String taskId = "45002";
    String userId = "zhangsan";
    ProcessEngine engine = ProcessEngines.getDefaultProcessEngine();
    TaskService taskService = engine.getTaskService();
    Task task = taskService.createTaskQuery().taskId(taskId).taskAssignee(userId).singleResult();
    if (task != null) {
        //设置新的任务负责人
        taskService.setAssignee(taskId, "sunxiaocuan");
        System.out.println("任务交接成功");
    }
}

8. 数据库表操作

查询当前任务执行表

SELECT * FROM act_ru_task

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

查询任务参与者

SELECT * FROM act_ru_identitylink

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

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