DescendantControl permet de lancer une requête sur les descendants d'une entité.
L'objet de données DescendantControl est une extension de HierarchyControl. Il est utilisé dans l'objet de données d'entrée de l'interface de programme d'application d'extraction pour lancer une requête sur les descendants d'une entité. Si vous ajoutez DescendantControl à l'objet de données dans une opération d'extraction, les descendants des entités sous l'objet de données Root sont retournés dans le graphique de données retourné.
DescendantControl étant une extension de SearchControl, vous pouvez indiquer des propriétés de recherche dans DescendantControl pour obtenir uniquement les descendants qui répondent aux critères de recherche. Par exemple, vous pouvez ajouter une expression de propriété avec la valeur : "entités[@xsi:type='PersonAccount'] afin de retourner uniquement les descendants dont le type d'entité est PersonAccount. DescendantControl permet également d'indiquer le niveau et les propriétés des descendants à retourner.
Niveau DescendantControl | Description |
---|---|
1 (par défaut) | Permet de retourner uniquement les enfants. |
Tout nombre entier positif | Permet de retourner le niveau indiqué de descendants. Par exemple, si vous indiquez 2, deux niveaux sont retournés, enfants et petits-enfants. |
0 | Permet de retourner tous les descendants. |
<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>