依預設,Rational CM API JAR 檔及其他必要的 JAR 檔會安裝在下列位置,其中變數 RATIONAL_INSTALL 代表安裝 Rational 產品檔案的目錄。
%RATIONAL_INSTALL%\Common\stpwvcm.jar
%RATIONAL_INSTALL%\Common\stpcmn.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 實例中,或是建立新的延伸規格安裝網站。這樣會為 ClearQuest CM API建立一個新目錄(例如:C:\eclipse\plug-ins\com.ibm.rational.stp.cmapi)。新的外掛程式包含 Rational CM API JAR 檔和 ClearQuest JAR 檔。在建立外掛程式目錄之後,您必須將每一個已安裝的 JAR 檔從其安裝位置複製到這個新的外掛程式目錄。每一個子提供者 JAR 檔都需要 ClearQuest CM API JAR 檔。下次啟動 Eclipse 時,即可使用此外掛程式。請注意,如果您安裝較新的產品版本或修補程式,則必須驗證外掛程式中的 JAR 檔是否符合已安裝的 JAR 檔並使用較新的 JAR 檔。
您必須將 com.ibm.rational.stp.cmapi 識別為相依關係,才能從外掛程式使用 ClearQuest CM API。如需建立外掛程式的相關資訊,請參閱 http://help.eclipse.org/help30/topic/org.eclipse.platform.doc.isv/guide/firstplugin.htm。
您也可以將 ClearQuest CM API 外掛程式當作專案匯入 Eclipse。
您必須有已授權且已安裝的 Rational 產品版本,才能使用該產品的 Rational CM API 子提供者。如果您已安裝子提供者 JAR 檔,但未安裝對應的產品,則呼叫 Java 套件會失敗。
若要讓用戶端應用程式對 Rational ClearQuest 子提供者發出要求,Rational ClearQuest 產品與呼叫 Rational ClearQuest CM API 的用戶端程式必須安裝在同一部電腦上。