1、获取执行的变量
GET运行时/执行/ {executionId} / variables / {variableName}?scope = {scope}
表1.获取执行变量 - URL参数
参数 | 需要 | 值 | 描述 |
---|---|---|---|
流程id | 是 | 串 | 执行到变量的id。 |
变量名 | 是 | 串 | 要获取的变量的名称。 |
范围 | 没有 | 串 | 无论是local或global。如果省略,则返回本地变量(如果存在)。如果不是,则返回全局变量(如果存在)。 |
表2.获取执行的变量 - 响应代码
响应码 | 描述 |
---|---|
200 表示找到执行和变量,并返回变量。 | |
400 | 指示请求正文不完整或包含非法值。状态说明包含有关错误的其他信息。 |
404 指示未找到请求的执行或者执行在所请求的作用域中没有具有给定名称的变量(在省略scope-query参数的情况下,变量在本地和全局作用域中不存在)。状态说明包含有关错误的其他信息。 |
成功回应机构:
{
"name":"intProcVar",
"type":"integer",
"value":123,
"scope":"local"
}
如果变量是二进制变量或可序列化的,则valueUrl指向一个URL以获取原始值。如果它是一个普通变量,则该值出现在响应中。
2、在执行上创建(或更新)变量
POST运行时/执行/ {executionId} /变量
PUT运行时/执行/ {executionId} /变量
使用时POST,所有传递的变量都被创建。如果其中一个变量已经存在于请求范围内的执行中,请求会导致错误(409 - CONFLICT)。当PUT使用时,在执行中创建不存在的变量,并覆盖现有的变量,没有任何错误。
表3.创建(或更新)执行上的变量 - URL参数
参数 | 需要 | 值 | 描述 |
---|---|---|---|
流程id | 是 | 串 | 执行到变量的id。 |
请求正文:
[
{
"name":"intProcVar"
"type":"integer"
"value":123,
"scope":"local"
}
]
请注意,您只能提供具有相同范围的变量。如果request-body数组包含来自混合作用域的变量,则请求会产生一个错误(400-BADREQUEST)。 可以将任意数量的变量传递到请求主体数组中。有关变量格式的更多信息可以在REST变量部分找到。请注意,范围被忽略,只有local变量可以在流程实例中设置。
表4.在执行时创建(或更新)变量 - 响应代码
响应码 | 描述 |
---|---|
201 | 指示找到执行并创建变量。 |
400 | 指示请求正文不完整或包含非法值。状态说明包含有关错误的其他信息。 |
404 | 指示未找到请求的执行。 |
409 | 指示已找到执行,但已经包含具有给定名称的变量(仅在使用POST方法时引发)。改用update-method。 |
成功回应机构:
[
{
"name":"intProcVar",
"type":"integer",
"value":123,
"scope":"local"
}
]
上面文章来自盘古BPM研究院:http://vue.pangubpm.com/
文章翻译提交:https://github.com/qiudaoke/flowable-userguide
了解更多文章可以关注微信公众号: