インストールとセットアップの要件

個々の製品のインストールには、共通コンポーネントと該当製品の Rational® CM API サブプロバイダが組み込まれます。たとえば、Rational ClearQuest® 製品のインストールには、Rational ClearQuest CM API サブプロバイダが組み込まれます。サブプロバイダ層により、 確実に CM API コンポーネント インフラストラクチャがインストールされます。したがって、 インストールする製品の組み合わせによって、システムには、次のすべての JAR ファイルまたは そのサブセットが存在します。

Rational CM API インフラストラクチャは、すべてのサブプロバイダが存在するかどうかに関係なく機能するよう設計されています。 プロバイダ インターフェイスは、サブプロバイダ JAR ファイルの リリース レベルが異なる場合でも、それを許可します。

Rational CM API コンポーネントには、複数パーツで構成されるバージョン番号が関連付けられます。サブプロバイダをインストールすると、そのサブプロバイダの 前バージョンでインストールしたインフラストラクチャ コンポーネントを上書きしますが、上書きが行われるのは、 インフラストラクチャ コンポーネントのバージョンが、既にインストールされているものより新しい場合に限られます。

Rational CM API JAR ファイルと必要なほかの JAR ファイルは、デフォルトで次の場所にインストールされます。 変数 <install-dir> は、Rational 製品の ファイルがインストールされているディレクトリを示します。デフォルトでは、このディレクトリは UNIX® システムおよび Linux® では /opt/rational、Windows® システムでは C:\Program Files\IBM Rational です。

Rational CM API の JAR ファイルを使用するには、すべてのファイルの場所をクラスパスに追加しなければなりません。

Eclipse プラグインから Rational CM API へのアクセス

<install-dir>\common\com.ibm.rational.stp.teamapi.zip ファイルと (前の項で一覧表示した) ほかのインストール済みファイルにパッケージされているファイルを使用して、Eclipse プラグインを作成し、Eclipse ランタイム環境内のほかのプラグインからの Rational CM API へのアクセスをサポートできます。この zip ファイルには、CM API チュートリアルで説明している例などのコード例が含まれています。

Rational CM API プラグインを ランタイム構成に追加するには、プラグインを Eclipse インスタンスにコピーするか、新規拡張のインストール場所を作成します。 この作業により、Rational CM API 用の新規ディレクトリ (たとえば、C:\eclipse\plug-ins\com.ibm.rational.stp.teamapi) が作成されます。 この新規プラグインは、必要なものを完備した単純な Eclipse プラグインで、 Rational CM API JAR ファイルと製品固有の (ClearCase と ClearQuest の) JAR ファイルで構成されます。 .zip ファイルには、実際の製品の JAR ファイルも含まれていることに注意してください。プラグインのディレクトリを作成したら、 インストール済みの各 JAR ファイルを、それぞれのインストール場所から、この新規プラグイン ディレクトリにコピーする必要があります。各サブプロバイダ JAR ファイルに Rational CM API JAR ファイルが必要です。プラグインは、次に Eclipse を開始したときに 使用可能になります。さらに新しいバージョンの製品またはパッチをインストールした場合、プラグインにある JAR ファイルがインストール済みの JAR ファイルと一致することを確認して、新しい JAR ファイルを使用するように注意してください。

プラグインから Rational CM API を使用するには、依存関係に com.ibm.rational.stp.teamapi を指定しなければなりません。 プラグインの作成方法については、http://help.eclipse.org/help30/topic/org.eclipse.platform.doc.isv/guide/firstplugin.htm を参照してください。

また、CM API プラグインをプロジェクトとして Eclipse にインポートすることもできます。

特定の Rational 製品の Rational CM API サブプロバイダを使用するには、その製品のライセンス交付を受けたバージョンがインストール済みでなければなりません。サブプロバイダ JAR ファイルを インストールしても、対応する製品をインストールしていなければ、その Java™ パッケージへの呼び出しは失敗します。

Java クライアント アプリケーションから Rational CM API へのアクセス

クライアント アプリケーションが Rational ClearQuest サブプロバイダに要求をするには、Rational CM API を呼び出すクライアント プログラムと同じコンピュータ上に Rational ClearQuest 製品がインストールされていなければなりません。

ClearCase サブプロバイダは、 Rational ClearCase CM Server を通して、Web ビューとリモート アクセスをサポートします。Rational CM API の現在のバージョンでは、動的ビューまたはスナップショット ビューはサポートされていません。該当の JAR ファイルは、 CM Server から、Rational CM API の使用法に応じて、クライアント マシンのクライアント インストール場所かプラグイン ディレクトリのいずれかにコピーする必要があります。


フィードバック