ClearQuset 作为变更管理工具，为用户提供了灵活的自定义设置，其中应用于模式（schema）的软件包（package）便是 CQ 提供的帮助用户自定义设置模式（schema），以完成不同功能需求的核心组成部分。本文主要介绍 CQ Package 的功能以及如何应用不同的软件包来完成集成工作模式的配置。

1. 前言

IBM Rational ClearQuest 是业界领先的变更管理工具。变更可以是新的需求、软件缺陷等。 ClearQuest 更能让客户根据自己的具体需求，灵活的设计变更管理流程。客户可以定义变更的字段和值的范围、变更的各种状态、引起状态转换的操作，和变更之间的关系等等。

除此以外，ClearQuest 提供了完成不同功能的各种软件包以帮助用户定制不同需求的功能流程。另外，业界对变更管理工具与其他的软件开发管理工具的集成有着强烈的需求；ClearQuest 不仅与 IBM Rational 其他家族产品有着良好的集成，并且还提供了与其他管理工具的集成，比如，MS Visual SourceSafe（MS VSS）以及 MS ProjectTracker 等等。

ClearQuest 与其它产品的集成大多是通过应用 ClearQuest 提供的相应的软件包（package）来完成的。下面举例介绍 ClearQuest 与配置管理工具 Rational ClearCase，Visual SourceSafe；需求管理工具 Rational RequistPro 的集成部署。

2. ClearQuest Package (软件包) 功能介绍及分类

Package 是 ClearQuest Schema 的组成部分，包括：记录类型（record type）、字段（field）、表单（form）、Tab、Hook&script 以及客户端界面的查询选项（query）；应用软件包到已经存在的 schema 上来完成不同需求的功能实现。这些新的功能也永久的成为这个 schema 的一部分。而 ClearQuest 与其它产品的集成也都是通过应用相应的软件包来实现的。比如：clearcase 就是 ClearQuest 与 Base ClearCase 集成需要应用的软件包；Unified Change Management 是 ClearQuest 与 UCM ClearCase 集成需要应用的；Visual SourceSafe 是 ClearQuest 与 MS VSS 集成需要在 CQ Schema 应用的软件包。ClearQuest 目前提供的所有软件包及其相应功能请参见附录表。

在安装好 ClearQuest 之后，可以查看当前安装 package 的版本及属性；Package 的默认安装路径是：“c:\Program Files\Rational\ClearQuest\package” 存储着 ClearQuest 提供的所有软件包。

如图 1，显示了软件包的存储路径。

所有的这些 Package（软件包），他们实现不同的功能需求，根据不同的功能类别大致可以分为以下几类：

3. CleatQuest 7.0.0 版本的 Package 新功能介绍

在已经发布的 IBM Rational ClearQuest 7.0.0 的新版本中，最大的功能改变就是 ClearQuest core 引入的 Unicode 以及对简体中文和日文的本地化。相应的，ClearQuest Package（软件包）的新功能最显著的当然也是这两方面的改变：

3.1 返回值（return_string）的 Unicode mode 以及 Local mode

ClearQuest7.0.0 对于字符处理采用 unicode，但是由于一些软件包（Package）是用来与其他产品集成使用的，因此对于相应的另一方产品不支持 unicode 字符处理的软件包（Package）还是采用返回值 local mode 的字符处理方式。

ClearQuest 7.0.0 版本的软件包（Pacakge）的字符处理模式如下表：

3.2 简体中文以及日语版本的软件包

ClearQuest 7.0.0 新版本实现了对简体中文和日语的本地化，那么，相应的软件包（Package）也有了相对应的简体中文与日语的版本。代码页如果选择了 936，（参见 “如何在ClearQuest中建立多语言模式库”）那么在 ClearQuest 的软件包应用向导列表中便可以显示版本为 x.y.3 这种格式的简体中文软件包（Package）；相应的，如果代码页选择的是 932，那么在软件包应用想到钟便可以显示版本为 x.y.2 的日语的软件包。当然 ASCII（也就是英文版本）的软件包同样也会显示在应用向导列表中。

如下图 2，图 3 显示的简体中文以及日语版本的软件包：

另外，ClearQuest 7.0.0 版本新增加了一些软件包，来完善更多的功能需求。比如完成对测试用例及测试计划管理的 CQTM，以便在 ClearQuest 中来实现之前 Rational TestManager 的功能；完成部署管理的 DeploymentTracking 以及 TPM（与 IBM Tivoli 集成的软件包）。

4．如何使用软件包向导（Package Wizard）完成软件包的应用

在初步了解了 ClearQuest软件包（Package）的功能之后，我们来了解一下 Package 的具体应用以及部署的步骤。

根据 Package 的不同功能，软件包的应用也分为两种：一种是应用于 schema 生成另外的一些记录类型（record type），来完成本身的需求功能，例如：EnhancementRequest、CrossPlatformSCM，以及在 ClearQuest 7.0.0 新版本中的 CQTM、DeploymentTracking、TPM；另一种是应用于 schema 中的某一些记录类型（比如：Defect），来完成一些扩展的功能或是用这种记录（比如：Defect）与其它产品集成使用，包括我们上面在软件包分类中提到的 General 和集成的这些软件包。

首先我们来看一下对于生成另外的一种或是一些记录类型（record type）的软件包的应用过程：

4.1 检出想应用软件包的 schema

在 ClearQuest Designer中选择检出（check out）想应用软件包的 schema。在菜单项单击“Package”,可以看到菜单列表：

“Package Wizard”: 软件包的应用向导，帮助用户完成对软件包的应用
“Setup Record Types For Packages”: 应用与这个 schema 相关联的 packages 到某个记录类型
“Setup State Types”: 匹配状态类型，比如 UnifiedChangeManagement 是需要匹配状态类型的
“Upgraded Installed Packages”: 升级所应用的软件包的版本，可以使所有的软件包更新到目前最高的版本

4.2 应用向导的软件包列表

选择单击“Package Wizard”软件包的应用向导，来完成 package 的应用。

首先，在软件包列表中选择需要应用的一项，若在列表中没有此 package，可以点击“More Packages”，将会列出 ClearQuest 提供的所有软件包。

之后，点击“下一步”，进入将 package 应用到 schema 或是 schema 中的某些记录类型（record type）的界面；

如图 6 将“EnhancementRequest”应用到 schema，因为 EnhancementRequest 是完成新增记录类型为“EnchancementRequest”的功能，所以在记录类型的列表中不选其他的记录类型，直接点击“完成”，将在检出的 schema 中看见成功应用这个软件包后生成的记录类型。

如图 7 将“AuditTrail”应用到检出的 schema 的某些记录类型，点击完成这个 package 应用于以下这些记录类型，完成审计跟踪的功能。（对于 AudiTrail 的详细功能可以参见 “应用IBM Rational ClearQuest CTSecure 完成电子记录跟踪及电子签名管理”。）

4.3 应用 schema 关联的软件包到某个记录类型

点击“Setup Record Types for Packages”应用与这个 schema 相关联的 packages 到某个记录类型。如图 8 应用 schema 关联的软件包到某个记录类型：

4.4 升级所有软件包版本

点击“Upgrade Installed Packages”, 升级所应用的软件包的版本，可以使所有的软件包更新到目前最高的版本。如图 9 点击升级所有软件包版本：

以上便是，应用软件包向导完成对 Package 的应用的详细说明。在对 Package 的应用机制了解之后，具体介绍一下应用 ClearQuest Package 来部署集成模式环境。

可能会有人有疑问，ClearQuest 提供的预定义的这些 schema 已经部署好了 ClearQuest 的集成环境，像 7.0.0 版本的 Enterprise schema 已经预先部署了 CQTM, UCM 集成环境以及 RequisitePro 需求管理的集成环境。但是，当一个成熟的项目已经建立，并且应用了其他没有部署这些集成环境的 schema，而随着项目的推进有集成其他管理工具的需求时，再去迁移数据库重新更换 schema 是不现实的，因此，应用 ClearQuest 提供的不同功能需求的软件包（Package）是最理想的选择。下面，我们就来具体了解应用 ClearQuest Package 来完成集成环境的部署。

5．应用 CQ Package 完成与配置管理工具的集成

软件配置管理不仅在软件开发过程中起到控制管理的作用，并且可以改进软件开发进程。而配置管理与变更管理工具的集成使用更会完善开发流程，因此 ClearQuest 与配置管理软件的集成也就成了人们关注的问题。ClearQuest 支持的与之集成的配置管理软件为 IBM Rational ClearCase 以及 MS Visual SourceSafe。

首先，来介绍 ClearQuest 与 ClearCase 的集成模式；需要说明的是，本文不再介绍具体的集成环境的部署（可参见 “UCM ClearCase 与 ClearQuest 的集成” 以及 “Base ClearCase 与 ClearQuest 的集成”），本文的关注重点是对于在 ClearQuest 和其他成品集成时对于 ClearQuest Package 的应用部署。

5.1 ClearQuest 与 Base ClearCase 的集成

一个项目不是很大，并且业务流程相对简单的情况下适合用 Base ClearCase；Base CC 不需要设置状态的转换，只需要将 ClearCase Package 应用到 schema 即可完成在 ClearQuest 的集成配置。

5.2 ClearQuest 与 UCM ClearCase 的集成

UCM ClearCase 提供了更加丰富和完善的功能，因而较多的应用于大型软件系统的开发过程中。配置 UCM 的状态需要与 ClearQuest 的状态类型相匹配，因此完成 UCM 的集成应用需要的 Package 有 AMStateTypes（匹配状态类型），UCMPolicyScripts，以及 UnifiedChangeManagement。需要注意的是，完成 UCM 集成功能首先需要完成状态以及状态类型的匹配；因此完成 UCM CC 集成所需要应用的软件包的顺序依次为：首先应用 AMStateTypes -> UCMPolicyscripts -> UnifiedChangeManagment。

应用 AMStateTypes 之后 ClearQuest 会弹出状态匹配的界面：

相对于UCM的四种状态转换（Set Activities, Work on Activities, Deliver Activities, Rebase your workspace），ClearQuest UCM 的状态类型也是由 Waiting, Ready, Active, Complete 组成。

对于“Defect”这种记录类型来说，状态类型的匹配为：

点击完成之后，需要在记录类型的“状态转移矩阵（State Transition Matrix）”中对相应的状态设置默认的转换状态的动作（Default Action）。

点击属性进入设置界面：

每个状态转换到另外状态的默认动作为：

至此，完成了对于 UCM 与 ClearQuest 的状态类型匹配。之后再依次应用 UCMPolicyScripts 以及 UnifiedChangeManagement 两个软件包到这个记录类型，就完成了在 ClearQuest Schema 应用 UCM ClearCase 的集成模式。

5.3 ClearQuest 与 MS Visual SourceSafe 的集成

MS Visual SourceSafe（MS VSS）是为大家所熟知的配置管理工具，ClearQuest 提供了与 VSS 集成的软件包，应用软件包到 schema，即可完成 CQ 与 VSS 集成的 ClearQuest 的部署。值得注意的是，VSS 软件包只能应用到一个记录类型上。

在 ClearQuest 安装路径下有一个应用程序 cqvss.exe，ClearQuest 与 Visual SourceSafe 集成的具体配置就在这个应用程序中完成。

6．应用 CQ Package 完成与需求管理工具的集成

IBM Rational RequisitePro 是一个能够使你在应用被开发之前指定一个应用的需求和特性的工具，可以帮助项目组的成员尤其是项目经理方便的管理和查看需求管理。ClearQuest 与 RequisitePro 的集成可以使成员更方便的管理信息需求，跟踪缺陷管理。通过集成可以使 RequsitePro 的需求和 ClearQuest 的变更请求关联在一起，比如“Defect”这种记录类型。（具体集成环境部署请参见 “IBM Rational RequisitePro 集成简介”）

6.1 应用 RequisitePro Package 到检出的 schema

如图6.1 应用RequisitePro软件包到Defect这种记录类型。

6.2 生成“Requirements_list”字段

双击记录类型的字段（field），在字段列表中选择应用 RequisitPro Package 后生成的一个字段“Requirements_list”，列出其属性；在“Back Reference”一项中填上“Defects_list”。

这是由于，我们可以看到这个由 RequisitePro 软件包生成的字段是“Reference”类型，也就是说它是关联到另外一个记录类型的，从选项看得出它是关联到由 Package 生成的另一种无状态（Stateless）的记录类型“Requirement”；由此我们也可以看得出“Defect”和“Requirement”这两种记录的关联也是通过这两个字段（Requirements_list 以及它的 Back Referent“Defects_list”）来完成的。当填好“Back Reference”这个项后，在它相关联的另一种记录类型的字段中就会出现这个反向引用（Back Reference）的字段；也就是这两种记录类型的关联是通过其中的这两个字段来完成。

如图 15 在记录类型“Defect”的字段“Requirements_list”的属性中添加“Back Reference”（反向引用）项：

如图6.3 查看相关联的记录类型“Requirement”的字段：

之后再检入 schema，就完成了应用 ClearQuest RequisitePro 软件包来完成 CQ 和 RP 集成在 ClearQuest schema 的设置。

7. 总结

本文主要介绍了 ClearQuest 的软件包（Package）的功能、软件包的应用机制以及利用应用软件包（CQ Package）完成 ClearQuest 与其它产品的集成部署，以完成更复杂的功能需求为软件开发提供更完善、有效的管理。但是，集成环境的具体部署本文不再赘述，请参见相关环境部署文章。

8. 附录

ClearQuest 7.0.0 新版本的所有软件包及主要功能列表：

参考资料

• 参考 “如何在ClearQuest中建立多语言模式库”。
• 参考 “应用IBM Rational ClearQuest CTSecure 完成电子记录跟踪及电子签名管理”。
• 参见 “UCM ClearCase 与 ClearQuest 的集成”。
• 参见 “Base ClearCase 与 ClearQuest 的集成”。
• 参见 “IBM Rational RequisitePro 集成简介”。
• 请访问 IBM developerWorks 中国网站 Rational 专区 能得到更多关于 IBM IBM Rational ClearQuest 产品的文章、教程和其他参考资源。