Flowable入门系列文章128 - 任务 02

1、查询任务

POST查询/任务

请求正文：

{
"name" : "My task",
"description" : "The task description",
...
"taskVariables" : [
{
"name" : "myVariable",
"value" : 1234,
"operation" : "equals",
"type" : "long"
}
],
"processInstanceVariables" : [
{
...
}
]
]
}

允许的所有支持的JSON参数字段与获取任务集合的参数（仅在此POST任务查询REST服务中可用的candidateGroupIn除外）完全相同，但作为JSON主体参数而不是URL参数传入以允许更高级的查询和防止太长的请求URI的错误。最重要的是，查询允许基于任务和过程变量进行过滤。的taskVariables和processInstanceVariables是包含与所述格式的对象既JSON阵列如这里所述。

表1.查询任务 - 响应代码

响应码	描述
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
}

2、更新任务

PUT运行时/任务/ {taskId}

身体JSON：

{
"assignee" : "assignee",
"delegationState" : "resolved",
"description" : "New task description",
"dueDate" : "2013-04-17T13:06:02.438+02:00",
"name" : "New task name",
"owner" : "owner",
"parentTaskId" : "3",
"priority" : 20
}

所有的请求值是可选的。例如，您只能在请求主体JSON对象中包含受让人属性，只更新任务的受让人，而不会影响其他所有字段。当明确包含属性并将其设置为空时，任务值将更新为空。例如：{“dueDate” : null}将清除任务的完成）。

表2.更新任务 - 响应代码

响应码	描述
200	表示任务已更新。
404	表示找不到请求的任务。
409	表示请求的任务已同时更新。

成功响应正文：请参阅响应runtime/tasks/{taskId}。

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