关于“环境”面板

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

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

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

“详细信息”选项卡

环境属性

指定以下环境属性:

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

变量属性

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

名称
变量名称在名称中只能使用字母数字字符(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:冒号 (:)
  • 清除:将值设置为空字符串。 如果“值”属性包含值,那么不使用此选项。
  • 删除/取消设置:从当前应用的环境中删除变量。如果“值”属性包含值,那么不使用此选项。
  • 指定隐藏:值在数据库中加密,并在日志和用户界面中显示为“*****”。 使用该选项存储敏感信息。

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

    如果环境变量的操作值是指定隐藏,那么无法更改变量的类型值和操作值。如果环境变量的操作值不是指定隐藏,那么无法将操作更改为指定隐藏

    指定隐藏环境变量不能与 7.1.x 代理程序一起使用。如果要使用指定隐藏环境变量,请将代理程序更新至相应的版本。例如,如果控制台版本是 8.0.0.1,那么请将代理程序版本更新至 8.0.0.1。

    注: 增加值长度将使其更安全。
    注: 如果您具有先前的“指定隐藏”变量,那么可以编辑并重新保存,以在 Build Forge® 用户界面“环境”页面中对其进行加密。您还可以选择使用 bfassignhiddenmigration 实用程序以批处理方式加密。 Build Forge 8.0 安装将不会更改指定隐藏值。如果未重新保存或升级 Build Forge 7.x 发行版的旧的指定隐藏变量值,那么将无法使用新的指定隐藏功能。 此行为与在 7.x 发行版中使用 Perl 引擎是相同的,但在新的 Java™ 引擎步骤日志中以明文提供指定隐藏值。建议您重新保存旧的指定隐藏值,或使用 bfassignhiddenmigration 实用程序对所有指定隐藏值进行加密。有关 bfassignhiddenmigration 实用程序的更多信息,请参阅主题 bfassignhiddenmigration 引用
    注: 如果将步骤中的某个变量设置为指定隐藏,那么该步骤中的其他变量会缺省为“指定隐藏”。
    注: 如果在 Build Forge 7.x 中使用多字节字符系统 (MBCS) 字符(例如,中文、日语或韩国语)设置指定隐藏变量,那么隐藏迁移实用程序将不会自动升级。建议您将变量替换为 ASCII 字符以提高安全性。如果未能执行此操作,那么会阻止您体验新的指定隐藏变量,因为这些行为与 Build Forge 7.x 相同。
在项目中
定义手动启动作业时变量的使用方式。 此属性仅影响在分配给项目的环境中使用的变量。在作业运行期间,此属性不会影响变量。值可以是以下选择之一:
  • 正常:变量在分配到项目时行为正常。
  • 必需:变量必须存在值。 具有此属性的变量会在“启动”面板中被突出显示。使用在变量定义中定义的值就可以了。如果值未定义,那么无法快速启动或启动作业。

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

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

“快照”选项卡

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


反馈