Argomento precedente: doSelect

Argomento successivo: getListValues

doQuery

I parametri seguenti sono validi per il metodo doQuery:

Parametro

Tipo

Descrizione

SID

Numero intero

Identifica la sessione recuperata dall'accesso.

ObjectType

Stringa

Identifica il tipo di oggetto (factory) per cui eseguire la query.

WhereClause

Stringa

(Facoltativo) Identifica la clausola where per la query.

Descrizione

Esegue un'operazione di selezione di tipo SQL per il tipo di oggetto specificato. Restituisce anche un handle di elenco che punti ad un elenco delle righe restituito dalla query, in cui ogni riga rappresenta un oggetto di CA SDM che corrisponde alla clausola where fornita. Il chiamante può caricare i valori per le righe di elenco utilizzando il metodo getListValues ().

Nota: per ulteriori informazioni sulle clausole where, consultare Clausole where.

L'elenco di oggetti viene memorizzato nel server di CA SDM impegnando le risorse di sistema. Il chiamante deve rilasciare l'elenco utilizzando il metodo freeListHandles().

Gli elenchi creati con questa funzione sono omogenei, ovvero gli oggetti in esso contenuti sono tutti dello stesso tipo e statici. Questo significa che l'elenco non subisce variazioni anche se il cambiamento ai dati di un oggetto ne determina l'esclusione dalla clausola where iniziale.

Valore restituito

Un handle di elenco che deve essere rilasciato utilizzando il metodo freeListHandle().

Elemento XML

Tipo

Descrizione

<listHandle>

Numero intero

Identifica l'handle dell'elenco.

<listLength>

Numero intero

Identifica la lunghezza dell'elenco generato.