Activiti之对用户任务签收办理操作

ゞ浴缸里的玫瑰 2022-05-11 03:54 479阅读 0赞

下文先介绍下用户任务的办理相关操作

用户任务分类：

分为4中状态：未签收/待办理、已签收/办理中、运行中/办理中、已完成/已办结

首先，我们要了解下 TaskService 这个服务的作用：

*  查询分配给用户或组的任务
 *  创建独立运行任务，这些任务与流程实例无关
 *  手工设置任务的执行者，或者这些用户通过何种方式与任务关联
 *  认领并完成一个任务。认领意味着一个人期望成为任务的执行者， 即这个用户会完成这个任务。完成意味着“做这个任务要求的事情”。 通常来说会有很多种处理形式

# API简述 #

从类 org.activiti.engine.impl.ServiceImpl 继承的字段

所有已实现的接口：TaskService

TaskService taskService = processEngine.getTaskService();

这边定义了几个通用的变量：

String userId = "Ypp";
    
    String userGroup = new String["Ypp1","Ypp101"];

## 1、未签收/待办理 ##

那么流程开启之后，如何能让下一个办理人取得待办任务呢？

通过下面几种的方法，将取得指定签收人/办理人的待办数据

单人待签收/待办理

List<Task> tasks = taskService.createTaskQuery().taskCandidateUser(userId).list();

用户组待签收/待办理

List<Task> tasks = taskService.createTaskQuery().taskCandidateGroup(userGroup).list();

进行签收操作，也就是将要接收办理这个任务

这边可以使用循环，也可以通过其他方法，常用的是先加载一个任务待办列表到页面上,签收任务传递后台一个taskId

task.getId() = taskId 
    
    // 完成签收这个时候就任务Task的Assignee属性就有了值
    taskService.claim(task.getId(), userId);

已经签收过的任务列表，某种意义上我理解为真正的办理人

List<Task> tasks = taskService.createTaskQuery().taskAssignee(userId).list();

## 2、办理 ##

通过 1、未签收/待办理 中取得需要办理的任务Task之后

// 调用 task.getId() = taskId 完成任务的办理，taskService服务自动流转到下一个办理节点
    taskService.complete(task.getId());
    
    // taskService.complete()方法 提供了重载，提供了3种方式供你选择
    complete(String taskId)
    complete(String taskId, Map<String,Object> variables)  
    complete(String taskId, Map<String,Object> variables, boolean localScope)

如果更深的了解如何流转的，可以查看源码

--------------------

任务并不一定要先签收再办理，可以直接到待办理中，而不是待签收中

可以把

taskService.claim(task.getId(), userId);

替换为

setAssignee(String taskId, String userId);

经过以上步骤，任务已经在办理中状态了。

## 3、已完成/已办结 ##

任务的已完成（调用过complete方法）是指当前待办的任务状态，而非整个流程实例的完成状态

流程中数据使用到 historyService 服务

查询指定用户发起的流程 （流程历史 用户发起 ）

*  finished()：完成的流程
 *  unfinish()：还在运行中的流程

下面的3种方法：

historyService.createHistoricProcessInstanceQuery()
    				.finished()
    				.startedBy(name)
    				.orderByProcessInstanceStartTime()
    				.desc()
    				.listPage(firstResult, maxResults);

查询指定用户参与的流程信息 （流程历史 用户参与 ）

historyService.createHistoricProcessInstanceQuery()
    				.involvedUser(name)
    				.orderByProcessInstanceStartTime()
    				.desc()
    				.listPage(firstResult, maxResults);

查询指定流程的任务流转路径 （流程历史 任务流转路经）

historyService.createHistoricTaskInstanceQuery()
    				.processInstanceId(processInstanceId)
    				.orderByHistoricTaskInstanceEndTime()
    				.asc()
    				.list();

查看流程是否完整的运行完毕方法也有好几种：

for (HistoricActivityInstance hai : hais) {
    
    	//如果下面的方法返回不是空，那就是已办结
    
    	hai.getEndTime();
    
    }
    
    //查看ACT_RU_TASK表
    
    Long long = taskService.createTaskQuery().processInstanceId("processInstanceId").taskId("taskId").count();
    
    //如果long为空，那么也是办结了
    
    taskService.createTaskQuery()查询条件是可选的
    
    可以是
    
    taskService.createTaskQuery().processInstanceId("processInstanceId");
    
    taskService.createTaskQuery().taskId("taskId");
    
    或者其他更多条件

# 总结： #

流程在流转中对于当前办理人/组和签收人/组来说，都是可以进行动态调整变化的

需要对程序进行特殊处理，添加监听或者其他方法

得到用户组待签收

TaskService taskService = processEngine.getTaskService();

单人待签收

List<Task> tasks = taskService.createTaskQuery().taskCandidateUser(userId).list();
    
    List<Task> tasks = taskService.createTaskQuery().taskCandidateGroup(userGroup).list();
    
    for (Task task : tasks) {
    	// 签收
    	taskService.claim(task.getId(), userId);
    }
    
    //得到用户待办
    tasks = taskService.createTaskQuery().taskAssignee(userId).list();
    
    for (Task task : tasks) {
    	//办理
    	taskService.complete(task.getId());
    }
    
    //顺便查看历史看看
    
    HistoryService historyService = processEngine.getHistoryService();
    
    HistoricProcessInstance historicProcessInstance = historyService.createHistoricProcessInstanceQuery()
    																.processInstanceId(procId)
    																.singleResult();