IndexedPageItemView

  • [アーティクル]

IndexedPageItemView 要素は、FindItem 操作または FindConversation 操作要求に対してページングされた会話またはアイテム情報を返す方法について説明します。

<IndexedPageViewItemView MaxEntriesReturned="" Offset="" BasePoint=""/>

IndexedPageViewType

属性と要素

以下のセクションで、属性、子要素、親要素について説明します。

属性

属性 説明
MaxEntriesReturned
応答で返されるアイテムまたは会話の最大数を示します。 この属性は省略可能です。
Offset
BasePoint からのオフセットについて説明します。 BasePoint が [開始] と等しい場合、オフセットは正になります。 BasePoint が End と等しい場合、オフセットは負のように処理されます。 これにより、応答で最初に配信されるアイテムまたは会話が識別されます。 この属性は必須です。
基点
検索条件を使用して見つかった一連のアイテムまたは会話の先頭または末尾から、アイテムまたは会話のページを開始するかどうかを示します。 最後からシークすると、常に後方に検索されます。 この属性は必須です。

BasePoint 属性

値 説明
最初
 ページ ビューは、見つかった会話またはアイテム セットの先頭から始まります。
End
 ページ ビューは、見つかった会話またはアイテム セットの末尾から始まります。

子要素

なし。

親要素

要素 説明
FindItem
メールボックス内のアイテムを検索する要求を定義します。
この要素への XPath 式を次に示します:
/FindItem
FindConversation
メールボックス内の会話を検索する要求を定義します。

注釈

最後からシークするには、オフセットによって識別される原点に移動する必要があります。 さらに、ポインターは要求されたレコードの数だけ戻されます。 たとえば、レコードが 100 個あり、オフセットが末尾から 25 の場合、検索は 75 から開始されます。 10 個のレコードが返された場合、ポインターは追加の 10 レコードを 65 に後方に移動し、レコード 65 から 75 を返します。 次のインデックスは 64 です。 ページの末尾からの次のオフセットは 100 から 64 で、36 と等しくなります。 36 は、末尾からの次のオフセットの値で、次のインデックス付きページを取得します。

この要素を記述するスキーマは、Exchange Web サービスをホストする IIS 仮想ディレクトリに置かれています。

例

次の例は、 FindItem 操作 要求を示しています。 各項目は、ID と件名で返されます。 MaxEntriesReturned 属性で指定された最大 6 つの項目が応答で返されます。 項目は、重要度でグループ化された昇順で一覧表示されます。 グループ内の項目は、件名別に集計されます。

<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
               xmlns:xsd="http://www.w3.org/2001/XMLSchema"
               xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
               xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types">
  <soap:Body>
    <FindItem Traversal="Shallow" xmlns="https://schemas.microsoft.com/exchange/services/2006/messages">
      <ItemShape>
        <t:BaseShape>IdOnly</t:BaseShape>
        <t:AdditionalProperties>
          <t:FieldURI FieldURI="item:Subject"/>
        </t:AdditionalProperties>
      </ItemShape>
      <IndexedPageItemView MaxEntriesReturned="6" BasePoint="Beginning" Offset="0" />
      <GroupBy Order="Ascending">
        <t:FieldURI FieldURI="item:Importance"/>
        <t:AggregateOn Aggregate="Maximum">
          <t:FieldURI FieldURI="item:Subject"/>
        </t:AggregateOn>
      </GroupBy>
      <ParentFolderIds>
        <t:DistinguishedFolderId Id="inbox"/>
      </ParentFolderIds>
    </FindItem>
  </soap:Body>
</soap:Envelope>

要素の情報

要素 例
Namespace
 https://schemas.microsoft.com/exchange/services/2006/messages
スキーマ名
 メッセージ スキーマ
検証ファイル
 Messages.xsd
空に設定可能
 False

関連項目

FindItem 操作

FindConversation 操作

アイテムの検索