BuildQuery

Descrizione

Crea e restituisce un nuovo oggetto QueryDef per il tipo di record specificato.

È possibile utilizzare l'oggetto QueryDef restituito per creare una query per ricercare i record il cui tipo di record corrisponde all'oggetto EntityDef specificato. Prima di poter eseguire la ricerca, è necessario aggiungere almeno un campo all'elenco di visualizzazione della query richiamando il metodo BuildField dell'oggetto QueryDef. Inoltre, è possibile aggiungere i filtri all'oggetto QueryDef per specificare i criteri di ricerca. Per ulteriori informazioni sulla specifica di tali informazioni, consultare la descrizione ed i metodi dell'QueryDef Object.

Il nome specificato nel parametro entitydef_name deve corrispondere a un tipo di record appropriato nello schema. Per ottenere un elenco di nomi validi per entitydef_name, utilizzare il metodo GetQueryEntityDefNames.

Prima di poter eseguire la query, è necessario associare l'oggetto QueryDef ad un Oggetto ResultSet. Consultare il metodo BuildResultSet per informazioni sull'esecuzione di tale operazione.

Nota: il campo id deve essere incluso come uno dei campi di visualizzazione (utilizzando il metodo BuildField dell'oggetto QueryDef) per la query per restituire la serie completa di risultati. Per il Web di Rational ClearQuest, è inoltre necessario includere il campo dbid come uno dei campi di visualizzazione.

Sintassi

VBScript

session.BuildQuery(entitydef_name) 

Perl

$session->BuildQuery(entitydef_name); 
Identificativo
Descrizione
session
L'oggetto Session che rappresenta la sessione di accesso al database corrente.
entitydef_name
Una stringa che contiene il nome dell'Oggetto EntityDef da utilizzare come modello durante la creazione del record.
Valore di ritorno
Un nuovo QueryDef Object. Questo oggetto non contiene alcun filtro o campo di creazione.

Esempi

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

Feedback