编辑同步规则以指定类别

在传入同步期间,必须设置工作项的“类别”属性,这是因为,工作项与基于其类别的团队区域相关联。在工作项编辑器和同步规则编辑器中,“类别”属性作为归类依据出现。
关于此任务
您可以通过下列方法向 Rational Team Concert™ 提供类别信息:
  • 将无状态 ClearQuest® 记录与类别相连接
  • 将一个或多个 ClearQuest 记录字符串值字段映射到类别
  • 将空的外部值映射到固定的类别值
  • 将一个或多个 ClearQuest 记录映射到类别,但不进行连接

要将无状态记录与类别相连接,请执行下列操作:

演示

  1. 创建含义与类别合理对应的无状态 ClearQuest 记录类型(例如“项目”)的一个或多个记录。确保要同步的记录类型包含一个特定字段,用户将在该字段中指示该记录所属的“项目”类型(或其他无状态记录类型)。例如,“缺陷”记录类型包含“项目”字段。
  2. 为无状态记录类型(例如“项目”)创建同步规则。将项类型设置为类别 - com.ibm.team.workitem。在“属性映射”部分中,至少将外部属性 Name 映射到“名称”项属性。单击保存以保存该同步规则。
  3. 打开要与工作项同步的记录类型(例如“缺陷”)的同步规则。在“属性映射”部分中,单击添加。对于“项属性”,选择归类依据。对于“外部属性”,选择引用了所创建的无状态记录类型(例如“项目”)的字段的名称。在同步字段中,选择输入/输出以启用双向同步。在引用同步规则字段中,选择您为无状态记录类型创建的同步规则。
  4. 单击确定。单击保存以保存变更。

要将一个或多个 ClearQuest 记录字符串值字段映射到类别,请执行下列操作:

  1. 在该记录类型的同步规则的“属性映射”部分中,对于“项属性”,选择归类依据。对于“外部属性”,选择 ClearQuest 字段。可以使用多个 ClearQuest 字段来组成与类别属性相对应的多级别值。例如,可以将一个字段命名为“项目”并将另一个字段命名为“子项目”。在“外部属性”中,通过用斜杠分隔字段名来指定此层次结构。例如,“项目/子项目”。
  2. 取消选择不变换。在“值变换器”列表中,选择工作项类别变换器

    您可以对使用工作项类别变换器值变换器的属性映射指定值映射。在传入方向,ClearQuest 连接器将在变换之前应用值映射。“外部值”必须是简单字段引用;字段名称不能包含句点(.)或斜杠(/)。将要被解释为工作项类别的名称或路径的字段值可以映射到另外某个类别名称或路径。在传出方向,ClearQuest 连接器将在变换后应用值映射,以便可以将工作项类别路径映射到另外某个字符串。

  3. 单击保存以保存变更。

要将空的外部值映射到固定的类别值,请执行下列操作:

  1. 在该记录类型的同步规则的“属性映射”部分中,对于“项属性”,选择归类依据。对于“外部”属性,请输入一个不存在的字段的名称,例如 Dummy。在“映射详细信息”部分中,将同步设置为输入
  2. 取消选择不变换。在“值变换器”列表中,选择工作项类别变换器。在“值映射”部分中,添加映射。保留“外部值”为空。对于“项值”,请输入要对每个创建工作项的传入同步操作设置的类别的名称。
  3. 单击保存以保存变更。

要将一个或多个 ClearQuest 记录映射到类别,请执行下列操作:

  1. 对于每个向父记录类型用于映射到类别的项属性添加字段值的记录类型,创建一个同步规则。例如,可以通过对“项目”和“子项目”记录类型中“名称”字段的值进行组合来组成项属性。父记录类型(例如“缺陷”)包含两个分别引用“项目”和“子项目”记录的字段。在此示例中,您将为“项目”和“子项目”记录类型创建同步规则。在同步规则编辑器中,保留项类型字段为空。由于此记录类型只对父记录类型添加名称,因此它未连接到任何 Rational Team Concert 项。在外部类型字段中,选择正在为其创建同步规则的记录类型。在“属性映射”部分的外部属性字段中,输入该字段的名称。例如“名称”。选中外部标识
  2. 单击保存以保存变更。
  3. 在父记录类型(在本示例中,这是“缺陷”)的同步规则中,单击添加以添加属性映射。在项属性字段中,选择归类依据。在外部属性字段中输入一个值,此值用于标识父记录类型中的引用字段以及所引用记录类型中的字段。使用句点将父记录类型中的引用字段与所引用记录类型中的字段分隔开。使用斜杠来分隔父记录类型中的引用字段。例如,指定“项目.名称/子项目.名称”,其中“项目”和“子项目”是“缺陷”记录类型中的引用字段,它们分别指向“项目”和“子项目”记录。“项目”和“子项目” 记录类型都包含一个“名称”字段。在同步字段中,选择输入/输出。在值变换部分中,取消选择不变换。选择工作项类别变换器

    如上一个方案所述,您可以对使用工作项类别变换器值变换器的属性映射指定值映射。

    您还需要为引用字段(在本示例中,这是“项目”和“子项目”)添加属性映射。在属性映射部分中,单击添加。保留项属性为空。在外部属性中,选择其中一个引用字段(例如“项目”)。在同步字段中,选择。在引用同步规则字段中,选择您为引用字段所指向的记录类型创建的同步规则。在本示例中,“项目”字段引用“项目”记录。“项目”记录类型具有同步规则。为第二个引用字段(在本示例中,这是“子项目”)添加映射。

  4. 单击保存以保存变更。

以上方案可能有其他变体。子记录类型中的字段可以是对另一个记录的引用,而不是字符串值字段。在到达包含字符串值字段的记录之前,可以存在引用链。请为引用链中的每种记录类型创建同步规则。在父记录类型的同步规则中,对于项属性字段,请选择归类依据。在外部属性字段中输入一个值,此值用于标识引用链以及路径末尾的字符串值字段。请指定由句点(.)分隔的字段名序列作为值。此变体仅受传入同步支持。


反馈

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