系统在每个作业步骤中自动设置以下变量的值。这些变量是只读的。在步骤日志的 ENV 行中列出了它们在该作业中的值。前四项是项目级别的通知。所有其他 BF_ 变量用于步骤级别。
项目级别的变量 | 值 |
---|---|
BF_D | 日期。可在标记中使用。格式由“标记:日期格式”系统设置决定。 |
BF_J | 当年的第几天。可在标记中使用。 |
BF_T | 时间。可在标记中使用。格式由“标记:时间格式”系统设置决定。 |
BF_W | 星期几,用 0(星期日)到 6(星期六)的数字表示。 |
步骤级别的变量 | 值 |
---|---|
BF_D | 日期。可在标记中使用。格式由“标记:日期格式”系统设置决定。 |
BF_J | 当年的第几天。可在标记中使用。 |
BF_T | 时间。可在标记中使用。格式由“标记:时间格式”系统设置决定。 |
BF_W | 星期几,用 0(星期日)到 6(星期六)的数字表示。 |
BF_AGENT_PLATFORM | 标识运行代理程序的操作系统平台的字符串。 |
BF_AGENT_VERSION | 当前服务器的代理程序的版本号。 |
B | 缺省标记变量,从 1 开始,按每个作业进行递增。可用在以 BF_TAG 表示的标记中。 |
BF_BID | 作业标识号,对于同一个项目的作业而言是唯一的。 |
BF_CALLER_ | 应用于从主调项目传递到链式项目的变量的前缀。 |
BF_CLASS | 项目的 Build Forge 类 |
BF_ENGINE | 唯一标识引擎的字符串。此值也存储在安装目录中的文件中:engine.id。 示例:D8531015-6C07-1014-8CA0-BD58317220B3。 |
BF_HOST | 逻辑服务器的主机名(TCP/IP 主机名)。(该变量是服务器环境的一部分。) |
BF_ITERATION | 成功启动 While 循环中某个步骤的次数。该数目在步骤条件的求值结果为 true 时递增。作业重新启动使用此变量的值作为重新启动的迭代。 |
BF_ITERATION_MAX | While 循环可以运行的最大次数。它在步骤属性中设置。如果达到此迭代次数,那么 BF_ITERATION_MAX_REACHED 设为“是”。 |
BF_ITERATION_MAX_REACHED | 缺省情况下不创建或不设置此变量。当 while 循环迭代达到 BF_ITERATION_MAX 值时,while 循环步骤的步骤唯一标识 (BF_SSID) 会追加到此变量的末尾。如果一个项目中的多个 While 循环步骤达到其 BF_ITERATION_MAX 值,那么此变量包含多个值,每个达到最大迭代次数的步骤都有一个值。 |
BF_LASTGOODRUN | 同一个项目的上一个通过的作业的日期,如果没有通过的作业,就为上一个作业的日期。 |
BF_LASTGOODTAG | 上一个通过的作业(如果没有存储同一个项目通过的作业,就为上一个作业)的标记。 |
BF_LASTGOODUNIX | 与 BF_LASTGOODRUN 相同,但是以 UNIX® 格式的日期表示。 |
BF_LASTRUN | 当前作业上一次运行的日期。 |
BF_LASTTAG | 同一个项目的前一个作业的标记字符串。 |
BF_LASTUNIX | 与 BF_LASTRUN 相同,但是以 UNIX 格式表示日期。 |
BF_ONFAIL | 步骤的“暂停/继续”标志。 |
BF_PID | 项目标识号。 |
BF_PROJECTNAME | 此作业的项目名称。 |
BF_PROJECTNAME_PHYS | 用于创建项目目录的项目名。系统将无效的相对目录字符系统设置中指定的字符更改为下划线字符,以创建项目目录。例如,如果此设置包含空格,那么名为 My Project 的项目会得到名为 My_Project 的项目目录。 |
BF_ROOT | 作业的基本工作目录,来源于作业属性。另请参阅 BF_STEP_ROOT。 |
BF_SERVER | 运行当前作业的服务器的名称(该变量是服务器环境的一部分)。 |
BF_SERVER_ROOT | 在服务器属性中分配给逻辑服务器的路径(该变量是服务器环境的一部分)。 |
BF_SID | 构建内步骤结果的序号。 |
BF_SPID | 如果当前作业被另一个作业调用,此变量包含主调项目的标识。否则,此值与 BF_PID 相同。 |
BF_STEPNAME | 步骤名称。在步骤属性中设置。 |
BF_STEP_ROOT | 步骤的基本工作目录,来源于步骤属性。另请参阅 BF_ROOT。 |
BF_SSID | 步骤标识,是项目中当前步骤的唯一标识。 |
BF_TAG | 作业标记。标记定义可以包含变量。此变量包含的值是通过启动作业时对这些变量进行解释而得到的。 |
BF_TAG_PHYS | 作业标记,用下划线替换 BF_TAG 值中存在的任何空格。如果选择了步骤的“绝对”选项,那么 BF_TAG_PHYS 与 BF_TAG 的作用相同。 |
BF_USER | 作业所有者的用户名。 |