创建查询层次结构

ClearQuest® 连接器使用查询对要与 Jazz™ 工作项同步的 ClearQuest 记录进行过滤以及确定要与 ClearQuest 用户数据库相连接的项目区域。
关于此任务
无论您是使用一个项目区域还是使用多个项目区域,都必须在公用查询个人查询文件夹中创建查询文件夹的层次结构。在 cqconnector.properties 文件中,请将 cq.queryTreeRoot 参数的值设置为根查询文件夹。在这个根文件夹中,请为用户数据库要连接到的每个项目区域创建文件夹。文件夹的名称必须与项目区域的名称完全匹配。对于每种记录类型,请不要为每个项目区域创建多个查询。

例如,在下图中,根文件夹名为 Jazz ClearQuest Connector。两个项目区域文件夹分别名为 Hawaii Project 和 Trinidad Project。Defect_query1 查询用于选择要与 Hawaii Project 项目区域中的工作项同步并且记录类型为“缺陷”的记录。

您必须将查询编写成避免将单一 ClearQuest 记录传递到同一 Jazz Team Server 上的多个项目区域。可以将 ClearQuest 记录传递到多个项目区域,条件是这些项目区域在不同的 Jazz Team Server 上。您可以将根文件夹置于“公用查询”或“个人查询”文件夹层次结构中的任何位置,但必须将项目区域文件夹直接存储在根下方,并且必须将查询直接存储在项目区域文件夹中。如果将根文件夹置于“个人查询”文件夹中,那么请确保登录时采用的用户身份(例如 cqconnector)就是您为 ClearQuest 连接器创建的或者指定供其使用的用户。

要创建查询层次结构,请执行下列操作:

  1. 单击开始 > 所有程序 > IBM Rational > IBM Rational ClearQuest > ClearQuest
  2. 单击文件 > 数据库 > 连接,然后选择用户数据库。
  3. 在“导航器”窗格中,右键单击公用查询个人查询,然后选择新建文件夹。指定根文件夹的名称。
  4. 右键单击根文件夹,然后选择新建文件夹。将该文件夹命名为 ClearQuest 用户数据库要连接到的 Jazz 项目区域的名称。名称必须完全匹配。
  5. 右键单击项目区域文件夹,然后选择新建查询。为您计划同步的其中一种记录类型创建查询。为您计划同步的其他每种记录类型创建附加的查询。

    如果将同一记录类型的记录与同一 Jazz Team Server 上的多个项目区域同步,那么必须指定查询。否则,指定查询这一操作是可选的。如果未指定查询,那么该记录类型的所有记录都将进行同步。无论您是否指定查询,都始终必须为项目区域指定一个文件夹。

  6. 必要时,在根文件夹正下方创建其他项目区域文件夹。在每个项目区域文件夹中,为您计划同步的每种记录类型创建一个查询。
下一步做什么
启动 ClearQuest 网关之后,如果添加或除去查询,那么必须停止并重新启动 ClearQuest 网关,以使 ClearQuest 连接器使用新的同步条件。

反馈