"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.
"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. |
<xsd:complexType name="AncestorControl">
<xsd:complexContent>
<xsd:extension base="HierarchyControl">
</xsd:extension>
</xsd:complexContent>
</xsd:complexType>
<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>