Obtention d'un objet Session

L'objet Session est le point d'entrée d'accès aux bases de données Rational ClearQuest. Si vous écrivez une application externe, vous devez créer un objet Session et l'utiliser pour vous connecter à une base de données. Une fois connecté à une base de données, vous pouvez utiliser l'objet Session pour :

Pour les points d'ancrage de script (VBScript et Perl), IBM Rational ClearQuest crée automatiquement un objet Session pour les points d'ancrage, lorsque l'utilisateur se connecte à la base de données. L'objet Session est disponible via l'objet Entity. Dans le contexte d'un crochet, pour obtenir un objet Session à partir d'un objet d'entité (Entity), utilisez la syntaxe suivante.

Langage de script
Syntaxe d'appel d'un objet Entity dans un crochet
VBScript
set currentSession = GetSession

Les points d'ancrage VBScript associent implicitement l'objet Entity à l'enregistrement en cours.

Perl
Lors de l'écriture de points d'ancrage Rational ClearQuest, un objet Session est créé et accessible via la variable de contexte $session. Vous n'avez pas besoin d'exécuter d'appel explicite pour le créer.
Si un objet Session est requis dans un autre contexte (lors de l'écriture d'une application externe, par exemple), vous pouvez obtenir un objet Session à l'aide de la syntaxe suivante :
$session=$entity->GetSession();

Pour les applications externes, vous devez créer un objet Session manuellement. Si vous souhaitez utiliser l'objet Adminsession, la même règle s'applique.

Exemple de langage
Syntaxe pour la création manuelle de l'objet Session (ou de l'objet AdminSession) dans une application externe
VBScript
set currentSession = CreateObject("CLEARQUEST.SESSION") 
set adminSession = CreateObject("CLEARQUEST.ADMINSESSION")
Perl
$currentSession = CQSession::Build();  
$currentAdminSession= CQAdminSession::Build();

Lorsque vous avez terminé d'utiliser l'objet, détruisez-le :

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


Commentaires en retour