创建同步规则

您需要为计划映射到 IBM® Engineering Workflow Management (EWM) 项的 ClearQuest® 记录类型创建同步规则。

要创建同步规则，请执行下列操作：

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

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

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

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

   缺省情况下，当对 ClearQuest 记录的更改与 EWM 项同步时，将使用 ClearQuest Gateway 用于登录到 Jazz 存储库的 Jazz 用户帐户来执行更新操作。 外部修饰符字段用于配置同步规则，因此将变更记录到执行那些变更的用户的上下文中。 请参阅 为外部用户配置同步规则 以获取详细信息。

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

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

   表 1. ClearQuest Synchronizer 变换器

   变换器名称	描述
   将字段连接到定制属性变换器	将工作项的定制属性值映射到由另一条记录中的字段引用的 ClearQuest 记录中的字段。
   添加程序详细信息变换器	当前未与 ClearQuest Synchronizer配合使用。
   在定制属性中显示所引用记录字段变换器	将引用的 ClearQuest 记录的内容映射到工作项定制属性，以便可以在工作项编辑器中显示这些内容。
   项目区域变换器	当前未与 ClearQuest Synchronizer配合使用。
   时间戳记/天数变换器	将用于标识 ClearQuest 记录中的天数的字符串转换为毫秒数，这是时间戳记用于确定时间的内容。
   工作项操作变换器	计算在传入同步期间从一种状态转换为另一种状态时要执行的操作。如果EWM 项工作流定义包含不明确的状态转换，其中可能有多个操作在两种状态之间转换，那么需要执行此操作。 与 Rational ClearQuest 记录类型不同， EWM 工作项类型允许多个操作从一个状态过渡到另一个状态。 如果不使用工作项操作变换器来同步包含多个状态转换操作的项，那么状态转换后的同步操作将生成错误，指示无法将 ClearQuest 记录转换为其他状态。
   工作项附件变换器	将 EWM 附件转换为 ClearQuest 记录附件。
   工作项类别变换器	当值为路径时，维护映射到 ClearQuest 记录的 EWM 类别的分层结构。
   工作项注释变换器	将 EWM 注释转换为 ClearQuest 记录注释。
   工作项标记变换器	将工作项中的标记变换为 ClearQuest 记录中的关键字。

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

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

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

8. 单击 保存 以保存您的工作。