建立查詢階層

ClearQuest® Connector 利用查詢來過濾 ClearQuest 記錄,以便與 Jazz™ 工作項目同步化,以及判斷哪些專案區域要連接 ClearQuest 使用者資料庫。
不論您是使用單一專案區域或多個專案區域,您都必須在公用查詢個人查詢資料夾中,建立一個查詢資料夾階層。 在 cqconnector.properties 檔中,您將 cq.queryTreeRoot 參數值設為根查詢資料夾。 在這個根資料夾內,建立使用者資料庫所要連接之各專案區域的資料夾。 資料夾的名稱必須完全符合專案區域的名稱。 只能對每個記錄類型的每一專案區域建立一個查詢。

例如,下圖中的根資料夾稱為 Jazz ClearQuest Connector。 兩個專案區域資料夾稱為 Hawaii Project 和 Trinidad Project。 Defect_query1 查詢選取「問題報告」記錄類型的記錄來與 Hawaii Project 專案區域中的工作項目同步化。

您必須將查詢寫成不會將單一 ClearQuest 記錄遞送到相同 Jazz Team Server 上的多個專案區域。 如果多個專案區域位於不同 Jazz Team Server 上,您便可以將一項 ClearQuest 記錄遞送到這些專案區域。 您可以將根資料夾放在「公用查詢」或「個人查詢」資料夾階層中的任何位置,但您必須將專案區域資料夾直接儲存在根資料夾之下,並將查詢直接儲存在專案區域資料夾之下。 如果您將根資料夾放在「個人查詢」資料夾中,請確定您是以專為 ClearQuest Connector 而建立或指定的相同使用者身分(如 cqconnector)來登入。

如果要建立查詢階層,請執行下列動作:

  1. 按一下開始 > 所有程式 > IBM Rational > IBM Rational ClearQuest > ClearQuest
  2. 按一下檔案 > 資料庫 > 連接,然後選取使用者資料庫。
  3. 在「導覽」窗格中,用滑鼠右鍵按一下公用查詢個人查詢,然後選取新建資料夾。 指定根資料夾名稱。
  4. 用滑鼠右鍵按一下根資料夾,然後選取新建資料夾。 以 ClearQuest 使用者資料庫所要連接之 Jazz 專案區域的名稱來指定資料夾名稱。 名稱必須完全符合。
  5. 用滑鼠右鍵按一下專案區域資料夾,然後選取新建查詢。 針對您計劃要同步化的其中一個記錄類型來建立一項查詢。 針對您計劃要同步化的其他各記錄類型來建立其他查詢。

    如果要在相同 Jazz Team Server 上的多個專案區域同步化相同記錄類型的記錄,您就必須指定這些查詢。 否則,您可選擇要不要指定查詢。 如果您並未指定查詢,便會將這個記錄類型的所有記錄同步化。 不論是否指定查詢,您一律必須指定專案區域的資料夾。

  6. 依照需要,建立直接在根資料夾之下的其他專案區域資料夾。 在每個專案區域資料夾內,為您計劃要同步化的每個記錄類型各建立一項查詢。
如果在啟動「ClearQuest 閘道」之後,您新增或移除查詢,您必須停止再重新啟動「ClearQuest 閘道」,ClearQuest Connector 才會使用新的同步化準則。

意見