Надстройки для Outlook и EWS в ExchangeOutlook add-ins and EWS in Exchange

Сведения о надстройках Outlook и их работе с EWS в Exchange.Find information about Outlook add-ins and how they work with EWS in Exchange.

Надстройки Outlook предоставляют единый интерфейс и модель программирования, использующие веб-стандарты для создания пользовательского интерфейса для пользователей электронной почты.Outlook add-ins provide a single interface and programming model that uses web standards to enable you to create a custom experience for your email users. Вы можете создавать почтовые приложения, отображающие контекстные или полезные сведения в фрейме HTML5, размещенном в Outlook; Например, почтовое приложение может показывать карту Bing с адресом, выделенным, когда сообщение электронной почты содержит адрес.You can create mail apps that display contextual or helpful information in an HTML5 frame hosted in Outlook; for example, a mail app can show a Bing map with an address highlighted when an email message contains an address. Или когда пользователь создает сообщение, почтовое приложение может показывать дополнительные сведения о получателе и вставлять стандартное приветствие в сообщение по нажатию кнопки.Or when a user is composing a message, a mail app can show additional information about the recipient, and insert a standard greeting into the email at the touch of a button.

Примечание

В этой статье "Outlook" означает расширенный клиент Outlook, Outlook RT, Outlook Web App и OWA для устройств."Outlook" in this article refers to the Outlook rich client, Outlook RT, Outlook Web App, and OWA for Devices.

Интерфейс почтовых приложений является частью API JavaScript для Office.The mail apps interface is part of the JavaScript API for Office. Вы можете использовать API для доступа к данным в Exchange, чтобы позволить почтовому приложению выполнять следующие действия:You can use the API to access information in Exchange to enable your mail app to:

  • Распознавание сущностей, таких как адреса, Номера телефонов, предложения по задачам и предложения о собраниях в сообщении электронной почты.Recognize entities, like addresses, phone numbers, task suggestions, or meeting suggestions in an email.

  • Открытие и отображение существующих сообщений и встреч в отдельном представлении, чтобы пользователи могли перекрестно ссылаться на информацию в одном или нескольких сообщениях.Open and display existing messages and appointments in a separate view so that users can cross-reference information in one or more messages.

  • Сделайте запросы EWS на сервер Exchange, на котором размещается почтовый ящик пользователя.Make EWS requests to the Exchange server that hosts the user's mailbox. Почтовое приложение может, например, получить список папок, чтобы пользователь мог выбрать одну из них для хранения сообщения или Показать все элементы в беседе или пометить сообщение электронной почты как нежелательное.A mail app can, for example, get a list of folders so that the user can choose one to store the message, or show all the items in a conversation, or mark an email message as junk.

  • Получите маркер для уникальной идентификации учетной записи электронной почты, чтобы включить единый вход в сторонней службе.Get a token to uniquely identify an email account to enable single sign on on a third-party service.

  • Получение маркера , который позволяет сторонней службе выполнять запросы EWS от имени пользователя, например, для извлечения вложений из элемента или получения элемента с сервера Exchange для дальнейшей обработки.Get a token that enables a third-party service to make EWS requests on behalf of the user, for example, to extract the attachments from an item, or to get an item from the Exchange server for further processing.

Вы можете использовать почтовые приложения, чтобы настроить взаимодействие с Outlook Web App для пользователей; Однако, если вы хотите настроить внешний вид и поведение Outlook Web App, ознакомьтесь со статьями на сайте TechNet:You can use mail apps to customize the Outlook Web App experience for your users; if, however, you want to customize the "look and feel" of Outlook Web App, see these articles on TechNet:

Ваша организация может устанавливать почтовые приложения на внутреннем сервере, чтобы ограничить доступ к авторизованным пользователям, а другие разработчики почтовых приложений могут помещать почтовые приложения в магазин Office для продажи в общедоступной общедоступной сети.Your organization can install mail apps on an internal server to limit access to authorized users, or you and other mail app developers can put mail apps on the Office Store for sale to the general public. Все, кто работает с Outlook, могут скачивать, устанавливать и использовать почтовые приложения из Marketplace.Anyone who is running Outlook can download, install, and use mail apps from the marketplace.

Если вы хотите узнать больше о создании почтовых приложений, ознакомьтесь с документацией по надстройкам Outlook или сделайте пример запроса EWS .If you want to learn more about creating mail apps, check out the Outlook add-ins documentation or the Make an EWS request sample.

Надстройки EWS и OutlookEWS and Outlook add-ins

Вы можете использовать подмножество операций EWS на сервере Exchange, на котором размещается учетная запись, на которой выполняется почтовое приложение.You can use a subset of EWS operations on the Exchange server that hosts the account that runs a mail app.

Функция Mailbox. makeEwsRequestAsync позволяет ОТПРАВЛЯТЬ запросы EWS из почтового приложения обратно на сервер, на котором размещается почтовый ящик пользователя.The mailbox.makeEwsRequestAsync function enables you to make EWS requests from your mail app back to the server that hosts the user's mailbox. Вы создаете конверт SOAP и запрос XML, а функция makeEwsRequestAsync вызывает EWS с помощью маркера проверки подлинности, определяющего почтовый ящик и почтовое приложение, которое делает запрос.You create the SOAP envelope and XML request, and the makeEwsRequestAsync function calls EWS with an authentication token that identifies the mailbox and mail app that is making the request. Чтобы обеспечить безопасность почтового ящика пользователя, сервер Exchange Server отклоняет все запросы, которые не поступают из почтового приложения или из почтового ящика, не размещенного на сервере.To help secure the user's mailbox, the Exchange server will reject any requests that do not come from the mail app or from a mailbox that is not hosted on the server.

Как и для любого другого приложения, почтовому приложению требуется разрешение на работу.Like any other application, a mail app needs permissions to work. Администратору необходимо выполнить указанные ниже действия.Your administrator needs to:

Кроме того, необходимо убедиться, что ваше приложение запрашивает разрешение на чтение и запись почтового ящика в модели разрешенийприложений для Office.You also need to make sure that your app requests the read/write mailbox permission in the apps for Office permission model.

После выполнения этих действий для почтового приложения будут доступны подмножество операций с папками и элементами EWS.When these steps are complete, a subset of folder and item EWS operations are available for the mail app to use.

Таблица 1. Операции с папками и элементами EWS, которые могут использовать почтовые приложенияTable 1. EWS folder and item operations that mail apps can use

Операции с папкамиFolder operations Операции с элементамиItem operations
Операция CreateFolderCreateFolder operation
Операция FindFolderFindFolder operation
Операция GetFolderGetFolder operation
Операция UpdateFolderUpdateFolder operation
Операция CopyItemCopyItem operation
Операция CreateItemCreateItem operation
Операция FindItemFindItem operation
Операция FindConversationFindConversation operation
Операция GetConversationItemsGetConversationItems operation
Операция GetItemGetItem operation
Операция MarkAsJunkMarkAsJunk operation
Операция MoveItemMoveItem operation
Операция SendItemSendItem operation
Операция UpdateItemUpdateItem operation

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

Маркеры обратного вызова службы позволяют почтовым приложениям передавать маркер доступа сторонней службе, чтобы служба могла отправлять запросы EWS на сервер Exchange, на котором размещается почтовый ящик.Service callback tokens enable mail apps to pass an access token to a third-party service so that the service can make EWS requests to the Exchange server that hosts the mailbox. Например, почтовое приложение может передать маркер обратного вызова службы сторонней службе, а также список идентификаторов вложений для изображений, вложенных в сообщение электронной почты.For example, a mail app can pass a service callback token to a third-party service along with a list of attachment IDs for pictures attached to an email. Затем служба может использовать идентификаторы вложений и маркер обратного вызова, чтобы отправить запрос EWS на сервер Exchange пользователя для получения вложенных изображений.The service can then use the attachment IDs and the callback token to make an EWS request to the user's Exchange server to get the attached pictures. Почтовые приложения также могут использовать токен обратного вызова службы со списком идентификаторов элементов для получения электронной почты и элементов встреч с сервера Exchange.Mail apps can also use the service callback token with a list of item IDs to get email and appointment items from the Exchange server.

Маркер обратного вызова службы — это непрозрачный маркер, который служба стороннего разработчика присоединяется к запросу EWS в заголовке проверки подлинности носителя.The service callback token is an opaque token that the third-party service attaches to the EWS request in a bearer authentication header. Маркер определяет почтовое приложение и почтовый ящик для защиты запроса EWS.The token identifies the mail app and the mailbox to help secure the EWS request. Чтобы узнать, как использовать маркеры обратного вызова службы, ознакомьтесь с разделом надстройки Outlook: получение вложений из примера сервера Exchange Server .To learn how to use service callback tokens, see the Outlook add-ins: Get attachments from an Exchange server sample.

См. такжеSee also