CM API 是對 Rational 產品執行作業的一般元件。
如果要對 Rational 產品使用這個 API,您必須將該產品安裝在系統上。
您還必須把在安裝 Rational 產品時已安裝在系統上的 CM API 檔案複製到類別路徑。
使用
Rational ClearQuest® 資源時所需的 CM API 檔案包括:所有 CM API 資源類型的必要檔案及
Rational ClearQuest 資源的必要檔案。
這些 Java™ 套件是使用 Rational CM
API 執行 Rational ClearQuest 作業所需要的。
- javax.wvcm:工作區版本化及配置管理套件 (WVCM)。
- com.ibm.rational.wvcm.stp:Rational 軟體小組套件是 WVCM 套件的延伸規格。
此套件包含 Rational CM API 的介面,並為 Rational 產品資源提供一般物件模型。
此套件與產品專用儲存庫或實作界限無關。
- com.ibm.rational.wvcm.stp.cq:產品專用延伸規格,提供 Rational ClearQuest 資料庫的存取權。此套件包含的功能,對
ClearQuest 資料庫及其基礎資源的功能提供更完整的(產品專用)存取權。
雖然您可以將此文件中的程式碼剪下及貼到可編譯的 Java 中,但它沒有編譯過,有可能因為包含印刷錯誤而無法編譯。這些範例的完整可編譯版本,可在補充保存檔中的 samples Eclipse 專案中找到,該保存檔是隨 Rational CM
API 的文件而分送的。
依預設,Rational CM
API JAR 檔和其他必要的 JAR 檔會安裝在下列位置。
install-dir 代表已安裝
Rational 產品檔案的目錄。
依預設,這個目錄在 UNIX® 系統和 Linux® 上會是
/opt/rational,在 Windows® 系統上則是
C:\Program Files\IBM Rational。
- 在 Windows 系統上:
- <install-dir>/Common/stpwvcm.jar:Rational CM
API 介面 JAR 檔。
- <install-dir>/Common/stpcmmn.jar:一般實作 JAR 檔。
- <install-dir>/ClearQuest/stpcq.jar:
ClearQuest 產品的延伸規格。
- <install-dir>/ClearQuest/cqjni.jar:Rational ClearQuest JAR
檔。
- 在 UNIX 及 Linux 系統上:
- <install-dir>/common/stpwvcm.jar
- <install-dir>/common/stpcmmn.jar
- <install-dir>/clearquest/cqweb/lib/stpcq.jar
- <install-dir>/clearquest/cqweb/lib/cqjni.jar
如果要使用 Rational CM API JAR 檔,您必須將所有其位置新增至類別路徑中。
若要從 Eclipse 外掛程式存取 Rational CM API,
可以將檔案 com.ibm.rational.stp.cmapi.zip 及專案範例匯入 Eclipse,或可以遵循下列步驟:
您必須有已安裝的 Rational ClearQuest 授權版本,才能對 ClearQuest 資源使用 Rational CM API。如果您安裝及配置 JAR 檔,但沒有安裝對應的產品,則對該Java 套件的呼叫會失敗。