管理 Exposed Process Value (EPV)
公开的流程值 (EPV) 是在测试,生产或其他运行时环境中的回放服务器或 Workflow Server 上运行流程时,某些用户可以更改的变量。
要查看和管理特定 EPV ,必须向您公开 EPV ,如 创建公开的流程值 (EPV)中所述。
可以管理 EPV 的用户是在流程设计期间确定的。 当流程作者创建 EPV 时,可使用公开设置来选择可以更改 EPV 的用户。 如果您包含在公开设置中,那么就可以按照以下过程中所述管理 EPV。
您可以使用 Process Admin Console 或 REST API 调用来管理 EPV。
重要信息: 为避免影响性能,请删除过去生效且不再是当前值的旧值,如以下过程中所述。
使用 Process Admin Console
- 在 Process Admin Console的 "服务器管理" 区域中,单击 管理工具 旁边的指示符以列出可用选项。
- 单击管理 EPV 选项。
- 使用下拉菜单,选择包含要修改 EPV 的流程应用程序 Snapshot。 所列的各流程应用程序 Snapshot 还包含跟踪名称。 流程应用程序的当前工作版本列示为
Tip,使您能够在回放服务器上测试 EPV 而无需创建 Snapshot。 - 使用下拉菜单,选择要编辑的 EPV。 Process Admin Console 显示 EPV 中可修改的变量值。
- 对于要修改的每个变量,完成以下步骤:
- 单击要更改的变量所在的行,然后单击新建。
- 在“公开的流程值”窗口中输入新值,设置该新值的生效日期和时间,然后单击确定。注: 当在 Process Admin Console中设置或更改 EPV 时,该 EPV 不能为空白值。
注: 可以为同一变量输入多个值,每个值在不同时间生效。 Process Admin Console 在单独的表中显示每个变量的所有修改。 - 要编辑或删除未来生效的 EPV,请选择表中的相应行,然后使用编辑或删除按钮来更改或移除所做的修改。 您无法编辑或删除当前的 EPV 值。
您还可以删除过去具有生效日期且不是当前 EPV 值的旧 EPV。
使用 REST API 调用
调用操作 REST API ACTION:
https://hostname.automationcloud.ibm.com/environment/ops/std/dba/containers/container_acronym/versions/version_acronym/epvs ,其中- ACTION 是 GET 或 POST , container_acronym 是包含目标 Snapshot 的应用程序或 Toolkit 的首字母缩略词, version_acronym 是目标 Snapshot 的首字母缩略词。
- 环境 的值为
dev(对于开发系统) ,test(对于测试系统) 或run(对于生产 (运行时) 系统)。
重要信息: 有关操作 REST API 的详细信息,要尝试从浏览器调用这些 API ,请使用 Swagger 界面。 Swagger 界面位于
https://hostname:ops/explorer ,其中 hostname 是产品预订的名称,例如 https://vhost123.mycloud.com/ops/explorer。以下示例说明了如何使用 REST API 来管理 EPV。
针对应用程序 APP1 的 Snapshot S1 检索 EPV 列表:
GET http://host:port/ops/std/bpm/containers/APP1/versions/S1/epvs- 对于应用程序 APP1、Snapshot S1、Exposed Process Value E1,将变量 PORT 设置为值 9090:
POST http://host:port/ops/std/bpm/containers/APP1/versions/S1/epvs{ "variable_value_details": [ { "epv_name": "E1", "epv_variable_name": "PORT", "epv_variable_value": "9090" } ] } - 将 Exposed Process Value 从应用程序 APP1 的 Snapshot S1 复制到 Snapshot S2:
POST http://host:port/ops/std/bpm/containers/APP1/versions/S1/epvs/sync?target_version=S2