activiti工作流常用api

最新推荐文章于 2021-07-01 16:55:13 发布

原创最新推荐文章于 2021-07-01 16:55:13 发布 · 1.2w 阅读

11 ·

CC 4.0 BY-SA版权

activiti工作流专栏收录该内容

2 篇文章

订阅专栏

本文介绍了Activiti工作流中的关键操作，包括流程启动人的绑定与获取、任务处理、批注管理及变量值的读取等。通过具体的代码示例展示了如何实现这些功能。

1、绑定启动流程的当前用户

在启动流程时，先调用下面的api 来绑定流程启动人

          identityService.setAuthenticatedUserId(user);

2、获取流程实例的启动人

  public String getStartUserId(String taskId) {
        Task task =
                taskService.createTaskQuery()
                           .taskId(taskId)
                           .singleResult();
        HistoricProcessInstance historicProcessInstance =
                historyService.createHistoricProcessInstanceQuery()
                                .processInstanceId(task.getProcessInstanceId())
                                .singleResult();
        return historicProcessInstance.getStartUserId();
    }

小结： activiti:initiator属性作用：可以把启动流程实例的操作人以变量名(比如"applyUserId")保存到数据库中，需要配合
        identityService.setAuthenticatedUserId(String userId)方法使用来进行赋值
        使用Authentication.getAuthenticatedUserId()方法或者
        使用HistoricProcessInstance实例的getStartUserId()可以获取一个流程实例由哪个用户启动

3、使用任务id获取formKey，即url

 public String findTaskFormKeyByTaskId(String taskId) {
        TaskFormData taskFormData = formService.getTaskFormData(taskId);
        return taskFormData.getFormKey();
    }

4、使用任务id获取businessKey

public String findBusinessKeyByTaskId(String taskId) throws Exception {
        ProcessInstance pi =
                activitiUtilServiceI.findProcessInstanceByTaskId(taskId);
        String businessKey = pi.getBusinessKey();
        if(StringUtils.isEmpty(businessKey)){
            throw new Exception("无法找到任务的BusinessKey");
        }
        return businessKey;
 }

5、组任务拾取

  if(StringUtils.isEmpty(task.getAssignee())){
            taskService.claim(taskId, currentAssignee);
        }

6、查询待办任务
(1)等待被签收的任务

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

(2)查询全部任务

List<Task> list = taskService.createTaskQuery()
			     .taskCandidateOrAssigned("userId")
			     .list();

(3)更细致查询全部与给定用户相关的任务

 TaskQuery query = taskService.createTaskQuery().taskInvolvedUser("userId");

小结：taskInvolvedUser()与taskCandidateUser()的区别就在于前者包含了参与人、候选人，以及属于某个候选组的人，
而后者只在候选人、候选组范围内查询

7、使用任务id查询该activityImpl节点的信息

public ActivityImpl findActivitiImpl(String taskId, String activityId)
                throws Exception {
        ProcessDefinitionEntity processDefinition =
                findProcessDefinitionEntityByTaskId(taskId);  
        if (StringUtils.isEmpty(activityId)) {  
            activityId = findTaskById(taskId).getTaskDefinitionKey();  
        }  
        ActivityImpl activityImpl =
                ((ProcessDefinitionImpl) processDefinition)  
                .findActivity(activityId);  
        return activityImpl;  
}

8、查询流程批注信息

 public List<Comment> findCommentByTaskId(String taskId) {
        Task task =
                taskService.createTaskQuery()
                            .taskId(taskId)
                            .singleResult();
        List<Comment> list = taskService.getProcessInstanceComments(task.getProcessInstanceId());
        return list;
    }

9、添加流程批注信息

Task task =
                taskService.createTaskQuery()
                            .taskId(taskId)
                            .singleResult();
 taskService.addComment(taskId, task.getProcessInstanceId(), message);

10、获取表单属性控制

 TaskFormData taskFormData = formService.getTaskFormData(taskId);
 List<FormProperty> formPropertiesList = taskFormData.getFormProperties();

11、获取变量值

 public Object getVariablesByTask(String taskId,String variableName){
        Object variable = taskService.getVariable(taskId, variableName);
        return variable;
    }