SortControl DataObject

SortControl は、戻された検索結果をどのようにソートするかを指定します。

SortControl DataObject の構造は、以下のものから構成されます。
locale
ソート操作中に使用する言語を指示します。
sortKeys
各 sortKey データ・オブジェクトに、ソートに使用する 2 つのプロパティーが含まれます。
property
ソートに使用する属性のリストを含みます。 SortControl に含める属性は、SearchControl のプロパティー・リストに示されているものでなければなりません。
ascendingOrder
各属性ごとにソート順を指定します。true に設定されていると、検索結果は昇順にソートされます。 false に設定されていると、検索結果は降順にソートされます。 例えば、Virtual member manager の呼び出し側が検索結果を「sn」によって降順にソートする場合は、 呼び出し側が ascendingOrder を false に設定する必要があります。

XML スキーマ定義

次に、SortControl DataObject の XML スキーマ定義を示します。
<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>

サンプル・データ・オブジェクト

次に、search API で使用される SortControl DataObject のサンプルを示します。 検索結果は sn (姓) によってソートされます。locale は英語に設定されます。
<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>
次に、search API で使用される SortControl DataObject のサンプルを示します。 検索結果は、まず sn によってソートされます。locale は英語に設定されます。 同じ sn を持つ結果が複数存在する場合は、さらに英語の givenName によってソートされます。
<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>


利用条件 | フィードバック