這個版本的 ClearQuest® Connector 有若干限制和已知問題。
這個版本包含下列限制和已知問題:
- 如果要使用 ClearQuest Connector,必須執行 IBM® Rational® ClearQuest 7.0.1 或更新版本。
- 「ClearQuest Connector
設定精靈」只能在 Windows® 上執行。如果您將 ClearQuest Connector
部署在 Linux® 上,您可以在 Windows 上執行「ClearQuest Connector 設定精靈」。此精靈會產生供「閘道」使用的 cqconnector.properties 檔。您可以將產生的內容檔複製到
Linux 電腦、進行編輯,然後在該電腦上啟動「閘道」。
- 在「ClearQuest Connector 設定精靈」的「Jazz™ 伺服器配置」部分,如果 Jazz 使用者登錄是唯讀的,則建立新帳戶選項會失敗。
如果 Jazz Team Server 是在 WebSphere® Application Server 上執行,或已配置為使用「輕量型目錄存取通訊協定 (LDAP)」時,確實會發生這種情況。
- 當工作項目註解與 ClearQuest 問題報告附註同步化時,會套用下列限制:
- 附註的時間戳記是同步化的時間,不是建立註解的時間。
- 附註的相關使用者名稱是 ClearQuest Connector 使用者帳戶的使用者名稱,而不是建立註解的使用者。
- 由於附註和註解的新增內容是附加到現有項目上,無法交錯,因此,項目的順序便是同步化的順序,而不是建立的順序。
- 當在 ClearQuest 記錄類型和 Rational Team Concert™ 項目之間對映狀態值時,您無法對映從 ClearQuest 的「已關閉」狀態到「已開啟」狀態的轉移。
- Jazz 儲存庫可以包含多國語言的字元資料,因為它用 Unicode 格式來儲存資料,但 ClearQuest 使用者資料庫每次只能存放一個字集的資料。
如果 ClearQuest 使用者資料庫的字集不支援工作項目的字集,同步化作業便會失敗,且會出現類似下列錯誤:
"「說明」欄位包含資料字碼頁 "1252 (MS Windows Latin 1)" 不支援的字元。"
- 在 ClearQuest 使用者資料庫中,UnDuplicate 動作會將記錄的狀態改成 Duplicate 動作之前的狀態。
在某些情況下,Rational Team Concert 工作項目無法進行相同的狀態轉移,因為它的狀態轉移模型不支援這項轉移。
- 當您在與 Rational Team Concert 項目同步化的 ClearQuest 記錄類型中定義關鍵字時,請使用小寫且不包含空格。
- 雖然 ClearQuest 記錄可以有多個附件清單欄位,但 Rational Team Concert 項目只能有一個。
- 請勿新增「說明」內容的對映到附件同步化規則;它不受支援,會造成同步化失敗,出現下列錯誤:「附件內容名稱無效:說明」。
- 如果您在 Microsoft® Internet Explorer 瀏覽器中使用 Rational Team Concert Web 介面時,新增附件到工作項目,而附加的檔案是在遠端電腦上,在某些情況中,同步化會失敗。
如果要暫時解決這個問題,請移除附件,將它複製到本端電腦,然後將它重新連接到工作項目。
或者,您可以將附件檔保留在遠端電腦上,等使用不同的瀏覽器時,再重新連接它。
- 如果 ClearQuest Connector 是搭配 DB2® 使用者資料庫和綱目儲存庫使用,在特定情況下資料庫可能發生死鎖。如果要避免這個問題,請將使用者資料庫和綱目儲存庫的 DB2 MAXAPPLS 參數設為 200。
- 當在 cqconnector.properties 檔中,利用 com.ibm.team.uris 參數來指定 Jazz 伺服器的「統一資源識別碼 (URI)」時,使用者名稱或密碼組件不可包含非標準 URL 字元,如 @ 字元。
請利用適當的跳出字元來取代非標準 URL 字元。
例如,利用 %40 來代替 @ 字元。
- 如果您在非 ASCII 環境下使用 ClearQuest Connector,對於 cqconnector.properties 檔中的任何非 ASCII 字元,您必須使用 Unicode 跳出字元。
Java™ 公用程式 native2ascii 可以將其他格式的字元轉換成 Unicode 跳出格式。
- 在支援 UTF-8 編碼的文字編輯器中(例如「記事本」)建立並儲存一個檔案,其中包含 cqconnector.properties 檔的非 ASCII 字元。
- 在執行 Windows 的電腦上,開啟「DOS 命令提示字元」主控台,並導覽至 Java-installation-directory/bin 目錄。
- 輸入 native2ascii.exe –encoding source-file to-be-generated-unicode-escape-file,其中 source-file 是您在步驟 1 建立的檔案。
- 開啟產生的檔案,複製其中的 Unicode 跳出字元。
開啟 cqconnector.properties 檔。將 Unicode 跳出字元貼到 cqconnector.properties 檔中需要的地方。
儲存已修改的 cqconnector.properties 檔。
- 您在將 JazzInterop 套件套用於綱目時,選取套件所要套用的一或多個記錄類型。
如果您後來決定要將套件套用於最初套用套件時所未選取的有狀態記錄類型,您可以這麼做。
不過,如果綱目的預設 Scripting 語言是 Visual Basic,您便無法將套件套用於最初將套件套用於綱目時所未選取的無狀態記錄類型。
- install-directory/gateway 目錄中的 server.shutdown Script 無法關閉「ClearQuest 閘道」。
在 Windows 上,按一下 Tomcat 主控台視窗的關閉圖示 (X)。
在 Linux 上,輸入 kill -9 process-ID 指令。
- Rational Team Concert 2.0
和 2.0.0.1 版中的「ClearQuest 匯入精靈」不相容於 ClearQuest 7.1.1。如果要將精靈與 ClearQuest 7.1.1 搭配使用,請升級至 Rational Team Concert 2.0.0.2。