SortControl DataObject

SortControl indique la méthode de tri des résultats de la recherche.

La structure d'un objet de données SortControl se compose des éléments suivants :
locale
indique la langue utilisée au cours de l'opération de tri.
sortKeys
Chaque objet de données de clé de tri comporte deux propriétés qui sont utilisées pour effectuer le tri :
property
liste des attributs utilisés pour effectuer le tri. Les attributs inclus dans SortControl doivent être répertoriés dans la liste de propriété de SearchControl.
ascendingOrder
indique l'ordre de tri de chaque attribut. S'ils sont définis sur True, les résultats de la recherche sont triés par ordre croissant. S'ils sont définis sur False, les résultats sont triés par ordre décroissant. Par exemple, si un appelant virtual member manager souhaite trier les résultats de la recherche par "sn", par ordre décroissant, l'appelant doit définir le paramètre ascendingOrder sur False.

Définition de schéma XML

Vous trouverez ci-dessous la définition du schéma XML pour l'objet de données SortControl :
<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>

Objets de données exemple

Voici un exemple d'objet de données SortControl pour une API de recherche. Les résultats de la recherche sont triés par sn (nom de famille) avec des paramètres de lieu définis sur anglais.
<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>
Voici un exemple d'objet de données SortControl pour une API de recherche. Les résultats de la recherche sont d'abord triés par sn avec des paramètres de lieu définis sur anglais. Si plusieurs résultats avec la même propriété sn existent, les résultats sont alors triés par le nom de famille en anglais.
<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>


Conditions d'utilisation | Commentaires