导入一批 ClearQuest 记录

ClearQuest® 连接器提供的导入工具允许您在 Jazz™ 存储库中为一批 ClearQuest 记录创建相应的项。
关于此任务
例如,您可以使用导入工具来创建与 ClearQuest 用户数据库中的一批缺陷相对应的 Rational Team Concert™ 工作项。新的工作项将与那些缺陷同步。您对工作项所作的变更将传播到相应的缺陷,您对缺陷所作的变更也将传播到相应的工作项。

导入工具使用 cqconnector.properties 文件中设置的参数。ClearQuest 连接器安装向导将根据您选择的选项来更新 cqconnector.properties 文件。您还可以通过直接编辑 cqconnector.properties 文件来设置参数。有关参数的描述,请参阅修改连接器服务参数。请将导入工具运行多次,即,对每种记录类型运行一次。此方法允许您先验证一种记录类型的同步是否成功,然后再继续处理下一种记录类型。

某些记录类型可能依赖于其他记录类型。您应该先对其他记录类型所依赖的记录类型运行导入工具。例如,在样本 DefectTrackingInterop 模式中,“缺陷”记录类型的同步依赖于“项目”和“用户”记录类型的同步成功完成。因此,请先对“项目”和“用户”记录类型运行导入工具。在确认那些记录类型的同步成功后,再对“缺陷”记录类型运行导入工具。

导入工具的语法如下所示:

synctool recordType=record-type-name jazzServer=url projectArea=project-area-name 

要导入记录,请执行下列操作:

  1. 转到 install-directory\gateway 目录。
  2. 运行 synctool 命令。 导入工具将搜索 cqconnector.properties 文件中 cq.queryTreeRoot 参数名所指定的查询文件夹。如果在所指定记录类型的项目区域文件夹中找到查询,那么将使用该查询来选择要导入的记录。如果不存在任何查询,那么导入工具将选择该记录类型的所有记录。如果要导入的记录类型的记录数非常庞大,请考虑多次运行导入工具并且每次变更查询,以便每次调用时选择其中的部分记录。例如,您可以对查询进行调整,以便根据创建日期来选择记录。并且,请确保将查询定义成只选择您计划在 Rational Team Concert 中处理的记录。通常,不需要包括处于“已关闭”状态的记录。

    每次添加或除去查询或者添加同步规则时,都必须停止并重新启动 ClearQuest 网关,以使 ClearQuest 连接器使用新的同步条件。

    例如,在 Windows® 上:

    synctool recordType="users" jazzServer="https://cqconnector:cqconnector@localhost:9443/jazz" projectArea="Reporting"

    在 Linux® 上,请在命令行开头指定 ./synctool

  3. 打开 Rational Team Concert 客户机并验证导入工具是否已经为该查询选择的 ClearQuest 记录创建用户记录。在团队工件视图中,展开我的团队区域文件夹。双击一个团队区域,以便将其打开。在成员区域中,单击添加以便对该团队区域添加新用户。要对用户指定角色,请从“成员”表中选择每个用户,然后单击过程角色
  4. 运行 synctool 命令并指定另一种记录类型。例如,“项目”记录类型。
  5. Rational Team Concert 客户机中,验证导入工具是否已经为该查询选择的 ClearQuest 项目记录创建相应的类别项。在“团队工件”视图中,右键单击项目区域,然后选择打开。在项目区域编辑器中,单击工作项类别选项卡。选择与 ClearQuest 项目记录相对应的类别。选择要与该类别相关联的团队区域。单击关联。对于导入工具创建的每个要与 ClearQuest 项目记录相对应的类别,重复此步骤。单击保存以保存对项目区域所作的变更。 使类别与团队区域相关联之后,具有该类别属性的工作项将与相应的团队相关联。
  6. 运行 synctool 命令并指定另一种记录类型。例如,“缺陷”记录类型。
  7. Rational Team Concert 客户机中,验证导入工具是否已经为该查询选择的 ClearQuest 缺陷创建相应的工作项。
结果
如果导入工具选择了当前与同一 Jazz Team Server 上另一个项目区域同步的记录,那么它将断开该记录与该项目区域的连接,以便能够使该记录与命令行中指定的项目区域同步。

反馈

本资料对您是否有帮助?您可以在 Jazz.net 上提供反馈(需要注册):在论坛中发表意见或者提交错误