Session-Objekt abrufen

Das Session-Objekt ist der Einstiegspunkt für den Zugriff auf die Rational ClearQuest-Datenbanken. Wenn Sie eine externe Anwendung schreiben, müssen Sie ein Session-Objekt erstellen und es für die Anmeldung an der Datenbank verwenden. Nach Anmeldung an der Datenbank haben Sie mit dem Session-Objekt die folgenden Möglichkeiten:

Bei Script-Hooks (VBScript und Perl) erstellt IBM Rational ClearQuest automatisch ein Session-Objekt für die Hooks, wenn sich der Benutzer an der Datenbank anmeldet. Das Session-Objekt wird über das Entity-Objekt zur Verfügung gestellt. Im Kontext eines Hooks verwenden Sie die folgende Syntax, um ein Session-Objekt aus einem Entity-Objekt abzurufen:

Scripting-Sprache
Syntax für den Aufruf eines Entity-Objekts in einem Hook
VBScript
set currentSession = GetSession

VBScript-Hooks ordnen das Entity-Objekt implizit dem aktuellen Datensatz zu.

Perl
Beim Schreiben von Rational ClearQuest-Hooks wird ein Session-Objekt erstellt und über die Kontextvariable $session zur Verfügung gestellt. Sie müssen für die Erstellung keinen expliziten Aufruf ausführen.
Wenn Sie ein Session-Objekt in einem anderen Kontext benötigen (z. B. beim Schreiben einer externen Anwendung), können Sie das Session-Objekt mit der folgenden Syntax abrufen:
$session=$entity->GetSession();

Für externe Anwendungen müssen Sie ein Session-Objekt manuell erstellen. Bei Verwendung des AdminSession-Objekts gilt dieselbe Regel.

Sprachbeispiel
Syntax für die manuelle Erstellung des Session-Objekts (oder AdminSession-Objekts) in einer externen Anwendung
VBScript
set currentSession = CreateObject("CLEARQUEST.SESSION") 
set adminSession = CreateObject("CLEARQUEST.ADMINSESSION")
Perl
$currentSession = CQSession::Build();  
$currentAdminSession= CQAdminSession::Build();

Wenn Sie das Objekt nicht mehr benötigen, löschen Sie es:

CQSession::Unbuild($currentSession);
CQAdminSession::Unbuild($currentAdminSession);


Feedback