SortControl DataObject

SortControl especifica cómo deben clasificarse los resultados de la búsqueda devueltos.

La estructura de un objeto de datos SortControl está formada por los elementos siguientes:
locale
indica el idioma que se utiliza durante la operación de clasificación.
sortKeys
Cada objeto de datos sortKey contiene dos propiedades que se utilizan para realizar la clasificación:
property
contiene una lista de atributos que se utilizan para realizar la clasificación. Los atributos incluidos en SortControl deben indicarse en la lista de propiedades de SearchControl.
ascendingOrder
especifica el orden de clasificación de cada atributo. Si se establece en true (verdadero), los resultados de la búsqueda se clasifican en orden ascendente. Si se estable en false (falso), los resultados de la búsqueda se clasifican en orden descendente. Por ejemplo, si un llamante de virtual member manager desea clasificar los resultados de la búsqueda por "sn” en orden descendente, el llamante debe establecer ascendingOrder en false.

Definición de esquema XML

A continuación se proporciona la definición del esquema XML para SortControl DataObject:
<xsd:complexType name="SortControl">
 <xsd:complexContent>
	<xsd:extension base="Control">
   <xsd:sequence>
	  <xsd:element name="sortKeys" type="SortKeyType" minOccurs="0" maxOccurs="unbounded"/>
	  <xsd:element name="locale" type="xsd:language" />
		 </xsd:sequence>
	  </xsd:extension>
   </xsd:complexContent>
	</xsd:complexType>

Objetos de datos de ejemplo

A continuación se proporciona un objeto de datos SortControl de ejemplo para la API de búsqueda. Los resultados de la búsqueda se clasifican por sn (apellido) con el entorno local establecido en inglés.
<wim:controls xsi:type="wim:SortControl">
      <wim:sortKeys>
        <wim:propertyName>sn</wim:propertyName>
        <wim:ascendingOrder>false</wim:ascendingOrder>
      </wim:sortKeys>
      <wim:locale>en-US</wim:locale>
</wim:controls>
A continuación se proporciona un objeto de datos SortControl de ejemplo para la API de búsqueda. Los resultados de la búsqueda primero se clasifican por sn con el entorno local establecido en inglés. Si existen varios resultados con el mismo sn, a continuación los resultados se clasifican por givenName en inglés.
<wim:controls xsi:type="wim:SortControl">
      <wim:sortKeys>
        <wim:propertyName>sn</wim:propertyName>
        <wim:ascendingOrder>false</wim:ascendingOrder>
      </wim:sortKeys>
      <sortKeys>
        <propertyName>givenName</propertyName>
        <ascendingOrder>false</ascendingOrder>
      </sortKeys>
      <wim:locale>en-US</wim:locale>
</wim:controls>


Condiciones de uso | Comentarios