< 前へ | 次へ >

ClearQuest CM API のセットアップとインストール

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 にアクセスするには、以下のステップを実行します。

  1. アーカイブ ファイル (%RATIONAL_INSTALL%\common\cm\teamapi.zip) のディレクトリ (\plugins\com.ibm.rational.stp.cmapi) にあるファイルを使用して Eclipse プラグインを作成します。
  2. ClearQuest CM API プラグインをランタイム構成に追加するには、プラグインを Eclipse インスタンスにコピーするか、新規の拡張機能インストール場所を作成します。これで、API の ための新しいディレクトリ (例えば、C:¥eclipse¥plugins¥com.ibm.rational.stp.cmapi) が作成されます。 新しいプラグインは ClearQuest CM API JAR ファイルおよび Rational ClearQuest JAR ファイル で構成されています。
  3. プラグイン ディレクトリを作成したら、インストール済みのそれぞれの JAR ファイルを、インストール ロケーションからこのディレクトリにコピーする必要があります。 ClearQuest JAR ファイルには ClearQuest CM API JAR ファイルが必要です。 このプラグインは、次回 Eclipse を開始したときに使用することができます。
  4. プラグインから ClearQuest CM API を使用するには、依存関係として com.ibm.rational.stp.cmapi を指定します。
これで、ClearQuest CM API を使用して Java プログラムの 作成を開始する準備ができました。
API を ClearQuest リソースで使用するには、ライセンス交付を受けて インストールされたバージョンの Rational ClearQuest が 必要です。 JAR ファイルをインストールして構成しても、対応する製品がインストールされていないと、その Java パッケージの呼び出しは失敗します。

演習のチェックポイント

これで、ClearQuest CM API を使用したプログラミング用にシステムが セットアップされたので、API オブジェクト モデルおよびプログラミング モデルの学習を開始する準備ができました。
この演習では、以下について学習しました。
  • ClearQuest CM API と Rational ClearQuest の関係
  • ClearQuest CM API を使用したプログラミングのためにシステムをセットアップする方法
  • ご使用のシステムに必要な ClearQuest CM API 内のファイル
< 前へ | 次へ >

フィードバック