BuildField

Descripción

Selecciona un campo para incluir los resultados de búsqueda de la consulta.

Antes de ejecutar una consulta, debe especificar un campo, como mínimo, en el que visualizar el resumen de los resultados de la búsqueda. Debe llamar a este método una vez para especificar cada campo que desea visualizar. El objeto ResultSet muestra los campos de izquierda a derecha en el orden en el que se han añadido al objeto QueryDef. En otras palabras, cada vez que llama a este método, añade el campo especificado al final de la lista; este orden no se puede cambiar.

Puesto que se asocia un objeto QueryDef con un objeto EntityDef al llamar al método BuildQuery, el parámetro field_name debe contener el nombre de un campo válido en el objeto EntityDef. Para obtener valores válidos para el argumento field_name argument, puede consultar el objeto EntityDef llamando a su método GetFieldDefNames.

Puede llamar a BuildField antes o después de construir la expresión de consulta (el árbol de nodos de filtro).

Sintaxis

VBScript

querydef.BuildField field_name

Perl

$querydef->BuildField(field_name);
Identificador
Descripción
querydef
Un objeto QueryDef.
field_name
Un valor String que identifica un campo válido del objeto EntityDef asociado.
Valor de retorno
Ninguno.

Ejemplo

VBScript

' Create a query for defect where id = SAMPL00000001
Dim  session
Set session = CreateObject("CLEARQUEST.SESSION")
session.UserLogon "admin", "", "SAMPL", AD_PRIVATE_SESSION, ""

 Set QueryDef = session.BuildQuery("defect")
 QueryDef.BuildField ("headline")
 QueryDef.BuildField ("id")

 Set filternode1 = QueryDef.BuildFilterOperator (AD_BOOL_OP_AND)
 filterNode1.BuildFilter "id", AD_COMP_OP_EQ, "SAMPL00000001"
 Set rsltset = session.BuildResultSet(QueryDef)
 rsltset.Execute

 Status = rsltset.MoveNext

Perl

$queryDef = $CQSession->BuildQuery("Defect");

@dbfields = ("ID","State","Headline");

foreach $field (@dbfields) {
      $queryDef->BuildField($field);
      }

Feedback