delete_group()

Löscht eine Gruppe vom ECM-Server.

Eine Gruppe kann nur gelöscht werden, wenn ihr keine Benutzer mehr zugeordnet sind. Leere sie zuvor mit empty_group().

1. Signatur

  • Sync

  • Async

ecm.security.delete_group(group: ECMGroup | str) -> None
await ecm.security.delete_group(group: ECMGroup | str) -> None

2. Parameter

Parameter Standard Beschreibung

group

—

Die zu löschende Gruppe — entweder ein ECMGroup (Identifikation über die GUID) oder ein Gruppenname (str).

3. Rückgabewert

Keine.

4. Fehler

  • ECMException (oder Unterklasse) bei Server-Fehlern, z.B. wenn die Gruppe noch Mitglieder hat.

5. Beispiele

5.1. Über das Gruppenobjekt löschen

  • Sync

  • Async

group = ecm.security.group("Sales")
assert group is not None
ecm.security.empty_group(group)
ecm.security.delete_group(group)
group = await ecm.security.group("Sales")
assert group is not None
await ecm.security.empty_group(group)
await ecm.security.delete_group(group)

5.2. Über den Gruppennamen löschen

ecm.security.empty_group("Sales")
ecm.security.delete_group("Sales")

6. Siehe auch