Rubrique précédente: Méthodes de liste/requêteRubrique suivante: doQuery


doSelect

Les paramètres suivants s'appliquent à la méthode doSelect :

Paramètre

Type

Description

SID

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.

maxRows

Nombre entier

Indique le nombre maximum de lignes à renvoyer. Indiquez -1 pour renvoyer toutes les lignes.

Remarque : Quel que soit l'entier défini, CA SDM renvoie un maximum de 250 lignes par appel.

attributes

Chaîne[]

Identifie la liste d'attributs pour laquelle des valeurs sont extraites. Les attributs séparés par des points sont autorisés. Si ce champ n'est pas renseigné, toutes les valeurs d'attributs sont renvoyées. Ces attributs ne peuvent pas être définis comme LOCAL dans le fichier de définition majic. Les attributs LOCAL sont temporaires ; ils ne sont pas stockés dans la base de données.

Description

Effectue une sélection de type SQL sur une table d'objet spécifique. Indiquez un ou plusieurs attributs à extraire des objets correspondant à la clause where fournie.

Eléments renvoyés

Une séquence d'éléments <UDSObject>. Les formats suivants sont appliqués :

<UDSObjectList>
<UDSObject>
 <Handle>
 <Attributes>
<AttributeNameA>
<AttributeValueA0>
<AttributeValueA1>
<AttributeNameB>
<AttributeValueB0>
…

Elément XML

Type

Description

<UDSObject>

N/D

Indique l'élément UDSObject standard qui contient le descripteur ainsi que les valeurs d'attributs demandées.

<UDSObjectList>

Séquence

Contient un élément <Handle> et une séquence <Attributes>.

Par exemple, si vous utilisez la méthode suivante :

String[] myArray = ["last_name", "irst_name"]
doSelect(mySID, "cnt", "last_name LIKE 'J%'", 2, myArray)

Les éléments renvoyés sont :

<UDSObjectList>
<UDSObject>
<Handle>cnt:555A043EDDB36D4F97524F2496B35E75</Handle>
<Attributes>
<AttributeName>last_name</AttributeName>
<AttributeValue>Johnson</AttributeValue>
<AttributeName>first_name</AttributeName>
<AttributeValue>Carol</AttributeValue>
</Attributes>
</UDSObject>
<UDSObject>
<Handle>cnt:555A043EDDB36D4F97524F2496B35E76</Handle>
<Attributes>
<AttributeName>last_name</AttributeName>
<AttributeValue>Jones</AttributeValue>
<AttributeName>first_name</AttributeName>
<AttributeValue>Ron</AttributeValue>
</Attributes>
</UDSObject>
</UDSObjectList>