配置运行时环境变量

在开发期间,流程作者可以为每个流程应用程序设置环境变量。 某些情况下,在流程设计期间,某一特定环境(测试或生产)的正确的值可能未知。 在这些情况下,您需要在新环境中安装流程应用程序后提供该值。

您可以使用 Process Admin Console 或 REST API 调用来管理环境变量。

使用 Process Admin Console

  1. 登录到 Process Admin Console,然后单击 已安装的应用程序 以显示服务器上当前 Snapshot 的列表。
  2. 单击要使用的 Snapshot。
  3. 在菜单栏中,单击环境变量
  4. 对于所列变量,提供一个值或确保显示的值适用于当前服务器。 如果未列出任何变量,那么在流程开发期间未建立任何变量。

使用 REST API 调用

调用操作 REST API ACTION: https://hostname.automationcloud.ibm.com/environment/ops/std/dba/containers/container_acronym/versions/version_acronym/env_vars 或 REST API ACTION: https://hostname.automationcloud.ibm.com/environment/ops/std/dba/containers/container_acronym/branches/branch_acronym/env_vars ,其中
  • container_acronym 是包含目标 Snapshot 的应用程序或 Toolkit 的首字母缩略词, version_acronym 是目标 Snapshot 的首字母缩略词, branch_acronym 是目标跟踪的首字母缩略词。
  • 环境 的值为 dev (对于开发系统) , test (对于测试系统) 或 run (对于生产 (运行时) 系统)。
重要信息: 有关操作 REST API 的详细信息,要尝试从浏览器调用这些 API ,请使用 Swagger 界面。 Swagger 界面位于 https://hostname:ops/explorer ,其中 hostname 是产品预订的名称,例如 https://vhost123.mycloud.com/ops/explorer。
以下示例说明了如何使用 REST API 来管理环境变量。
  • 检索流程应用程序 APP1 的 Snapshot S1 的环境变量列表:
    GET http://host:port/ops/std/bpm/containers/APP1/versions/S1/env_vars
  • 对于流程应用程序 APP1,Snapshot S1,将环境变量 DEBUG 设置为值 true
    POST http://host:port/ops/std/bpm/containers/APP1/versions/S1/env_vars
    {
      "pairs": [
        {
          "name": "DEBUG",
          "value": "true"
        }
      ]
    }
    
  • 将环境变量从流程应用程序 APP1 的 Snapshot S1 复制到 Snapshot S2:
    POST http://host:port/ops/std/bpm/containers/APP1/versions/S1/env_vars/sync?target_version=S2
  • 对于流程应用程序 APP1 的跟踪 T1 的提示快照,将环境变量 TRACE 设置为值 true
    POST http://host:port/ops/std/bpm/containers/APP1/branches/T1/env_vars
    {
      "pairs": [
        {
          "name": "TRACE",
          "value": "true"
        }
      ]
    }
    
重要: 对 Operations REST API 的所有调用都要求在每次请求中设置 HTTP 标头 BPMCSRFToken 。 有关如何获取令牌的信息,请参阅防止跨站点请求伪造