使用 ClearQuest API 函数的常见顺序是从以下步骤开始:
- 启动 ClearQuest 会话。
- 登录到 ClearQuest 数据库。
- 处理 ClearQuest 记录。
- 结束 ClearQuest 会话。
对于外部应用程序,您必须创建一个 Session 对象,并使用其登录到用户数据库。
创建 Session 对象的语法如下:
require CQPerlExt;
$CQsession = CQSession::Build();
接下来,您可以通过调用新创建的 Session 对象的
UserLogon 方法登录到数据库,或首先获取可访问数据库的列表。
处理完会话后,使用
Unbuild 方法删除 Session 对象。释放 Session 对象的语法如下:
CQSession::Unbuild($session);
挂钩附于当用户与 IBM Rational ClearQuest 交互时所发生的事件。由于在会话期间预定义的时间会执行挂钩,因此您的挂钩代码不会结束会话。用户注销后,会话会自动结束。但是,当您编写外部应用程序时,必须通过删除自己创建的 Session 对象来结束当前会话。删除您显式创建并且不再需要的任何对象,包括 Session 对象。