Damit Sie die ClearQuest CM-API
verwenden können, müssen Sie Ihrem Klassenpfad Dateien hinzufügen und eine
lizenzierte Version von Rational
ClearQuest installiert
haben.
Die API ist eine allgemeine Komponente zur Ausführung von Operationen für
Rational-Produkte. Damit Sie diese
API mit einem Rational-Produkt verwenden können,
muss das Produkt auf Ihrem System installiert sein. Außerdem müssen Sie die API-Dateien,
die bei der Installation des Rational-Produkts
auf Ihrem System installiert werden, in Ihren Klassenpfad kopieren.
Die folgenden
Java-Pakete sind erforderlich, um
Rational
ClearQuest-Operationen durch Verwendung
der API auszuführen.
- javax.wvcm: Das WVCM-Paket (Workspace Versioning and Configuration
Management).
- com.ibm.rational.wvcm.stp: Das
Rational-Software-Team-Paket ist eine
Erweiterung des WVCM-Pakets. Dieses Paket enthält die Schnittstellen der API und stellt
das allgemeine Objektmodell für
Rational-Produktressourcen
bereit. Dieses Paket ist unabhängig von produktspezifischen Repository- oder Implementierungsgrenzen.
- com.ibm.rational.wvcm.stp.cq: Eine produktspezifische Erweiterung,
die Zugriff auf ClearQuest-Datenbanken
zur Verfügung stellt.
Dieses Paket enthält Funktionen, die einen umfassenderen (produktspezifischen) Zugriff auf die Funktionalität
einer ClearQuest-Datenbank und ihre
zu Grunde liegenden Ressourcen bereitstellt.
Zwar sollte es prinzipiell
möglich sein, die Codebeispiele in diesem Dokument auszuschneiden und in kompilierbaren
Java-Code einzufügen. Allerdings wurde
der Code nicht kompiliert und er könnte Schreibfehler enthalten, die die Kompilierung
möglicherweise verhindern. Sie finden vollständige, kompilierbare Versionen dieser Beispiele
in dem Eclipse-Projekt mit dem Namen samples in der ergänzenden Archivdatei,
die zusammen mit der API-Dokumentation verteilt wird.
Die JAR-Datei für die
ClearQuest CM-API und weitere erforderliche
JAR-Dateien werden standardmäßig an den folgenden Positionen installiert.
Dabei ist
Installationsverzeichnis das Verzeichnis, in dem die
Rational-Produktdateien installiert
wurden. Standardmäßig lautet dieses Verzeichnis /opt/rational
auf UNIX®- und Linux®-Systemen und
C:\Programme\IBM Rational auf
Windows®-Systemen.
- Auf Windows-Systemen:
- <Installationsverzeichnis>/Common/stpwvcm.jar:
Die JAR-Datei für die ClearQuest
CM-API-Schnittstelle.
- <Installationsverzeichnis>/Common/stpcmmn.jar: Eine JAR-Datei für allgemeine Implementierung.
- <Installationsverzeichnis>/ClearQuest/stpcq.jar: Erweiterung für das
ClearQuest-Produkt.
- <Installationsverzeichnis>/ClearQuest/cqjni.jar:
Eine JAR-Datei für Rational
ClearQuest.
- Auf UNIX- und
Linux-Systemen:
- <Installationsverzeichnis>/common/stpwvcm.jar
- <Installationsverzeichnis>/common/stpcmmn.jar
- <Installationsverzeichnis>/clearquest/cqweb/lib/stpcq.jar
- <Installationsverzeichnis>/clearquest/cqweb/lib/cqjni.jar
Sie
müssen die Positionen der API-JAR-Dateien Ihrem Klassenpfad hinzufügen, damit Sie
die API verwenden können.
Führen Sie die folgenden Schritte aus, um von
einem Eclipse-Plug-in auf die ClearQuest
CM-API zuzugreifen:
Jetzt können Sie damit beginnen, Java-Programme
unter Verwendung der ClearQuest CM-API zu
schreiben.
Sie müssen über eine lizenzierte und installierte Version von
Rational
ClearQuest verfügen, damit Sie die API
mit ClearQuest-Ressourcen
verwenden können.
Wenn Sie die JAR-Dateien installieren und konfigurieren, ohne dass das zugehörige Produkt installiert ist,
scheitern die Aufrufe an dieses
Java-Paket.