118 - 进程实例 07

Posted 2022-02-08 分享牛

1、获取流程实例的变量

GET运行时/进程实例/ processInstanceId /变量/ 变量名

表1.获取流程实例的变量 - URL参数

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

表2.获取流程实例的变量 - 响应代码

响应码	描述
200	指示已找到流程实例和变量，并返回变量。
400	指示请求正文不完整或包含非法值。状态说明包含有关错误的其他信息。
404	指示未找到请求的流程实例，或者流程实例没有给定名称的变量。状态说明包含有关错误的其他信息。

成功回应机构：

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

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

2、在流程实例上创建（或更新）变量

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

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

使用时POST，所有传递的变量都被创建。如果流程实例中已经存在其中一个变量，则请求会导致错误（409 - CONFLICT）。何时PUT使用，在流程实例上创建不存在的变量，现有的变量将被覆盖而不会出现任何错误。

表3.在流程实例上创建（或更新）变量 - URL参数

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

请求正文：

[

“名”： “intProcVar”
“类型”：“整数”
“值”：123
，
...
]

任何数量的变量都可以传递到请求主体数组中。有关变量格式的更多信息可以在REST变量部分找到。请注意，范围被忽略，只有local变量可以在流程实例中设置。

表4.在流程实例上创建（或更新）变量 - 响应代码

响应码	描述
201	指示已找到流程实例并创建变量。
400	指示请求正文不完整或包含非法值。状态说明包含有关错误的其他信息。
404	指示未找到请求的流程实例。
409	指示已找到流程实例，但已经包含具有给定名称的变量（仅在使用POST方法时引发）。改用update-method。

成功回应机构：

[

“名”：“intProcVar”
“类型”：“整数”，
“值”：123，
“范围”：“本地”
，
...
]

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