AncestorControl permet de lancer une requête sur les ancêtres d'une entité.
L'objet de données AncestorControl est une extension de HierarchyControl. Il est utilisé dans l'objet de données d'entrée de l'API d'extraction (get) pour lancer une requête sur les ancêtres d'une entité. Si vous ajoutez AncestorControl à l'objet de données dans une opération d'extraction, les ancêtres des entités sous l'objet de données racine (Root DataObject) sont renvoyés dans l'objet de données retourné.
AncestorControl étant une extension de SearchControl, vous pouvez indiquer des propriétés de recherche dans AncestorControl pour obtenir uniquement les ancêtres qui répondent aux critères de recherche. AncestorControl permet également d'indiquer le niveau et les propriétés des ancêtres à retourner.
Niveau AncestorControl | Description |
---|---|
1 (par défaut) | Permet de retourner uniquement les parents. |
Tout nombre entier positif | Permet de retourner le niveau indiqué d'ancêtres. Par exemple, si vous indiquez 2, deux niveaux sont retournés, parent et grand-parent. |
0 | Permet de retourner tous les ancêtres jusqu'au noeud de virtual member manager. |
<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>