Rubrique précédente: doSelectRubrique suivante: getListValues


doQuery

Les paramètres suivants s’appliquent à la méthode doQuery :

Paramètre

Type

Description

ID de système

Nombre entier

Identifie la session extraite depuis la connexion.

ObjectType

Chaîne

Identifie le type d'objet (sous-objet) à interroger.

WhereClause

Chaîne

(Facultatif) Identifie la clause where de la requête.

Description

Effectue une sélection de type SQL sur le type d’objet spécifié. Renvoie également un descripteur de liste qui pointe vers une liste des lignes renvoyées par la requête, où chaque ligne représente un objet CA SDM qui correspond à la clause Where fournie. L’appelant peut extraire des valeurs pour les lignes de la liste à l’aide de la méthode getListValues().

Remarque : Pour plus d'informations sur les clauses Where, reportez-vous à la section Clauses Where.

Important : La liste d'objets est stockée sur le serveur CA SDM et consomme des ressources système. L’appelant doit libérer la liste à l’aide de la méthode freeListHandles(). La présence d'une liste dans la mémoire peut entraîner un dépassement de la mémoire allouée au processus au-delà de la limite de 2 Go, des fuites de mémoire et une panne du système.

Les listes créées à l’aide de cette fonction sont homogènes, ce qui signifie que tous les objets sont de même type. Ils sont également statiques, ce qui signifie que la liste ne change pas, même si la modification d’une donnée d’un objet entraîne son exclusion de la clause Where initiale.

Eléments renvoyés

Un descripteur de liste à libérer à l’aide de freeListHandle().

Elément XML

Type

Description

<listHandle>

Nombre entier

Identifie le descripteur de liste.

<listLength>

Nombre entier

Identifie la longueur de la liste générée.