AncestorControl se utiliza para solicitar los ascendientes de una entidad.
El objeto de datos AncestorControl se extiende desde HierarchyControl. Se utiliza en el objeto de datos de entrada de la API de obtención (get) para solicitar los ascendientes de una entidad. Si se añade AncestorControl al objeto de datos en una operación get (obtener), se devuelven los ascendientes de las entidades debajo Root DataObject en el objeto de datos de devolución.
Debido a que AncestorControl se extiende desde SearchControl, puede especificar propiedades de búsqueda en AncestorControl para devolver únicamente los ascendientes que cumplan los criterios de la búsqueda. AncestorControl también se puede utilizar para especificar el nivel y las propiedades que se devolverán para los ascendientes.
Nivel de AncestorControl | Descripción |
---|---|
1 (valor predeterminado) | Sólo devuelve el padre. |
Cualquier entero positivo | Devuelve el nivel especificado de ascendientes. Por ejemplo, si se especifica 2 se devuelven dos niveles, el padre y el abuelo. |
0 | Devuelve todos los ascendientes hasta el nodo 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>