Папки и элементы в веб-службах Exchange
Узнайте о папках и элементах почтовых ящиков, а также о том, как их представляет управляемый API EWS или клиент EWS.
Папки — это упорядоченный элемент почтового ящика Exchange. Папки могут содержать элементы почтового ящика, такие как сообщения электронной почты, контакты, встречи, собрания и задачи, или могут содержать другие папки. Exchange включает разные типы папок, но типы папок похожи друг на друга. Основное различие между ними заключается в типе элемента, который они содержат.
Однако элементы имеют уникальные типы. Каждый тип элемента имеет свой набор свойств или схем для его определения. В этой статье мы обсудим типы доступных папок и элементов, а также различия между ними.
Folders
Все папки являются производными от одного базового класса или базового типа, класса Folder в управляемом API EWS или типа Папки в EWS. На следующем рисунке показаны классы управляемого API EWS и типы EWS.
Рис. 1. Классы папок управляемого API EWS и типы папок EWS
Основное различие между каждым из классов папок и типами папок заключается в том, что в каждом типе папок можно создать только определенный тип элемента. Еще одно отличие заключается в том, как клиент отображает сведения в папке. Например, Exchange позволяет создавать встречи в папке Календарь. Вы можете переместить другие типы элементов в папку Календарь после их создания, но Outlook не будет отображать их. Outlook отображает только элементы календаря, такие как встречи и собрания, в папке "Календарь", даже если в папке существует элемент другого типа.
Таблица 1. Классы папок управляемого API EWS и типы папок EWS
| Класс Управляемого API EWS | Тип EWS | Значение FolderClass | Contains | Примечания. |
|---|---|---|---|---|
| Folder |
Folder |
Ipf. Примечание |
Email сообщений или папок. |
Это универсальный класс папок или тип для следующих папок WellKnownFolderName управляемого API EWS и папок EWS DistinguishedFolderId :
|
| CalendarFolder |
CalendarFolder |
Ipf. Назначение |
Встречи и собрания. |
Когда пользователь отвечает на приглашение на собрание, встреча добавляется только в управляемый API EWS WellKnownFolderName.Calendar или EWS DistinguishedFolderId.CalendarFolder . Это единственные папки, поддерживающие автоматическое взаимодействие с приглашениями на собрания и ответами. Этот тип папок или папок поддерживает использование представлений календаря для возврата встреч и собраний на основе даты начала и окончания с помощью метода EWS Managed API Folder.FindItem и класса CalendarView либо операции EWS FindItem и элемента CalendarView . |
| ContactsFolder |
ContactsFolder |
Ipf. Контакт |
Контакты и списки рассылки. |
Нет. |
| SearchFolder |
SearchFolder |
Ipf. Примечание |
Содержимое определяется ограничением или фильтром. Папки поиска не имеют вложенных папок. |
Элементы, которые соответствуют условиям поиска, на самом деле не содержатся в папке поиска; Вместо этого они находятся в другом месте почтового ящика. Чтобы убедиться, что папки поиска доступны в Outlook, создайте их в папке Finder. |
| TasksFolder |
TasksFolder |
Ipf. Задача |
Содержит рабочие элементы для завершения. |
Нет. |
Структура папок
Папки предоставляют структуру почтового ящика. Это относится к поддереву IPM, известному как Top of Information Store в EWS, где большинство пользователей взаимодействуют со своим почтовым ящиком, а также системные папки, которые большинство пользователей никогда не видят, которые находятся в поддереве или корневом поддереве не IPM в EWS. На следующем рисунке показана структура папок для пользователя и указаны папки для элементов пользователя, а какие — системные.
Рис. 2. Элементы и системные папки в почтовом ящике
Известные папки
Некоторые из папок в почтовом ящике являются специальными. Они приравниваются к известным папкам в управляемом API EWS или к различающиеся папки в EWS. Некоторые из этих папок имеют ограничения на имя папки, их расположение в структуре папок и возможность их удаления. Другие "универсальные" (не специальные) папки не имеют одинаковых ограничений. Важно, чтобы вы были знакомы со следующими хорошо известными или отличительными папками, так как они являются корневой системой, пользователями и папками поиска и применимы к большинству реализаций.
Табл. 2. Основные хорошо известные и различающиеся папки
| Понятное имя | Значения WellKnownFolderName управляемого API EWS | Значения EWS DistinguishedFolderId | Описание |
|---|---|---|---|
| Корневой (поддеревок, отличный от IPM) |
WellKnownFolderName.Root |
РазличающеесяFolderId.root |
Содержит корневую папку почтового ящика, также называемую поддеревом, не являющегося IPM. У этой папки нет родительской папки, и ее нельзя перемещать, копировать, переименовывать или удалять. Каждое хранилище сообщений содержит только одну корневую папку. |
| Начало хранилища сведений (поддеревье IPM) |
WellKnownFolderName.MsgFolderRoot |
РазличающеесяFolderId.msgfolderroot |
Содержит папку "Входящие" и другие папки пользователей. |
| Finder (папки поиска) |
WellKnownFolderName.SearchFolders |
РазличающиесяFolderId.searchfolders. |
Содержит папки поиска, видимые в Outlook. |
Полный список значений свойств WellKnownFolderName управляемого API EWS см. в перечислении WellKnownFolderName . Полный список значений EWS DistinguishedFolderId см. в разделе DistinguishedFolderId.
свойства папки.
В управляемом API EWS все свойства папки являются производными от базового класса Folder . А в EWS все папки используют элементы папок, доступные в типе Folder . Большинство свойств и элементов, связанных с папками, просты (идентификатор родительской папки, отображаемое имя и т. д.), но некоторые из них требуют более подробного объяснения.
Следующие предостережения относятся к свойству EWS Managed API Folder.FolderClass или элементу EWS FolderClass :
Если задано значение, значение свойства или элемента должно совпадать с производным классом или типом папки. Например, свойство Или элемент FolderClass не может указывать, что папка является папкой Контактов, а класс или тип папки указывает, что папка является папкой Календарь.
Можно создать папки определенного типа без задания свойства FolderClass или элемента, либо можно создать папку с универсальным типом папки и указать свойство FolderClass или элемент . Оба параметра создают одинаковый результат.
После установки значения FolderClass путем создания определенного типа папки или установки свойства FolderClass или самого элемента его нельзя изменить. Например, нельзя изменить IPF. Запишите папку в IPF. Папка contact. Однако его можно изменить на IPF. Примечание. Папка Contoso.
Любое значение FolderClass , не использующее один из предопределенных префиксов, обрабатывается как IPF. Папка "Заметки". Например, значение FolderClass IAmAFolderClass обрабатывается как IPF. Папка "Заметки".
Значение класса папки расширяемо. Это означает, что значения FolderClass по умолчанию, перечисленные в таблице 1, обрабатываются как префиксы, и вы можете добавить пользовательские значения. Например, можно создать папку со значением FolderClass IPF. Contact.Contoso, и он обрабатывается как папка "Контакты".
Вы можете определить, какие разрешения у клиента есть в папках, например на удаление, чтение и изменение, с помощью свойства EWS Managed API Folder.EffectiveRights или элемента EWS EffectiveRights .
Общедоступные папки
Общие папки предназначены для осуществления общего доступа к файлам. Это простой и эффективный способ сбора, организации и использования информации внутри рабочей группы или в масштабах всей организации. Вы также можете использовать общедоступные папки для архивации содержимого группы рассылки. Подробные сведения об общедоступных папках см. в статье Доступ к общедоступным папкам с помощью EWS в Exchange.
Скрытые папки
Все папки, создаваемые Exchange в корне почтового ящика, скрыты, и вы можете использовать управляемый API EWS или EWS для скрытия дополнительных папок в верхней части хранилища сведений. Дополнительные сведения о скрытых папках см. в статье Работа со скрытыми папками с помощью EWS в Exchange.
Папки поиска
Папки поиска похожи на обычные папки, за исключением того, что они имеют свойство или элемент, определяющий фильтр поиска. Папки поиска можно создавать в любой папке в почтовом ящике Exchange и создавать так же, как и в любой другой папке. Однако для отображения папки поиска в Outlook, Outlook Web App или Outlook Live объекты SearchFolder, созданные с помощью управляемого API EWS, должны находиться в папке WellKnownFolderName.SearchFolders, а типы SearchFolder, созданные с помощью EWS, должны находиться в папке DistinguishedFolderId.SearchFolders. Если папка поиска создана в другом расположении, она по-прежнему доступна и ее можно просмотреть в пользовательских клиентских приложениях.
Элементы
EWS в Exchange использует элементы для представления отдельных сообщений электронной почты, встреч, собраний, контактов, списков рассылки, задач, записей и других элементов в почтовом ящике. Элементы либо строго типизированы, то есть имеют определенный связанный класс или схему, либо не строго типизированы, также известные как универсальные элементы. Универсальные элементы — это объекты Item в управляемом API EWS и типы элементов в EWS. Общие элементы, такие как сообщения электронной почты, контакты, списки рассылки, записи и задачи, строго типизированы, и для них можно задать определенные схематизированные свойства или элементы.
Табл. 3. Строго типизированные элементы
| Тип элемента управляемого API EWS | Элемент элемента EWS |
|---|---|
| Встреча |
CalendarItem |
| Contact |
Contact |
| ContactGroup |
DistributionList |
| EmailMessage |
Сообщение |
| PostItem |
PostItem |
| Задача |
Задача |
Строго типизированные элементы управляемого API EWS являются производными от базового класса Item . Однако обычно вы работаете с одним из производных типов, перечисленных в таблице 3, а не с классом Item напрямую. Однако при работе с классом ItemCollection можно работать непосредственно с экземплярами класса Item . В этом случае следует реализовать логику, определяющую тип элемента в хранилище, которое представляет экземпляр класса Item . Для работы с этим элементом необходимо привязать к элементу с помощью экземпляра класса , представляющего элемент.
Элементы в папках
Некоторые папки имеют ограничения на типы элементов, которые они могут содержать. Это ограничения, которые база данных почтовых ящиков Exchange применяет к папкам, а не ограничения представления клиента.
Табл. 4. Ограничения элементов для папок
| Класс EWS Managed API Folder | Тип папки EWS | Restriction |
|---|---|---|
| Класс Base Folder |
Folder |
В универсальных папках можно создавать только объекты EmailMessage управляемого API EWS и объекты PostItem , типы сообщений EWS или PostItem . Другие типы элементов можно перемещать в универсальные папки, но клиент может не отображать их. |
| CalendarFolder |
CalendarFolder |
В папке Calendar можно создавать только объекты EWS Managed API Appointment и типы EWS CalendarItem . Вы можете переместить другие типы элементов в папку Календарь, но клиент может не отображать их. |
| ContactsFolder |
ContactsFolder |
В папке Контакты можно создавать только объекты Contact и ContactGroup управляемого API EWS, а также типы контактов EWS или DistributionList . Вы можете переместить другие типы элементов в папку Контакты, но клиент может не отображать их |
| SearchFolder |
SearchFolder |
Нет ограничений. Элементы фактически не находятся в папке Поиска; они находятся в другом месте почтового ящика. |
| TasksFolder |
TasksFolder |
В папке "Задачи" можно создавать только объекты задач управляемого API EWS или типы задач EWS. Другие типы элементов можно переместить в папку "Задачи", но клиент может не отображать их |
Обновление с более ранних версий продукта
Папки по большей части остались без изменений в более ранних и текущих версиях продукта. Однако обратите внимание, что в более ранних версиях Exchange для управления записями сообщений (MRM) используются управляемые папки. Exchange Online, Exchange Online в рамках Office 365, а версии Exchange, начиная с Exchange 2013, используют политики хранения для MRM. Вы можете обновить управляемые папки, чтобы использовать политики хранения.
Элементы не изменились в более ранних и текущих версиях продукта.