GroupBy

Статья
03/29/2023

Элемент GroupBy задает произвольное группирование для запросов FindItem.

<GroupBy Order="">
   <FieldURI/>
   <AggregateOn/>
</GroupBy>

<GroupBy Order="">
   <ExtendededFieldURI/>
   <AggregateOn/>
</GroupBy>

<GroupBy Order="">
   <IndexedFieldURI/>
   <AggregateOn/>
</GroupBy>

GroupByType

Атрибуты и элементы

В разделах ниже приводится описание атрибутов, дочерних и родительских элементов.

Атрибуты

Атрибут	Описание
Order	Определяет порядок групп в массиве сгруппированных элементов, возвращаемого в ответе. Этот атрибут имеет тип SortDirectionType.

Упорядочение значений атрибутов

Значение	Описание
По возрастанию	Группы упорядочены по возрастанию.
По убыванию	Группы упорядочены в порядке убывания.

Дочерние элементы

Элемент	Описание
FieldURI	Определяет свойства, на которые часто ссылаются URI.
IndexedFieldURI	Определяет отдельные члены словаря.
ExtendedFieldURI	Определяет расширенные свойства MAPI для получения, задания или создания.
AggregateOn	Представляет поле, используемое для определения порядка групп в ответе.

Родительские элементы

Элемент	Описание
FindItem	Определяет запрос на поиск элементов в почтовом ящике. Ниже приведено выражение XPath для этого элемента: `/FindItem`

Замечания

Ответ FindItem будет содержать коллекцию групп. Каждая группа будет содержать все элементы, которые имели соответствующие значения для свойства GroupBy . Свойство, определяющее группирование, определяется в элементах FieldURI, IndexedFieldURI или ExtendedFieldURI .

Схема, описывающая этот элемент, расположена в виртуальном каталоге EWS на компьютере, работающем под управлением Microsoft Exchange Server 2007, с установленной ролью сервера клиентского доступа.

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

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

Поделиться через