Операции EWS в Exchange

  • Статья

Сведения об операциях EWS, доступных в Exchange.

Получить доступ к данным в хранилище Exchange вы можете с помощью множества операций веб-служб Exchange (EWS). Статьи в этом разделе описывают общую структуру запросов, ответов и сообщений об ошибочных ответах, касающихся операций EWS, а также содержат примеры XML для каждой такой операции. В них кратко рассмотрены структуры сообщений, которыми обмениваются клиент и сервер. Эти сведения позволят отладить структуры сообщений, а также узнать, какие действия доступны в запросе EWS. Дополнительные сведения о том, что представляет собой структура XML, см. в статье XML-элементы EWS в Exchange.

Функциональность EWS связана с версией схемы. Новые версии схемы EWS вводятся в новых выпусках Exchange Server или Exchange Online. Элемент RequestServerVersion содержит атрибут Version, который сопоставляет версию сервера с версией схемы. В данной статье указано, когда была введена каждая операция. Для использования определенных возможностей операций может потребоваться более поздняя версия службы. Версионирование схем позволяет клиентам, разработанным для старой версии веб-служб Exchange, работать с новой их версией.

Целевым объектом этих операций может быть конечная точка EWS, которая обслуживает почтовый ящик. Вы можете перейти к конечной точке EWS, используя URL-адрес, похожий по структуре на http://<clientaccessserver.com>/ews/exchange.asmx, где <clientaccessserver> — это сервер клиентского доступа Exchange, который обслуживает ваш почтовый ящик. Получить URL-адрес сервера клиентского доступа, обслуживающего почтовый ящик, можно с помощью службы автообнаружения. Дополнительные сведения об автообнаружение см. в разделе Автообнаружения для Exchange.

Операции обнаружения электронных данных

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

В таблице ниже перечислены операции обнаружения электронных данных.

Имя операции Версия, где параметр был представлен
Операция GetDiscoverySearchConfiguration
Exchange 2013
Операция GetHoldOnMailboxes
Exchange 2013
Операция GetNonIndexableItemDetails
Exchange 2013
Операция GetNonIndexableItemStatistics
Exchange 2013
Операция GetSearchableMailboxes
Exchange 2013
Операция SearchMailboxes
Exchange 2013
Операция SetHoldOnMailboxes
Exchange 2013

Операции с данными почтовых ящиков Exchange

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

В таблице ниже перечислены операции с данными почтовых ящиков Exchange.

Имя операции Версия, где параметр был представлен
Операция ArchiveItem
Exchange 2013
CreateItem Operation
Exchange 2007
CopyItem Operation
Exchange 2007
Операция DeleteItem
Exchange 2007
FindItem Operation
Exchange 2007
GetItem Operation
Exchange 2007
Операция MarkAllItemsAsRead
Exchange 2013
MoveItem Operation
Exchange 2007
SendItem Operation
Exchange 2007
UpdateItem Operation
Exchange 2007

В таблице ниже перечислены операции с папками данных в почтовых ящиках Exchange.

Имя операции Версия, где параметр был представлен
CreateFolder Operation
Exchange 2007
Операция CreateFolderPath
Exchange 2013
Операция CreateManagedFolder
Exchange 2007. Вместо этой возможности в Exchange 2010 и более поздних версий используются другие. Дополнительные сведения о переходе на использование тегов хранения и политик для управления записями обмена сообщениями см. в разделе Миграция из управляемых папок.
Операция CopyFolder
Exchange 2007
Операция DeleteFolder
Exchange 2007
Операция EmptyFolder
Exchange 2010
FindFolder Operation
Exchange 2007
GetFolder Operation
Exchange 2007
Операция MoveFolder
Exchange 2007
Операцию UpdateFolder
Exchange 2007

В таблице ниже перечислены операции с вложениями в почтовых ящиках Exchange.

Имя операции Версия, где параметр был представлен
Операция CreateAttachment
Exchange 2007
Операция GetAttachment
Exchange 2007
Операция DeleteAttachment
Exchange 2007

В таблице ниже перечислены операции с напоминаниями в почтовых ящиках Exchange.

Имя операции Версия, где параметр был представлен
Операция GetReminders
Exchange 2013
Операция PerformReminderAction
Exchange 2013

В таблице ниже перечислены операции с беседами в почтовых ящиках Exchange.

Имя операции Версия, где параметр был представлен
Операция ApplyConversationAction
Exchange 2010 с пакетом обновления 1 (SP1)
FindConversation Operation
Exchange 2010 SP1
GetConversationItems operation
Exchange 2013

В таблице ниже перечислены операции с использованием служебных программ в почтовых ящиках Exchange.

Имя операции Версия, где параметр был представлен
Операция ConvertId
Exchange 2007 с пакетом обновления 1 (SP1)
Операция ExpandDL
Exchange 2007
Операция GetUserPhoto
Exchange 2013. Эта операция может выполняться как с помощью REST, так и с помощью протокола SOAP.
MarkAsJunk Operation
Exchange 2013
Операция ResolveNames
Exchange 2007
Операция GetPasswordExpirationDate
Exchange 2010 SP1

Операции проверки доступности

Операции проверки доступности повышают удобство работы с календарем и обмена сведениями о доступности, так как предоставляют защищенные, актуальные и полные сведения о доступности. Сведения о доступности критически важны при планировании собраний. Поэтому операции проверки доступности обеспечивают его эффективность.

В таблице ниже перечислены операции проверки доступности.

Имя операции Версия, где параметр был представлен
Операция GetUserAvailability
Exchange 2007
Операция GetRoomLists
Exchange 2010
Операция GetRooms
Exchange 2010
Операция GetUserOofSettings
Exchange 2007
Операция SetUserOofSettings
Exchange 2007

Операции массовой передачи данных

С помощью операций массовой передачи данных клиенты могут выполнять потоковую передачу элементов в почтовый ящик и из него.

В таблице ниже перечислены операции массовой передачи данных.

Имя операции Версия, где параметр был представлен
Операция UploadItems
Exchange 2010 SP1
Операция ExportItems
Exchange 2010 SP1

Операции управления делегированием

С помощью операций управления делегированием клиенты могут добавлять, получать, обновлять и удалять делегатов в почтовых ящиках.

В таблице ниже перечислены операции управления делегированием.

Имя операции Версия, где параметр был представлен
Операция AddDelegate
Exchange 2007 с пакетом обновления 1 (SP1)
Операция GetDelegate
Exchange 2007 SP1
Операция UpdateDelegate
Exchange 2007 SP1
Операция RemoveDelegate
Exchange 2007 SP1

Операции с правилами для папки "Входящие"

Операции с правилами для папки "Входящие" позволяют клиентам получать правила для папки "Входящие" и обновлять их для сообщений на сервере. Правила для папки "Входящие" — это наборы условий и связанных с ними действий, с помощью которых клиенты могут автоматически упорядочивать и классифицировать сообщения, доставляемые в папки, а также выполнять с ними действия.

В таблице ниже перечислены операции с правилами для папки "Входящие"

Имя операции Версия, где параметр был представлен
Операция GetInboxRules
Exchange 2010 SP1
Операция UpdateInboxRules
Exchange 2010 SP1

Операции управления почтовыми приложениями

Операции управления почтовыми приложениями позволяют управлять почтовыми приложениями для Outlook. С помощью этих операций можно устанавливать, удалять и отключать почтовые приложения, доступные для Outlook Web App и Outlook 2013, а также получать о них информацию.

В таблице ниже перечислены операции управления почтовыми приложениями.

Имя операции Версия, где параметр был представлен
Операция DisableApp
Exchange 2013
Операция GetAppManifests
Exchange 2013
Операция GetAppMarketplaceUrl
Exchange 2013
Операция GetClientAccessToken
Exchange 2013
Операция InstallApp
Exchange 2013
Операция UninstallApp
Exchange 2013

Операция с подсказками электронной почты

Операция с подсказками электронной почты позволяет клиентам запрашивать у сервера сведения о почтовых ящиках получателей, когда автор составляет сообщение. В таблице ниже указана операция с подсказками электронной почты.

Имя операции Версия, где параметр был представлен
Операция GetMailTips
Exchange 2010

Операции отслеживания сообщений

С помощью операций отслеживания сообщений клиенты могут находить сообщения, соответствующие определенным условиям, и получать подробные сведения об отслеживании каждого сообщения в отчетах об отслеживании сообщений.

В таблице ниже перечислены операции отслеживания сообщений.

Имя операции Версия, где параметр был представлен
Операция FindMessageTrackingReport
Exchange 2010
Операция GetMessageTrackingReport
Exchange 2010

Операции с уведомлениями

Операции с уведомлениями сообщают клиентскому приложению о событиях, связанных с элементами и папками в определенном почтовом ящике. Модель подписки может базироваться на push- и pull-технологии, а также потоковой передаче данных.

В таблице ниже перечислены операции с уведомлениями.

Имя операции Версия, где параметр был представлен
Операция GetEvents
Exchange 2007
Операция GetStreamingEvents
Exchange 2010 SP1
Операции подписки
Exchange 2007
Отписаться операции
Exchange 2007

Операции с пользователями

При использовании операции с пользователями доступен интерфейс, с помощью которого можно находить и получать сведения о связанном контакте. В таблице ниже перечислены операции с пользователями.

Имя операции Версия, где параметр был представлен
Операция FindPeople
Exchange 2013
Операция GetPersona
Exchange 2013

Операция с политиками хранения

Операция с политиками хранения предоставляет список всех тегов хранения, связанных с политикой хранения пользователя.

В таблице ниже указана операция с политикой хранения.

Имя операции Версия, где параметр был представлен
Операция GetUserRetentionPolicyTags
Exchange 2013

Операция с конфигурацией служб

Операция с конфигурацией служб позволяет клиентам получать сведения о конфигурации для служб единой системы обмена сообщениями, правил защиты, подсказок политики и подсказок электронной почты.

В таблице ниже указана операция с конфигурацией служб.

Имя операции Версия, где параметр был представлен
Операция GetServiceConfiguration
Exchange 2010

Операции общего доступа

С помощью операций общего доступа клиенты могут обмениваться данными календарей и контактов.

В таблице ниже перечислены операции общего доступа.

Имя операции Версия, где параметр был представлен
CreateItem (AcceptSharingInvitation)
Exchange 2010. Хотя операция CreateItem применима ко всем версиям EWS, объект ответа AcceptSharingInvitation применим только к EWS в Exchange 2010 и более поздних версий.
Операция GetSharingFolder
Exchange 2010
Операция GetSharingMetadata
Exchange 2010
Операция RefreshSharingFolder
Exchange 2010

Операции синхронизации

Операции синхронизации предоставляют односторонне синхронизированную кэшированную копию папок и элементов пользователя.

В таблице ниже перечислены операции синхронизации.

Имя операции Версия, где параметр был представлен
Операция SyncFolderHierarchy
Exchange 2007
Операция SyncFolderItems
Exchange 2007

Операция с часовыми поясами

Операция с часовыми поясами позволяет клиентам получить список определений часовых поясов, поддерживаемых сервером.

В таблице ниже указана операция с часовыми поясами.

Имя операции Версия, где параметр был представлен
Операция GetServerTimeZones
Exchange 2010

Операции с единой системой обмена сообщениями

При помощи операций с единой системой обмена сообщениями клиенты могут читать сведения о свойствах единой системы обмена сообщениями и воспроизводить сообщения голосовой почты по телефону.

В таблице ниже перечислены операции с единой системой обмена сообщениями.

Имя операции Версия, где параметр был представлен
Операция DisconnectPhoneCall
Exchange 2010
Операция GetPhoneCallInformation
Exchange 2010
Операция PlayOnPhone (EWS)
Exchange 2010

Используйте операцию GetServiceConfiguration , чтобы получить сведения о конфигурации единой системы обмена сообщениями для почтового ящика. Для приложений единой системы обмена сообщениями, предназначенных для Exchange 2007, используйте веб-службу единой системы обмена сообщениями. Дополнительные сведения см. в статье Справочник по веб-службе единой системы обмена сообщениями для Exchange.

Операции с единым хранилищем контактов

Единое хранилище контактов позволяет использовать общий список контактов для всех продуктов Office и выполняет роль точки интеграции для сторонних приложений, чтобы они использовали то же самое хранилище контактов. С помощью него пользователи и приложения могут хранить сведения о контактах, управлять ими, получать к ним доступ, а также открывать глобальный доступ к ним в Lync, Exchange 2013, Outlook, Outlook Web App и других приложениях, в которых реализован доступ к единому хранилищу контактов. Exchange выполняет функцию хранилища содержимого для единого хранилища контактов.

В таблице ниже перечислены операции с единым хранилищем контактов.

Имя операции Версия, где параметр был представлен
Операция AddNewImContactToGroup
Exchange 2013
Операция AddImContactToGroup
Exchange 2013
Операция AddImGroup
Exchange 2013
Операция AddNewTelUriContactToGroup
Exchange 2013
Операция AddDistributionGroupToImList
Exchange 2013
Операция GetImItemList
Exchange 2013
Операция GetImItems
Exchange 2013
Операция RemoveContactFromImList
Exchange 2013
Операция RemoveImContactFromGroup
Exchange 2013
Операция RemoveDistributionGroupFromImList
Exchange 2013
Операция RemoveImGroup
Exchange 2013
Операция SetImGroup
Exchange 2013

Операции с конфигурациями пользователей

Операции с конфигурациями пользователей позволяют клиентам создавать, удалять, получать и обновлять сведения о конфигурации пользователей.

В таблице ниже перечислены операции с конфигурациями пользователей.

Имя операции Версия, где параметр был представлен
Операция CreateUserConfiguration
Exchange 2010
Операция DeleteUserConfiguration
Exchange 2010
Операция GetUserConfiguration
Exchange 2010
Операция UpdateUserConfiguration
Exchange 2010

См. также