[Activit7]任务组任务(第十章)

============================================================

============Activiti7：Candidate-users 候选人==============

============================================================

需求：在流程定义中在任务结点的 assignee 固定设置任务负责人，在流程定义时将参与者固定设置在.bpmn 文件中，如果临时任务负责人变更则需要修改流程定义，系统可扩展性差。针对这种情况可以给任务设置多个候选人，可以从候选人中选择参与者来完成任务。

设置任务候选人：

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

查看 bpmn 文件：

我们可以看到部门经理的审核人已经设置为 zhangsan,lishi这样的一组候选人，可以使用activiti:candiateUsers=”用户 1,用户 2,用户 3”的这种方式来实现设置一组候选人。

=============================================================

=============组任务流程===============

=============================================================

第一步：查询组任务

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

候选人不能办理任务。

第二步：拾取(claim)任务

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

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

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

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

第三步：查询个人任务

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

第四步：办理个人任务

=============================================================

=============用户查询组任务===============

=============================================================

1：根据候选人查询组任务

@Test

public void findGroupTaskList() {

// 流程定义key

String processDefinitionKey = "holiday4";

// 任务候选人

String candidateUser = "zhangsan";

// 创建TaskService

TaskService taskService = processEngine.getTaskService();

//查询组任务

List<Task> list = taskService.createTaskQuery()//

.processDefinitionKey(processDefinitionKey)//

.taskCandidateUser(candidateUser)//根据候选人查询

.list();

for (Tasktask : 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：候选人员拾取组任务后该任务变为自己的个人任务

@Test

public void claimTask(){

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：查询方式同个人任务查询

@Test

public voidfindPersonalTaskList() {

// 流程定义key

StringprocessDefinitionKey = "holiday4";

// 任务负责人

Stringassignee = "zhangsan";

// 创建TaskService

TaskServicetaskService = 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：完成任务

@Test

public void completeTask(){

//任务ID

String taskId = "12304";

processEngine.getTaskService()//

.complete(taskId);

System.out.println("完成任务："+taskId);

}

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

=============================================================

=============归还组任务===============

=============================================================

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

// 归还组任务，由个人任务变为组任务，还可以进行任务交接

@Test

public void setAssigneeToGroupTask() {

// 查询任务使用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方法将任务委托给其它用户负责，注意被委托的用户可以不是候选人（建议不要这样使用）

=============================================================

=============任务交接===============

=============================================================

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

@Test

public void setAssigneeToCandidateUser() {

// 查询任务使用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);

}

}