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

Get Role by Name

The Get Role by Name operation outputs the data of the role with the specified name.

Input XML

XML
<?xml version="1.0" encoding="UTF-8"?>
<Name></Name>

Name

Element

Description

Possible values

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="Name" type="xs:string"/>
</xs:schema>

Example

Input

XML
<?xml version="1.0" encoding="UTF-8"?>
<Name>x4_dev_access</Name>

Output

XML
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Role>
    <Id>3915229f-7544-4701-b1dc-6092861d9101</Id>
    <Name>x4_dev_access</Name>
    <Composite>false</Composite>
    <ClientRole>false</ClientRole>
    <ContainerId>X4Realm</ContainerId>
    <Attributes/>
</Role>