X4 Produktdokumentation

Add Composite to Role

Die Operation Add Composite to Role fügt einer zusammengesetzten Rolle eine untergeordnete Rolle hinzu. Sobald einem Benutzer die zusammengesetzte Rolle zugewiesen wird, werden dem Benutzer alle in der zusammengesetzten Rolle untergeordneten Rollen automatisch zugewiesen.

Input-XML

XML
<?xml version="1.0" encoding="UTF-8"?>
<ParentRole>
	<ParentId></ParentId>
	<SubRoles>
		<SubRole>
			<Id></Id>
			<Name></Name>
			<Composite></Composite>
			<ContainerId></ContainerId>
			<Attributes>
       			<Attribute>
            		<Name></Name>
            		<Values>
                		<Value></Value>
            		</Values>
      			</Attribute>
			</Attributes>
		</SubRole>
	</SubRoles>
</ParentRole>

ParentRole

Element

Beschreibung

Mögliche Werte

ParentId

UUID der zusammengesetzten Rolle

UUID

SubRoles

Rollendefinition der untergeordneten Rollen

Das Element enthält folgende Elemente:

  • SubRole (Mehrfachdeklaration möglich)

SubRoles

Element

Beschreibung

Mögliche Werte

SubRoles

Rollendefinition der untergeordneten Rollen

Das Element enthält folgende Elemente:

  • SubRole (Mehrfachdeklaration möglich)

SubRole

Rolle

Das Element enthält folgende Elemente:

  • Id

  • Name

  • Description (optional)

  • Composite (optional)

  • ContainerId

  • Attributes (optional)

Id

UUID der Rolle

Beliebiger String

Name

Name der Rolle

Beliebiger String

Description

Beschreibung der Rolle

Beliebiger String

Composite

Angabe, ob die Rolle eine zusammengesetzte Rolle ist

  • true: Die Rolle ist eine zusammengesetzte Rolle.

  • false: Die Rolle ist keine zusammengesetzte Rolle. (Standard)

ContainerId

Name des Realm

Beliebiger String

Attributes

Personalisierte, konfigurierbare Attribute

Das Element enthält folgende Elemente:

  • Attribute (Mehrfachdeklaration möglich)

Attributes

Element

Beschreibung


Attributes

Personalisierte, konfigurierbare Attribute

Das Element enthält folgende Elemente:

  • Attribute (Mehrfachdeklaration möglich)

Attribute

Personalisiertes, konfigurierbares Attribut

Das Element enthält folgende Elemente:

  • Name

  • Values

Name

Attributname

Beliebiger String

Values

Attributwerte

Das Element enthält folgende Elemente:

  • Value (Mehrfachdeklaration möglich)

Value

Attributwert

Beliebiger 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="ParentRole">
		<xs:complexType>
			<xs:sequence>
				<xs:element ref="ParentId"/>
				<xs:element ref="SubRoles"/>
			</xs:sequence>
		</xs:complexType>
	</xs:element>
	<xs:element name="ParentId" type="xs:string"/>
	<xs:element name="SubRoles">
		<xs:complexType>
			<xs:sequence>
				<xs:element ref="SubRole"/>
			</xs:sequence>
		</xs:complexType>
	</xs:element>
	<xs:element name="SubRole">
		<xs:complexType>
			<xs:sequence>
				<xs:element ref="Id"/>
				<xs:element ref="Name"/>
				<xs:element ref="Attributes"/>
			</xs:sequence>
		</xs:complexType>
	</xs:element>
	<xs:element name="Id" type="xs:string"/>
	<xs:element name="Attributes">
		<xs:complexType>
			<xs:sequence>
				<xs:element maxOccurs="unbounded" ref="Attribute"/>
			</xs:sequence>
		</xs:complexType>
	</xs:element>
	<xs:element name="Attribute">
		<xs:complexType>
			<xs:sequence>
				<xs:element ref="Name"/>
				<xs:element maxOccurs="unbounded" ref="Values"/>
			</xs:sequence>
		</xs:complexType>
	</xs:element>
	<xs:element name="Values">
		<xs:complexType>
			<xs:sequence>
				<xs:element ref="Value"/>
			</xs:sequence>
		</xs:complexType>
	</xs:element>
	<xs:element name="Value" type="xs:string"/>
	<xs:element name="Name" type="xs:string"/>
</xs:schema>

Beispiel

Input

XML
<?xml version="1.0" encoding="UTF-8"?>
<ParentRole>
	<ParentId>3915229f-7544-4701-b1dc-6092861d9101</ParentId>
	<SubRoles>
		<SubRole>
			<Id>4915229f-7544-4701-b1dc-6092861d9102</Id>
			<Name>x4_admin_access_1</Name>
			<Attributes>
       			<Attribute>
            		<Name>Team</Name>
            		<Values>
                		<Value>Red</Value>
            		</Values>
            		<Values>
                		<Value>Blue</Value>
            		</Values>
      			</Attribute>
			</Attributes>
		</SubRole>
		<SubRole>
			<Id>5915229f-7544-4701-b1dc-6092861d9103</Id>
			<Name>x4_admin_access_2</Name>
			<Attributes>
       			<Attribute>
            		<Name>Team</Name>
            		<Values>
                		<Value>Pink</Value>
            		</Values>
            		<Values>
                		<Value>Green</Value>
            		</Values>
      			</Attribute>
			</Attributes>
		</SubRole>
	</SubRoles>
</ParentRole>