Session オブジェクトは、Rational ClearQuest データベースにアクセスするためのエントリ ポイントです。 外部アプリケーションを作成する場合、Session オブジェクトを作成し、それを使用してデータベースにログオンする必要があります。データベースにログオンしたら、次の場合に Session オブジェクトを使用できます。
スクリプト フック (VBScript と Perl) の場合、IBM Rational ClearQuest は、ユーザーがデータベースにログオンする際に、使用するフックの Session オブジェクトを自動的に作成します。この Session オブジェクトは、Entity オブジェクトを介して使用できます。フックのコンテキスト内で、Entity オブジェクトから Session オブジェクトを取得するには、次の構文を使用します。
外部アプリケーションの場合は、手動で Session オブジェクトを作成する必要があります。AdminSession オブジェクトを使用する場合も、同様のルールが適用されます。
set currentSession = CreateObject("CLEARQUEST.SESSION")
set adminSession = CreateObject("CLEARQUEST.ADMINSESSION")
$currentSession = CQSession::Build(); $currentAdminSession= CQAdminSession::Build();
オブジェクト操作が終了したら、次のようにしてオブジェクトを破棄します。
CQSession::Unbuild($currentSession); CQAdminSession::Unbuild($currentAdminSession);