X4 Help Center
7.5 7.4 German English
Auto Light Dark
Auto Light Dark
7.5 7.4 German English

Add Roles to Group

The Add Roles to Group operation assigns one or more roles to a group.

Input XML

XML
<Group>
	<GroupId></GroupId>
	<Roles>
		<Role>
			<Id></Id>
			<Name></Name>
		</Role>
	</Roles>
</Group>

Group

Element

Description

Possible values

Group

Group definition

The element contains the following elements:

  • GroupId

  • Roles

GroupId

UUID of the group

UUID

Roles

Role definitions

The element contains the following elements:

  • Role

    (Multiple declaration possible)

Roles

Element

Description

Possible values

Roles

Role definitions

The element contains the following elements:

  • Role

    (Multiple declaration possible)

Role

Role definition

The element contains the following elements:

  • Id

  • Name

Id

UUID of the role

UUID

Name

Name of the role

Any string

XSD

XML
<?xml version="1.0" encoding="UTF-8"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified">
	<xs:element name="Group">
		<xs:complexType>
			<xs:sequence>
				<xs:element ref="GroupId"/>
				<xs:element ref="Roles"/>
			</xs:sequence>
		</xs:complexType>
	</xs:element>
	<xs:element name="GroupId" type="xs:string"/>
	<xs:element name="Roles">
		<xs:complexType>
			<xs:sequence>
				<xs:element maxOccurs="unbounded" ref="Role"/>
			</xs:sequence>
		</xs:complexType>
	</xs:element>
	<xs:element name="Role">
		<xs:complexType>
			<xs:sequence>
				<xs:element ref="Id"/>
				<xs:element ref="Name"/>
			</xs:sequence>
		</xs:complexType>
	</xs:element>
	<xs:element name="Id" type="xs:string"/>
	<xs:element name="Name" type="xs:string"/>
</xs:schema>

Example

Input

XML
<Group>
	<GroupId>8445918e-f3ba-4c93-b3c4-7afd7b65fa57</GroupId>
	<Roles>
		<Role>
			<Id>3915229f-7544-4701-b1dc-6092861d9101</Id>
			<Name>x4_dev_access</Name>
		</Role>
	</Roles>
</Group>