Jazz技术平台问世以来，一直着力打造不受地理限制、面向全球、共同构建的软件协作平台。基于该平台的产品将能为团队软件开发和交付提供一个丰富的功能集合，Rational Team Concert便在这种情况下应孕而生。什么是Rational Team Concert（以下简称RTC）？其具备了实时性、信息共享性，基于服务器/客户端的架构使其非常适合用于企业的协作和集成，除此之外，它所提供的流程配置和定制特性，也使其成为您管理项目的得力助手。

在Rational家族中，也有一款用于项目需求变更管理的老成员ClearQuest。如何将其二者有效的结合呢？本文将介绍ClearQuest连接器的工作原理及其使用，它能帮助您同时在两个工具中共享数据，完成二者之间的信息共享。

ClearQuest连接器简介及工作原理

1.1环境要求

在使用ClearQuest连接器之前，需要对安装环境有所要求：

1）使用ClearQuest连接器必须安装Rational Team Concer标准版

2）安装ClearQuest版本必须在7.0.1或更高版本

1.2 ClearQuest配置概要

ClearQuest连接器需要通过ClearQuest网关与Jazz Team Server进行通信，建立相关的同步规则，将ClearQuest记录连接到一个或多个Jazz项目区域相关联的工作项。如图：

安装有几点注意事项：

1）Jazz Team Server与ClearQuest并不强制要求安装在同一台电脑上，一台或不同物理机都可以。

2）ClearQuest网关只能连接一个数据库或是数据库副本。

3） 为了使Jazz Team Server与ClearQuest之间能顺利同步，需要在ClearQuest端与Jazz Team Server中授权用户ClearQuest连接器或开发者许可证，该用户可以同时登陆到ClearQuest和Jazz中。

4）为了能够对ClearQuest数据库中的记录类型进行同步，需要在修改ClearQuest端的数据库，添加JazzInterop包。将该包从install-directory/gateway/cqPackage/JazzInterop文件夹中拷贝到cq-install-dir/packages中，在ClearQuest Designer客户端升级完成后便可以生效了。

然而，要想让ClearQuest与Jazz Team Server完全同步，上面的工作仅仅只完成了三分之一。我们还需要对ClearQuest的查询目录层次结构以及ClearQuest连接器的服务参数进行修改，具体的修改方法可以查询Jazz.net社区上的相关资料。本文在这里就不着墨多介绍了。

1.3同步规则

同步是完成二者信息共享一个很重要的操作，ClearQuest连接器只有在执行了同步操作后，才能完成Jazz Team Server与ClearQuest之间的数据共享。同步规则即是指定Jazz项属性如何映射到ClearQuest记录字段。这个映射是具有方向的，传入同步定义如何将ClearQuest记录所作的更改应用到Jazz项中，而传出同步定义如何将Jazz项中的更改应用到ClearQuest记录上。每个ClearQuest记录类型到Jazz类型的映射都需要唯一的同步规则。

这里我们以Defect记录类型为例。

首先，创建一个"外部代理"cqconnector，输入ClearQuest的网关信息，如图：

接下来，创建同步规则。在Jazz端需要确认工作项的相关信息，在"Type Mapping"选择要同步的工作项。补充一下，这里要求其所属的Project Area应用的process是Eclipse way。确定了这些后，看看应该如何选择"Type Mapping"，在本例中：

Item type: WorkItem-com.ibm.team.workitem
Item type qualifier: TypeCategory: workItemType-com.ibm.team.workitem
Item manager: Work Item Manager
External repository:cqconnector
External manager:ClearQuest Manager(non-user records)
External type: com.ibm.rational.clearquest.Defect

而后，将Jazz中Defect的工作项与ClearQuest中的Defect属性相互匹配，在"Property Mappings"中，匹配需要非常小心，漏掉一个或错了一个都可能造成同步失败。大家可以参考\connectors\gateway\sample\syncRules下以xml格式存储的同步规则，也可以直接导入这些同步规则，如图：

实例演示

这里有一个已经配置好的ClearQuest数据库"Jazz"和Jazz同步规"cqconnector"。

为了确认当前双方的配置是正常的，需要利用网关服务器进程查看，在浏览器中键入http://localhost:8081/InteropGateway，查看ClearQuest连接器网关的相关信息。可以检查ClearQuest Database信息，Jazz Team Server信息以及目前Polling Information目前是否Polling Enabled: true。

以cqconnector/cqconnector身份登录ClearQuest，在ClearQuest中新建一个Defect，"test connector"，如图：

登录RTC客户端，在Work Items的"Recently created"查询中，查询是否有刚创建的defect，很明显刚刚创建的Defect "test connector"赫然出现在查询结果中。

现在再在RTC中对该defect的priority进行修改，由"Low"到"Medium"。刷新ClearQuest客户端，现在这个defect的priority应由"4-low priority"变为"3-Normal Queue"，这样就完全同步成功了。

客户还可以在RTC中直接查看同步信息，选中同步记录，显示其"Synchronization status"：