关于“环境”面板

“环境”面板用于为项目创建和管理环境。要查看该面板,请选择环境

“环境”面板中所显示环境的列表

在“环境”面板中,还可以单击环境以显示和编辑其变量。

“详细信息”选项卡

环境属性

指定以下环境属性:

名称
环境的名称。
访问
可使用此环境的用户的访问组。

变量属性

在“环境”面板中,选择变量以查看“变量”面板。使用“变量”面板指定以下属性:

名称
变量名称在名称中只能使用字母数字字符(a-z,A-Z, 0-9)和下划线字符(_)。最大长度为 255 个字节:
  • 单字节字符集:255 个字符
  • 双字节字符集:127 个字符
变量值具有以下特性:
  • 长度:值可以是任意长度(如果操作系统有限制,那么最大长度为操作系统的限制值)。
  • 特殊字符:字符 %、$、[、]、{、}、\、 " 和 ' 对预解析器(操作系统求值前)和操作系统求值而言具有特殊意义。避免使用这些特殊字符。特殊字符的转义使用反斜杠(\)进行传递。请参阅步骤中的变量解释

    如果值用单引号括起,变量名称将作为字面值而不是解释值传递。例如,变量指定 MyEnv='$env' 导致字符串 $env 赋值给 MyEnv 而不是变量 $env 的值。

  • 值中的变量:如果变量位于变量值中,那么在运行使用该变量的步骤时会解释该变量。
  • 下拉值:要指定下拉变量的项,请将变量类型设置为“下拉列表”,保存该变量,然后进行编辑。单击“下拉选项”选项卡可以向下拉列表添加项。请参阅为变量创建下拉列表
  • 用作值的点命令:某些点命令可用作环境变量的值;在这些情况下,系统使用其他值替换点命令。请参阅在变量中使用点命令
  • 回车符:变量不存储回车符。 可将多行值赋予变量,如下例所示。文件 text.txt 的内容赋值给变量 test
    .bset env "test = `type text.txt`"
    文件中的行被并置。例如,假设文件内容如下:
    A first line
    And a second line
    变量的值随后将成为如下所示:
    A first lineAnd a second line
类型
向变量分配以下类型之一:
  • 标准 - 缺省值。可以向变量分配值和操作。
  • 包含 - 变量值指向要包含的另一个环境。该环境中的所有变量都会被包含在内。
    注: “包含”变量类型取代了之前版本中提供的 .include 函数。
  • 下拉列表 - 变量包含一组可供用户选择的值。下拉列表变量创建完毕后,就可以选中它,然后单击下拉选项选项卡来添加值。
操作

选择以下项之一:

  • 设置:缺省选项。向变量分配指定的值。如果变量不存在,会进行创建。
  • 未设置时设置:此操作仅在变量还不存在值时向变量赋值。请参阅关于变量
  • 追加:将值追加到该变量的当前值末尾。在两个值之间添加操作系统特定的 PATH 定界符:
    • Windows:分号(;)
    • UNIX 或 Linux:冒号(:)
  • 前置:将值插入当前值之前。在两个值之间添加操作系统特定的 PATH 定界符:
    • Windows:分号(;)
    • UNIX 或 Linux:冒号(:)
  • 清除:将值设置为空字符串。 如果“值”属性包含值,那么不使用此选项。
  • 删除/取消设置:从当前应用的环境中删除变量。如果“值”属性包含值,那么不使用此选项。
  • 分配隐藏:系统向变量赋值,但在日志中隐藏该值,使其显示为“*****”。使用该选项可向运行项目的用户隐藏变量值。
    要点: 如果将敏感信息存储到隐藏变量中,请谨慎使用该选项。可通过检查数据库或使用 API 客户机来读取隐藏变量的值。对于密码等敏感信息,该选项不安全。

    缺省情况下,“指定隐藏”变量受到保护,无法编辑。不具有“编辑隐藏的标记”许可权的用户不能编辑这些值。 但是,如果他们具有这些许可权,那么可以删除并重新创建这些值。 具有“编辑隐藏的标记”许可权的用户可以直接编辑这些值,但必须重新输入要使用的值。此行为通过将“指定隐藏”变量的类型更改为“设置”,防止用户显示该变量的值。

    注: 如果将步骤中的变量设置为“指定隐藏”,那么该步骤中所有的变量都会视为已设置为“指定隐藏”。
    注: “指定隐藏”变量仅适用于项目。如果将“指定隐藏”变量传递给适配器,那么该变量就不再保持隐藏状态。

    系统通常会将命令行中的变量语法更改为适合您操作系统的相应格式(%VAR% 用于 Windows®,$VAR 用于 Linux® 和 UNIX® 系统)。但是对于隐藏的变量,不进行这种更改。 该变量直接传递到服务器,且服务器的操作系统环境会解释此变量。

    因此,请勿使用可由任意操作系统解析的变量名称。示例:
    • $name:如果此变量设为“指定隐藏”,那么在 UNIX 或 Linus 系统上解释该变量时,操作系统会尝试在其环境中而不是在 Build Forge 环境中对它进行解析。
    • %address%。如果此变量设为“指定隐藏”,那么在 Windows 系统上解释时,操作系统会尝试在其环境中而不是在 Build Forge 环境中对它进行解析。
在项目中
定义手动启动作业时变量的使用方式。 此属性仅影响在分配给项目的环境中使用的变量。在作业运行期间,此属性不会影响变量。值可以是以下选择之一:
  • 正常:变量在分配到项目时行为正常。
  • 必需:变量必须存在值。 具有此属性的变量会在“启动”面板中被突出显示。使用在变量定义中定义的值就可以了。如果值未定义,那么无法快速启动或启动作业。

    如果包含“必需”变量的作业由调度程序而不是用户启动,那么当这些变量当前具有值时会保持不变,当没有值时将为空。

  • 只读:值无法更改。
  • 禁止显示:变量不显示在“启动作业”面板上。但是,变量存在且可用于步骤中。
  • 必须更改:变量值必须更改。具有此属性的顶级变量会在“启动”面板中突出显示;如果未输入新值,就无法快速启动或启动该作业。
    注: 如果包含“必须更改”变量的作业由调度程序而不是用户启动,那么变量值不会更改。此外,如果包含“必须更改”变量的作业由类属性启动,那么变量值不会更改。类属性包含“在清除时启动”、“在进入时启动”和“在退出时启动”。

“快照”选项卡

环境快照是环境的一个实例。“快照”选项卡提供快照名称。使用此选项卡可查看或更改快照名称以及有关快照的注释。


反馈