BuildQuery

설명

지정된 레코드 유형에 대한 새 QueryDef 오브젝트를 작성하여 리턴합니다.

리턴된 QueryDef 오브젝트를 사용하여 레코드 유형이 지정된 EntityDef와 일치하는 검색 레코드의 조회를 빌드할 수 있습니다. 검색을 수행하기 전에 QueryDef 오브젝트의 BuildField 메소드를 호출하여 최소한 하나의 필드를 조회의 표시 목록에 추가해야 합니다. 필터를 QueryDef 오브젝트에 추가하여 검색 기준을 지정할 수도 있습니다. 이 정보의 지정에 대한 자세한 정보는 QueryDef 오브젝트의 설명과 메소드를 참조하십시오.

entitydef_name 매개변수에 지정하는 이름은 스키마의 적절한 레코드 유형에 해당해야 합니다. entitydef_name에 유효한 이름의 목록을 얻으려면 GetQueryEntityDefNames 메소드를 사용하십시오.

조회를 실행하기 전에 QueryDef 오브젝트를 ResultSet 오브젝트와 연관시켜야 합니다. 이렇게 하는 방법에 대한 자세한 정보는 BuildResultSet 메소드를 참조하십시오.

주: id 필드를 표시 필드의 하나로 포함시켜야(QueryDef 오브젝트의 BuildField 메소드를 사용하여) 조회가 완전한 결과 세트를 리턴합니다. Rational ClearQuest 웹의 경우 dbid 필드도 표시 필드의 하나로 포함시켜야 합니다.

구문

VBScript

session.BuildQuery(entitydef_name) 

Perl

$session->BuildQuery(entitydef_name); 
ID
설명
session
현재 database-access 세션을 나타내는 Session 오브젝트입니다.
entitydef_name
레코드를 작성할 때 템플리트로 사용할 EntityDef 오브젝트의 이름이 포함된 문자열입니다.
Return value
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");

피드백