AncestorControl DataObject

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.

La estructura del gráfico de datos de un objeto de datos AncestorControl está compuesta por los elementos siguientes:
properties
es una lista de los atributos que desea que se devuelvan de las entidades que coinciden con los criterios de búsqueda. Por ejemplo, desea obtener los atributos sn y givenName de las personas que están en el departamento de marketing.
searchBases
es una lista de las bases de búsqueda que se utilizan para limitar la búsqueda a las bases especificadas en la lista.
countLimit
especifica el número máximo de resultados de la búsqueda devueltos por la operación de búsqueda.
timeLimit
Si el depósito del perfil da soporte a timeLimit, especifica en milisegundos la duración máxima de la búsqueda.
expression
es la expresión de búsqueda en formato XPath.
level
especifica el nivel de los ascendientes que deben devolverse. El valor predeterminado para el nivel es 1. Consulte la tabla siguiente.
Esta tabla resume los valores posibles del nivel de ascendiente:
Tabla 1. Valores de nivel de AncestorControl
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.

Definición de esquema XML

A continuación se proporciona la definición del esquema XML para AncestorControl DataObject.
<xsd:complexType name="AncestorControl">
		<xsd:complexContent>
			<xsd:extension base="HierarchyControl">
			</xsd:extension>
		</xsd:complexContent>
	</xsd:complexType>

Objeto de datos de ejemplo

A continuación se proporciona un AncestorControl DataObject de ejemplo que devuelve todos los ascendientes y sus propiedades uid, cn, o y ou, si existen:
<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>


Condiciones de uso | Comentarios