"DescendantControl" wird verwendet, um die untergeordneten Elemente einer Entität abzufragen.
Das Datenobjekt "DescendantControl" ist eine Erweiterung von "HierarchyControl". Es wird im Eingabedatenobjekt der API "get" verwendet, um die untergeordneten Elemente einer Entität abzufragen. Wenn "DescendantControl" dem Datenobjekt in einer Operation "get" hinzugefügt wird, werden die untergeordneten Elemente der Entitäten unter dem Datenobjekt "Root" im zurückgegebenen Datengraph zurückgegeben.
Da "DescendantControl" eine Erweiterung von "SearchControl" ist, können Sie die Suchmerkmale in "DescendantControl" so angeben, dass nur die untergeordneten Elemente zurückgegeben werden, die die Suchkriterien erfüllen. Beispiel: Sie können das Merkmal "expression" mit dem Wert "entities[@xsi:type="PersonAccount"]" hinzufügen, so dass nur die untergeordneten Elemente zurückgeben werden, die den Entitätstyp "PersonAccount" besitzen. Das Datenobjekt "DescendantControl" kann auch verwendet werden, um die Ebene und die Merkmale anzugeben, die für die übergeordneten Elemente zurückgegeben werden sollen.
DescendantControl-Ebene | Beschreibung |
---|---|
1 (Standard) | Gibt nur untergeordnete Elemente zurück. |
Jede positive ganze Zahl | Gibt die angegebene Ebene der untergeordneten Elemente zurück. Beispiel: Wenn Sie "2" angeben, werden 2 Ebenen zurückgegeben: die untergeordneten Elemente und die diesen untergeordneten Elemente (Enkelelemente). |
0 | Gibt alle untergeordneten Elemente zurück. |
<xsd:complexType name="DescendantControl">
<xsd:complexContent>
<xsd:extension base="HierarchyControl">
</xsd:extension>
</xsd:complexContent>
</xsd:complexType>
<wim:controls xsi:type="wim:DescendantControl" level="0">
<wim:properties>uid</wim:properties>
<wim:properties>cn</wim:properties>
<wim:properties>o</wim:properties>
<wim:properties>ou</wim:properties>
</wim:controls>