Flowable入门系列文章119 - 进程实例 08

1、更新流程实例上的单个变量

PUT运行时/进程实例/ {processInstanceId} /变量/ {变量名}

表1.更新流程实例上的单个变量 - URL参数

参数	需要	值	描述
processInstanceId	是	串	将流程实例的id添加到变量中。
变量名	是	串	要获取的变量的名称。

请求正文：

{
"name":"intProcVar"
"type":"integer"
"value":123
}

有关变量格式的更多信息可以在REST变量部分找到。请注意，范围被忽略，只有local变量可以在流程实例中设置。

表2.更新流程实例上的单个变量 - 响应代码

响应码	描述
200	指示已找到流程实例和变量，并更新变量。
404	指示未找到请求的流程实例，或者流程实例没有给定名称的变量。状态说明包含有关错误的其他信息。

成功回应机构：

{
"name":"intProcVar",
"type":"integer",
"value":123,
"scope":"local"
}

如果变量是二进制变量或可序列化的，则valueUrl指向一个URL以获取原始值。如果它是一个普通变量，则该值出现在响应中。请注意，只有local范围变量被返回，因为没有global范围的流程实例变量。

2、在流程实例上创建一个新的二进制变量

POST运行时/ process-instances / {processInstanceId} /变量

表3.在流程实例 - URL参数上创建一个新的二进制变量

参数	需要	值	描述
processInstanceId	是	串	创建新变量的流程实例的ID。

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

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

成功回应机构：

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

表4.在流程实例上创建一个新的二进制变量 - 响应代码

响应码	描述
201	指示变量已创建并返回结果。
400	指示要创建的变量的名称已丢失。状态消息提供了附加信息。
404	指示未找到请求的流程实例。
409	指示流程实例已经具有给定名称的变量。使用PUT方法来更新任务变量。
415	指示可序列化的数据包含运行Flowable引擎的JVM中没有类的对象，因此无法反序列化。

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