mng.SetGroupAttributes

This job sets the properties of a group.

1. Input Parameters

Name Type Required Description

Flags

INT

Yes

Currently not supported — pass 0.

GroupInfo

BASE64

Yes

Properties of the group in XML format (see below).

HasEncoding

BOOL

Yes

GroupInfo contains encoding (e.g., UTF-8).

2. GroupInfo Structure

<AdmInfo>
  <Groups>
    <Group id="0" name="STANDARD" osguid="AE38D1BB1F1C4CB98B5695A2935E0169" profil="0" description="Test"/>
  </Groups>
</AdmInfo>
Attribute Type Description

id

INT

ID of the group

name

STRING

Name of the group

osguid

STRING

GUID of the group

profil

INT

ID of the profile user assigned to the group

description

STRING

Description 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.GetGroupAttributes