roles()

Gibt die dem Benutzer zugewiesenen Systemrollen als Liste von ECMSystemRole-Enum-Werten zurück. Ohne Angabe einer user_guid werden die Rollen des aktuell angemeldeten Benutzers abgerufen.

1. Signatur

  • Sync

  • Async

ecm.security.roles(user_guid: str = "") -> list[ECMSystemRole]
await ecm.security.roles(user_guid: str = "") -> list[ECMSystemRole]

2. Parameter

Parameter Standard Beschreibung

user_guid

""

GUID des Benutzers, dessen Rollen abgerufen werden sollen. Leerer String (Standard) gibt die Rollen des aktuell angemeldeten Benutzers zurück.

Das Abfragen der Rollen eines anderen Benutzers erfordert die Systemrolle ADMIN_CONFIGURE_SECURITY. Unbekannte Rollen-IDs (nicht im ECMSystemRole-Enum vorhanden) werden stillschweigend übersprungen.

3. Rückgabewert

Liste von ECMSystemRole-Enum-Werten. Leere Liste, wenn dem Benutzer keine Rollen zugewiesen sind.

4. Beispiele

4.1. Eigene Rollen prüfen

  • Sync

  • Async

from ecmind_blue_client.ecm import ECMSystemRole

roles = ecm.security.roles()
if ECMSystemRole.ADMIN_CONFIGURE_SECURITY in roles:
    print("Benutzer darf Sicherheitseinstellungen konfigurieren")

for role in roles:
    print(role.name, role.value)
from ecmind_blue_client.ecm import ECMSystemRole

roles = await ecm.security.roles()
if ECMSystemRole.ADMIN_CONFIGURE_SECURITY in roles:
    print("Benutzer darf Sicherheitseinstellungen konfigurieren")

for role in roles:
    print(role.name, role.value)

4.2. Rollen eines anderen Benutzers prüfen

Erfordert die Systemrolle ADMIN_CONFIGURE_SECURITY:

  • Sync

  • Async

from ecmind_blue_client.ecm import ECMSystemRole

user = ecm.security.user("john")
if user:
    roles = ecm.security.roles(user.guid)
    print([r.name for r in roles])
from ecmind_blue_client.ecm import ECMSystemRole

user = await ecm.security.user("john")
if user:
    roles = await ecm.security.roles(user.guid)
    print([r.name for r in roles])

5. Siehe auch

  • users() — Alle Benutzerkonten abrufen

  • user() — Attribute eines einzelnen Benutzers abrufen