Web-Service-Methoden › Gruppenverwaltungsmethoden › getGroupMemberListValues

getGroupMemberListValues

Die folgenden Parameter gelten für die Methode „getGroupMemberListValues“:

Beschreibung

Funktioniert ähnlich wie „getListValues()“, jedoch mit dem Unterschied, dass die Gruppen- und Mitgliederbeziehungen im System abgefragt werden. Das System verwendet ein spezielles Gruppenmitgliedsobjekt (grpmem) für jede Gruppen-/Mitgliedsbeziehung. Das CA SDM-System verwaltet "grpmem"-Objekte im Hintergrund (Sie bearbeiten sie nicht direkt). Diese Objekte sind für bestimmte Abfragen wichtig.

Das "grpmem"-Objekt enthält zwei Verweise, einen zu einem Kontakt und einen zweiten zu einer Gruppe, die selbst wiederum ein Kontaktobjekt ist. Die Attributnamen lauten „member“ bzw. „group“. Da es sich hierbei um Verweise handelt, muss die Punktnotation zur normalen Formulierung einer Abfrage verwendet werden. Um beispielsweise alle Kontakte zu suchen, deren Nachname mit „B“ beginnt und die sich in einer Gruppe mit dem Namen „Seattle“ befinden, würden Sie Folgendes verwenden:

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

Sie können auch Kennungen wie gewohnt verwenden, wie im Folgenden dargestellt:

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

Beachten Sie, dass diese Methode Werte von allen Mitgliedern und aus allen Gruppen abrufen kann, nicht nur aus einer einzelnen Gruppe. Um Informationen über alle Mitglieder einer bestimmten Gruppe oder eines bestimmten Mitglieds zu erhalten, legen Sie eine Kennung in der Where-Klausel fest. Das folgende Beispiel würde Werte aus einer bestimmten Gruppe abrufen:

group.id = U'555A043EDDB36D4F97524F2496B35E75'

Folgende Begriffe sind wichtig und müssen beachtet werden:

• Das „grpmem“-Objekt enthält zwei Verweisattribute: eines zu einem Mitglied und das andere zu einer Gruppe.
• Das „grpmem“-Objekt ist für jede Gruppen-/Mitgliedsbeziehung vorhanden.

Die Methode „grpmem“ fragt die Objekttabelle „grpmem“ ab und gibt ein Objekt zurück, das eine Beziehung zwischen zwei Kontakten darstellt. Daher muss für die in Attributen abzurufenden Attributwerte die Punktnotation aus dem „grpmem“-Objekt verwendet werden. Um Werte aus dem Mitglied abzurufen, sollten alle Attributnamen die Form „member.ATTRNAME“ aufweisen, wie im folgenden Beispiel dargestellt:

‘member.last_name’

Um Werte aus der Gruppe abzurufen, verwenden Sie „group.ATTRNAME“.

Hinweis: Ein Beispiel für eine effiziente Abfrage von Gruppen und Mitgliedern finden Sie unter "Where-Klauseln".

Rückgabe

Gibt automatisch keine Kennungen zurück. Das <Handle>-Element in der Rückgabe ist stets leer. Um die Mitglieds- oder Gruppenkennung für jede Zeile anzufordern, verwenden Sie einen der in der folgenden Tabelle beschriebenen Attributparameter.

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