Datenobjekt "AncestorControl"

"AncestorControl" wird verwendet, um die übergeordneten Elemente einer Entität abzufragen.

Das Datenobjekt "AncestorControl" ist eine Erweiterung von "HierarchyControl". Es wird im Eingabedatenobjekt der API "get" verwendet, um die übergeordneten Elemente einer Entität abzufragen. Wenn "AncestorControl" dem Datenobjekt in einer Operation "get" hinzugefügt wird, werden die übergeordneten Elemente der Entitäten unter dem Datenobjekt "Root" im zurückgegebenen Datenobjekt zurückgegeben.

Da "AncestorControl" eine Erweiterung von "SearchControl" ist, können Sie die Suchmerkmale in "AncestorControl" so angeben, dass nur die übergeordneten Elemente zurückgegeben werden, die die Suchkriterien erfüllen. "AncestorControl" kann auch verwendet werden, um die Ebene und die Merkmale anzugeben, die für die übergeordneten Elemente zurückgegeben werden sollen.

Die Datengraphstruktur des Datenobjekts "AncestorControl" besteht aus Folgendem:
properties
Dies ist eine Liste der Attribute, die Sie von den Entitäten abrufen möchten und die mit den Suchkriterien übereinstimmen sollen. Beispiel: Sie möchten die Attribute "sn" (Familienname) und "givenName" (Vorname) für eine bestimmte Person im Vertrieb abrufen.
searchBases
Eine Liste der verwendeten Suchbasen, um die Suche auf die in der Liste angegebenen Suchbasen zu beschränken.
countLimit
Gibt die maximale Anzahl von Suchergebnissen an, die durch die Suchoperation zurückgegeben werden sollen.
timeLimit
Wenn das Profil-Repository "timeLimit" unterstützt, gibt dieser Parameter die maximale Suchdauer in Millisekunden an.
expression
Ist der Suchausdruck im XPath-Format.
level
Gibt die Ebene der übergeordneten Elemente an, die zurückgegeben werden sollen. Der Standardwert für "level" ist 1. Siehe auch die folgende Tabelle.
In dieser Tabelle werden die gültigen Werte für die Ebene der übergeordneten Elemente dargestellt:
Tabelle 1. "AncestorControl" - Ebenen und Werte
"AncestorControl"-Ebene Beschreibung
1 (Standard) Gibt nur das übergeordnete Element zurück.
Jede positive ganze Zahl Gibt die zuvor angegebene Ebene an übergeordneten Elementen zurück. Beispiel: Wenn Sie "2" angeben, werden 2 Ebenen zurückgegeben: die übergeordneten Elemente und die diesen übergeordneten Elemente.
0 Gibt sämtliche übergeordneten Elemente bis hoch zum Virtual Member Manager-Knoten an.

XML-Schemadefinition

Nachfolgend finden Sie die XML-Schemadefinition für das Datenobjekt "AncestorControl".
<xsd:complexType name="AncestorControl">
		<xsd:complexContent>
						<xsd:extension base="HierarchyControl">
			</xsd:extension>
		</xsd:complexContent>
	</xsd:complexType>

Beispieldatenobjekt

Im Folgenden sehen Sie ein Beispiel für das Datenobjekt "AncestorControl", das sämtliche übergeordneten Elemente und deren Merkmale "uid", "cn", "o" und "ou" zurückgibt, falls vorhanden:
<wim:controls xsi:type="wim:AncestorControl" level="0">
    <wim:properties>uid</wim:properties>
    <wim:properties>cn</wim:properties>
    <wim:properties>o</wim:properties>
    <wim:properties>ou</wim:properties>
 </wim:controls>


Rechtliche Hinweise | Feedback