Desenvolver suplementos do Outlook para o novo Outlook no Windows

Artigo
07/03/2024

O novo cliente de ambiente de trabalho do Outlook no Windows unifica as bases de código do Windows e web para criar uma experiência do Outlook mais consistente para utilizadores e administradores. A sua interface moderna e simplificada adicionou capacidades e tem como objetivo melhorar a produtividade, a organização e a colaboração para os utilizadores. Mais importante ainda, o novo Outlook no Windows suporta suplementos Web do Outlook, para que possa continuar a expandir a funcionalidade do Outlook.

Impacto nos suplementos VSTO e COM

O novo Outlook no Windows tem como objetivo unificar a experiência de extensibilidade em todas as plataformas do Outlook. Para proporcionar uma experiência de suplemento mais fiável e estável, os suplementos VSTO e COM não são suportados no novo Outlook no Windows. Para garantir que o seu suplemento continua a funcionar no novo Outlook no Windows, tem de migrar o suplemento VSTO ou COM para um suplemento Web do Outlook. Migrar para um suplemento Web do Outlook não só permite a compatibilidade com o novo Outlook no Windows, como também disponibiliza a sua solução aos utilizadores noutras plataformas, como o Outlook para Mac, em dispositivos móveis ou na Web.

Para o ajudar a começar a trabalhar no processo de migração, veja a seguinte documentação de orientação.

As diferenças nas funcionalidades e cenários suportados pelos suplementos VSTO e COM e suplementos Web do Outlook estão a ser abordadas. Para determinar se o seu cenário de suplemento é totalmente suportado num suplemento Web do Outlook, veja Cenários suportados nos suplementos Web do Outlook.
Para obter orientações sobre como fazer a transição do suplemento VSTO para um suplemento Web do Outlook, consulte Guia do programador do suplemento VSTO e Tutorial: Partilhar código entre um Suplemento VSTO e um Suplemento do Office com uma biblioteca de código partilhada.
Se não estiver familiarizado com os suplementos Web do Outlook, experimente o guia de introdução do Outlook para criar o seu primeiro suplemento.
Se for um administrador de TI e quiser saber mais sobre como fazer a transição para suplementos Web do Outlook na sua organização, consulte Transição de suplementos do Outlook clássico para o novo Outlook para Windows.

Observação

Os suplementos VSTO e COM continuam a ser suportados no Outlook clássico no Windows.

Cenários suportados em suplementos Web do Outlook

O desenvolvimento da API JavaScript do Outlook utilizada pelos suplementos Web do Outlook concentra-se em fechar a lacuna em cenários que só são suportados por soluções de suplemento VSTO e COM. Desta forma, os utilizadores que transitem para o suplemento Web do Outlook podem continuar a ter uma experiência totalmente integrada.

A tabela seguinte identifica os principais cenários do Outlook e o respetivo estado de suporte num suplemento Web. Esta tabela será atualizada à medida que forem suportados cenários adicionais. Verifique periodicamente esta secção à medida que planeia migrar o suplemento VSTO ou COM.

Dica

À medida que continuamos a atualizar a tabela de cenários suportados, se quiser ver as alterações recentes efetuadas, selecione Editar Este Documento (ícone de lápis) no canto superior direito do artigo e, em seguida, selecione Histórico.

Para saber mais sobre as funcionalidades de suplemento do Outlook que estão em pré-visualização, veja Conjunto de requisitos de pré-visualização da API de suplementos do Outlook.

Cenário	Descrição	Estado do suporte nos suplementos Web do Outlook	Funcionalidades e exemplos relacionados
Relatórios de e-mail de spam e educação	Permitir que os utilizadores comuniquem mensagens não solicitadas e potencialmente inseguras e saiba como identificar estas mensagens.	Com suporte. Estão em desenvolvimento melhorias para melhorar ainda mais a experiência do utilizador.	Implementar um suplemento integrado de relatórios de spam ReportPhishingCommandSurface extension point (Ponto de extensão ReportPhishingCommandSurface) Office.context.mailbox.item.getAsFileAsync
Reuniões on-line	Permitir que os utilizadores criem e participem em reuniões online.	Com suporte.	Criar um suplemento do Outlook para um fornecedor de reunião online Ativar pastas partilhadas e cenários de caixas de correio partilhadas num suplemento do Outlook Office.context.mailbox.item.getSharedPropertiesAsync Office.SharedProperties
Melhoramentos da reunião	Fornecer serviços adicionais aos utilizadores quando agendam reuniões, tais como seleção de localização, serviços de catering e iluminação da sala e ajustes de temperatura.	Com suporte.	Configurar o suplemento do Outlook para ativação baseada em eventos Processar eventos OnMessageSend e OnAppointmentSend no seu suplemento do Outlook com Alertas Inteligentes Office.context.mailbox.item.enhancedLocation
Assinaturas online	Adicione automaticamente assinaturas temáticas a mensagens e compromissos.	Com suporte.	Atualizar automaticamente a sua assinatura ao alternar entre contas do Exchange Implementar a ativação baseada em eventos nos suplementos móveis do Outlook Use a ativação baseada em eventos do Outlook para definir a assinatura Office.context.mailbox.item.loadCustomPropertiesAsync Office.context.mailbox.item.body.setSignatureAsync
Gestão de relações com o cliente (CRM) e serviços de controlo	Permitir que os utilizadores enviem e obtenham informações do respetivo sistema CRM para controlar as comunicações com clientes existentes e potenciais.	Com suporte.	Ativar o seu suplemento do Outlook sem o Painel de Leitura ativado ou uma mensagem selecionada Registar notas de compromisso para uma aplicação externa nos suplementos do Outlook Mobile Office.context.mailbox.item.loadCustomPropertiesAsync
Reutilização de conteúdo	Permitir que os utilizadores transfiram e obtenham texto e outros tipos de conteúdo a partir de sistemas de parceiros.	Com suporte.	Anexar ou anexar conteúdo a uma mensagem ou corpo de compromisso durante o envio Office.context.mailbox.item.body.appendOnSendAsync Office.context.mailbox.item.body.prependAsync Office.context.mailbox.item.body.prependOnSendAsync
Transformação de item de correio	Permitir que os utilizadores transformem itens de correio noutros formatos.	Com suporte.	getAsFileAsync method (Método getAsFileAsync)
Gerenciamento de projeto	Permitir que os utilizadores criem e controlem itens de trabalho do projeto a partir de sistemas parceiros.	Com suporte.	Ativar o seu suplemento do Outlook em várias mensagens Ativar o seu suplemento do Outlook sem o Painel de Leitura ativado ou uma mensagem selecionada Verificar as categorias de cores aplicadas a uma nova mensagem ou compromisso
Gestão de anexos	Permitir que os utilizadores importem ou exportem anexos a partir de localizações de parceiros.	Com suporte.	Ativar o seu suplemento do Outlook em várias mensagens Ativar o seu suplemento do Outlook sem o Painel de Leitura ativado ou uma mensagem selecionada Configurar o suplemento do Outlook para ativação baseada em eventos
Criptografia de mensagens	Permitir que os utilizadores encriptem e desencriptem mensagens.	Parcialmente suportado. As funcionalidades essenciais ainda não foram abordadas para criar uma experiência semelhante aos suplementos VSTO ou COM.	Office.context.mailbox.item.display (pré-visualização) Office.context.mailbox.item.display.body.setAsync (pré-visualização) Office.context.mailbox.item.display.subject.setAsync (pré-visualização)
Prevenção contra perda de dados	Impedir os utilizadores de reencaminhar itens de correio que contenham informações altamente confidenciais.	Parcialmente suportado. As funcionalidades essenciais ainda não foram abordadas para criar uma experiência semelhante aos suplementos VSTO ou COM.	Verificar automaticamente um anexo antes de uma mensagem ser enviada Processar eventos OnMessageSend e OnAppointmentSend no seu suplemento do Outlook com Alertas Inteligentes Gerir a etiqueta de confidencialidade da sua mensagem ou compromisso no modo de composição Verificar a etiqueta de confidencialidade de uma mensagem Office.SensitivityLabel Office.SensitivitiyLabelsCatalog Office.SensitivityLabelDetails Office.context.mailbox.item.closeAsync Office.context.mailbox.item.inReplyTo Office.context.mailbox.item.getConversationIndexAsync Office.context.mailbox.item.getItemClassAsync
Classificação de itens de correio	Permitir que os utilizadores identifiquem e classifiquem mensagens que contenham informações confidenciais.	Parcialmente suportado. As funcionalidades essenciais ainda não foram abordadas para criar uma experiência semelhante aos suplementos VSTO ou COM.	Verificar automaticamente um anexo antes de uma mensagem ser enviada Processar eventos OnMessageSend e OnAppointmentSend no seu suplemento do Outlook com Alertas Inteligentes Gerir a etiqueta de confidencialidade da sua mensagem ou compromisso no modo de composição Gerir o nível de confidencialidade de um compromisso Office.Sensitivity Office.SensitivityLabel Office.SensitivitiyLabelsCatalog Office.SensitivityLabelDetails
Serviço de sincronização de dados	Ativar a sincronização bidirecional de itens de correio com sistemas de parceiros.	Parcialmente suportado. As funcionalidades essenciais ainda não foram abordadas para criar uma experiência semelhante aos suplementos VSTO ou COM.	Utilizar o Microsoft Graph para gerir contactos pessoais no Outlook
Verificação de itens de correio	Forneça aos utilizadores assistência de verificação linguística em tempo real à medida que compõem mensagens.	Não há suporte atualmente.	Não disponível

Existem várias possibilidades para expandir a funcionalidade do Outlook através de suplementos. Se a sua solução de suplemento VSTO ou COM não se ajustar a nenhum dos cenários na tabela, conclua o inquérito para partilhar o seu cenário.

Suporte para o Outlook clássico no Windows

O Outlook Clássico no Windows com uma subscrição do Microsoft 365 ou uma versão perpétua de revenda do Office 2016 ou posterior continuará a suportar o desenvolvimento de suplementos Web do Outlook novos e existentes. Além disso, continuará a receber lançamentos das funcionalidades mais recentes do suplemento outlook.

Testar o seu suplemento no novo Outlook no Windows

Teste o seu suplemento Web do Outlook no novo Outlook no Windows hoje mesmo! Para mudar para o novo Outlook no Windows, tem de cumprir os seguintes requisitos.

Ter uma conta escolar ou profissional do Microsoft 365 ligada ao Exchange Online. Atualmente, o novo cliente não suporta contas do Exchange no local, híbridas ou soberanas.

Observação

Embora possa adicionar contas de correio não Microsoft, como o Gmail, ao novo Outlook no Windows, só pode utilizar suplementos do Outlook com uma conta Microsoft.
Tenha uma instalação mínima do SO do Windows 10, Versão 1809 (Compilação 17763).

Para o ajudar a instalar e configurar o cliente de ambiente de trabalho do Outlook, consulte Introdução ao novo Outlook para Windows.

Para obter orientações sobre como carregar o seu suplemento em sideload, veja Sideload Outlook add-ins for testing (Sideload de suplementos do Outlook para testes).

Dica

Se estiver a mudar do cliente clássico do Outlook no Windows para o novo cliente outlook, tenha em atenção que a localização dos suplementos é diferente. Enquanto os suplementos são acedidos a partir do friso ou da barra de aplicações no cliente clássico do Outlook, o acesso aos suplementos no novo cliente do Outlook depende se está a ler ou a compor um item de correio. Para saber mais, consulte Utilizar suplementos no Outlook.

Depurar o suplemento

Para depurar um suplemento instalado no novo cliente de ambiente de trabalho do Outlook no Windows, execute o seguinte:

Feche o novo cliente do Outlook no Windows, se já o tiver aberto.
Em seguida, numa linha de comandos, execute o seguinte comando para abrir o novo cliente do Outlook no Windows e uma instância do Microsoft Edge DevTools.
```
olk.exe --devtools
```
Dica

Depois de executar o comando, a janela DevTools permanece aberta, para que possa depurar o painel de tarefas de um suplemento à medida que o abre e fecha. Se fechar a janela DevTools, primeiro tem de fechar o cliente do Outlook antes de executar olk.exe --devtools novamente.
Faça sideload do suplemento para o Outlook na Web.
Utilize o Microsoft Edge DevTools para depurar o seu suplemento.

Comentários sobre a experiência de desenvolvimento

À medida que testa o seu suplemento Web do Outlook no novo Outlook no Windows, partilhe feedback sobre a sua experiência com a comunidade de programadores através do GitHub.

Partilhar via