Общих папок в Exchange доступ с EWS
Узнайте, как использовать EWS и Управляемый API EWS для доступа к общедоступным папкам и маршрутизации запросов общедоступных папок в Exchange.
Общедоступные папки предоставляют общий репозиторий элементов, к которым пользователи в вашей организации могут получить доступ. Office 365, Exchange Online и локальные версии Exchange, начиная с Exchange 2013, представляют новую архитектуру для общедоступных папок. Общедоступные папки в Exchange используют специализированный макет почтового ящика (вместо базы данных общедоступных папок) для хранения иерархии общедоступных папок и содержимого общедоступных папок. Разрешения общедоступных папок управляются с помощью контроль доступа на основе ролей (RBAC).
Технологии клиентского доступа, такие как веб-службы Exchange (EWS) и Управляемый API EWS, предоставляют программный доступ к иерархии общедоступных папок и элементам содержимого в базе данных общедоступных папок. В этой статье содержатся сведения о том, как использовать EWS и Управляемый API EWS для доступа к общедоступным папкам, общедоступным папкам и данным общедоступных папок.
Операции EWS и методы управляемого API EWS для доступа к общедоступным папкам
Большинство основных операций EWS поддерживают доступ к общедоступным папкам. Для работы с общедоступными папками можно использовать операции с папками и элементами, а также методы управляемого API EWS, перечисленные в следующей таблице.
Сведения о методах управляемого API EWS см. в разделе Пространства имен управляемых API EWS.
| Операция служб EWS | Метод управляемого API EWS |
|---|---|
|
CreateFolder Operation |
Folder.Save() |
|
Операцию UpdateFolder |
Folder.Update() |
|
Операция DeleteFolder |
Folder.Delete() |
|
Операция MoveFolder1 |
Folder.Move() |
|
Операция CopyFolder2 |
Folder.Copy() |
|
GetFolder Operation |
Folder.Bind() |
|
Операция EmptyFolder3 |
Folder.Empty() |
|
FindFolder Operation |
ExchangeService.FindFolders() Folder.FindFolders() |
|
CreateItem Operation |
Item.Save() |
|
MoveItem Operation |
Item.Move() |
|
CopyItem Operation |
Item.Copy() |
|
UpdateItem Operation |
Item.Update() |
|
Операция DeleteItem |
Item.Delete() |
|
Операция FindItem4 |
ExchangeService.FindItems() Folder.FindItems() |
|
GetItem Operation |
Item.Bind() |
|
Операция ConvertId5 |
ExchangeService.ConvertId() ExchangeService.ConvertIds() |
1 Перемещение папок между общедоступной и частной папками недоступно в версиях Exchange, начиная с Exchange 2013.
2 Эта операция применима только к общедоступным папкам в Exchange Server 2007 и Exchange Server 2010.
3 Эта операция применима только к общедоступным папкам в Exchange 2010.
4 Полнотекстовый индексированный поиск в одной общедоступной папке с помощью параметра поиска QueryString поддерживается в версиях Exchange, начиная с Exchange 2013.
5 Операция ConvertId неправильно преобразует идентификаторы общедоступных папок из идентификатора EWS в идентификатор хранилища. Вы можете вручную обновить идентификатор, возвращаемый в качестве обходного решения.
Следующие операции не поддерживаются или частично поддерживаются для общедоступных папок в версиях Exchange, начиная с Exchange 2013:
CopyFolder (не поддерживается). Для реализации функциональных возможностей операции CopyFolder можно использовать CreateFolder с операцией CopyItems.
EmptyFolder (не поддерживается). Вы можете использовать FindItem с операцией DeleteItem для реализации функциональных возможностей операции EmptyFolder .
MoveFolder (частично поддерживается). Нельзя перемещать папки между частными и общедоступными папками. Вы можете перемещать папки между частными и общедоступными папками в Exchange 2007 и Exchange 2010. Папки в общедоступной папке можно перемещать во всех версиях Exchange.
EWS и Управляемый API EWS не поддерживают следующие функции для общедоступных папок:
Использование SyncFolderHierarchy. Используйте операции FindFolder, GetFolder, FindItem и GetItem для синхронизации элементов и папок в почтовом ящике общедоступных папок.
Поиск по иерархии общедоступных папок с глубоким обходом. Используйте рекурсивные вызовы операций FindFolder для обхода иерархии общедоступных папок.
Использование операции CreateFolderPath для создания иерархии папок для общедоступных папок. При выборе почтового ящика общедоступных папок необходимо будет использовать операцию CreateFolder для каждого уровня папок в отдельной иерархии папок.
Использование операции CreateItem для сохранения копий отправленных сообщений электронной почты. Вместо этого используйте операцию MoveItem для перемещения копии сообщения в общедоступную папку.
Сценарии использования EWS и Управляемого API EWS для работы с общедоступными папками
Общедоступные папки позволяют использовать множество важных сценариев для пользователей почтовых ящиков Exchange. Вы можете предоставить пользователям возможность использовать EWS и Управляемый API EWS для реализации пользовательских решений для доступа и использования общедоступных папок и их содержимого.
Программный доступ к сообщениям электронной почты, отправленным в списки рассылки
Пользователи почтовых ящиков Exchange могут использовать общедоступные папки для хранения сообщений электронной почты, отправляемых в списки рассылки. Это удобный способ сохранения журнала списка рассылки. Для доступа к сохраненным сообщениям электронной почты списка рассылки можно использовать операцию FindItem в EWS или методы ExchangeService.FindItems() и Folder.FindItems() в управляемом API EWS.
Совместное использование важных сообщений электронной почты и других элементов почтового ящика
Пользователи почтовых ящиков могут использовать общедоступные папки в качестве общего репозитория для элементов почтовых ящиков. Различные пользователи в организации могут обмениваться важными сообщениями электронной почты или контактами с помощью общедоступных папок. EWS может предоставить доступ к этим общим элементам почтового ящика. Вы можете использовать операцию MoveItem в EWS или метод Item.Move() в Управляемом API EWS для перемещения сообщений электронной почты, контактов и других элементов почтового ящика в общедоступную папку и из нее.
Открытые обсуждения с элементами публикации
Общедоступные папки — это удобный контейнер для размещения элементов. Элементы публикации позволяют использовать потоковые беседы без необходимости отправлять сообщения электронной почты между пользователями. Пользователи могут использовать общедоступные папки и публиковать элементы для размещения и поддержания потоковой беседы между разными пользователями почтовых ящиков в организации. Таким образом, пользователи почтовых ящиков могут получить доступ к общему журналу беседы, в которой используются элементы записи, даже если они не были частью беседы. Вы можете использовать операцию CreateItem в EWS или метод Item.Save() в управляемом API EWS для создания и реагирования на элементы публикации, хранящиеся в общедоступной папке.
Маршрутизация запросов общедоступных папок
Содержимое общедоступных папок может храниться на нескольких серверах почтовых ящиков. Иерархия общедоступных папок может храниться в одном почтовом ящике, а содержимое общедоступной папки — в другом. И каждый из этих серверов может отличаться от сервера почтовых ящиков для пользователя, запрашивающего информацию. В таких ситуациях важно включить дополнительные заголовки X-AnchorMailbox и X-PublicFolderMailbox в запросы к общедоступным папкам для получения точных сведений об общедоступных папках.
Значение X-AnchorMailbox и X-PublicFolderMailbox может отличаться в зависимости от того, выполняется ли запрос, связанный с иерархией папок или содержимым папки. В следующей таблице показано, какую процедуру следует выполнить для каждого метода управляемого API EWS или операции EWS.
Методы управляемого API EWS и операции EWS для маршрутизации запросов к общедоступным папкам
| При вызове этих методов | При вызове этих операций | Используйте эту процедуру |
|---|---|---|
|
Folder.FindFolders Folder.Delete Folder.Update Folder.Move |
CreateFolder FindFolder DeleteFolder UpdateFolder MoveFolder |
Маршрутизация запросов иерархии общедоступных папок |
|
Item.Bind Item.Update Item.Copy Item.Move Item.Delete Folder.Bind Folder.FindItems |
CreateItem GetItem UpdateItem CopyItem MoveItem DeleteItem GetFolder FindItem |
Маршрутизация запросов содержимого общедоступных папок |
Различия версий
В Exchange 2007 и Exchange 2010 операция ConvertId работает должным образом при преобразовании идентификаторов общедоступных папок из идентификатора EWS в идентификатор хранилища.