mng.AddUserGroupAsc

This job adds the specified users to a group. Users and groups can be specified either by GUID or ID.

1. Input Parameters

Name Type Required Description

Flags

INT

Yes

Currently not supported — pass 0.

AdmInfo

BASE64

Yes

Group assignments in XML format (see below).

2. AdmInfo Structure

<AdmInfo>
  <Associations>
    <Association osuid="..." osgid="..."/>
    <!-- OR -->
    <Association user_id="..." group_id="..."/>
  </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 modifies users or groups and therefore requires the calling user to hold system role 4 (Administrator: Configure security 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.RemoveUserGroupAsc