< Vorherige Lektion | Nächste Lektion >

Perl verwenden

Sie können das ClearQuest-API-Perl-Paket (CQPerlExt) verwenden, indem Sie "cqperl.exe" oder "ratlperl.exe" ausführen.
Alle externen Anwendungen, die in Perl geschrieben sind, müssen mit einer der folgenden Anweisungen beginnen:
require CQPerlExt; 
oder
use CQPerlExt; 

Ab Version 2003.06.00 kann die Rational-ClearQuest-API mit "cqperl.exe" oder "ratlperl.exe" für externe Anwendungen verwendet werden. Bei Verwendung von "cqperl" werden "CQPerlExt.pm" implizit die korrekten Include-Pfade hinzugefügt ("CQPerlExt.pm" ist das Perl-Paket, das die Rational-ClearQuest-API zur Verfügung stellt). Unter UNIX und Linux kann "cqperl" nicht in der Anweisung use oder require in Perl-Scripts verwendet werden. Wenn Sie "ratlperl" auf einem UNIX-System und unter Linux verwenden, muss der korrekte Pfad gesetzt werden. Sie können das binäre Script "ratlperl" verwenden, das sich im Verzeichnis /opt/rational/common befindet, z. B. unter /opt/rational/common/linux_x86/bin.

Sie können "CQPerlExt.pm" nicht mit dem standardmäßigen Perl anstelle von "ratlperl" oder "cqperl" verwenden. Wenn Sie eine Integration mit anderen Modulen durchführen müssen, müssen Sie sie für die bereitgestellte Version von "ratlperl" erstellen.

Notationskonventionen für Perl:
  • Das Präfix für Objekte, auf die die Rational-ClearQuest-API über das CQPerlExt-Paket aufrufen kann, ist CQ. Beispiel: CQEntity $CQPerlExt::CQ
  • Das Präfix für Perl-Aufzählungskonstanten ist CQPerlExt::CQ. Beispiel: $CQPerlExt::CQ_DB2 als Wert der DB2-DatabaseVendor-Konstante.

Die Aufzählungskonstanten von Rational ClearQuest sind vorinstalliert und stehen in Feld-Hooks sowie in Datensatz-Scripts und globalen Scripts zur Verfügung. Zur Verwendung der Konstanten in einer externen Anwendung müssen Sie Ihrem Programm die Konstantendefinitionen hinzufügen, bevor Sie sie im Programm verwenden können. Andernfalls werden die Werte nicht gesetzt.

Lektionsprüfpunkt

Sie haben sich mit einigen Voraussetzungen für die Programmierung mit der ClearQuest-API auseinander gesetzt und können jetzt damit beginnen, sich mit dem Sitzungsobjekt der ClearQuest-API und der Nutzung der API in der Programmierung zu befassen.

Feedback