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.
Le funzioni hook VBScript associano implicitamente l'oggetto entità al record corrente.
Per le applicazioni esterne, è necessario creare un oggetto sessione manualmente. Se si desidera utilizzare l'oggetto AdminSession, viene applicata la stessa regola.
set currentSession = CreateObject("CLEARQUEST.SESSION")
set adminSession = CreateObject("CLEARQUEST.ADMINSESSION")
$currentSession = CQSession::Build(); $currentAdminSession= CQAdminSession::Build();
Una volta finito con questo oggetto, eliminarlo:
CQSession::Unbuild($currentSession); CQAdminSession::Unbuild($currentAdminSession);