BuildForge 能够与 Rational ClearQuest 协作以更新构建记录。
Build Forge 与 ClearQuest 具有两种集成方式:
这些功能是完全相互独立的。特别是,适配器与为其创建的环境相关联。该环境中的变量独立于为激活自动构建记录而设置的变量。
系统可以在您的 IBM Rational® ClearQuest® 数据库中自动创建构建记录,并附带指向日志数据的链接。再则,当作业通过时,系统可以更新 ClearQuest 数据库,标注作业已完成、记录结束时间以及完成的步骤汇总。该功能需要 Rational ClearQuest V7.0 或更高版本。
您可以通过特殊环境变量来配置自动更新构建记录。要将项目链接到 ClearQuest 数据库,请确保在项目的环境中包含下表中的变量。
要通过 Build Forge 作业来激活自动更新构建记录,必须为项目设置以下环境变量。它们在步骤级别不起作用。
变量 |
描述 |
---|---|
CQ_DBNAME |
必需。要更新的 ClearQuest 数据库的名称。 |
CQ_DBSET |
ClearQuest 数据库设置值。不是必需的。缺省为空。 |
CQ_INTERACTION |
如果您的项目环境已定义用于启用 ClearQuest 构建记录创建的相应环境变量,而您不希望创建构建记录,请将此变量设置为 OFF 来禁用构建记录创建。 要启用创建构建记录,将此环境变量设置为 ON。 注: 如果要使用 ClearQuest 的任一适配器,将此环境变量设置为 OFF。适配器直接与构建记录交互。
|
CQ_PASSWORD |
必需。登录到 ClearQuest 数据库时使用的密码。不是必需的;缺省为空。 |
CQ_RELEASE_NAME |
必需。ClearQuest 数据库中要更新的发行版的名称。 |
CQ_USER |
必需。用于登录到 ClearQuest 数据库的用户名。 |
ClearQuest 适配器模板样本提供了几种方法来扫描 ClearCase 和更新 ClearQuest 中的构建记录。这通常与 Build Forge 中运行的构建的成功或失败有关。请参阅适配器需求以了解一般需求。另外,需要执行以下配置。
执行以下操作:
您无需安装代理程序。ClearQuest 适配器使用 ClearQuest Perl API,通过客户机直接与 ClearQuest 进行通信。
提供了以下适配器模板样本。
适配器模板中定义的变量:
适配器模板中定义的变量:
适配器模板中定义的变量:
此表引用了适配器模板的变量列表。
变量 |
描述 |
---|---|
ACTIVITIES | 对于 ClearQuestClearCaseByActivity 适配器,这是一组用空格定界的活动标识。示例:SAMPL0001@\ProjectVob |
BFSERVER | 将此变量设置为 Build Forge 控制台的主机名。 |
CQ_PASSWORD |
必需。登录到 ClearQuest 数据库时使用的密码。不是必需的;缺省为空。 |
CQ_USER |
必需。用于登录到 ClearQuest 数据库的用户名。 |
CurDate | 通过使用 .date 命令生成当前日期,以提供给适配器。请不要更改此值。 |
LAST_RUN | 对于 ByDate 适配器,系统使用该值来确定是否发生了任何更改;该值是上一次成功运行的日期。可在测试适配器时操作此值,通过选择在某些更改之前的某个已知日期可强制适配器运行。如果适配器允许运行继续,它将自动把此值更新为当前日期。缺省值为 1-Jan-05.00:00:00。 |
UNIXCLIENT | 用于设置特定于平台的信息。如果客户机运行在 Windows 平台上,请设置为 0。如果客户机运行在 UNIX 或 Linux 平台上,请设置为 1。 |
VIEW | 将此变量设置为要用于适配器的 ClearCase 视图的名称。 |
VOB_PATH | 将此值设置为组件 VOB 的名称及其子目录(子目录可选)。对于多个名称,请使用以逗号分隔的列表。 |
_CHAR_NATIVE | 内部使用并且始终设置为 1。 |
要能够重新启动,您必须使用 ClearQuest 设计器工具编辑 ClearQuest 模式。必须修改 Build 记录的工作流,以允许状态从“已完成”转变为“提交”。