Visão geral dos suplementos do Outlook

Artigo
07/19/2024

Os suplementos do Outlook são soluções que expandem a funcionalidade do cliente do Outlook através de uma plataforma baseada na Web. Os suplementos do Outlook têm três aspetos fundamentais.

O mesmo suplemento e lógica empresarial funcionam na Web (Microsoft 365 e Outlook.com), ambiente de trabalho (Outlook no Windows (clássico) e mac) e dispositivos móveis.
Os suplementos do Outlook consistem em um manifesto, que descreve como o suplemento se integra ao Outlook (por exemplo, um botão ou um painel de tarefas), e o código JavaScript/HTML, que compõe a interface do usuário e lógica de negócios do suplemento.
Os suplementos do Outlook podem ser adquiridos na AppSource ou sideloaded por usuários finais ou administradores.

Os suplementos do Outlook são diferentes dos suplementos de COM ou VSTO, que são integrações mais antigas específicas do Outlook para Windows. Diferentemente dos suplementos de COM, os suplementos do Outlook não têm qualquer código fisicamente instalado no dispositivo do usuário ou no cliente do Outlook. No caso de um suplemento do Outlook, o Outlook lê o manifesto, conecta os controles especificados na interface do usuário e carrega o HTML e o JavaScript. Todos os componentes Web são executados no contexto de um controlo de browser ou webview num sandbox.

Importante

Os suplementos COM e VSTO não são suportados no novo Outlook no Windows. No entanto, estes suplementos continuam a ser suportados no cliente de ambiente de trabalho clássico do Outlook no Windows. Para saber mais, consulte Desenvolver suplementos do Outlook para o novo Outlook no Windows.
No Outlook clássico no Windows, não é recomendado instalar suplementos COM juntamente com suplementos Web do Office, especialmente se funcionarem na mesma superfície ou item de correio. As operações realizadas pelos suplementos COM e Web podem interferir entre si e levar a um comportamento inesperado. Se precisar de suportar as versões dos suplementos COM e Web da sua solução, tem de especificar a solução COM como um suplemento equivalente. Para saber mais, consulte Tornar o seu Suplemento do Office compatível com um suplemento COM existente.

Os itens do Outlook que dão suporte a suplementos incluem mensagens de email, compromissos, solicitações, respostas e cancelamentos de reunião. Cada suplemento do Outlook define o contexto no qual está disponível, incluindo os tipos de itens e se o usuário está lendo ou redigindo um item.

Observação

Se você planeja publicar o seu suplemento no AppSource e disponibilizá-lo na experiência do Office, certifique-se de que está em conformidade com as políticas de certificação do Marketplace Comercial. Por exemplo, para passar na validação, o suplemento deve funcionar em todas as plataformas com suporte para os métodos definidos (saiba mais na seção 1120.3 e na página de aplicativo e disponibilidade do Suplemento do Office).

Pontos de extensão

Pontos de extensão são as formas usadas pelos suplementos para se integrar ao Outlook. Seguem-se as formas como isto pode ser feito.

Os suplementos podem declarar botões que aparecem nas superfícies de comando em mensagens e compromissos. Para obter mais informações, veja Comandos de suplementos.
Os suplementos podem ligar correspondências de expressão regulares em mensagens e compromissos. Para saber mais, confira Suplementos contextuais do Outlook.

Importante

Os suplementos contextuais do Outlook baseados em entidades foram descontinuados. Como solução alternativa, implemente regras de expressão regulares no seu suplemento contextual. Para obter orientações sobre como implementar estas regras, veja Suplementos contextuais do Outlook.
Os suplementos podem executar tarefas quando ocorre um evento específico. Para obter mais informações, veja Configurar o suplemento do Outlook para ativação baseada em eventos.

Itens de caixa de correio disponíveis para suplementos

Os suplementos do Outlook são ativados quando o usuário está redigindo ou lendo uma mensagem ou compromisso, mas não em outros tipos de item. Entretanto, os suplementos não são ativados se o item de mensagem atual, em um formulário de redação ou de leitura, estiver em uma das seguintes situações:

Protegido pela Gestão de Direitos de Informação (IRM) ou encriptado de outras formas para proteção e acesso a partir do Outlook em dispositivos móveis. Uma mensagem assinada digitalmente é um exemplo, uma vez que a assinatura digital depende de um destes mecanismos. Para saber mais sobre o suporte de IRM nos suplementos do Outlook, consulte Mail items protected by IRM (Itens de correio protegidos por IRM).
Um item de correio protegido por IRM com uma etiqueta de confidencialidade que tem a opção de política personalizada Permitir acesso programático definida como false. Para saber mais sobre o suporte de IRM nos suplementos do Outlook, consulte Mail items protected by IRM (Itens de correio protegidos por IRM).
Um relatório de entrega ou notificação que tem a classe de mensagem IPM.Report.*, incluindo NDRs (notificações de falha na entrega) e notificações de leitura, falha na leitura e atraso.
Um arquivo .msg que é um anexo de outra mensagem.
Um arquivo .msg aberto no sistema de arquivos.
Numa caixa de correio de grupo, numa caixa de correio partilhada*, na caixa de correio de outro utilizador*, numa caixa de correio de arquivo ou numa pasta pública.

Importante

* O suporte para cenários de acesso delegado (por exemplo, pastas partilhadas a partir da caixa de correio de outro utilizador) foi introduzido no conjunto de requisitos 1.8, enquanto o suporte de caixa de correio partilhada foi introduzido no conjunto de requisitos 1.13. Para saber mais, consulte Ativar pastas partilhadas e cenários de caixa de correio partilhada.
Usando um formulário personalizado.
Criado através de MAPI simples. O MAPI simples é usado quando um usuário do Office cria ou envia um email de um aplicativo do Office no Windows com o Outlook fechado. Por exemplo, um usuário pode criar um email do Outlook enquanto trabalha no Word, o que dispara uma janela de composição do Outlook sem iniciar o aplicativo Outlook completo. No entanto, se o Outlook já estiver em execução quando o usuário criar o email a partir do Word, esse não será um cenário MAPI simples para que os suplementos do Outlook funcionem no formulário de composição, desde que outros requisitos de ativação sejam atendidos.

Atualmente, há considerações adicionais ao projetar e implementar suplementos para clientes móveis. Para saber mais, consulte Adicionar suporte para comandos de suplementos no Outlook em dispositivos móveis.

Itens de correio protegidos por IRM

Os suplementos do Outlook são ativados em itens de correio protegidos por IRM quando o item é acedido a partir dos seguintes clientes suportados.

Outlook na Web
Novo Outlook no Windows
Outlook Clássico no Windows a partir da Versão 2009 (Compilação 13229.10000)

Observação

A assinatura digital baseia-se em mecanismos de proteção, como a IRM. A partir do Outlook clássico no Windows Versão 1711 (Compilação 8711.1000) associada a uma subscrição do Microsoft 365, os suplementos são ativados em mensagens assinadas digitalmente.
Outlook para Mac a partir da Versão 16.77 (23082700)

No entanto, os suplementos não serão ativados em itens protegidos por IRM quando:

O item protegido por IRM é acedido a partir do Outlook em dispositivos móveis.
O item protegido por IRM tem uma etiqueta de confidencialidade com a opção de política personalizada Permitir acesso programático definida como false. Para obter mais informações sobre as opções de política personalizada, veja Direitos de utilização e descrições.

Clientes com suporte

Os suplementos do Outlook são suportados no Outlook na Web, Outlook no Windows (novo e clássico), Outlook no Mac, Outlook para iOS, Outlook no Android e Outlook.com. Nem todos os recursos mais recentes têm suporte em todos os clientes ao mesmo tempo. Para obter detalhes sobre o suporte de funcionalidades em clientes e servidores, veja Conjuntos de requisitos suportados por servidores Exchange e clientes do Outlook e artigos específicos dessas funcionalidades.

Introdução à criação de suplementos do Outlook

Para começar a construir suplementos do Outlook, tente o seguinte:

Início Rápido - Criar um painel de tarefas simples.
Tutorial : saiba como criar um suplemento que insere gists do GitHub em uma nova mensagem.

Compartilhar via