内容

• 引言
• 前提条件
• 禁止外向的同步化
• 为外部性用户配置同步化规则
• 映射 Comments 和 Notes 字段
• 匹配 Rational Quality Manager 工作流程与 Rational ClearQuest 转换模型
• 映射命令字段
• 设置同步化时间
• 故障排除同步化问题
• 集成，同步化，并为后续操作做好准备
• 参考资料

引言

运行 ClearQuest Connector 安装配置向导只是集成 IBM® Rational® Quality Manager 与 IBM® Rational ClearQuest® 的开始。在运行完安装配置向导之后，您需要安排 Rational Quality Manager 工作流程与 Rational ClearQuest 状态转变模型，这样 Rational Quality Manager 中的状态就会与 Rational ClearQuest 中的状态相匹配了。您还需要将 Rational ClearQuest 记录中的命令字段映射到 Rational Quality Manager 中相应的字段。Rational Quality Manager 有一个内构性的缺陷追踪系统，但是有一些用户可能会继续使用 ClearQuest 来追踪缺陷。当测试团队在 Rational Quality Manager 中输入缺陷时，ClearQuest Connector 要么创建要么同步化 Rational ClearQuest 中缺陷的拷贝。与之类似，当用户在 Rational ClearQuest 中提交或者编辑一项缺陷时，Rational Quality Manager 中缺陷的拷贝会与 Rational ClearQuest 中的缺陷保持同步化。

前提条件

在继续剩下的操作之前，请确定您已经安装了 Rational ClearQuest，并设置了方案与用户数据库。确认在您的电脑上安装了 ClearQuest Connector，而且这台电脑上已经安装了 Rational ClearQuest。（您可以从 Jazz.net 下载 ClearQuest Connector）。（参照 wiki 中“演示：运行 Setup Wizard”部分中的安装配置步骤”）。

IBM Rational Team Concert™ 客户端必须安装在一个可以通过网络访问 Rational Quality Manager 服务器的电脑上。（您可以从 Jazz.net 网站下载 Rational Team Concert 客户端）。

在您查看来自前面提到过的安装配置向导连接器时，可以启动 Rational Quality Manager 服务器与 ClearQuest Gateway。为了完成集成操作，您可以按照下面的程序来在 Rational Quality Manager 工作流程中做进一步的配置工作。

禁止外向的同步化

在继续之前，您可以暂时性地禁止外向的同步化 ：

1. 启动 Rational Team Concert 客户端，并使用客户端来连接到 Rational Quality Manager 项目区域。
2. 如果 Rational Team Concert 中的欢迎界面打开的话，您就关掉页面。
3. 在 Rational Team Concert 客户端的左边，您可以右击 Team Artifacts 中的用户 ID，然后点击 Administer > Synchronization Rules， 如图 1 所示。这个部分在 Rational Team Concert 客户端的底部附近打开一个视图。

4. 展开 External Repository Connections。
5. 右击显示的连接，并选择如图 2 所示的 Open。外部性连接会作为 ClearQuest Connector 安装配置向导的一部分设置。

6. 在打开的对话框中，选择 禁止自动的外向同步化，如图 3 所示，然后点击 OK。

为外部性用户配置同步化规则

ClearQuest Gateway 使用连接用户，来在 Rational ClearQuest 和 Rational Quality Manager 之间交流。如果对于外部性用户的配置并没有创建起来，那么用户提交或者编辑的所有缺陷，都会与一个连接用户联系起来。但是，您可以配置 ClearQuest Connector，这样缺陷编辑就会与作出更改的实际用户联系起来：

1. 在 Rational Team Concert 的 Synchronization Rules 部分中，右击与 Defect 相应的规则，并选择 Open（参见图 4）。

2. 在 Property Mappings 部分中，点击 Add。Property Mappings 对话框就会打开了。
3. 在 选择一个外部性属性以进行映射 中，点击 已存在的或者定义的用户 ，选择 modifiedBy，，然后选择 External modifier，如图 5 所示。
4. 点击 OK，然后点击 Save。

映射 Comments 和 Notes 字段

客户一般会向缺陷添加评论，以从提交器那里请求更多的信息或者进一步研究缺陷。您需要将 Rational Quality Manager 中的 Comment 字段映射到 Rational ClearQuest 中的 Notes 字段：

1. 在 Property Mappings 部分 Rational Quality Manager 中，点击 Add。
2. 在第一个列表中，选择 Comments。
3. 在第二个列表中，选择 In/Out。
4. 在第三个列表中，选择 Notes_Log，然后点击 OK（参见图 6）。

5. 在 Property Mappings 部分中，清除 No Transformation（只是复制） 复选框的选择。
6. 为 引用同步化规则列表中的用户切换并为用户选择同步化规则：com.ibm.rational.clearquest.users.Quality Manager（参见图 7）。
7. 从 Value Transformer 列表中，选择 Work Item Comments Transformer，如图 7 所示，然后点击 Save。

图 7. 配置同步化规则

匹配 Rational Quality Manager 工作流程与 Rational ClearQuest 转换模型

Rational Quality Manager 中的“工作流程” 类似于 Rational ClearQuest 中的状态转变模型。两款产品中的状态与值需要得到匹配，这样同步化就可以顺利地进行了：

1. 在 Rational Team Concert 客户端的左边，右击项目区域，如图 8 所示，然后选择 Open。

2. 点击 Process Configuration 项（参见图 9）。
3. 展开 Process Configuration，展开 Configuration Data，并展开 Work Items（高级）。
4. 选择 Workflows（参见图 9）。

5. 在工作流程的 Transitions 部分中，将 Rational Quality Manager 状态与操作映射到 Rational ClearQuest 记录中的状态。
6. 选择需要的操作，以作出从一个状态到另一个状态的转变。例如，参见图 10。对于从“In Progress”状态变为“Closed”状态的用户来说，用户必须选中 Close。

图 10 的大图

7. 如果转变是允许的，但是列表并没有包含合适的操作，您可以选择 New Action 来添加一个操作。
   在图 11 中，用户会允许从“In Progress”到“Duplicate”的转变。但是，Rational Quality Manager 尚没有允许该转变的操作。您可以通过点击列表来添加一项操作，并选择 New Action。对于同样新的操作，您创建一个名为 Duplicate 的操作，以允许从 “Progress”状态到“Duplicate”状态的转变。

图 11 的大图

8. 如果一项转变不被允许的话，您可以选择 None 作为转变的操作。在图 12 中，用户不能将“In Progress”状态转变为 “Duplicate”状态，这样这里的操作就会设置为 None。

9. 对于从“In Progress”的其他转变，确认转变对您来说是否合适。如果在 Rational ClearQuest 中并不支持转变，那么您可以选择 None。
10. 继续浏览整行，并确定对每一个单元都设置了合适的操作。使用 Tab 键来从行中的一个单元跳到另一个单元中。
11. 为了添加，删除，或者编辑状态，您可以切换至 Transitions 之后的 States 部分。查看图 13。

图 13 的大图

12. 为了添加、删除或者编辑解决方案，您可以切换至 Resolutions 部分，参见图 14。

图 14 的大图

13. 切换至 Actions 部分，并确认所有的操作满足了您的需要；然后按照您的需要来做出更改。参见图 15。

图 15 的大图

映射命令字段

当您必须输入命令字段时，两个产品有着不同的需要。默认条件下，在 Rational Quality Manager 中当您将缺陷从“New”（Submitted）状态转化为“In Progress”（Assigned）状态时，没有必要为缺陷指定一个拥有者。但是，当您在 Rational ClearQuest 中将一个缺陷从“Submitted”状态转化为“Assigned”状态时，您必须指定一个拥有者并设置优先级。图 16 中的信息，显示了需要设置的 Owner 与 Priority 字段，以将字段更改为“In Progress”状态。

图 16 的大图

为了解决这个问题，更改 Rational Quality Manager 中的模型以让这个区域变为强制性执行：

1. 从您在前面步骤中使用的 Process Configuration 页面中，展开 Team Configuration，然后选择 Operation Behavior，如图 17 所示。

2. 在编辑器的中部，找到 Operation Behavior 部分。切换至 Work Items 部分，并选择 Everyone 列中的图标（参见图 18）。

图 18 的大图

3. 进一步切换至 Work Items 部分，并选择 Required Properties（参见图 19）。

图 19 的大图

4. 切换至 Category 或者 Type 部分，如图 20 所示，并选择 com.ibm.team.workItem.workItemType。
5. 点击条目左边的加号（+）来展开 com.ibm.team.workItem.workItemType 项目。

图 20 的大图

6. 在 Category 或者 Type 部分中，下拉并展开 Defect 项目，然后选择 In Progress。
7. 点击 Edit，如图 21 所示。

图 21 的大图

8. 在打开的 Edit Defect 对话框中，选择 Owned By 和 Priority。当用户在“Assigned”（发展中）状态中输入一个缺陷时，这两个字段 Rational ClearQuest 都需要。
9. 点击 OK，然后点击 Save。
10. 选择该部分中显示的其他行，如 Closed 或者 Resolved，并当状态中存在缺陷时，指定 Rational ClearQuest 需要的强制性区域。
11. 在您完成早期的阶段之后，点击页面底部的 外部性储存库连接 条目（参见图 22）。

12. 清除 禁止自动输出同步化 复选框的选择，来允许输出的同步化，如图 23 所示。

同步化再次激活，您更改了转换模型以满足自己的需要。您可能仍然想要进一步地调整环境。当您需要调整同步化规则，或者状态转化模型（工作流程）时，您可以返回至如图 23 所示的对话框，并选择 禁止自动输出同步化 以临时禁止自动化。

设置同步化时间

您要独立地为每一个产品设置同步化延迟时间。

在 Rational Quality Manager 中，您在 Jazz 服务器管理页面上中的 Advanced Properties 部分中设置同步化时间：

1. 在浏览器（Internet Explorer 7 或者 Firefox 3.0 或者更新的版本）中打开 Rational Quality Manager，并用管理员权限的用户登录上。
2. 在 Rational Quality Manager 主页面的右上部，点击 Admin > Jazz Server Administration。
3. 在页面的左边，点击 高级属性 连接。
4. 当页面打开以后，您可以搜索 interop 以快速移动到 Item Interoperation 部分。
5. 在这个部分中，确定 外向同步化激活 区域被设置成 true。
6. 将 外向同步化任务固定延迟时间 区域设置为一个较小的值，比如说 10，单位是秒。默认条件下该值被设置为 300 秒。
7. 翻到页面的顶部，并点击 Save。

对于 Rational ClearQuest，您要设置 Connector Gateway 中的同步化时间。

1. 切换至 Rational Team Concert Connector Gateway 安装的位置。
2. 切换至 RTC-CQConnector-Install dir\jazz\connectors\gateway 文件夹中的 cqconnector.properties 文件。
3. 打开 cqconnector.properties 文件，并将值设置为 10 秒，如以下的行所示，然后保存文件。com.ibm.rational.interop.pollingPeriod=10
4. 如果 Connector Gateway 已经运行的话，那么就将其关掉，然后重启以让更改发生效果。

故障排除同步化问题

有时同步化功能由于很多原因可能不会正常发挥作用。此时可以可以使用 Rational Team Concert 客户端来找到故障产生的原因。

当一项缺陷不能与其他部分同步化时（假设固定的延迟时间已经通过了），那么您可以完成以下的程序：

1. 右击 Rational Team Concert 中的 Defect synchronization rule，并选择 Show Unsynchronized（参见图 24）。

Synchronization Status 页面如图 25 和图 26 那样打开。

2. 双击同步化失败的项目，并读取关于怎样解决问题的错误信息。您可能需要暂时地停止自动的同步化，如前面介绍的那样。在完成更改之后，您要确保重新激活同步化功能。

图 26 的大图

3. 您要一直调整同步化规则以及转化模型，并检查未同步化的项目，直到可以输入缺陷且不产生错误的情况下进行更改为止。
4. 检查缺陷中的所有可能状态，以确保两种产品可以同步化所有的状态，而且不会产生错误。您还可以在 Rational Team Concert 帮助中搜索帮助项以得到进一步的具体信息。

集成，同步化，并为后续操作做好准备

运行 ClearQuest Connector 安装配置向导会为集成打开大门。但安装配置向导并不会检测到您的工作流程以及记录缺陷的需要。因此，在 ClearQuest Connector 安装配置完毕之后，您还需要描述环境，并调整所设定的环境参数，以便 Rational Quality Manager 与 Rational ClearQuest 可以协同工作。按照上面的步骤，两个应用程序将会协同工作，以保持集成的连接、同步化和高效率。

参考资料

学习

• 查看 Rational Team Concert 信息中心 的“开始使用 ClearQuest Connector”章节。
• 查看 IBM® developerWorks® 上的 Rational Quality Manager 产品专题 页面，可以查找到产品文档、文章、教程、课程、下载，以及其它有用的区域。
• 查看 Rational Quality Manager 信息中心 的技术指南。
• 如想寻找相关的提示说明，请阅读 Michael Kelly 在 developerWorks 上的文章：
  • 开始使用 IBM Rational Quality Manager（2008 年 12 月）
  • 使用 IBM Rational Quality Manager 管理您的第一个项目（2008 年 10 月）。
• 了解 IBM 质量管理解决方案 页面，学习更多相关内容。
• 在 IBM Rational 软件交付平台 中了解其它应用程序，包括适用于并行开发和地域分布式团队的协作工具，以及用于架构管理、资产管理、变更和发布管理，集成需求管理、过程和组合管理，和质量管理。
• 访问 developerWorks 上的 Rational 专区，了解有关 Rational 软件交付平台产品的技术资源和最佳实践。
• 查找 Rational 基于计算机、基于 Web，以及在线指导课程。训练您的技能，并学习更多有关 Rational 工具的课程，包括入门级和高级课程。在此目录上的课程可进行购买，包括基于计算机的和基于 Web 的培训。此外，一些“入门”课程是免费的。
• 订阅 IBM developerWorks 时事通讯，获得有关最佳的 developerWorks 教程、文章、下载、社区活动、网络广播和事件的每周更新。

获得产品和技术

• IBM Rational Team Concert（RTC）是一个基于 Jazz 平台技术的实时协作式软件交付环境，可以帮助跨地域分布的开发团队简化协作开发过程，并使其软件交付过程实现自动化管理。

  免费下载：

  • Rational Team Concert Standard Edition（企业版）
  • Rational Team Concert Standard Edition（标准版）
  • Rational Team Concert Standard Edition（易捷版）
  • Rational Team Concert Express-C Edition（免费版）
  • Rational Team Concert for i Standard Edition（System i 标准版）
  • Rational Team Concert for Power Systems Software
• IBM Rational Quality Manager（RQM）是一个基于 Jazz 平台技术的实时协作式质量管理环境，可以帮助跨地域分布的开发团队简化协作质量管理，并使其软件质量管理过程实现自动化管理。

  免费下载：

  • Rational Quality Manager 试用版
• 下载免费的 IBM Rational ClearQuest 试用版。您还可以试用 IBM Rational ClearQuest ALM Appliance（预配置系统），在虚拟机上体验立即可用的 Rational ALM 变更管理解决方案。
• 下载这些 IBM 产品评估版，并着手使用来自于 Rational®，DB2®、Lotus®、Tivoli®，以及 WebSphere® 的应用程序开发工具和中间件产品。
• 下载 IBM Rational 软件的试用版本。

讨论

• 加入 Rational Quality Manager 讨论区，也包括有关 Rational Test Lab Manager 的讨论区。
• 查看 developerWorks 上的 Rational TestManager 讨论区。
• 查看 developerWorks 博客，并加入 My developerWorks 中文社区。