Rational CM API インフラストラクチャは、すべてのサブプロバイダが存在するかどうかに関係なく機能するよう設計されています。 プロバイダ インターフェイスは、サブプロバイダ JAR ファイルの リリース レベルが異なる場合でも、それを許可します。
Rational CM API コンポーネントには、複数パーツで構成されるバージョン番号があります。サブプロバイダをインストールすると、そのサブプロバイダの 前バージョンでインストールしたインフラストラクチャ コンポーネントを上書きしますが、上書きが行われるのは、 インフラストラクチャ コンポーネントのバージョンが、既にインストールされているものより新しい場合に限られます。
デフォルトで、Rational CM API JAR ファイルおよび他の必要な JAR ファイルは、次の場所にインストールされます。変数 RATIONAL_INSTALL は、Rational 製品ファイルがインストールされているディレクトリを表します。
%RATIONAL_INSTALL%¥Common¥stpwvcm.jar
%RATIONAL_INSTALL%¥clearcase¥web¥cmapi¥stpcc.jar
%RATIONAL_INSTALL%¥ClearQuest¥stpcq.jar
次のファイルも必須ファイルです: %RATIONAL_INSTALL%¥ClearQuest¥cqjni.jar
Rational CM API の JAR ファイルを使用するには、すべてのファイルの場所をクラスパスに追加しなければなりません。
Eclipse プラグインは、前セクションにリストされたファイル、およびアーカイブ ファイル %RATIONAL_INSTALL%¥common¥cm¥teamapi.zip の ¥plugins¥com.ibm.rational.stp.cmapi ディレクトリにあるファイルを使用して作成できます。
Rational CM API プラグインを ランタイム構成に追加するには、ファイルを Eclipse インスタンスにコピーするか、新規拡張のインストール場所を作成します。この作業により、Rational CM API 用の新規ディレクトリ、例えば、C:¥eclipse¥plug-ins¥com.ibm.rational.stp.cmapi が作成されます。 この新規プラグインは、Rational CM API JAR ファイル、および製品固有 (ClearCase および ClearQuest) JAR ファイルで構成されます。プラグインのディレクトリを作成したら、 インストール済みの各 JAR ファイルを、それぞれのインストール場所から、この新規プラグイン ディレクトリにコピーする必要があります。 各サブプロバイダ JAR ファイルに Rational CM API JAR ファイルが必要です。プラグインは、次に Eclipse を開始したときに使用可能になります。さらに新しいバージョンの製品またはパッチをインストールした場合、プラグインにある JAR ファイルがインストール済みの JAR ファイルと一致することを確認して、新しい JAR ファイルを使用するように注意してください。
プラグインから Rational CM API を使用するには、依存関係に com.ibm.rational.stp.cmapi を指定しなければなりません。プラグインの作成については、http://help.eclipse.org/help30/topic/org.eclipse.platform.doc.isv/guide/firstplugin.htmを参照してください。
また、CM API プラグインをプロジェクトとして Eclipse にインポートすることもできます。
特定の Rational 製品の Rational CM API サブプロバイダを使用するには、その製品のライセンス交付を受けたバージョンがインストール済みでなければなりません。サブプロバイダ JAR ファイルを インストールしても、対応する製品をインストールしていなければ、その Java™ パッケージへの呼び出しは失敗します。
クライアント アプリケーションが Rational ClearQuest サブプロバイダに要求をするには、Rational CM API を呼び出すクライアント プログラムと同じコンピュータ上に Rational ClearQuest 製品がインストールされていなければなりません。
ClearCase サブプラバイダは、Change Management Server (CM Server) を通して、Web ビューとリモート アクセスをサポートします。Rational CM API の現在のバージョンでは、動的ビューまたはスナップショット ビューはサポートされていません。該当の JAR ファイルは、 CM Server から、Rational CM API の使用法に応じて、クライアント コンピュータ(クライアント インストール場所か、plug-in ディレクトリのいずれか) にコピーする必要があります。