Standardmäßig werden die Rational CM API-JAR-Datei sowie die anderen erforderlichen JAR-Dateien an den folgenden Positionen installiert, wobei die Variable RATIONAL_INSTALL das Verzeichnis angibt, in dem die Rational-Produktdateien installiert sind.
%RATIONAL_INSTALL%\Common\stpwvcm.jar
%RATIONAL_INSTALL%\Common\stpcmn.jar
%RATIONAL_INSTALL%\clearcase\web\cmapi\stpcc.jar
%RATIONAL_INSTALL%\ClearQuest\stpcq.jar
Die folgende Datei wird ebenfalls benötigt: %RATIONAL_INSTALL%\ClearQuest\cqjni.jar
Sie müssen die Position aller JAR-Dateien der Rational CM API zu Ihrem Klassenpfad hinzufügen, um die Dateien verwenden zu können.
Sie erstellen ein Eclipse-Plug-in, indem Sie die im vorherigen Abschnitt aufgelisteten Dateien im Verzeichnis \plugins\com.ibm.rational.stp.cmapi der Archivdatei %RATIONAL_INSTALL%\common\cm\teamapi.zip verwenden.
Um das Rational CM- API-Plug-in zu Ihrer Laufzeitkonfiguration hinzufügen, kopieren Sie die Dateien in Ihre Eclipse-Instanz, oder erstellen Sie einen neuen Erweiterungsinstallationstandort. Hierdurch wird ein neues Verzeichnis für die ClearQuest CM API erstellt, beispielsweise C:\eclipse\plug-ins\com.ibm.rational.stp.cmapi. Das neue Plug-in umfasst die Rational CM API-JAR-Dateien und die ClearQuest-JAR-Dateien. Nach der Erstellung des Plug-in-Verzeichnisses müssen Sie jede installierte JAR-Datei von ihrer Installationsposition in ihr neues Plug-in-Verzeichnis kopieren. Für jede Subprovider-JAR-Datei ist die ClearQuest CM API-JAR-Datei erforderlich. Das Plug-in kann ab dem nächsten Start von Eclipse verwendet werden. Falls Sie eine neuere Produktversion oder ein Patch installieren, müssen Sie sicherstellen, dass die JAR-Dateien im Plug-in mit den installierten JAR-Dateien übereinstimmen, und dass Sie die neuen JAR-Dateien verwenden.
Sie müssen com.ibm.rational.stp.cmapi als eine Abhängigkeit angeben, um die ClearQuest CM API Ihres Plug-ins zu verwenden. Unter http://help.eclipse.org/help30/topic/org.eclipse.platform.doc.isv/guide/firstplugin.htm finden Sie Informationen zur Erstellung eines Plug-ins.
Sie können das ClearQuest CM API-Plug-in auch als Projekt in Eclipse importieren.
Voraussetzung für die Verwendung des Rational CM-API-Subproviders für ein Rational-Produkt ist eine installierte Lizenzversion des Rational-Produkts. Sollten Sie die Subprovider-JAR-Dateien installieren, ohne das entsprechende Produkt installiert zu haben, schlagen Aufrufe dieses Java-Pakets fehl.
Damit eine Clientanwendung Anforderungen an den Rational ClearQuest-Subprovider richten kann, muss das Produkt Rational ClearQuest auf demselben Computer wie das Clientprogramm installiert sein, das die Rational ClearQuest CM API aufruft.