user_groups()

Gibt alle Gruppen zurück, denen der angegebene Benutzer angehört.

1. Signatur

  • Sync

  • Async

ecm.security.user_groups(user_guid: str) -> list[ECMGroup]
await ecm.security.user_groups(user_guid: str) -> list[ECMGroup]

2. Parameter

Parameter Standard Beschreibung

user_guid

—

GUID des Benutzers, dessen Gruppenmitgliedschaften abgerufen werden sollen.

3. Rückgabewert

Liste von ECMGroup-Instanzen. Leere Liste, wenn der Benutzer keiner Gruppe angehört.

Felder von ECMGroup — siehe groups().

4. Beispiele

4.1. Gruppen eines Benutzers abrufen

  • Sync

  • Async

user = ecm.security.user("john")
if user:
    groups = ecm.security.user_groups(user.guid)
    for group in groups:
        print(group.name)
user = await ecm.security.user("john")
if user:
    groups = await ecm.security.user_groups(user.guid)
    for group in groups:
        print(group.name)

4.2. Prüfen ob Benutzer Mitglied einer bestimmten Gruppe ist

  • Sync

  • Async

user = ecm.security.user("john")
if user:
    groups = ecm.security.user_groups(user.guid)
    is_admin = any(g.name == "Administrators" for g in groups)
    print(f"john ist Admin: {is_admin}")
user = await ecm.security.user("john")
if user:
    groups = await ecm.security.user_groups(user.guid)
    is_admin = any(g.name == "Administrators" for g in groups)
    print(f"john ist Admin: {is_admin}")

5. Siehe auch

  • users() — Alle Benutzer mit Gruppenliste (extended_info=True)

  • groups() — Alle Gruppen des Servers

  • group_members() — Mitglieder einer Gruppe abrufen