(二)Flowable中TaskServiceAPI详解

Flowable中TaskServiceAPI详解

1.FormInfo getTaskFormModel​(String taskId)
获取特定任务任务表单的表单模型实例
参数：
taskId-ID的任务，不能是空的。
抛出：
org.flowable.common.engine.api.FlowableObjectNotFoundException-当任务或形式定义不存在时。

2.FormInfo getTaskFormModel​(String taskId,boolean ignoreVariables)
获取特定任务任务表单的表单模型实例，无需任何可变处理
参数：
taskId-ID的任务，不能是空的。
ignoreVariables-获取表单模型时应忽略变量吗？
抛出：
org.flowable.common.engine.api.FlowableObjectNotFoundException-当任务或形式定义不存在时。

3.void setAssignee​(String taskId,String userId)
将给定任务的受让人更改为给定的用户Id。不检查用户是否由身份组件知道。
参数：
taskId-ID的任务，不能是空的。
userId-用户作为受让人使用的ID。
抛出：
org.flowable.common.engine.api.FlowableObjectNotFoundException-当任务或用户不存在时。

4.void setOwner​(String taskId,String userId)
将此任务的所有权转移给其他用户。不检查用户是否由身份组件知道。
参数：
taskId-ID的任务，不能是空的。
userId-接受所有权的人
抛出：
org.flowable.common.engine.api.FlowableObjectNotFoundException-当任务或用户不存在时。

5.List getIdentityLinksForTask​(String taskId)
检索与给定任务相关的任务。这样可以告知某个身份（例如组或用户）如何与特定任务关联（例如作为候选人、受让人等）IdentityLinkIdentityLink

6.void addCandidateUser​(String taskId,String userId)
任务候选人(绑定权限) 关联表act_ru_identitylink
参数：
taskId-ID的任务，不能是空的。
userId-ID的用户作为候选者使用，不能是空的。
抛出：
org.flowable.common.engine.api.FlowableObjectNotFoundException-当任务或用户不存在时。

7.void addCandidateGroup​(String taskId,String groupId)
任务候选组(绑定权限) 关联表act_ru_identitylink
参数：
taskId-ID的任务，不能是空的。
groupId-ID组用作候选者，不能为空。
抛出：
org.flowable.common.engine.api.FlowableObjectNotFoundException-当任务或组不存在时。

8.void addUserIdentityLink​(String taskId,String userId,String identityLinkType)
涉及执行任务的用户。身份链接的类型由给定的身份链接类型定义。
参数：
taskId-ID的任务，不能是空的。
userId-用户的ID涉及，不能是空的。
identityLinkType-身份链接类型，不能为空（@see）。IdentityLinkType
抛出：
org.flowable.common.engine.api.FlowableObjectNotFoundException-当任务或用户不存在时。

9.void addGroupIdentityLink​(String taskId,String groupId,String identityLinkType)
涉及一个执行任务的组。身份链接的类型由给定的身份链接定义。
参数：
taskId-ID的任务，不能是空的。
groupId-组的ID参与，不能是空的。
identityLinkType-身份类型，不能为空（@see）。IdentityLinkType
抛出：
org.flowable.common.engine.api.FlowableObjectNotFoundException-当任务或组不存在时。

10.void deleteCandidateUser​(String taskId,String userId)
用于删除使用身份链接
参数：
taskId-ID的任务，不能是空的。
userId-ID的用户作为候选者使用，不能是空的。
抛出：
org.flowable.common.engine.api.FlowableObjectNotFoundException-当任务或用户不存在时。

11.void deleteCandidateGroup​(String taskId,String groupId)
删除组
参数：
taskId-ID的任务，不能是空的。
groupId-ID组用作候选者，不能为空。
抛出：
org.flowable.common.engine.api.FlowableObjectNotFoundException-当任务或组不存在时。

12.void deleteUserIdentityLink​(String taskId,String userId,String identityLinkType)
删除用户与给定身份链接类型任务之间的关联。
参数：
taskId-ID的任务，不能是空的。
userId-用户的ID涉及，不能是空的。
identityLinkType-身份链接类型，不能为空（@see）。IdentityLinkType
抛出：
org.flowable.common.engine.api.FlowableObjectNotFoundException-当任务或用户不存在时。

13.void deleteGroupIdentityLink​(String taskId,String groupId,String identityLinkType)
删除组与给定身份链接类型的任务之间的关联。
参数：
taskId-ID的任务，不能是空的。
groupId-组的ID参与，不能是空的。
identityLinkType-身份类型，不能为空（@see）。IdentityLinkType
抛出：
org.flowable.common.engine.api.FlowableObjectNotFoundException-当任务或组不存在时。

14.void setPriority​(String taskId,int priority)
设置优先性（字符串任务Id，国际优先级）
更改任务的优先级。授权：实际所有者/企业管理员
参数：
taskId-ID的任务，不能是空的。
priority-任务的新优先级。
抛出：
org.flowable.common.engine.api.FlowableObjectNotFoundException-当任务不存在时

15.void setDueDate​(String taskId,Date dueDate)
更改任务的截止日期
参数：
taskId-ID的任务，不能是空的。
dueDate-任务的新截止日期
抛出：
org.flowable.common.engine.api.FlowableException-当任务不存在时

16.TaskQuery createTaskQuery()
返回可用于动态查询任务的新任务。TaskQuery

17.NativeTaskQuery createNativeTaskQuery()
返回新的任务。NativeQuery

18.void setVariable​(String taskId,String variableName,Object value)
在任务上设置变量。如果变量尚未存在，则将在最外部范围内创建该变量。这意味着如果此任务与执行相关，则过程实例。

19.void setVariables​(String taskId,Map<String,​? extends Object> variables)
设置任务变量。如果变量尚未存在，则将在最外部范围内创建该变量。这意味着如果此任务与执行相关，则过程实例。

20.void setVariableLocal​(String taskId,String variableName,Object value)
在任务上设置变量。如果变量尚未存在，将在任务中创建该变量。

21.void setVariablesLocal​(String taskId,Map<String,​? extends Object> variables)
设置任务变量。如果变量尚未存在，将在任务中创建该变量。

22.Object getVariable​(String taskId,String variableName)
在任务范围中获取变量并进行搜索，如果可用，还可以获取执行范围。

23. T getVariable​(String taskId,String variableName,Class variableClass)
在任务范围中获取变量并进行搜索，如果可用，还可以获取执行范围。

24.VariableInstance getVariableInstance​(String taskId,String variableName)
变量。搜索变量是在给定任务（包括父示波器）可见的所有示波器中完成的。当未找到带有给定名称的可变值时，返回无效。
参数：
taskId-任务的ID，不能是空的。
variableName-可变名称，不能为空。
返回：
变量或空，如果变量未定义。
抛出：
org.flowable.common.engine.api.FlowableObjectNotFoundException-当未找到针对给定任务的执行时Id。