组任务办理流程
设置任务候选人
在流程图中任务节点的配置中设置 candidate-users(候选人),多个候选人之间用逗号分开。
第一步:查询组任务
指定候选人,查询该候选人当前的待办任务。
候选人不能办理任务。
第二步:拾取(claim)任务
该组任务的所有候选人都能拾取。
将候选人的组任务,变成个人任务。原来候选人就变成了该任务的负责人。
***如果拾取后不想办理该任务?
需要将已经拾取的个人任务归还到组里边,将个人任务变成了组任务。
第三步:查询个人任务
查询方式同个人任务部分,根据 assignee 查询用户负责的个人任务。
第四步:办理个人任务
1. 部署流程定义
// 1. 部署流程定义
@Test
public void deployProcess() {
// 1.得到ProcessEngine对象
ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
// 2.得到RepositoryService对象
RepositoryService repositoryService = processEngine.getRepositoryService();
// 3.部署
Deployment deploy = repositoryService.createDeployment()
.addClasspathResource("diagram/holiday05.bpmn")
// .addClasspathResource("diagram/holiday4.png")
.name("请假流程候选人")
.deploy();
System.out.println(deploy.getId());
System.out.println(deploy.getName());
}
2.启动流程实例,同时还要设置流程变量的值
// 2.启动流程实例,同时还要设置流程变量的值
@Test
public void startProcess() {
// 1.得到ProcessEngine对象
ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
// 2.得到RunService对象
RuntimeService runtimeService = processEngine.getRuntimeService();
// 3.启动流程实例,并设置流程变量
ProcessInstance processInstance = runtimeService.startProcessInstanceByKey("holiday");
// 4.输出实例信息
System.out.println(processInstance.getName());
System.out.println(processInstance.getProcessDefinitionId());
}
3.完成任务
// 3. 完成任务 xiaozhang -> zhangsan,lisi -->xiaowang
@Test
public void completeTask() {
// 1. 得到ProcessEngine
ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
// 2.得到TaskService对象
TaskService taskService = processEngine.getTaskService();
// 3.查询当前用户是否有任务
Task task = taskService.createTaskQuery()
.processDefinitionKey("holiday")
.taskAssignee("xiaozhang")
.singleResult();
// 4. 判断task != null,说明当前用户有任务
if(task != null){
taskService.complete(task.getId());
System.out.println("用户 "+task.getAssignee() +" 任务执行完毕");
}
}
4. 查询候选用户的组任务
// 4. 查询候选用户的组任务
@Test
public void findGroupTaskList(){
// 1. 得到ProcessEngine
ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
// 2.得到TaskService对象
TaskService taskService = processEngine.getTaskService();
// 3. 设置一些参数,流程定义的key,候选用户
String key = "holiday";
String candidateUser = "zhangsan";
// 4. 执行查询
List<Task> list = taskService.createTaskQuery()
.processDefinitionKey(key)
.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());
}
}
5. 用户拾取组任务
// 5. 测试zhangsan用户,拾取组任务
// 拾取任务的过程,就是将候选用户变成任务负责人
@Test
public void claimTask() {
// 1. 得到ProcessEngine
ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
// 2.得到TaskService对象
TaskService taskService = processEngine.getTaskService();
// 3. 设置一些参数,流程定义的key,候选用户
String key = "holiday";
String candidateUser = "zhangsan";
// 4. 执行查询
Task task = taskService.createTaskQuery()
.processDefinitionKey(key)
.taskCandidateUser(candidateUser)
.singleResult();
// 5. 用户拾取组任务
if(task != null){
// 第一个参数任务id 第二个参数候选人
taskService.claim(task.getId(), candidateUser);
System.out.println("任务拾取完毕");
}
}
6.当前用户查询自己的任务
// 6.当前用户查询自己的任务
@Test
public void findPersonalTaskList(){
// 1. 得到ProcessEngine
ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
// 2.得到TaskService对象
TaskService taskService = processEngine.getTaskService();
// 3. 设置一些参数,流程定义的key,候选用户
String key = "holiday";
String assignee = "zhangsan";
// 4. 执行查询
List<Task> list = taskService.createTaskQuery()
.processDefinitionKey(key)
.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());
}
}
7.当前用户完成自己的任务
// 7.当前用户完成自己的任务
@Test
public void assigneeCompleteTask(){
// 1. 得到ProcessEngine
ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
// 2.得到TaskService对象
TaskService taskService = processEngine.getTaskService();
// 3. 设置一些参数,流程定义的key,候选用户
String key = "holiday";
String assignee = "zhangsan";
// 4. 执行查询
Task task = taskService.createTaskQuery()
.processDefinitionKey(key)
.taskAssignee(assignee)
.singleResult();
// 5. 执行当前任务
if(task != null){
taskService.complete(task.getId());
System.out.println("任务执行完毕");
}
}
8.归还组任务
// 归还组任务,由个人任务变为组任务,还可以进行任务交接
@Test
public void setAssigneeToGroupTask() {
// 1. 得到ProcessEngine
ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
// 2.得到TaskService对象
TaskService taskService = processEngine.getTaskService();
// 3. 设置一些参数,流程定义的key,候选用户
String key = "holiday";
String assignee = "zhangsan";
// 4. 执行查询
Task task = taskService.createTaskQuery()
.processDefinitionKey(key)
.taskAssignee(assignee)
.singleResult();
// 5. 执行当前任务
if(task != null){
// 第一个参数任务id 第二个参数候选人
taskService.setAssignee(task.getId(), null);
System.out.println("归还任务执行完毕");
}
}
9. 任务交接
//任务交接,任务负责人将任务交给其它候选人办理该任务
@Test
public void setAssigneeToCandidateUser() {
// 1. 得到ProcessEngine
ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
// 2.得到TaskService对象
TaskService taskService = processEngine.getTaskService();
// 3. 设置一些参数,流程定义的key,候选用户
String key = "holiday";
String assignee = "zhangsan";
// 4. 执行查询
Task task = taskService.createTaskQuery()
.processDefinitionKey(key)
.taskAssignee(assignee)
.singleResult();
// 5. 执行当前任务
if(task != null){
// 第一个参数任务id 第二个参数候选人
taskService.setAssignee(task.getId(), "lisi"); // 设置责任人为李四
System.out.println("交接任务执行完成");
}
}
