Надстройки для Outlook и EWS в Exchange

  • Статья

Здесь вы найдете сведения о надстройках Outlook и о том, как они работают с EWS в Exchange.

Надстройки Outlook предоставляют единый интерфейс и модель программирования, в которой используются веб-стандарты, что позволяет создавать настраиваемые возможности для пользователей электронной почты. Вы можете создавать почтовые приложения, которые отображают контекстную или полезную информацию во фрейме HTML5, размещенном в Outlook. Например, почтовое приложение может отображать карту Bing с выделенным адресом, если сообщение электронной почты содержит адрес. Или когда пользователь пишет сообщение, почтовое приложение может показать дополнительную информацию о получателе и вставить стандартное приветствие в электронное письмо одним нажатием кнопки.

Примечание.

В этой статье "Outlook" означает расширенный клиент Outlook, Outlook RT, Outlook Web App и OWA для устройств.

Интерфейс почтовых приложений является частью API JavaScript для Office. Вы можете использовать API для доступа к сведениям в Exchange, чтобы почтовое приложение могло:

  • Распознавать объекты, такие как адреса, номера телефонов, предложения по задачам или предложения по встречам в электронном письме.

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

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

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

  • Получить маркер, который позволяет сторонней службе выполнять запросы EWS от имени пользователя, например, для извлечения вложений из элемента или для получения элемента с сервера Exchange Server для дальнейшей обработки.

Вы можете использовать почтовые приложения, чтобы настроить Outlook Web App для своих пользователей. Однако, если вы хотите настроить дизайн Outlook Web App, см. следующие статьи на TechNet:

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

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

Надстройки EWS и Outlook

Вы можете использовать подмножество операций EWS на сервере Exchange Server, на котором размещена учетная запись, в которой запускается почтовое приложение.

Функция mailbox.makeEwsRequestAsync позволяет отправлять запросы EWS из почтового приложения обратно на сервер, на котором размещен почтовый ящик пользователя. Вы создаете конверт протокола SOAP и XML-запрос, а функция makeEwsRequestAsync вызывает EWS с маркером проверки подлинности, который идентифицирует почтовый ящик и почтовое приложение, отправляющее запрос. Чтобы обеспечить безопасность почтового ящика пользователя, сервер Exchange Server будет отклонять любые запросы, поступающие не из почтового приложения или из почтового ящика, не размещенного на сервере.

Как и любому другому приложению, почтовому приложению требуются разрешения для работы. Администратор должен:

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

После выполнения этих шагов почтовому приложению будет доступно подмножество операций EWS с папками и элементами.

Таблица 1. Операции с папками и элементами EWS, которые могут использовать почтовые приложения

Операции с папками Операции с элементами
CreateFolder Operation
FindFolder Operation
GetFolder Operation
Операцию UpdateFolder
CopyItem Operation
CreateItem Operation
FindItem Operation
Операция FindConversation
GetConversationItems operation
GetItem Operation
MarkAsJunk Operation
MoveItem Operation
SendItem Operation
UpdateItem Operation

Маркеры обратного вызова службы

Маркеры обратного вызова службы позволяют почтовым приложениям передавать маркер доступа сторонней службе, чтобы служба могла выполнять запросы EWS к серверу Exchange Server, на котором размещен почтовый ящик. Например, почтовое приложение может передать маркер обратного вызова службы сторонней службе вместе со списком идентификаторов вложений для изображений, вложенных в сообщение электронной почты. Затем служба может использовать идентификаторы вложений и маркер обратного вызова, чтобы отправить запрос EWS на сервер Exchange Server пользователя для получения вложенных изображений. Почтовые приложения также могут использовать маркер обратного вызова службы со списком идентификаторов элементов для получения элементов электронной почты и встреч с сервера Exchange Server.

Маркер обратного вызова службы — это непрозрачный маркер, который сторонняя служба прикрепляет к запросу EWS в заголовке проверки подлинности носителя. Маркер идентифицирует почтовое приложение и почтовый ящик для защиты запроса EWS. Чтобы узнать, как использовать маркеры обратного вызова службы, ознакомьтесь с примером Надстройки Outlook: получение вложений с сервера Exchange Server.

См. также