IndexedPageItemView

Статья
03/29/2023

Элемент 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 — это значение для следующего смещения от конца, чтобы получить следующую индексированную страницу.

Схема, описывающая этот элемент, находится в виртуальном каталоге IIS, в котором размещены веб-службы Exchange.

Пример

В следующем примере показан запрос операции FindItem . Каждый элемент возвращается с его идентификатором и темой. В ответе возвращается не более шести элементов, как указано в атрибуте MaxEntriesReturned . Элементы перечислены в порядке возрастания, сгруппированных по важности. Элементы в группе агрегируются по темам.

<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>

Сведения об элементе

Элемент	Пример
Пространство имен	https://schemas.microsoft.com/exchange/services/2006/messages
Имя схемы	Схема Messages
Файл проверки	Messages.xsd
Может быть пустым	False