activiti工作流常用api

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

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

[java]  view plain  copy

1. identityService.setAuthenticatedUserId(user);  

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

[java]  view plain  copy

1. public String getStartUserId(String taskId) {  
2.       Task task =  
3.               taskService.createTaskQuery()  
4.                          .taskId(taskId)  
5.                          .singleResult();  
6.       HistoricProcessInstance historicProcessInstance =  
7.               historyService.createHistoricProcessInstanceQuery()  
8.                               .processInstanceId(task.getProcessInstanceId())  
9.                               .singleResult();  
10.       return historicProcessInstance.getStartUserId();  
11.   }  

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

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

[java]  view plain  copy

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

    4、使用任务id获取businessKey
   

[java]  view plain  copy

1. public String findBusinessKeyByTaskId(String taskId) throws Exception {  
2.         ProcessInstance pi =  
3.                 activitiUtilServiceI.findProcessInstanceByTaskId(taskId);  
4.         String businessKey = pi.getBusinessKey();  
5.         if(StringUtils.isEmpty(businessKey)){  
6.             throw new Exception("无法找到任务的BusinessKey");  
7.         }  
8.         return businessKey;  
9.  }  

   5、组任务拾取
     

[java]  view plain  copy

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

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

[java]  view plain  copy

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

       (2)查询全部任务

[java]  view plain  copy

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

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

[java]  view plain  copy

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

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

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

[java]  view plain  copy

1. public ActivityImpl findActivitiImpl(String taskId, String activityId)  
2.                 throws Exception {  
3.         ProcessDefinitionEntity processDefinition =  
4.                 findProcessDefinitionEntityByTaskId(taskId);    
5.         if (StringUtils.isEmpty(activityId)) {    
6.             activityId = findTaskById(taskId).getTaskDefinitionKey();    
7.         }    
8.         ActivityImpl activityImpl =  
9.                 ((ProcessDefinitionImpl) processDefinition)    
10.                 .findActivity(activityId);    
11.         return activityImpl;    
12. }  

8、查询流程批注信息

[java]  view plain  copy

1. public List<Comment> findCommentByTaskId(String taskId) {  
2.        Task task =  
3.                taskService.createTaskQuery()  
4.                            .taskId(taskId)  
5.                            .singleResult();  
6.        List<Comment> list = taskService.getProcessInstanceComments(task.getProcessInstanceId());  
7.        return list;  
8.    }  

9、添加流程批注信息

[java]  view plain  copy

1. Task task =  
2.                 taskService.createTaskQuery()  
3.                             .taskId(taskId)  
4.                             .singleResult();  
5.  taskService.addComment(taskId, task.getProcessInstanceId(), message);  

10、获取表单属性控制

[java]  view plain  copy

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

11、获取变量值

[java]  view plain  copy

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