ClearQuest® CM
API を使用する前に、クラスパスにファイルを追加して、ライセンス交付を受けた
バージョンの Rational® ClearQuest を
インストールする必要があります。
API は、Rational 製品で操作を実行するための共通コンポーネントです。Rational 製品でこの API を使用するには、ご使用のシステムにその製品をインストールしておく必要があります。 Rational 製品をインストールしたときにシステムにインストールされた API ファイルを、クラスパスにコピーすることも必要です。
API を
使用して Rational ClearQuest 操作を
実行するためには、以下の Java パッケージが必要です。
- javax.wvcm: ワークスペースのバージョン管理と構成管理パッケージ (WVCM)。
- com.ibm.rational.wvcm.stp: Rational ソフトウェア チーム パッケージは WVCM パッケージの拡張機能です。
このパッケージには、API のインターフェイスが含まれ、Rational 製品リソースの
共通オブジェクト モデルが用意されています。
このパッケージは、製品固有のリポジトリや実装の境界から独立しています。
- com.ibm.rational.wvcm.stp.cq: ClearQuest データベースに
アクセスできるようにする製品固有の拡張機能です。
このパッケージには、ClearQuest データベースおよびその基礎になるリソースの機能に対してさらに完全な (製品固有の) アクセスを行えるようにする機能が含まれています。
この
資料内にあるコードの例を、コンパイル可能な Java にカット アンド ペーストすることが
できるはずですが、コードはコンパイルされておらず、また誤植が含まれているためにコンパイルできない可能性があります。
これらの例の、完全でコンパイル可能なバージョンは、API の資料と共に配布される
補足的なアーカイブ ファイル内の samples という Eclipse プロジェクトにあります。
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 を使用
するには、API JAR ファイルのロケーションをクラスパスに追加する必要があります。
Eclipse プラグインから ClearQuest CM
API にアクセスするには、以下のステップを実行します。
API を ClearQuest リソースで使用するには、ライセンス交付を受けて
インストールされたバージョンの Rational ClearQuest が
必要です。
JAR ファイルをインストールして構成しても、対応する製品がインストールされていないと、その Java パッケージの呼び出しは失敗します。