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