create_group()

Legt eine neue Benutzergruppe auf dem ECM-Server an. Die server-vergebenen Felder (id, guid) werden im Rückgabewert zurückgeliefert.

1. Signatur

  • Sync

  • Async

ecm.security.create_group(
    name: str,
    *,
    profile_id: int = 0,
    description: str = "",
) -> ECMGroup
await ecm.security.create_group(...) -> ECMGroup

2. Parameter

Parameter Standard Beschreibung

name

—

Name der Gruppe.

profile_id

0

ID des der Gruppe zugeordneten Profilbenutzers; 0 = kein Profil.

description

""

Optionale Beschreibung der Gruppe.

3. Rückgabewert

ECMGroup mit gesetzten id und guid.

4. Fehler

  • ECMException (oder Unterklasse) – wenn der Server die Anlage ablehnt, z.B. bei doppeltem Gruppennamen.

5. Beispiele

5.1. Minimaler Aufruf

  • Sync

  • Async

group = ecm.security.create_group("Sales", description="Sales EMEA")
print(group.guid, group.id)
group = await ecm.security.create_group("Sales", description="Sales EMEA")

6. Siehe auch