DescendantControl DataObject

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.

La structure d'un objet de données DescendantControl se compose des éléments suivants :
propriétés
liste des attributs à retourner des entités qui répondent aux critères de recherche. Par exemple, vous souhaitez obtenir les attributs sn et givenName des personnes du service marketing.
searchBases
liste de bases de recherche permettant de limiter la recherche aux bases recensées.
countLimit
permet d'indiquer le nombre maximal de résultats renvoyés par l'opération de recherche.
timeLimit
Si le référentiel de profil prend en charge le délai, il indique la durée maximale de recherche en milliseconde.
expression
expression de recherche au format XPath.
level
niveau des descendants à retourner. Par défaut, la valeur de niveau est définie sur 1. Voir le tableau suivant.
Ce tableau répertorie les valeurs possibles du niveau des descendants :
Tableau 1. Valeurs du niveau DescendantControl
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.

Définition de schéma XML

Vous trouverez ci-dessous la définition du schéma XML pour l'objet de données DescendantControl.
<xsd:complexType name="DescendantControl">
		<xsd:complexContent>
			<xsd:extension base="HierarchyControl">
			</xsd:extension>
		</xsd:complexContent>
	</xsd:complexType>

Objet de données exemple

Vous trouverez ci-dessous un exemple d'objet de données DescendantControl qui renvoie tous les descendants et leurs propriétés uid, cn, o et ou, le cas échéant :
<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>


Conditions d'utilisation | Commentaires