适配器任务概述

本主题涵盖创建源代码适配器,使用适配器链接将其连接到项目和以测试方式运行适配器链接的项目所需的全部任务。

通过选择模板创建适配器

要通过选择模板创建适配器,请执行以下操作:

  1. 选择项目 → 适配器
  2. 单击添加适配器
  3. 在“名称”字段中,为适配器输入唯一名称。适配器名称在整个适配器集合中必须唯一并且不能包含空格。
  4. 在“类型”部分,选择适配器类型。
  5. 在“模板”部分,选择模板。此列表包含随 Build Forge 产品安装的适配器模板。ClearCase 和 ClearQuest 适配器无需单独的许可证密钥。其他适配器则需要通过适配器工具包(Adaptor Toolkit)单独进行许可。
  6. 在“访问”部分,选择一个访问组。只有这些组成员才能查看或编辑该适配器。
  7. 单击保存适配器

创建空环境

要创建空环境,请执行以下操作:

  1. 选择项目 → 环境
  2. 单击添加环境
  3. 在“名称”字段中,输入环境名称。指定一个描述环境的用途的名称。
  4. 在“访问”部分,选择一个访问组。只有这些组成员才能查看或编辑该环境。
  5. 单击保存环境

将适配器添加到项目

要将适配器添加到项目,请执行以下操作:

  1. 选择项目 → 适配器链接
  2. 单击添加适配器链接
  3. 在“适配器”中,选择创建的适配器(以及适配器模板)。
  4. 在“项目”部分,选中此项目。此列表显示尚未链接到适配器的项目。
  5. 在“状态”中,选择活动
  6. 在“环境”中,选择为适配器链接创建的空环境。
  7. 在“填充环境”部分,选择。适配器模板中的应用程序环境变量已添加到环境中。
  8. 单击保存可将适配器链接到项目。 适配器和项目将添加到适配器链接列表中。

编辑环境变量

要编辑环境变量,请执行以下操作:

  1. 选择环境
  2. 对于所创建的环境,单击编辑图标 “编辑”(铅笔)图标。该面板会显示自动添加到环境中的适配器环境变量。
  3. 复审适配器模板提供的环境变量的缺省值。
  4. 根据需要更改您的源代码应用程序的缺省值,以便运行适配器项目。

条件属性

condition 属性允许通过使用 Perl 比较运算符将条件应用于某些适配器属性。字符串文字、数字或变量都可以用于比较。

condition 属性的语法为:

condition="true(<lvalue> <operator> <rvalue>)"
condition="false(<lvalue> <operator> <rvalue>)"
condition="hastext(variable)"
condition="isempty(variable)"

指定以下四种类型之一:

类型 描述
true 如果 lvalue 和 rvalue 相等,那么求值成功。
false 如果 lvalue 和 rvalue 不相等,那么求值成功。
hastext 如果值长度大于 0,那么求值成功。
isempty 如果值长度为 0,那么求值成功。
lvalue 和 rvalue 可以是字符串、数字或包含字符串或数字的变量。条件运算符是任何 Perl 兼容的条件运算符。包括字符串条件运算符和数字条件运算符。您必须使用恰当的运算符,否则您会接收到不可预测的结果。
字符串运算符 数字运算符
eq ==
ne !=
gt >
lt <
ge >=
le <=

对字符串使用数字运算符不会返回正确的结果,对数值使用字符串比较运算符也是如此。

例如:condition="true("PASS"=="FAIL")

上面的条件总是返回 true,这是错误的。

条件示例:
  • condition="true($BF_SERVER eq "TEST_BOX") - 仅当构建服务器变量包含 TEST_BOX 时,才运行该项。
  • condition="false($BF_BID <=141) - 仅当构建标记大于 141 或不小于 141 时,才运行该构建。
支持条件的适配器属性:
  • adduser
  • bom
  • run
  • setenv
仔细检查 Build Forge 当前安装的 DTD 中是否有关于哪些属性支持该条件属性的最新信息。

对于支持条件的属性,会看到类似于下面的条目:

<!ATTLIST adduser condition CDATA #IMPLIED>

适配器 DTD 作为 interface.dtd 文件位于 %BF_HOME%\interface(针对 Windows)和 $BF_HOME/Platform/interface(针对 UNIX)中。

以测试方式运行适配器

要以测试方式运行适配器:

  1. 选择管理 → 系统
  2. 在系统配置参数列表中,选择链接调试方式
  3. 在“链接调试方式”中,选择
  4. 单击保存
  5. 选择作业 → 启动
  6. 在项目列表中,从“启动项目”页面选择创建的,适配器链接的项目。
  7. 单击执行

查看作业状态和日志

要查看适配器项目的作业状态和日志信息:
  1. 打开作业
  2. 在项目列表中找到适配器链接的项目以查看作业的通过/失败状态。
  3. 要查看作业日志:
    • 选择适配器项目的“标记名称”以访问作业日志信息。
    • 选择“材料清单”以访问 BOM 报告。

反馈