Rational CM API 基礎架構的設計並不會考慮所有子提供者是否存在,一概都能運作。提供者介面允許子提供者 JAR 檔屬於不同的版本層次。
Rational CM API 元件具有多組件版本號碼。只有在基礎架構元件的版本比已安裝的版本還新的情況下,安裝一個子提供者才會改寫由舊版的子提供者所安裝的基礎架構元件。
依預設,Rational CM API JAR 檔及其他必要的 JAR 檔會安裝在下列位置,其中變數 RATIONAL_INSTALL 代表安裝 Rational 產品檔案的目錄。
%RATIONAL_INSTALL%\Common\stpwvcm.jar
%RATIONAL_INSTALL%\clearcase\web\cmapi\stpcc.jar
%RATIONAL_INSTALL%\ClearQuest\stpcq.jar
也需要下列檔案:%RATIONAL_INSTALL%\ClearQuest\cqjni.jar
若要使用 Rational CM API JAR 檔,您必須將其所有位置都新增至類別路徑中。
您可以使用前一節中列出的檔案,以及位於保存檔 %RATIONAL_INSTALL%\common\cm\teamapi.zip 中 \plugins\com.ibm.rational.stp.cmapi 目錄的檔案,來建立 Eclipse 外掛程式。
若要將 Rational CM API 外掛程式新增至執行時期配置中,請將這些檔案複製到 Eclipse 實例中,或是建立新的延伸規格安裝網站。這樣會為 Rational CM API 建立一個新目錄(例如:C:\eclipse\plug-ins\com.ibm.rational.stp.cmapi)。新的外掛程式包含 Rational CM API JAR 檔及產品特有的(ClearCase 及 ClearQuest)JAR 檔。在建立外掛程式目錄之後,您必須將每一個已安裝的 JAR 檔從其安裝位置複製到這個新的外掛程式目錄。每一個子提供者 JAR 檔都需要 Rational CM API JAR 檔。下次啟動 Eclipse 時,即可使用此外掛程式。請注意,如果您安裝較新的產品版本或修補程式,則必須驗證外掛程式中的 JAR 檔是否符合已安裝的 JAR 檔並使用較新的 JAR 檔。
您必須將 com.ibm.rational.stp.cmapi 識別為相依關係,才能從外掛程式使用 Rational CM API。如需建立外掛程式的相關資訊,請參閱http://help.eclipse.org/help30/topic/org.eclipse.platform.doc.isv/guide/firstplugin.htm。
您也可以將 CM API 外掛程式當作專案匯入 Eclipse 中。
您必須有已授權且已安裝的 Rational 產品版本,才能使用該產品的 Rational CM API 子提供者。如果您已安裝子提供者 JAR 檔,但未安裝對應的產品,則呼叫 Java™ 套件會失敗。
若要讓用戶端應用程式對 Rational ClearQuest 子提供者發出要求,Rational ClearQuest 產品與呼叫 Rational CM API 的用戶端程式必須安裝在同一部電腦上。
ClearCase 子提供者支援 Web 視圖,以及透過「變更管理伺服器」(CM 伺服器)進行遠端存取。目前的 Rational CM API 版本不支援動態或 Snapshot 視圖。必須根據 Rational CM API 的使用方式,將適當的JAR檔從「CM 伺服器」複製到用戶端電腦(用戶端安裝位置或 plug-in 目錄)。