Suplementos do Outlook e EWS no ExchangeOutlook add-ins and EWS in Exchange

Encontre informações sobre os suplementos do Outlook e como eles funcionam com o EWS no Exchange.Find information about Outlook add-ins and how they work with EWS in Exchange.

Os suplementos do Outlook oferecem uma interface única e um modelo de programação que usa padrões da Web para permitir que você crie uma experiência personalizada para seus usuários de email.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. Você pode criar aplicativos de email que exibem informações contextuais ou úteis em um quadro HTML5 hospedado no Outlook; por exemplo, um aplicativo de email pode mostrar um mapa do Bing com um endereço realçado quando uma mensagem de email contém um endereço.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. Ou quando um usuário está redigindo uma mensagem, um aplicativo de email pode mostrar informações adicionais sobre o destinatário e inserir uma saudação padrão no email com o toque de um botão.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.

Observação

"Outlook" neste artigo se refere ao cliente avançado do Outlook, Outlook RT, Outlook Web App, e OWA para Dispositivos."Outlook" in this article refers to the Outlook rich client, Outlook RT, Outlook Web App, and OWA for Devices.

A interface de aplicativos de email faz parte da API JavaScript para Office.The mail apps interface is part of the JavaScript API for Office. Você pode usar a API para acessar informações no Exchange para habilitar o aplicativo de email para:You can use the API to access information in Exchange to enable your mail app to:

  • Reconhecer entidades, como endereços, números de telefone, sugestões de tarefas ou sugestões de reunião em um email.Recognize entities, like addresses, phone numbers, task suggestions, or meeting suggestions in an email.

  • Abrir e exibir mensagens e compromissos existentes em um modo de exibição separado para que os usuários possam fazer referência cruzada de informações em uma ou mais mensagens.Open and display existing messages and appointments in a separate view so that users can cross-reference information in one or more messages.

  • Faça solicitações de EWS para o servidor Exchange que hospeda a caixa de correio do usuário.Make EWS requests to the Exchange server that hosts the user's mailbox. Um aplicativo de email pode, por exemplo, obter uma lista de pastas para que o usuário possa escolher uma para armazenar a mensagem ou mostrar todos os itens em uma conversa ou marcar uma mensagem de email como lixo eletrônico.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.

  • Obtenha um token para identificar exclusivamente uma conta de email a fim de habilitar o logon único em um serviço de terceiros.Get a token to uniquely identify an email account to enable single sign on on a third-party service.

  • Obter um token que permite que um serviço de terceiros faça solicitações do EWS em nome do usuário, por exemplo, para extrair os anexos de um item ou para obter um item do Exchange Server para processamento adicional.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.

Você pode usar aplicativos de email para personalizar a experiência do Outlook Web App para seus usuários; se, no entanto, você quiser personalizar a "aparência" do Outlook Web App, consulte estes artigos no 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:

Sua organização pode instalar aplicativos de email em um servidor interno para limitar o acesso a usuários autorizados ou você e outros desenvolvedores de aplicativos de email podem colocar aplicativos de email na Office Store para venda ao público geral.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. Qualquer pessoa que esteja executando o Outlook pode baixar, instalar e usar aplicativos de email do Marketplace.Anyone who is running Outlook can download, install, and use mail apps from the marketplace.

Se você quiser saber mais sobre a criação de aplicativos de email, confira a documentação dos suplementos do Outlook ou faça um exemplo de solicitação do 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.

Suplementos do EWS e do OutlookEWS and Outlook add-ins

Você pode usar um subconjunto de operações EWS no servidor Exchange que hospeda a conta que executa um aplicativo de email.You can use a subset of EWS operations on the Exchange server that hosts the account that runs a mail app.

A função Mailbox. makeEwsRequestAsync permite que você faça solicitações de EWS do seu aplicativo de email de volta para o servidor que hospeda a caixa de correio do usuário.The mailbox.makeEwsRequestAsync function enables you to make EWS requests from your mail app back to the server that hosts the user's mailbox. Você cria o envelope SOAP e a solicitação XML, e a função makeEwsRequestAsync chama o EWS com um token de autenticação que identifica a caixa de correio e o aplicativo de email que está fazendo a solicitação.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. Para ajudar a proteger a caixa de correio do usuário, o servidor Exchange rejeitará todas as solicitações que não são provenientes do aplicativo de email ou de uma caixa de correio que não esteja hospedada no servidor.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.

Como qualquer outro aplicativo, um aplicativo de email precisa de permissões para funcionar.Like any other application, a mail app needs permissions to work. O administrador precisa:Your administrator needs to:

Você também precisa certificar-se de que seu aplicativo solicite a permissão de leitura/gravação de caixa de correio no modelo de permissãode aplicativos para Office.You also need to make sure that your app requests the read/write mailbox permission in the apps for Office permission model.

Quando essas etapas estiverem concluídas, um subconjunto de operações do EWS de pasta e item estará disponível para o aplicativo de email a ser usado.When these steps are complete, a subset of folder and item EWS operations are available for the mail app to use.

Tabela 1. Operações de pasta e item do EWS que os aplicativos de email podem usarTable 1. EWS folder and item operations that mail apps can use

Operações de pastaFolder operations Operações de itemItem operations
Operação CreateFolderCreateFolder operation
Operação FindFolderFindFolder operation
Operação GetFolderGetFolder operation
Operação UpdateFolderUpdateFolder operation
Operação CopyItemCopyItem operation
Operação CreateItemCreateItem operation
Operação FindItemFindItem operation
Operação FindConversationFindConversation operation
Operação GetConversationItemsGetConversationItems operation
Operação GetItemGetItem operation
Operação MarkAsJunkMarkAsJunk operation
Operação MoveItemMoveItem operation
Operação SendItemSendItem operation
Operação UpdateItemUpdateItem operation

Tokens de retorno de chamada de serviçoService callback tokens

Os tokens de retorno de chamada de serviço permitem que os aplicativos de email transmitam um token de acesso para um serviço de terceiros, para que o serviço possa fazer solicitações de EWS ao servidor Exchange que hospeda a caixa de correio.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. Por exemplo, um aplicativo de email pode passar um token de retorno de chamada de serviço para um serviço de terceiros junto com uma lista de IDs de anexo para imagens anexadas a um email.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. O serviço pode então usar as IDs de anexo e o token de retorno de chamada para fazer uma solicitação de EWS ao servidor Exchange do usuário para obter as imagens anexadas.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. Os aplicativos de email também podem usar o token de retorno de chamada de serviço com uma lista de IDs de item para receber itens de email e de compromisso do servidor 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.

O token de retorno de chamada de serviço é um token opaco que o serviço de terceiros anexa à solicitação EWS em um cabeçalho de autenticação de portador.The service callback token is an opaque token that the third-party service attaches to the EWS request in a bearer authentication header. O token identifica o aplicativo de email e a caixa de correio para ajudar a proteger a solicitação do EWS.The token identifies the mail app and the mailbox to help secure the EWS request. Para saber como usar tokens de retorno de chamada de serviço, confira os suplementos do Outlook: obter anexos de um exemplo do Exchange Server .To learn how to use service callback tokens, see the Outlook add-ins: Get attachments from an Exchange server sample.

Confira tambémSee also