修改連接器服務參數

cqconnector.properties 檔包含「ClearQuest® 閘道」和 synctool 指令行公用程式執行時所依據的參數設定。
執行這項作業的原因和時機

「ClearQuest Connector 設定精靈」會根據您在精靈中所做的選擇,來更新 cqconnector.properties 檔。如果您想要在執行精靈的相同電腦上部署 ClearQuest Connector,則不需要編輯 cqconnector.properties 檔。 如果您想要將 ClearQuest Connector 部署到另一部電腦,例如執行 Linux® 的電腦,請將 cqconnector.properties 檔複製至該電腦上,然後編輯檔案,使得參數中指定的任何電腦路徑名稱都是正確的。

下表說明 ClearQuest Connector 參數。
表 1. ClearQuest Connector 參數
參數 說明
com.ibm.rational.interop.pollingPeriod 用來控制「ClearQuest 閘道」輪詢 ClearQuest 使用者資料庫變更頻率的輪詢期間。 預設輪詢期間是 60 秒。
com.ibm.team.uris 這是 Jazz™ 伺服器的「統一資源識別碼 (URI)」。 預設 URI 是 https://cqconnector:cqconnector@localhost:9443/jazz。 利用分號 (;) 來區隔代表多部 Jazz 伺服器的各個項目。您必須建立名稱為 cqconnector 的 Jazz 使用者,或將 cqconnector 取代為另一個 Jazz 使用者。 Jazz 使用者(cqconnector 或其他)必須有Jazz ClearQuest Connector 或 Developer 授權。 如果您利用 cqconnector 作為使用者 ID,請務必變更預設密碼 cqconnector。
cq.dbSetDbName ClearQuest 綱目儲存庫和使用者資料庫。 預設綱目儲存庫是 sample_schema_repo。 預設使用者資料庫是 SAMPL。 格式是 schema-repository-connection-name/user-database-name
cq.orderedProperties.record-type 這是一份逗點區隔的欄位清單,指出在送出同步化作業期間,ClearQuest Connector 應設定這些欄位值的順序。 您可以為每個含有同步化規則的記錄類型,設定這個參數。 在處理完清單中的欄位之後,才會處理這份清單所未指定的欄位。 如果 ClearQuest 記錄類型含有用來在欄位間建立相依關係的連結鉤,您可能需要指定順序。

另一個指定順序的方式是在 ClearQuest Designer 的表單定義中,對各欄位使用 Web 相依欄位內容。如果您同時指定了「Web 相依欄位」內容和 cq.orderedProperties 參數,ClearQuest Connector 會使用 cq.orderedProperties 參數所指定的順序。

cq.password 用來登入 ClearQuest 使用者資料庫的密碼。 「ClearQuest 閘道」和「匯入」工具利用這個密碼及 cq.userId 參數指定的使用者名稱來登入 ClearQuest 使用者資料庫,以及擷取您想要匯入 Jazz 儲存庫的記錄。 預設值是 cqconnector。 請務必變更密碼的預設值。
cq.userId 用來登入 ClearQuest 使用者資料庫的使用者名稱。 「ClearQuest 閘道」和「匯入」工具利用這個使用者名稱及 cq.password 參數指定的密碼來登入 ClearQuest 使用者資料庫,以及擷取您想要匯入 Jazz 儲存庫的記錄。 預設值是 cqconnector。 這位使用者必須有 SQL 編輯器許可權。
cq.queryTreeRoot 這是根資料夾的完整路徑名稱,其中包含一或多個專案區域專用的查詢資料夾,您利用這些查詢來過濾要與 Rational Team Concert™ 項目同步化的記錄。您可以針對每個專案區域所要同步化的每個記錄類型,分別指定一項查詢。 您必須將查詢撰寫成不會選取某一 ClearQuest 記錄,與同一部 Jazz Team Server 上的多個專案區域同步化。

根資料夾可以在「公用查詢」或「個人查詢」之下的任何層次的資料夾階層上,不過,它的階層必須如下:root-folder/project-area-name-folder。 查詢必須直接儲存在專案區域資料夾中。 您可以有多個專案區域資料夾。 每個專案區域資料夾的名稱都必須符合 Jazz 儲存庫中對應的專案區域名稱。

您必須指定這個參數的值。 您指定的根查詢資料夾必須存在,且在這個資料夾中,必須針對計劃要同步其記錄和工作項目的每個專案區域,各包含一個資料夾。 如果專案區域資料夾未包含具有同步化規則之記錄類型的查詢,ClearQuest Connector 會嘗試將這個記錄類型的所有記錄同步化。

   

如果要修改參數,請執行下列動作:

  1. 導覽至 install-directory\gateway 資料夾。開啟 cqconnector.properties 檔。
  2. 依照需要,修改參數值來配合您的環境。
    1. 編輯 com.ibm.team.uris 參數值來指向一或多部 Jazz 伺服器的位置。 依預設,「ClearQuest 閘道」會嘗試以 cqconnector 使用者身分登入 Jazz 伺服器。 您必須建立名稱為 cqconnector 的 Jazz 使用者,或將 cqconnector 取代為另一個 Jazz 使用者。 Jazz 使用者(cqconnector 或其他)必須具備 Rational Team Concert ClearQuest Connector 或 Developer 授權。如果要指定另一個使用者,請在主機名稱前面插入 user_name[:password]@。 例如:https://chris:chris_pw@localhost:9443/jazz。 利用分號 (;) 來區隔代表多部 Jazz 伺服器的各個項目。
    2. 編輯 cq.dbSetDbName 參數值來識別您的綱目儲存庫和使用者資料庫。
    3. 如果您想要變更 60 秒的預設輪詢期間,請編輯 com.ibm.rational.interop.pollingPeriod 參數值。
    4. 如果要過濾要同步化的 ClearQuest 記錄,請針對每個具有同步化規則的記錄類型來建立查詢。 請在根資料夾之下,將查詢儲存在專案區域專屬的資料夾中。 請編輯 cq.queryTreeRoot 參數來識別根資料夾的完整路徑名稱。 例如:Public Queries/Jazz CQ Connector。 即使您不想過濾記錄,也必須建立根資料夾,且必須針對計劃要同步其記錄和工作項目的每個專案區域,各建立一個專案區域資料夾。
    5. 請利用 cq.userId 和 cq.password 參數來指定登入 ClearQuest 的使用者名稱和密碼。 cq.userId 參數所指定的使用者必須有 SQL 編輯器專用權。
    6. 如果您計劃要同步化的 ClearQuest 記錄類型中,有任何欄位含有用來建立與其他欄位之相依關係的連結鉤,且您未利用 ClearQuest 表單定義中的「Web 相依欄位」內容來指定應設定欄位值的順序,請設定cq.orderedProperties.record-type 參數。一個欄位的相關連結鉤可以利用使用者輸入這個欄位的值來決定如何設定另一欄位的值。 在這個實務中,您必須識別在送出同步化作業期間執行鏈結鉤的順序,以確保 ClearQuest 記錄欄位會設成正確的值。 例如:cq.orderedProperties.Defect=Headline,Type,Product,Component。 這個範例指定「問題報告」記錄類型中的「標題」欄位應該最先設定,接著再設定 「類型」、「產品」和 「元件」欄位。

      如果您同時指定了「Web 相依欄位」內容和 cq.orderedProperties 參數,ClearQuest Connector 會使用 cq.orderedProperties 參數所指定的順序。

    7. 關閉和儲存 cqconnector.properties 檔。
下一步
註: 由於 cqconnector.properties 檔包含 ClearQuest 和 Jazz 使用者帳戶的登入名稱和密碼,請務必設定這個檔案的許可權,只讓獲授權的使用者讀取它。

意見

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