mng.CreateGroup

Dieser Job legt eine neue Benutzer-Gruppe an. Es wird ein Eintrag in der DB-Tabelle gruppen erstellt. ID und osguid werden durch den Job generiert und im XML zurückgegeben.

1. Eingabeparameter

Name Typ Pflicht Beschreibung

Flags

INT

Ja

Derzeit nicht unterstützt — 0 übergeben.

GroupInfo

BASE64

Ja

Eigenschaften der Gruppe im XML-Format (siehe unten).

HasEncoding

BOOL

Ja

GroupInfo beinhaltet Encoding (z. B. UTF-8).

2. GroupInfo-Struktur

<AdmInfo>
  <Groups>
    <Group name="Test" profil="0"/>
  </Groups>
</AdmInfo>
Attribut Typ Beschreibung

id

INT

ID der Gruppe (wird durch den Job gesetzt)

name

STRING

Name der Gruppe

osguid

STRING

GUID der Gruppe (wird durch den Job gesetzt)

profil

INT

ID des Profilusers, welcher der Gruppe zugeordnet ist

description

STRING

Beschreibung der Gruppe

3. Ausgabeparameter

Name Typ Abhängigkeit Beschreibung

GroupInfo

BASE64

—

Eigenschaften der Gruppe im XML-Format — id und osguid sind gesetzt.

4. Rückgabe

(INT): 0 = Job erfolgreich, sonst Fehlercode.

5. Benötigte Systemrolle

Dieser Job verändert Benutzer bzw. Gruppen und setzt daher die Systemrolle 4 (Administrator: Konfiguration Sicherheitssystem) für den aufrufenden Benutzer voraus. Fehlt diese Rolle, wird der Aufruf mit dem Fehlercode -1040906164 abgewiesen; der zugehörige Fehlertext lautet:

User {username} does not have permission to configure the security system. Please contact your administrator.

Die dem aufrufenden Benutzer zugewiesenen Systemrollen lassen sich mit mng.GetUserRoles ermitteln; eine Übersicht aller Rollen findet sich unter Systemrollen. Siehe auch Fehlercodes.