创建同步规则

对于您计划映射至 Rational Team Concert™ 项的 ClearQuest® 记录类型,您需要为其创建同步规则。
开始之前

您可以使用 ClearQuest 连接器安装向导来创建同步规则或同步规则模板。但是,在使用此向导来生成同步规则之后,您仍需要复审并修改这些规则,然后才能将其投入使用。本主题描述如何使用 Rational Team Concert Eclipse 客户机中的同步规则编辑器来创建和修改规则。

要创建、修改和删除同步规则,您必须被授予开发者或 ClearQuest 连接者客户访问许可证。此外,必须配置项目区域,以便将许可权授予您的用户角色。要设置许可权,请打开项目区域,接着依次单击过程配置选项卡和项目配置 > 许可权,选择角色,然后从允许的操作列表中选择项连接者

在创建同步规则之前,请确保启动 ClearQuest 网关;否则,“同步规则”编辑器列表将不会包含 ClearQuest 记录类型中的字段。

关于此任务
有关在创建同步规则前创建计划工作表的详细信息,请参阅计划同步规则。除本节中的主题以外,另请参阅 https://jazz.net/wiki/bin/view/Main/WritingSyncRules 以获取有关将 ClearQuest 记录字段类型映射到 Rational Team Concert 项属性的示例。

要创建同步规则,请执行下列操作:

  1. 登录到 Rational Team Concert 客户机。
  2. 团队工件视图中,右键单击存储库连接,然后选择管理 > 同步规则。在同步规则视图中,右键单击项目区域,然后选择新建 > 同步规则。要编辑现有的同步规则,请展开项目区域节点以查看同步规则。双击规则,以便在同步规则编辑器中将其打开。
  3. 在同步规则编辑器中的名称属性中,为该规则输入唯一的名称。使用类似于 Java™ 包命名约定的命名约定有助于确保名称唯一。例如 com.sapphire.clearquest.SchemaName.RecordType,其中,SchemaName 是 ClearQuest 模式的名称,RecordType 是该模式中要同步的记录类型的名称。
  4. 类型映射部分中,选择要与 ClearQuest 记录类型同步的项类型。“项管理器”属性设置为创建所选项类型并对其进行同步的管理器。在外部存储库字段中,选择处理此同步规则时要使用的外部存储库连接。对于除“用户”以外的所有记录类型,选择 ClearQuest 管理器(非用户记录)作为外部管理器。对于“用户”记录类型,选择 ClearQuest 管理器(用户记录) 注:由于 Rational Team Concert 用户项并非属于一个项目区域,因此每个 Jazz™ Team Server 的“用户”记录类型只能有一个同步规则。在外部类型字段中,选择要与 Rational Team Concert 项同步的 ClearQuest 记录类型。

    创建新工作项时,它的类型字段是必需的。您创建的用于将记录类型映射至工作项的同步规则必须指示如何设置工作项的“类型”字段值。有关详细信息,请参阅将记录类型映射到工作项类型

  5. 启用的团队区域部分中,选择和取消选择团队区域,以便限制同步规则的作用域。缺省情况下,所有与具有同步规则的项目区域相关联的 Rational Team Concert 项都是传出同步的候选者。您可能希望只为那些与特定团队区域相关联的项创建 ClearQuest 记录。如果选择父团队区域,那么还将选择它的所有子团队区域。您可以选择子团队区域,而不选择它的父团队区域。
  6. 使用最大周期数字段来指定同步操作失败前 ClearQuest 连接器应该尝试的同步周期数。为有状态记录类型编写同步规则时,请选中对所有项状态进行同步。对于无状态记录类型,请不要选中对所有项状态进行同步
  7. 属性映射部分中,指定哪些工作项属性将映射至哪些 ClearQuest 记录类型字段。单击添加以创建映射。选择项属性和相应的外部属性(ClearQuest 记录类型字段)。要映射工作项关系,请选择下列其中一个项属性:“相关”、“阻塞”、“依赖于”、“父代”或“子代”。然后,选择引用了相关 ClearQuest 记录的外部属性。 除了每次添加一个映射以外,您还可以单击初始化以便根据匹配或部分匹配的属性名来创建一组初始映射。然后,您可以浏览列表并在必要时除去或编辑映射。

    映射详细信息部分显示“属性映射”表中所选映射的详细信息。要清除项属性外部属性字段中的条目,请选择“项属性”或“外部属性”下方的。使用“同步”字段来指定同步方向。输入/输出将启用双向同步。输入仅启用从 ClearQuest 用户数据库到 Rational Team Concert 项的同步。输出仅启用从 Rational Team Concert 项到 ClearQuest 用户数据库的同步。如果将该属性用作查找键以便将项映射至 ClearQuest 记录,请选中项标识。如果将 ClearQuest 字段用作查找键以便将 ClearQuest 记录映射至 Rational Team Concert 项,请选中外部标识。通常,不必设置“项标识”和“外部标识”字段。假定 ClearQuest 网关正在运行,同步规则编辑器将在必要时设置这两个字段。

    缺省情况下,当 ClearQuest 记录变更与 Rational Team Concert 项进行同步时,将使用 ClearQuest 网关用于登录到 Jazz 存储库的 Jazz 用户帐户来执行更新操作。外部修饰符字段用于配置同步规则,因此将变更记录到执行那些变更的用户的上下文中。有关详细信息,请参阅为外部用户配置同步规则

    如果属性值引用另一个已定义同步规则的对象,请从引用同步规则列表中选择该同步规则。例如,如果 ClearQuest 的“缺陷”记录类型包含引用了“用户”记录类型的字段,请选择“用户”记录类型的同步规则。在同步期间,将处理该同步规则并建立从 Rational Team Concert 项到 Jazz 用户的引用。如果属性引用另一个工作项,那么指定哪个工作项同步规则作为引用同步规则无关紧要。当同步操作确定所引用对象的类型时,它将使用正确的同步规则。例如,假定“缺陷”和“增强”工作项类型都包含引用了另一个工作项的“(副本)”属性。“缺陷”同步规则中“(副本)”的属性映射将指定“缺陷”同步规则作为引用同步规则。同样,“增强”同步规则中“(副本)”的属性映射将指定“增强”同步规则作为引用同步规则。如果同步操作确定将“缺陷”标记为“增强”的副本,那么它将使用“增强”同步规则。

    使用值变换器部分来指定对 Rational Team Concert 项与 ClearQuest 记录字段之间传播的数据进行变换时需要执行的任何特殊处理。如果不需要变换数据,请保留不变换处于选中状态;否则,请取消选中此选项以激活其他字段。ClearQuest 连接器提供了下列值变换器。您可以通过创建插件扩展来添加变换器。

    表 1. ClearQuest 连接器变换器
    变换器名称 描述
    将字段连接到定制属性变换器 将工作项的定制属性值映射到另一记录中的某个字段所引用的 ClearQuest 记录中的字段。
    添加程序详细信息变换器 当前不与 ClearQuest 连接器配合使用。
    在定制属性中显示所引用记录字段变换器 将所引用 ClearQuest 记录的内容映射到工作项定制属性,以便可以在工作项编辑器中显示该内容。
    项目区域变换器 当前不与 ClearQuest 连接器配合使用。
    时间戳记/天数变换器 将 ClearQuest 记录中用于标识天数的字符串转换为毫秒数,时间戳记将使用此毫秒数来确定时间。
    工作项操作变换器 计算传入同步期间从一种状态过渡到另一种状态时需要执行的操作。如果 Rational Team Concert 项工作流程定义包含不明确的状态过渡,导致在两种状态之间过渡时有可能执行多个操作,那么此变换器是必需的。

    与 Rational ClearQuest 记录类型不同,Rational Team Concert 工作项类型允许从一种状态过渡到另一种状态时执行多个操作。如果您不想使用工作项操作变换器对包含多个用于状态过渡的操作的项进行同步,那么状态过渡后执行的同步操作将生成一个错误,指出 ClearQuest 记录无法过渡到另一状态。

    工作项附件变换器 Rational Team Concert 附件转换为 ClearQuest 记录附件。
    工作项类别变换器 当值为路径时,维护映射到 ClearQuest 记录的 Rational Team Concert 类别的分层结构。
    工作项注释变换器 Rational Team Concert 附件转换为 ClearQuest 记录注解。
    工作项标记变换器 将工作项中的标记变换为 ClearQuest 记录中的关键字。

    某些值变换器可能需要其他属性才能变换数据。必要时,请单击设置变换器所需的其他输入属性,并在“必需属性”对话框中选择属性。

    使用值映射部分来指定要从项映射到记录的值。单击添加。输入项值和相应的 ClearQuest 记录字段值。如果不存在所有值的一对一映射,请指定一个值作为缺省值。例如,ClearQuest 的“优先级”字段可以具有四个值(1、2、3 和 4),但 Team Concert 的“优先级”属性可以具有三个值(高、中和低)。如果将“高”同时映射至 1 和 2,请选择 1 或 2 作为“缺省外部值”。要对 ClearQuest 记录字段指定空值,请保留该值为空。除了每次添加一个值映射以外,您还可以单击初始化以便根据匹配或部分匹配的值名称来创建一组初始映射。然后,您可以浏览列表并在必要时除去或编辑值映射。

    Rational ClearQuest 和 Rational Team Concert 分别允许您标识重复的记录和项。要对重复项进行同步,请将项属性(副本)映射到外部属性来源。在“引用同步规则”字段中,选择用于工作项的同步规则。

  8. 单击保存以保存您的工作。
下一步做什么

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


反馈

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