更新 ClearQuest 构建记录

您可以将系统与 Rational ClearQuest 集成,以自动创建和更新 ClearQuest 数据库内的构建记录。

系统可以在您的 IBM Rational® ClearQuest® 数据库中自动创建构建记录,并附带指向日志数据的链接。再则,当作业通过时,系统可以更新 ClearQuest 数据库,标注作业已完成、记录结束时间以及完成的步骤汇总。该功能需要 Rational ClearQuest V7.0 或更高版本。

注: 要成功创建构建记录并用构建相关信息填充该记录,您必须先打开 ClearQuest 维护工具并建立与数据库的连接。
当您将项目配置为更新 ClearQuest 数据库时,系统执行以下步骤:
作业启动
当系统启动一个作业时,系统将创建一个 ClearQuest 构建记录。构建记录处于“已提交”状态,其中包含作业日志 URL、开始时间、发行版名称、标识以及表明“Build XYZ started.”的日志条目。如果源控制适配器取消了作业(例如,由于找不到任何源更改),那么不会创建任何 ClearQuest 构建记录。
注: 如果某项目链向其他项目,那么新项目将获取其自己的唯一 ClearQuest 构建标识。
作业通过/失败
当作业通过或失败时,系统会将 ClearQuest 中的构建状态更改为“已完成”或“失败”,设置构建结束时间,并在 ClearQuest 构建日志中存储作业步骤的摘要。该摘要包含每个步骤的名称、结果状态和服务器。
作业重新启动
当作业重新启动时,系统会将 ClearQuest 中的构建状态更改为“已提交”,并创建一个 ClearQuest 构建日志条目指出“已重新启动构建 XYZ”。

您可以通过特殊环境变量配置 ClearQuest 集成。要将项目链接到 ClearQuest 数据库,请确保在项目的环境中包含下表中的变量。

注: 项目环境中必须有这些变量。将它们添加至某个步骤还不够。但可以使用设置为“包含”类型的变量,这一类型通过另一个环境来包含这些变量。此外,由于 CQ_RELEASE_NAME 值是唯一可能随项目而变化的值,因此您可能希望创建一个环境来包括其他变量,并使用“包含”类型的变量将该环境包括在项目环境中,您还可在其中将 CQ_RELEASE_NAME 指定为特定于项目的环境变量。
表 1. Rational ClearQuest 集成所需的环境变量

变量

描述

CQ_DBNAME

要更新的 ClearQuest 数据库的名称。

CQ_INTERACTION

如果您的项目环境已定义用于启用 ClearQuest 构建记录创建的相应环境变量,而您不希望创建构建记录,请将此变量设置为 OFF 来禁用构建记录创建。

要启用创建构建记录,将此环境变量设置为 ON。

注: 如果要使用 ClearQuest 的任一适配器,将此环境变量设置为 OFF。

CQ_USER

用于登录到 ClearQuest 数据库的用户名。

CQ_RELEASE_NAME

ClearQuest 数据库中要更新的发行版的名称。

CQ_PASSWORD

登录到 ClearQuest 数据库时使用的密码。不是必需的;缺省为空。

CQ_DBSET

ClearQuest 数据库设置值。不是必需的;缺省为空。


反馈