Удаление элементов с помощью EWS в Exchange
Узнайте, как использовать управляемый API EWS или EWS в Exchange для удаления элементов, переместив их в папку "Удаленные" или в контейнер.
Вы когда-нибудь спрашивали себя, в чем разница между перемещением элементов в папку "Удаленные" и перемещением их в контейнер? Вам может быть интересно о различных вариантах обработки удаленных элементов и о том, как реализовать эти параметры в приложении. Веб-службы Exchange (EWS) включают три варианта обработки удаленных элементов. Эта статья, надеюсь, прояснит любую путаницу, возможно, о различиях между ними.
Удаление элементов — какие у меня варианты?
Прежде чем вы сможете понять общую картину для удаления элементов, важно определить разницу между следующими:
Папка "Удаленные" — при удалении элементов в почтовом ящике они отправляются именно туда.
Мусорная корзина (папка "Элементы с возможностью восстановления") — при удалении элементов из почтового ящика они отправляются именно туда.
На рисунках 1 и 2 показано, как выглядит процесс удаления элементов и папок в почтовом ящике.
Рис. 1. Процесс удаления элементов из почтового ящика
Рис. 2. Процесс удаления папок из почтового ящика
Вы можете удалить элементы и папки тремя разными способами в зависимости от того, насколько "постоянным" вы хотите удалить удаление.
Таблица 1. Параметры удаления элементов с помощью EWS
| Option | Что происходит |
|---|---|
| Перемещение в папку удаленных элементов |
Это наименее постоянный способ удаления элементов. Это все равно, что положить лист бумаги в корзину у вашего стола. Вы можете легко схватить его, если вам нужно снова. Для выполнения этого действия можно использовать любую операцию удаления , реализующую перемещение в папку "Удаленные". Вы также можете использовать операцию MoveItem ( Item.Move()) или операцию MoveFolder ( Folder.Move()) для перемещения элемента или папки в папку "Удаленные". |
| Обратимое удаление |
Элемент перемещается в папку Удаления в контейнере. Это похоже на очистку корзины в контейнере на обочине. Вы по-прежнему можете получить доступ к элементу, если вам это нужно, это просто немного сложнее. Дополнительные сведения о контейнере (также называемой папкой "Элементы с возможностью восстановления") и таких сценариях, как обнаружение электронных данных или удержание для судебного разбирательства, см. в разделе Папка с возможностью восстановления в TechNet. Обратимое удаление не рекомендуется использовать для приложений, предназначенных для Exchange 2007. В Exchange 2007 обратимое удаление обрабатывается путем задания элемента, указывающего на то, что он будет перемещен в контейнер в неопределенное время. Обходы обратимого удаления или поиск элементов, которые были обратимо удалены с помощью операции FindItem, не поддерживаются в Exchange Online, Exchange Online в составе Office 365 и версиях Exchange, начиная с Exchange 2010. ПРИМЕЧАНИЕ. Папки нельзя удалить обратимо. |
| Необратимое удаление |
Элемент или папка удаляются без возможности восстановления. Жестко удаленные элементы помещаются в папку Очистки мусорного ящика. Это похоже на то, когда мусоровоз очищает ваш бордюрный контейнер для переработки. Невозможно получить доступ к элементам из почтового клиента, например Outlook или Outlook Web App, и если в почтовом ящике нет набора удержаний, они будут окончательно удалены по истечении определенного периода времени. Дополнительные сведения о хранении элементов см. в статье Настройка хранения удаленных элементов и квот элементов с возможностью восстановления. ПРИМЕЧАНИЕ. Папки не помещаются в папку Очистки при их жестком удалении. Жестко удаленные папки удаляются из почтового ящика. |
Перемещение в папку "Удаленные" и параметры жесткого удаления являются транзакциональными. Это означает, что к моменту завершения вызова веб-службы элемент был перемещен в папку "Удаленные" или в контейнер.
Чтобы лучше понять экосистему папок, используемых для хранения удаленных элементов, на следующем рисунке показана иерархия папок, которые могут содержать удаленные элементы. Имена папок отображаются в типе схемы DistinguishedFolderIdNameType или перечислении WellKnownFolderName в управляемом API EWS.
Рис. 3. Иерархия папок, содержащих удаленные элементы
Таблица 2. Папки, содержащие удаленные элементы
| Имя папки | Версия, где параметр был представлен | Описание |
|---|---|---|
| deleteditems |
Exchange 2007 |
Папка "Удаленные" по умолчанию. Элементы остаются в этой папке до обратимого или жесткого удаления или до истечения срока хранения. Затем они перемещаются в папку в контейнере. Удаленные папки помещаются в папку Удаленные, а при обратимом или жестком удалении они удаляются из почтового ящика без возможности восстановления. |
| recoverableitemsroot |
Exchange 2010 |
Корневой каталог мусорной корзины или папка "Элементы с возможностью восстановления". Доступ к контейнеру был реализован в EWS в Exchange 2010. Отображаемое имя для этой папки — "Элементы с возможностью восстановления". |
| recoverableitemsdeletions |
Exchange 2010 |
Основная папка мусорного ящика для почтового ящика. Обратимо удаленные элементы и элементы, перемещенные из папки "Удаленные" политикой хранения, помещаются в эту папку. Отображаемое имя для этой папки — "Удаления". |
| recoverableitemsversions |
Exchange 2010 |
Где хранятся более старые версии элемента. Старые версии элемента создаются при обновлении элемента. Черновая версия элемента не сохраняется в этой папке. Отображаемое имя этой папки — Versions. |
| recoverableitemspurges |
Exchange 2010 |
Где хранятся элементы, удаленные из папки Удаления. Все элементы хранилища, жестко удаленные, перемещаются в эту папку. Отображаемое имя для этой папки — "Очистка". |
| archiveddeletedtitems |
Exchange 2010 |
Папка "Удаленные" по умолчанию для архивного почтового ящика. |
| archiverecoverablesitemsroot |
Exchange 2010 |
Корневая папка мусорного ящика для архивного почтового ящика. Обратимо удаленные архивные элементы перемещаются во вложенную папку в этой папке. |
| archiverecoverableitemsdeletions |
Exchange 2010 |
Основная папка для архивного почтового ящика. Архивные элементы, перенесенные в мусорную корзину, помещаются здесь. |
| archiverecoverableitemsversions |
Exchange 2010 |
Где хранятся более старые версии архивных элементов. |
| archiverecoverableitemspurges |
Exchange 2010 |
Где хранятся элементы, которые жестко удалены из архивной папки Deletes в контейнере. Все архивные элементы, удаленные в хранилище, перемещаются в эту папку. |
Разделы справки удалить элементы?
Используйте один из следующих способов, чтобы указать, следует ли переместить элемент в папку "Удаленные" или выполнить обратимое или жесткое удаление:
Простой тип DisposalType , если для доступа к Exchange используется EWS.
Перечисление DeleteMode, если используется управляемый API EWS.
Для удаления элементов и папок из почтового ящика можно использовать ряд различных операций EWS или методов управляемого API EWS.
Таблица 3. Операции EWS и методы управляемого API EWS для удаления элементов
| Операция служб EWS | Метод управляемого API EWS | Версия, где параметр был представлен | Действие |
|---|---|---|---|
| Операция DeleteFolder |
Метод Folder.Delete |
Exchange 2007 |
Удаляет папки из почтового ящика. С помощью EWS можно пакетно удалять папки. С помощью управляемого API EWS можно удалить только одну папку для каждого вызова. |
| Операция DeleteItem |
Метод Item.Delete Метод ExchangeService.DeleteItems |
Exchange 2007 |
Удаляет элементы из почтового ящика. |
| Операция EmptyFolder |
Метод Folder.Empty |
Exchange 2010 |
Удаляет все элементы в папке и при необходимости удаляет все вложенные папки в папке. |
| Операция ApplyConversationAction |
Метод Conversation.EnableAlwaysDeleteItems Метод Conversation.DeleteItems |
Exchange 2010 |
Задает действие обработки удаления для сообщений электронной почты в беседе, чтобы они были удалены. |
| Операция DeleteUserConfiguration |
Метод UserConfiguration.Delete |
Exchange 2010 |
Удаляет связанный с папкой элемент и перемещает его в контейнер. |
| CreateItem Operation |
Метод Appointment.Accept Метод Appointment.AcceptTentatively Метод Appointment.CancelMeeting Appointment.Decline Метод MeetingRequest.Accept Метод MeetingRequest.AcceptTentatively Метод MeetingRequest.Decline |
Exchange 2007 |
Опосредованно перемещает элемент в папку "Удаленные" при отправке ответа на приглашение на собрание или при установке ответа на встречу. Тип удаления не задан для этой операции. Сообщения о собрании перемещаются в папку "Удаленные", когда объект ответа успешно обрабатывается службой. |
Вы также можете переместить элементы в папку Удаленные с помощью правил папки "Входящие". Например, можно создать правила с действием удаления.
Некоторые моменты, которые следует отметить об удалении элементов:
Удаление вхождения повторяющегося элемента не приводит к переходу в папку "Удаленные" или в контейнер. Это приводит к обновлению повторяющегося главного элемента повторяющегося ряда.
Нельзя удалить папки по умолчанию из почтового ящика.
Избегайте удаления собраний или сообщений о собраниях, таких как приглашения на собрания и обновления собраний. Вместо этого отвечайте на эти элементы с помощью объектов ответа. Таким образом, связанные элементы календаря обновляются, чтобы отразить действия респондента или организатора.
Ключ изменения элемента не обновляется при перемещении элемента в папку Удаленные или Удаления.
Если выполнить жесткое удаление элемента, а затем вызвать операцию SyncFolderHierarchy или метод Управляемого API SyncFolderHierarchy EWS, операцию SyncFolderItems или метод SyncFolderItems , будет возвращена запись Delete change. При перемещении элемента в папку Удаленные возвращается запись Об изменении обновления . Это связано с тем, что элемент или папка будут иметь новое значение свойства ParentFolderId . Ознакомьтесь с дополнительными сведениями о синхронизации , если синхронизация удаленных элементов является частью вашего сценария.
Дополнительные сведения об удалении элементов
См. также
- Папки и элементы в веб-службах Exchange
- Разработка клиентов веб-служб для Exchange
- Папка "Элементы с возможностью восстановления"
- Восстановление одного элемента в Exchange Server 2010 г.
- Exchange 2013: программное удаление повторяющегося ряда с серверов Exchange
- Exchange 2013: программное удаление задач из учетной записи на серверах Exchange
- Exchange 2013: пустые папки на серверах Exchange Server программными средствами
- Exchange 2013: программное удаление папок с серверов Exchange
- Exchange 2013: программное удаление многих элементов с серверов Exchange
- Exchange 2013: программное удаление контактов с серверов Exchange
- Удаление встреч и отмена собраний с помощью EWS в Exchange
- Управление параметрами постоянных приложений с помощью EWS в Exchange