getRelatedListValues

Méthodes de services Web › Méthodes de liste/requête › getRelatedListValues

getRelatedListValues

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

Paramètre	Type	Description
SID	Nombre entier	Identifie la session extraite depuis la connexion.
objectHandle	Chaîne	Identifie le descripteur d'objet.
listName	Chaîne	Identifie un nom d'attribut de type liste pour l'objet.
numToFetch	Nombre entier	Indique le nombre maximum de lignes à renvoyer. Il doit être différent de zéro. Indiquez -1 pour renvoyer toutes les lignes. Remarque : Quel que soit l'entier défini, les services Web peuvent renvoyer un maximum de 250 lignes par appel.
attributes	Chaîne[]	Identifie un tableau, contenant un ou plusieurs noms d'attributs, duquel extraire les valeurs. Les noms contenant des points sont autorisés.
getRelatedListValuesResult	String Holder	Identifie l'objet String Holder pour la capture des données renvoyées.
numRowsFound	Détenteur de nombre entier	Identifie l'objet de détenteur de nombre entier pour la capture des données renvoyées.

Description

Renvoie des valeurs pour les listes associées à un objet spécifique. Les listes doivent être définies en tant que QREL ou BREL. Utilisez les méthodes LREL pour demander les types LREL.

Par exemple, une liste est associée à l'objet demande. Cette liste est appelée children et contient les demandes enfants. Cette méthode constitue une alternative à la méthode getRelatedList() qui ne nécessite pas de descripteur de liste. Le format est similaire à getListValues(), à savoir :

<numRowsFound>

< UDSObjectList >

<UDSObject>
<Handle>
<AttributeName0>
<AttributeName1>

Vous pouvez récupérer des informations pour des attributs de liste d'objet à l'aide de schéma d'objet (majic). Vous pouvez également utiliser la méthode getObjectTypeInformation().

Eléments renvoyés

La méthode renvoie les éléments suivants :

Elément XML	Type	Description
<getRelatedListValuesResult>	N/D	Indique l'élément externe, <UDSObjectList>, qui contient une séquence d'éléments <UDSObject>. Chaque élément <UDSObject> contient un élément <Handle> et zéro, un ou plusieurs éléments <AttributeNameX>.
<numRowsFound>	Nombre entier	Indique le nombre total de lignes dans la liste appelée. Remarque : Le nombre total de lignes n'est pas nécessairement le nombre de lignes renvoyées.

Elément XML

Type

Description

N/D

Indique l'élément externe, <UDSObjectList>, qui contient une séquence d'éléments <UDSObject>. Chaque élément <UDSObject> contient un élément <Handle> et zéro, un ou plusieurs éléments <AttributeNameX>.

Nombre entier

Indique le nombre total de lignes dans la liste appelée.

Remarque : Le nombre total de lignes n'est pas nécessairement le nombre de lignes renvoyées.