BuildQuery

説明

指定されたレコード タイプの新規 QueryDef オブジェクトを作成して戻します。

戻された QueryDef オブジェクトを使用すると、指定された EntityDef と一致するレコード タイプのレコードを検索するクエリーを作成できます。検索を実行するには、QueryDef オブジェクトの BuildField メソッドを呼び出して、少なくとも 1 つのフィールドをクエリーの表示リストに追加しておく必要があります。また、QueryDef オブジェクトにフィルタを追加して、検索条件を指定することもできます。この情報の指定の詳細については、QueryDef オブジェクトの説明およびメソッドを参照してください。

entitydef_name パラメータに指定する名前は、スキーマ内の該当するレコード タイプに対応している必要があります。 entitydef_name の正当な名前のリストを取得するには、GetQueryEntityDefNames メソッドを使用します。

クエリーを実行するには、QueryDef オブジェクトと ResultSet オブジェクトを関連付ける必要があります。このための詳細については、BuildResultSet メソッドを参照してください。

注: 完全な結果セットを戻すには、クエリーに、表示フィールドの 1 つとして id フィールドが組み込まれている必要があります (QueryDef オブジェクトの BuildField メソッドを使用)。Rational® ClearQuest® Web の場合、表示フィールドの 1 つとして dbid フィールドも組み込む必要があります。

構文

VBScript

session.BuildQuery(entitydef_name) 

Perl

$session->BuildQuery(entitydef_name); 
識別子
説明
session
現在のデータベース アクセス セッションを表す Session オブジェクト。
entitydef_name
レコードを作成する場合にテンプレートとして使用する EntityDef オブジェクトの名前を含む String。
戻り値
新規の QueryDef オブジェクト。このオブジェクトには、フィルタもビルド フィールドも含まれていません。

VBScript

set sessionObj = GetSession 

' Create a query for "defect" records 
set queryDefObj = sessionObj.BuildQuery("defect") 

Perl

$sessionObj = $entity->GetSession();

# Create a query for "defect" records 
$queryDefObj = $sessionObj->BuildQuery("defect"); 

フィードバック