计划同步规则

在可以创建同步规则之前,您需要分析要与 Rational Team Concert™ 工作项同步的 ClearQuest® 记录类型,并创建一个计划以便将记录类型中的字段映射到工作项中的属性。
关于此任务
理想情况下,计划并创建同步规则的人员应该是创建或维护 ClearQuest 模式的人员。您还应该基本了解 Jazz™ 并熟悉项目区域和工作项。

将每种记录类型都映射到工作项类型并不实际。这两种类型在用途、必需字段和状态过渡模型方面应该类似。您应该复审要连接到 Jazz 项目区域的用户数据库的模式中定义的所有记录类型,并指定哪些记录类型是同步的良好候选者。

您可以使用 ClearQuest 连接器安装向导来创建同步规则的初始版本,但需要对那些规则进行编辑以指定其他映射详细信息。至少,您必须编辑同步规则以指定如何设置工作项的“类别”属性。

在执行下列计划步骤时,请在附带的工作表中记录有关记录类型的信息。请为您计划要同步的每种记录类型创建一个工作表。在开始创建或编辑同步规则时,就应该使用该工作表。如果使用 ClearQuest 连接器安装向导来创建同步规则的初始版本,请在同步规则编辑器中打开那些同步规则;将映射详细信息与计划工作表中的需求作比较并确定差别。

要计划同步规则,请执行下列操作:

  1. 通过使用 Rational Team Concert 的“故事”工作项类型来开发用例,以便描述团队计划如何在 Rational Team Concert 中工作。“故事”应该指示团队打算使用的过程(例如 Scrum)、工作项类型和工作流程。
  2. 根据“故事”,指定哪些 ClearQuest 记录类型要与哪些工作项类型同步。如果没有现成的 Rational Team Concert 工作项类型与所要同步的 ClearQuest 记录类型紧密匹配,那么可以创建与该记录类型相对应的工作项类型。
  3. 您可以将一种 ClearQuest 记录类型映射到多种工作项类型。例如,您的记录类型可能是通用类型(例如“变更请求”)并包含将其限定为“错误”或“发行版要求”的字段。在这种情况下,请指示用于限定记录类型的 ClearQuest 字段的名称,并列示字段值及其相应的工作项类型。
  4. 定义记录类型与工作项类型之间的同步方向。如果您计划将 ClearQuest 用户数据库中的一组记录导入到 Jazz 存储库 中,然后让团队只在 Rational Team Concert 中工作,那么同步方向只是“输入”。如果您打算同时在 Rational Team ConcertRational® ClearQuest 中工作,那么同步方向是“输入”和“输出”。
  5. 指定 ClearQuest 记录类型和相应工作项类型中的必需字段集。如果您使用 Scrum 过程,那么在“缺陷”和“任务”工作项类型中,只有“摘要”和“归类依据(类别)”字段要求输入。在工作项编辑器的“概述”页面中,必需字段标有星号。

    要查看 ClearQuest 记录类型的必需字段,请在 ClearQuest Designer 中打开该模式。单击开始 > 所有程序 > IBM Rational > IBM Rational ClearQuest > ClearQuest Designer。在“打开模式”向导中,选择要同步的记录类型的模式。在导航窗格中,依次展开记录类型文件夹和特定的记录类型文件夹,然后展开状态和操作文件夹。双击行为。“行为”矩阵将必需字段标识为必需

  6. 对于每个必需的 ClearQuest 字段,请指定工作项类型中可以将 ClearQuest 字段映射到的字段。同样,对于每个必需的工作项类型字段,指定相应的 ClearQuest 字段。在选择适当的映射字段时,请考虑该字段和字段类型的含义。要查看 ClearQuest 记录类型的字段类型,请在 ClearQuest Designer 中打开该记录类型的模式。在导航窗格中,依次展开记录类型文件夹和特定的记录类型文件夹,然后双击字段以打开“字段”矩阵。

    要在 Rational Team Concert 中查看字段类型,请登录到 Rational Team Concert 客户机。在团队工件视图中双击项目区域,以便在项目区域编辑器中将其打开。单击过程配置选项卡。依次展开项目配置配置数据工作项。单击编辑器表示。为所同步的工作项类型选择编辑器表示。在编辑器表示区域中,展开选项卡和各个部分以查看表示(字段)的列表。类型将显示在每个字段名后面的圆括号中。

  7. 如果工作项类型没有要映射到某些必需 ClearQuest 记录类型字段的适当字段,请在该工作项类型中创建新字段。在项目配置页面上,依次展开项目配置配置数据工作项。单击类型。选择工作项类型类别。在定制属性区域中,单击添加。输入字段的名称,然后选择与相应 ClearQuest 字段类型兼容的类型。单击确定。单击保存以保存对工作项类型所作的变更。
  8. 如果记录类型没有要映射到某些必需工作项类型字段的适当字段,请通过在“字段”矩阵中添加行在该记录类型中创建新字段。
  9. 在传入同步期间,必须设置工作项的类别属性,这是因为,工作项与基于其类别的团队区域相关联。 您可以通过下列方法向 Rational Team Concert 提供类别信息:
    • 将无状态 ClearQuest 记录与类别相连接
    • 将一个或多个 ClearQuest 记录字符串值字段映射到类别
    • 将空的外部值映射到固定的类别值
    • 将一个或多个 ClearQuest 记录映射到类别,但不进行连接

    请参阅编辑同步规则以指定类别以了解这些方法的详细信息,然后选择其中一种要使用的方法。

  10. 指定要与工作项字段同步的任何其他非必需 ClearQuest 记录字段。指定相对应的工作项字段。必要时,通过添加定制属性在该工作项类型中创建字段。
  11. 指定任何要显示在工作项中但不与任何工作项字段同步的 ClearQuest 记录字段。
  12. 是否任何要同步的字段带有值的选项列表(例如“优先级”或“严重性”字段)?对于每个这类字段,请指定从 ClearQuest 记录字段到工作项字段的值映射。如果不存在所有值的一对一映射,请指定一个值作为缺省值。
  13. 是否任何要同步的字段要求进行特殊处理以便对将它们的值进行变换,然后才能将那些值发送到相应的工作项字段或 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 记录注解。您必须使用 Rational ClearQuest 附带提供的标准 Notes 软件包。
    工作项标记变换器 将工作项中的标记变换为 ClearQuest 记录中的关键字。

    指定任何要求进行变换的字段并列示所需的变换器。

  14. 如果记录类型包含附件,那么您可以创建同步规则,以便 ClearQuest 记录与工作项进行同步时,还将对记录和工作项的任何附件进行同步。指示您是否计划对附件进行同步。
  15. 指定任何要进行同步并且是引用类型字段的 ClearQuest 记录字段。您必须为这些字段所引用的记录类型创建同步规则。
  16. 是否任何要同步的 ClearQuest 记录字段带有挂钩(用于建立与其他字段的依赖关系)?例如,与一个字段相关联的挂钩可以使用用户输入到该字段中的值来确定如何设置另一个字段的值。在这种情况下,您必须指定挂钩的执行顺序,以确保 ClearQuest 记录字段设置为正确的值。

    cqconnector.properties 文件包含参数 cq.orderedProperties.record-type,您可以使用此参数来指定 ClearQuest 记录字段值的设置顺序。所有未指定 cq.orderedProperties.record-type 的字段都将在指定了该参数的字段处理完毕后处理。

    另一种指定顺序的方法是,在 ClearQuest Designer 中使用表单定义中的字段的 Web 从属字段属性。如果同时指定“Web 从属字段”属性和 cq.orderedProperties 参数,那么 ClearQuest 连接器将使用 cq.orderedProperties 参数指定的顺序。


反馈

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