Datenobjekt "SortControl"

"SortControl" gibt an, wie die zurückgegebenen Suchergebnisse sortiert werden sollen.

Die Struktur des Datenobjekts "SortControl" hat folgende Bestandteile:
locale
Gibt die Sprache an, die während der Sortierungsoperation verwendet wird.
sortKeys
Jedes Datenobjekt "sortKey" enthält zwei Merkmale, die verwendet werden, um die Sortierung auszuführen:
property
Enthält eine Liste der Attribute, die verwendet werden, um die Sortierung auszuführen. Die in "SortControl" enthaltenen Attribute müssen in der Merkmalsliste von "SearchControl" aufgelistet sein.
ascendingOrder
Gibt die Sortierreihenfolge für die einzelnen Attribut an. Wenn dieser Parameter auf "true" gesetzt ist, werden die Suchergebnisse aufsteigend sortiert. Wenn dieser Parameter auf "false" gesetzt wird, werden die Suchergebnisse absteigend sortiert. Beispiel: Wenn ein Virtual Member Manager-Aufrufender die Suchergebnisse für "sn" absteigend sortieren möchte, muss der Aufrufende "ascendingOrder" auf "false" setzen.

XML-Schemadefinition

Nachfolgend finden Sie die XML-Schemadefinition für das Datenobjekt "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>

Beispieldatenobjekte

Hier sehen Sie ein Beispiel für das Datenobjekt "SortControl" für die API "search". Die Suchergebnisse sind sortiert nach "sn" (Familienname), und "locale" ist auf die Sprache Englisch gesetzt.
<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>
Hier sehen Sie ein Beispiel für das Datenobjekt "SortControl" für die API "search". Die Suchergebnisse sind zuerst sortiert nach "sn" (Familienname), und "locale" ist auf die Sprache Englisch gesetzt. Wenn mehrere Ergebnisse mit demselben Familiennamen vorhanden sind, werden die Ergebnisse sodann nach dem Vornamen "givenName" in englischer Sprache sortiert.
<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>


Rechtliche Hinweise | Feedback