mng.AddUserGroupAsc

Dieser Job fügt die angegebenen Benutzer einer Gruppe hinzu. Benutzer und Gruppe können entweder über die GUID oder die ID angegeben werden.

1. Eingabeparameter

Name Typ Pflicht Beschreibung

Flags

INT

Ja

Derzeit nicht unterstützt — 0 übergeben.

AdmInfo

BASE64

Ja

Gruppenzuordnungen im XML-Format (siehe unten).

2. AdmInfo-Struktur

<AdmInfo>
  <Associations>
    <Association osuid="..." osgid="..."/>
    <!-- ODER -->
    <Association user_id="..." group_id="..."/>
  </Associations>
</AdmInfo>
Attribut Typ Beschreibung

[osuid]

STRING

GUID des Benutzers

[osgid]

STRING

GUID der Gruppe

[user_id]

STRING

ID des Benutzers

[group_id]

INT

ID der Gruppe

3. Rückgabe

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

4. 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.

5. Siehe auch

mng.RemoveUserGroupAsc