DescendantControl DataObject

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.

La estructura de un objeto de datos DescendantControl está formada 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
se utiliza para especificar 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 descendientes que deben devolverse. El valor predeterminado para el nivel es 1. Consulte la tabla siguiente.
Esta tabla resume los valores posibles del nivel de descendiente:
Tabla 1. Valores de nivel de DescendantControl
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

Definición de esquema XML

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

Objeto de datos de ejemplo

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


Condiciones de uso | Comentarios