Pour utiliser les fonctions des API ClearQuest,
procédez comme suit :
- Démarrez une session ClearQuest.
- Connectez-vous à une base de données ClearQuest.
- Utilisez les enregistrements ClearQuest.
- Fermez la session ClearQuest.
Pour les applications externes, vous devez créer un objet Session et l'utiliser
pour vous connecter à une base de données utilisateur.
Syntaxe pour la création d'un objet Session :
require CQPerlExt;
$CQsession = CQSession::Build();
Ensuite, vous pouvez vous connecter à une base de données en appelant la méthode
UserLogon
du nouvel objet Session ou récupérer d'abord une liste des bases de données accessibles.
Une fois que
la session est créée, supprimez l'objet Session
avec la méthode
Unbuild. Syntaxe pour l'édition d'un objet Session :
CQSession::Unbuild($session);
Les points d'ancrage sont liés à des événements qui se produisent lorsqu'un utilisateur interagit
avec IBM Rational ClearQuest. Etant donné que les points d'ancrage s'exécutent à des heures prédéfinies, pendant
une session, le code de point d'ancrage ne met pas fin à une session. La session s'arrête automatiquement lorsque l'utilisateur se déconnecte. Toutefois, lorsque vous écrivez une application externe, vous devez mettre fin à la session en cours en supprimant l'objet Session que vous avez créé. Supprimez tous les objets que vous avez explicitement créés et dont vous n'avez plus besoin, y compris l'objet Session.