Flowable入门系列文章127 - 任务 01

1、获取一个任务

GET运行时/任务/ {taskId}

表1.获取任务 - URL参数

参数	需要	值	描述
任务id	是	串	要获取的任务的ID。

表2.获取任务 - 响应代码

响应码	描述
200	表示找到并返回任务。
404	表示找不到请求的任务。

成功回应机构：

{
"assignee" : "kermit",
"createTime" : "2013-04-17T10:17:43.902+0000",
"delegationState" : "pending",
"description" : "Task description",
"dueDate" : "2013-04-17T10:17:43.902+0000",
"execution" : "http://localhost:8182/runtime/executions/5",
"id" : "8",
"name" : "My task",
"owner" : "owner",
"parentTask" : "http://localhost:8182/runtime/tasks/9",
"priority" : 50,
"processDefinition" : "http://localhost:8182/repository/process-definitions/oneTaskProcess%3A1%3A4",
"processInstance" : "http://localhost:8182/runtime/process-instances/5",
"suspended" : false,
"taskDefinitionKey" : "theTask",
"url" : "http://localhost:8182/runtime/tasks/8",
"tenantId" : null
}

• delegationState：任务的状态，可以null，“pending"或者"resolved”.

2、任务列表

GET运行时/任务

表3.任务列表 - URL查询参数

参数	需要	值	描述
名称	没有	串	只返回给定名称的任务。
nameLike	没有	串	只返回名称类似于给定名称的任务。
描述	没有	串	只返回给定描述的任务。
优先	没有	整数	只返回给定优先级的任务。
minimumPriority	没有	整数	只返回优先级大于给定值的任务。
maximumPriority	没有	整数	只返回优先级低于给定值的任务。
代理人	没有	串	只返回分配给给定用户的任务。
assigneeLike	没有	串	只返回像给定值一样分配给受让人的任务。
所有者	没有	串	只返回给定用户拥有的任务。
ownerLike	没有	串	只返回与给定值一样的所有者分配的任务。
未分配	没有	布尔	只返回没有分配给任何人的任务。如果false通过，则该值被忽略。
delegationState	没有	串	只返回具有给定委派状态的任务。可能的值是pending和resolved。
candidateUser	没有	串	只返回给定用户可以声明的任务。这包括用户是明确候选人的任务，以及由用户所属组织要求的任务。
candidateGroup	没有	串	只返回用户在给定组中可以声明的任务。
candidateGroups	没有	串	只返回给定组中用户可以声明的任务。值以逗号分隔。
involvedUser	没有	串	只返回给定用户参与的任务。
taskDefinitionKey	没有	串	只返回给定任务定义ID的任务。
taskDefinitionKeyLike	没有	串	只返回具有给定任务定义ID的任务，如给定的值。
processInstanceId	没有	串	只返回具有给定id的流程实例的一部分任务。
processInstanceBusinessKey	没有	串	只返回具有给定业务键的流程实例的一部分任务。
processInstanceBusinessKeyLike	没有	串	只返回具有业务键（如给定值）的流程实例的一部分任务。
processDefinitionId	没有	串	只返回具有给定ID的流程定义的流程实例的一部分的任务。
processDefinitionKey	没有	串	只返回具有给定键的流程定义的流程实例的一部分的任务。
processDefinitionKeyLike	没有	串	只返回作为流程实例的一部分的任务，该实例具有与给定值一样的键的流程定义。
processDefinitionName	没有	串	只返回具有给定名称的流程定义的流程实例的一部分的任务。
processDefinitionNameLike	没有	串	只返回流程实例的一部分，该流程实例的流程定义的名称与给定的值相同。
流程id	没有	串	只返回属于给定id的执行部分的任务。
创建于	没有	ISO日期	只返回在给定日期创建的任务。
createdBefore	没有	ISO日期	只返回在给定日期之前创建的任务。
createdAfter	没有	ISO日期	只返回在给定日期之后创建的任务。
由于上	没有	ISO日期	只返回在给定日期到期的任务。
dueBefore	没有	ISO日期	只返回在给定日期之前到期的任务。
dueAfter	没有	ISO日期	只返回给定日期之后到期的任务。
withoutDueDate	没有	布尔	只返回没有截止日期的任务。如果值是，则忽略该属性false。
excludeSubTasks	没有	布尔	只返回不是其他任务子任务的任务。
活性	没有	布尔	如果true只返回没有被暂停的任务（或者是一个没有被暂停或者根本不是某个进程的一部分的进程）。如果为false，则仅返回已暂挂流程实例的一部分任务。
includeTaskLocalVariables	没有	布尔	指示在结果中包含任务局部变量。
includeProcessVariables	没有	布尔	指示在结果中包含过程变量。
tenantId	没有	串	只返回给定tenantId的任务。
tenantIdLike	没有	串	只返回tenantId类似给定值的任务。
withoutTenantId	没有	布尔	如果true只返回没有tenantId的任务。如果false，该withoutTenantId参数被忽略。
candidateOrAssigned	没有	串	选择已声明或分配给用户的任务或等待用户（候选用户或组）申请的任务。
类别	没有	串	选择给定类别的任务。请注意，这是任务类别，而不是流程定义的类别（BPMN Xml中的名称空间）。

表4.任务列表 - 响应代码

响应码	描述
200	表示请求已成功并返回任务
400	指示以错误格式传递的参数，或者delegationState具有无效值（除了挂起和解析）。状态消息包含附加信息。

成功回应机构：

{
"data": [
{
"assignee" : "kermit",
"createTime" : "2013-04-17T10:17:43.902+0000",
"delegationState" : "pending",
"description" : "Task description",
"dueDate" : "2013-04-17T10:17:43.902+0000",
"execution" : "http://localhost:8182/runtime/executions/5",
"id" : "8",
"name" : "My task",
"owner" : "owner",
"parentTask" : "http://localhost:8182/runtime/tasks/9",
"priority" : 50,
"processDefinition" : "http://localhost:8182/repository/process-definitions/oneTaskProcess%3A1%3A4",
"processInstance" : "http://localhost:8182/runtime/process-instances/5",
"suspended" : false,
"taskDefinitionKey" : "theTask",
"url" : "http://localhost:8182/runtime/tasks/8",
"tenantId" : null
}
],
"total": 1,
"start": 0,
"sort": "name",
"order": "asc",
"size": 1
}

上面文章来自盘古BPM研究院：http://vue.pangubpm.com/
文章翻译提交：https://github.com/qiudaoke/flowable-userguide
了解更多文章可以关注微信公众号：