Alle Gruppen auflisten
Dieser Service Task gibt alle Benutzergruppen zurück, die im aktuellen Tenant definiert sind.
Nutzen: Prozesse können dynamisch auf die Organisationsstruktur reagieren — verfügbare Gruppen für Routing, Zuweisung oder Benachrichtigungsentscheidungen auflisten, ohne Gruppennamen fest zu codieren.
Funktionsweise
Pantarey unterstützt Benutzergruppen zur Organisation von Benutzern in Teams, Abteilungen oder Rollen. Dieser Service Task fragt alle definierten Gruppen ab und gibt deren IDs und Anzeigenamen zurück.
Es ist keine Eingabe erforderlich — der Task gibt immer die vollständige Gruppenliste des aktuellen Tenants zurück.
Eingabeparameter
Keine Eingabeparameter erforderlich. Der Task kann mit einem leeren Objekt aufgerufen werden.
Beispiel-Eingabe
{}
Ausgabe
| Feld | Typ | Beschreibung |
|---|---|---|
totalCount |
Zahl | Anzahl der gefundenen Gruppen. |
groups |
Array | Liste der Gruppenobjekte. |
Jede Gruppe enthält:
| Feld | Typ | Beschreibung |
|---|---|---|
groupId |
String | Die eindeutige Gruppenkennung. |
displayName |
String | Der Anzeigename der Gruppe. |
Beispiel-Ausgabe
{
"totalCount": 3,
"groups": [
{ "groupId": "sales", "displayName": "Vertrieb" },
{ "groupId": "support", "displayName": "Kundendienst" },
{ "groupId": "management", "displayName": "Management" }
]
}
Anwendungsfälle
- Dynamisches Routing: Prozesse an verschiedene Bearbeiter weiterleiten, basierend auf verfügbaren Gruppen.
- Benachrichtigungsziele: Empfängerlisten zusammenstellen, indem alle Gruppen durchlaufen werden.
- Validierung: Prüfen, ob eine bestimmte Gruppe existiert, bevor ein Benutzer zugewiesen wird.
- Berichtswesen: Gruppen zählen oder in einer Prozessübersicht auflisten.
Hinweise
- Das Ergebnis enthält nur Gruppen, keine Mitglieder. Mit Gruppenmitglieder abrufen können die Benutzer einer bestimmten Gruppe abgefragt werden.
- Gruppen sind tenant-bezogen — es werden nur Gruppen des aktuellen Tenants zurückgegeben.