匯入一批 ClearQuest 記錄

ClearQuest® Connector 包含一個「匯入」工具,供您在 Jazz™ 儲存庫中建立一批 ClearQuest 記錄的對應項目。
執行這項作業的原因和時機
例如,您可以利用「匯入」工具來建立 Rational Team Concert™ 工作項目,對應至 ClearQuest 使用者資料庫中的一批問題報告。新的工作項目會與問題報告同步化。 您在工作項目上進行的變更會傳送至對應的問題報告,在問題上進行的變更會傳送至對應的工作項目。

「匯入」工具會使用 cqconnector.properties 檔中所設定的參數。「ClearQuest Connector 設定精靈」 會根據您所做的選擇來更新 cqconnector.properties 檔。您也可以直接編輯 cqconnector.properties 檔來設定參數。請參閱修改連接器服務參數,以取得參數的說明。 請重複執行「匯入」工具,每個記錄類型各一次。 這個方式可讓您驗證好一個記錄類型已同步化成功之後,才繼續進行下一記錄類型。

部分記錄類型可能會相依於其他記錄類型。 您應該先在其他記錄類型所依賴的記錄類型上執行「匯入」工具。 例如,在範例 DefectTrackingInterop 綱目中,「問題報告」記錄類型的同步化會因「專案」及使用者記錄類型同步化順利完成而跟著完成。 因此,請先在「專案」及使用者記錄類型上使用「匯入」工具。 請在確認這些記錄類型的同步化順利完成之後,才在「問題報告」記錄類型上執行「匯入」工具。

「匯入」工具語法如下:

synctool recordType=record-type-name jazzServer=url projectArea=project-area-name 

如果要匯入記錄,請執行下列動作:

  1. 導覽至 install-directory\gateway 目錄。
  2. 執行 synctool 指令。 「匯入」工具會搜尋 cqconnector.properties 檔中的 cq.queryTreeRoot 參數所指名的查詢資料夾。 如果它在專案區域資料夾中找到對於指定記錄類型的查詢,它會利用這項查詢來選取要匯入的記錄。 如果沒有任何查詢,「匯入」工具會選取這個記錄類型的所有記錄。 如果要匯入的記錄類型有大量記錄,請考慮重複執行「匯入」工具數次,而且每次都變更查詢,讓每次呼叫都只選取總記錄數的一部分。 例如,您可以調整查詢來根據建立日期選取記錄。 另外,也務必定義查詢,使它們只選取您計劃在 Rational Team Concert 中操作的記錄。一般而言,您並不需要併入關閉狀態的記錄。

    每當新增或移除查詢,或新增同步化規則時,您都必須停止再重新啟動「ClearQuest 閘道」,ClearQuest Connector 才會使用新的同步化準則。

    例如,在 Windows® 上:

    synctool recordType="users" jazzServer="https://cqconnector:cqconnector@localhost:9443/jazz" projectArea="Reporting"

    在 Linux® 上,利用 ./synctool 來啟動指令行。

  3. 開啟 Rational Team Concert 用戶端,驗證「匯入」工具針對查詢所選的 ClearQuest 記錄,建立了使用者記錄。 在團隊構件視圖中,展開我的團隊區域資料夾。 按兩下某團隊區域來開啟它。 在成員區域中,按一下新增,將新使用者加到團隊區域中。 如果要將角色指派給使用者,請在「成員」表格中選取各使用者,然後按一下程序角色
  4. 指定另一個記錄類型來執行 synctool 指令。 例如,「專案」記錄類型。
  5. Rational Team Concert 用戶端中,驗證「匯入」工具建立了查詢所選的 ClearQuest 專案記錄的對應種類項目。 在「團隊構件」視圖中,用滑鼠右鍵按一下專案區域,然後選取開啟。 在「專案區域」編輯器中,按一下工作項目種類標籤。 選取對應於 ClearQuest 專案記錄的種類。 選取要關聯於種類的團隊區域。 按一下關聯。 針對「匯入」工具為了對應 ClearQuest 專案記錄而建立的每個種類,重複這個步驟。 按一下儲存來儲存專案區域的變更。 將種類關聯於團隊區域之後,含有這個種類內容的工作項目便會關聯於適當的團隊。
  6. 指定另一個記錄類型來執行 synctool 指令。 例如,「問題報告」記錄類型。
  7. Rational Team Concert 用戶端中,驗證「匯入」工具建立了查詢所選的 ClearQuest 問題報告的對應工作項目。
結果
如果「匯入」工具選取目前同步化於相同 Jazz Team Server 上另一個專案區域的記錄,它會切斷記錄與這個專案區域的連線,以便將記錄與指令行所指定的專案區域同步化。

意見

以上說明對您有幫助嗎?您可以在 Jazz.net 網站中提供意見(需要登錄):在討論區中提供意見提交錯誤