BuildQuery

Descripción

Crea y devuelve un nuevo objeto QueryDef para el tipo de registro especificado.

Puede utilizar el objeto QueryDef devuelto para compilar una consulta buscando registros cuyo tipo de registro coincida con el EntityDef especificado. Antes de llevar a cabo la búsqueda, se debe añadir al menos un campo a la lista de visualización de la consulta llamando al método BuildField del objeto QueryDef. También puede añadir filtros al objeto QueryDef para especificar los criterios de búsqueda. Para obtener más información sobre cómo especificar esta información, consulte la descripción y los métodos del Objeto QueryDef.

El nombre que se especifica en el parámetro entitydef_name debe corresponder a un tipo de registro adecuado en el esquema. Para obtener una lista de nombre permitidos para entitydef_name, utilice el método GetQueryEntityDefNames.

Antes de ejecutar la consulta, se debe asociar el objeto QueryDef a un Objeto ResultSet. Para obtener más información sobre cómo hacerlo, consulte el método BuildResultSet.

Nota: El campo id se debe incluir como uno de los campos de visualización (utilizando el método BuildField del objeto QueryDef) para que la consulta devuelva el conjunto de resultados completo. Para Rational ClearQuest Web, también debe incluir el campo dbid como uno de los campos de visualización.

Sintaxis

VBScript

session.BuildQuery(entitydef_name) 

Perl

$session->BuildQuery(entitydef_name); 
Identificador
Descripción
session
El objeto Session que representa la sesión de acceso a la base de datos actual.
entitydef_name
Un valor String que contienen el nombre de Objeto EntityDef que se va a utilizar como una plantilla al crear el registro.
Valor de retorno
Un nuevo Objeto QueryDef. Este objeto no contiene filtros ni campos de compilación.

Ejemplos

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"); 

Comentarios