groups()

Gibt alle auf dem Server definierten Gruppen zurück.

1. Signatur

  • Sync

  • Async

ecm.security.groups() -> list[ECMGroup]
await ecm.security.groups() -> list[ECMGroup]

2. Rückgabewert

Liste von ECMGroup-Instanzen. Leere Liste, wenn keine Gruppen existieren.

2.1. ECMGroup-Felder

Feld Typ Beschreibung

id

int

Numerische Gruppen-ID.

name

str

Name der Gruppe.

guid

str

Globally Unique Identifier der Gruppe.

profile_user_id

int

ID des der Gruppe zugewiesenen Profilbenutzers. -1 wenn kein Profilbenutzer zugewiesen.

description

str

Optionale Beschreibung der Gruppe.

3. Beispiele

3.1. Alle Gruppen auflisten

  • Sync

  • Async

groups = ecm.security.groups()
for group in groups:
    print(group.name, group.guid)
groups = await ecm.security.groups()
for group in groups:
    print(group.name, group.guid)

3.2. Gruppe nach Name suchen

  • Sync

  • Async

groups = ecm.security.groups()
admins = next((g for g in groups if g.name == "Administrators"), None)
groups = await ecm.security.groups()
admins = next((g for g in groups if g.name == "Administrators"), None)

4. Siehe auch