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>