Come ottenere un oggetto sessione

L'oggetto sessione è il punto di ingresso per accedere ai database Rational ClearQuest. Se si sta scrivendo un'applicazione esterna, è necessario creare un oggetto sessione e utilizzarlo per accedere ad un database. Dopo aver effettuato l'accesso ad un database, è possibile utilizzare l'oggetto sessione per:

Per le funzioni hook dello script (VBScript e Perl), IBM Rational ClearQuest crea automaticamente un oggetto sessione per le funzioni hook quando l'utente accede al database. L'oggetto sessione è disponibile tramite l'oggetto entità. Nel contesto di una funzione hook, per ottenere un oggetto sessione da un oggetto entità, utilizzare la seguente sintassi.

Linguaggio di script
Sintassi per effettuare una chiamata ad un oggetto entità in una funzione hook
VBScript
set currentSession = GetSession

Le funzioni hook VBScript associano implicitamente l'oggetto entità al record corrente.

Perl
Quando si scrivono funzioni hook Rational ClearQuest, viene creato e reso disponibile un oggetto sessione tramite la variabile di contesto $session. Non è necessario eseguire chiamate esplicite per crearlo.
Se si necessita di un oggetto sessione in qualche altro contesto (come quando si scrive un'applicazione esterna) è possibile ottenere un oggetto sessione utilizzando la seguente sintassi:
$session=$entity->GetSession();

Per le applicazioni esterne, è necessario creare un oggetto sessione manualmente. Se si desidera utilizzare l'oggetto AdminSession, viene applicata la stessa regola.

Esempio di linguaggio
Sintassi per la creazione manuale dell'oggetto sessione (o l'oggetto AdminSession) in un'applicazione esterna
VBScript
set currentSession = CreateObject("CLEARQUEST.SESSION") 
set adminSession = CreateObject("CLEARQUEST.ADMINSESSION")
Perl
$currentSession = CQSession::Build();  
$currentAdminSession= CQAdminSession::Build();

Una volta finito con questo oggetto, eliminarlo:

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


Feedback