Méthodes de services Web › Méthodes de gestion des groupes › getGroupMemberListValues

getGroupMemberListValues

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

Description

Fonctionne comme la méthode getListValues(), mais elle interroge les relations avec les groupes et les membres du système. Le système utilise un objet Membre du groupe (grpmem) spécial pour chaque relation avec les membres/groupes. C'est en réalité le système CA SDM qui gère les objets grpmem (vous ne les manipulez pas directement) : ces derniers sont indispensables pour certaines requêtes.

L'objet grpmem comporte simplement deux pointeurs : le premier vers un contact et le second vers un groupe, qui est en lui-même un objet Contact. Les noms des attributs sont respectivement member et group. Comme ce sont des pointeurs, vous devez utiliser la notation par insertion de point pour formuler normalement une requête. Par exemple, pour rechercher tous les contacts dont le nom de famille commence par la lettre B dans un groupe nommé Seattle, vous devez utiliser la requête suivante :

member.last_name LIKE 'B%' AND group.last_name = 'Seattle'

Vous devez utiliser des descripteurs de la manière habituelle, comme le montre l'exemple suivant :

member.last_name LIKE 'A%' AND group.id = U'555A043EDDB36D4F97524F2496B35E75'

Il est important de constater que cette méthode peut extraire des valeurs provenant de tous les membres et tous les groupes, et pas seulement d'un groupe unique. Pour obtenir des informations à propos de tous les membres d'un groupe ou d'un membre spécifique, il vous suffit d'indiquer un descripteur dans la clause WHERE. L'exemple suivant permet d'extraire les valeurs d'un groupe spécifique :

group.id = U'555A043EDDB36D4F97524F2496B35E75'

Tenez compte des concepts importants suivants :

• L'objet grpmem comporte deux attributs de pointeur : le premier désigne le membre et l'autre, le groupe.
• L'objet grpmem existe pour chaque relation avec les groupes/membres.

La méthode grpmem interroge en réalité la table de l'objet grpmem et renvoie donc un objet représentant une relation entre deux contacts. Par conséquent, les valeurs d'attributs que vous souhaitez extraire des attributs doivent avoir recours à la notation par insertion de point à partir de l'objet grpmem. Pour extraire les valeurs du membre, les noms des attributs doivent tous prendre la forme member.ATTRNAME, comme indiqué dans l'exemple suivant :

‘member.last_name'

Pour extraire les valeurs du groupe, utilisez group.ATTRNAME.

Remarque : Vous trouverez des exemples de requêtes efficaces pour les groupes et les membres sous la section Clause WHERE.

Eléments renvoyés

Ne renvoie automatiquement aucun descripteur. L'élément <Handle> renvoyé est toujours vide. Pour interroger le descripteur d'un membre ou d'un groupe pour chaque ligne, utilisez l'un des exemples suivants dans le paramètre des attributs décrit dans la table.

• “member.persistent_id”
• “group.persistent_id”