mng.RemoveUserGroupAsc

This job deletes a user-to-group assignment (DB table bgrel).

1. Input Parameters

Name Type Required Description

Flags

INT

Yes

Indicates which parameter is used:
0 = AdmInfo
1 = UserGUID

[AdmInfo]

BASE64

No

Group assignments to be deleted in XML format (see below).

[UserGUID]

STRING

No

GUID of the user — the user is removed from all groups.

2. AdmInfo Structure

<AdmInfo>
  <Associations>
    <Association user_id="..." group_id="..."/>
    <!-- OR -->
    <Association osuid="..." osgid="..."/>
  </Associations>
</AdmInfo>
Attribute Type Description

[osuid]

STRING

GUID of the user

[osgid]

STRING

GUID of the group

[user_id]

STRING

ID of the user

[group_id]

INT

ID of the group

3. Return Value

(INT): 0 = Job successful, otherwise error code.

4. Required System Role

This job accesses the security system or user and group data and therefore requires the calling user to hold system role 4 (Administrator: Configure security system — configure the rights system). If this role is missing, the call is rejected with the error code -1040906164; the associated error text reads:

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

The system roles assigned to the calling user can be determined with mng.GetUserRoles; an overview of all roles is available under System Roles. See also Error Codes.

5. See Also

mng.AddUserGroupAsc