La secuencia común para utilizar las funciones de la API de ClearQuest empieza con estos pasos:
- Iniciar una sesión de ClearQuest.
- Iniciar la sesión en una base de datos de ClearQuest.
- Trabajar con registros de ClearQuest.
- Terminar la sesión de ClearQuest.
Para aplicaciones externas, debe crear un objeto Session y utilizarlo para iniciar la sesión en una base de datos de usuario.
Sintaxis para crear un objeto Session:
require CQPerlExt;
$CQsession = CQSession::Build();
A continuación, puede iniciar la sesión en una base de datos llamando al método
UserLogon del objeto Session que acaba de crear, o bien obtenga primero una lista de bases de datos accesibles.
Una vez que haya terminado la sesión, suprima el objeto Session con el método
Unbuild. Sintaxis para liberar un objeto Session:
CQSession::Unbuild($session);
Los enganches se adjuntan a sucesos que se producen cuando un usuario interactúa con IBM Rational ClearQuest. Como los enganches se ejecutan en momentos predefinidos a lo largo de una sesión, el código de enganche no finaliza una sesión. La sesión finaliza, automáticamente, cuando el usuario cierra la sesión. Sin embargo, cuando escribe una aplicación externa, debe finalizar la sesión actual suprimiendo el objeto Session que ha creado. Suprima cualquier objeto que haya creado de modo explícito y que ya no necesite, incluido un objeto Session.