Flowable入门系列文章132 - 任务 06

1、在任务上创建新的变量

POST运行时/任务/ {taskId} /变量

表1.在任务上创建新变量 - URL参数

参数	需要	值	描述
任务id	是	串	创建新变量的任务的ID。

创建简单（非二进制）变量的请求主体：

[
{
"name" : "myTaskVariable",
"scope" : "local",
"type" : "string",
"value" : "Hello my friend"
},
{ }
]

请求主体应该是一个数组，其中包含一个或多个代表应该创建的变量的JSON对象。

• name：变量的必需名称
• scope：创建的变量的范围。如果省略，local则假定。
• type：创建的变量的类型。如果省略，则还原为原始JSON值类型（字符串，布尔值，整数或双精度）。
• value：变量值。

有关变量格式的更多信息可以在REST变量部分找到。

成功回应机构：

[
{
"name" : "myTaskVariable",
"scope" : "local",
"type" : "string",
"value" : "Hello my friend"
},
{ }
]

表2.在任务上创建新变量 - 响应代码

响应码	描述
201	指示变量已创建并返回结果。
400	指示要创建的变量的名称丢失，或者尝试在独立任务上创建变量（没有与进程关联），global或者在请求中包含变量的空数组，或者请求中未包含数组的变量。状态消息提供了附加信息。
404	表示找不到请求的任务。
409	表示任务已经有一个给定名称的变量。使用PUT方法来更新任务变量。

2、在任务上创建一个新的二进制变量

POST运行时/任务/ {taskId} /变量

表3.在任务 - URL参数上创建一个新的二进制变量

参数	需要	值	描述
任务id	是	串	创建新变量的任务的ID。

请求正文：
该请求应该是类型的multipart/form-data。变量的二进制值应该包含一个文件部分。最重要的是，可以存在以下附加的表单字段：

• name：变量的必需名称。
• scope：创建的变量的范围。如果省略，local则假定。
• type：创建的变量的类型。如果省略，binary则假定该请求中的二进制数据将被存储为一个字节数组。

成功回应机构：

{
"name" : "binaryVariable",
"scope" : "local",
"type" : "binary",
"value" : null,
"valueUrl" : "http://.../runtime/tasks/123/variables/binaryVariable/data"
}

表4.在任务上创建一个新的二进制变量 - 响应代码

响应码	描述
201	指示变量已创建并返回结果。
400	指示要创建的变量的名称已丢失，或者尝试在范围内的独立任务（没有关联进程）上创建变量global。状态消息提供了附加信息。
404	表示找不到请求的任务。
409	表示任务已经有一个给定名称的变量。使用PUT方法来更新任务变量。
415	指示可序列化的数据包含运行Flowable引擎的JVM中没有类的对象，因此无法反序列化。

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