mng.SetGroupAttributes

This job sets the properties of a group.

1. Input Parameters

Name Type Required Description

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

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

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

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