Session オブジェクトの取得

Session オブジェクトは、Rational ClearQuest データベースにアクセスするためのエントリ ポイントです。 外部アプリケーションを作成する場合、Session オブジェクトを作成し、それを使用してデータベースにログオンする必要があります。データベースにログオンしたら、次の場合に Session オブジェクトを使用できます。

スクリプト フック (VBScript と Perl) の場合、IBM Rational ClearQuest は、ユーザーがデータベースにログオンする際に、使用するフックの Session オブジェクトを自動的に作成します。この Session オブジェクトは、Entity オブジェクトを介して使用できます。フックのコンテキスト内で、Entity オブジェクトから Session オブジェクトを取得するには、次の構文を使用します。

スクリプト言語
フック内で Entity オブジェクトを呼び出す構文
VBScript
set currentSession = GetSession

VBScript フックは、暗黙的に Entity オブジェクトを現在のレコードに関連付けます。

Perl
Rational® ClearQuest® フックの作成時、Session オブジェクトはコンテキスト変数 $session を使用して作成され、使用可能になります。このオブジェクトの作成に明示的呼び出しを実行する必要はありません。
ほかのコンテキスト内で Session オブジェクトが必要な場合 (例えば外部アプリケーションを作成する場合など)、次の構文を使用して Session オブジェクトを取得できます。
$session=$entity->GetSession();

外部アプリケーションの場合は、手動で Session オブジェクトを作成する必要があります。AdminSession オブジェクトを使用する場合も、同様のルールが適用されます。

言語例
外部アプリケーションで Session オブジェクト (または AdminSession オブジェクト) を手動で作成する構文
VBScript
set currentSession = CreateObject("CLEARQUEST.SESSION")
set adminSession = CreateObject("CLEARQUEST.ADMINSESSION")
Perl
$currentSession = CQSession::Build();

$currentAdminSession= CQAdminSession::Build();

オブジェクト操作が終了したら、次のようにしてオブジェクトを破棄します。

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


フィードバック