DescendantControl se utiliza para solicitar los descendientes de una entidad.
El objeto de datos DescendantControl se extiende desde HierarchyControl. Se utiliza en el objeto de datos de entrada de la API de obtención (get) para solicitar los descendientes de la entidad. Si se añade DescendantControl al objeto de datos en una operación get (obtener), se devuelven los descendientes de las entidades debajo de Root DataObject en el gráfico de datos de retorno.
Debido a que DescendantControl se extiende desde SearchControl, puede especificar propiedades de búsqueda en DescendantControl para devolver únicamente los descendientes que cumplan los criterios de la búsqueda. Por ejemplo, puede añadir una expresión de propiedad con el valor: entities[@xsi:type='PersonAccount'] para devolver únicamente los descendientes del tipo de entidad PersonAccount. DescendantControl también se puede utilizar para especificar el nivel y las propiedades que se devolverán para los descendientes.
Nivel de DescendantControl | Descripción |
---|---|
1 (valor predeterminado) | Sólo devuelve los hijos. |
Cualquier entero positivo | Devuelve el nivel especificado de descendientes. Por ejemplo, si se especifica 2 se devuelven dos niveles, el hijo y el nieto. |
0 | Devuelve todos los descencientes |
<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>