Usar a atividade do Office 365 Outlook para enviar um email com o Outlook

A atividade do Office 365 Outlook no Data Factory para Microsoft Fabric permite enviar emails usando sua conta do Office 365. Você pode personalizar a mensagem com expressões dinâmicas.

Prerequisites

Certifique-se de que tem o seguinte:

• Uma conta de locatário com uma assinatura ativa. Registe-se gratuitamente.
• Um espaço de trabalho criado.

Adicionar a atividade do Office 365 Outlook a um pipeline

Siga estas etapas para usar a atividade do Office 365 Outlook num pipeline:

1. Crie um novo pipeline em seu espaço de trabalho.

2. Procure por "Office 365 Outlook" no painel Atividades do pipeline e selecione-o para adicioná-lo à visualização do pipeline. Dependendo da largura da janela do navegador, talvez seja necessário expandir a lista de atividades ou procurar o ícone do Outlook sem um rótulo.

   

3. Selecione a nova atividade do Outlook na tela se ainda não estiver selecionada.

   

Consulte o Guia de configurações gerais para configurar a guia Configurações gerais.

Configurar a atividade do Office 365 Outlook

Para configurar a atividade do Office 365 Outlook:

1. Adicione uma conexão à sua atividade do Outlook na parte superior das configurações. Você pode criar uma nova conexão ou usar uma existente.

   Observação

   • Se você estiver usando a autenticação de usuário e implantando o pipeline com a atividade do Outlook ou do Teams em outro espaço de trabalho, a atividade ficará inativa no espaço de trabalho de destino até que você crie uma nova conexão de autenticação de usuário lá.
   • Se você não tiver acesso às conexões usadas na atividade do Outlook, a implantação inicial falhará. Para solucionar problemas, você pode editar o pipeline de destino e alterar a autorização ou definir a atividade como inativa.
   • O conteúdo que está a ser enviado a partir do e-mail será enviado a partir da sua conta.

2. Forneça detalhes para o e-mail, incluindo destinatários, assunto e corpo. Você também pode adicionar detalhes avançados, como um endereço "de" personalizado, destinatários CC e BCC, sensibilidade e um endereço de resposta personalizado. Todos os campos suportam expressões dinâmicas.

   

Partilhar e reutilizar a funcionalidade de e-mail com a atividade do Outlook do Office 365

A atividade de e-mail do Office 365 permite que os pipelines enviem notificações e mensagens automatizadas através de uma ligação autenticada.

Em cenários de desenvolvimento colaborativo, as equipas podem precisar de reutilizar a lógica do email em múltiplos pipelines e utilizadores. No entanto, as ligações por email estão atualmente destinadas a utilizadores individuais e não são concebidas para partilha direta entre autores.

Para suportar a reutilização e consistência, pode adotar um padrão de composição baseado em pipeline que centraliza a funcionalidade do email. Em vez de duplicar a configuração do email entre pipelines, crie um pipeline dedicado responsável pelo envio de emails e invoce-o a partir de outros pipelines.

1. Crie um pipeline de emails reutilizável

   Defina um pipeline que encapsule todo o comportamento relacionado com email:

   • Configurar a atividade de Email do Office 365
   • Estabelecer a ligação necessária
   • Validar o pipeline de forma independente

   Este pipeline funciona como um serviço reutilizável para a entrega de emails.

   

2. Permitir o acesso partilhado através de uma ligação ao pipeline

   Crie e configure uma ligação de pipeline que possa ser usada por vários utilizadores para invocar o pipeline de email através do portal Manage Connections and Gateways em Fabric.

   • Conceda acesso a programadores ou equipas que precisem de enviar emails
   • Assegure que as permissões estão alinhadas com as políticas de segurança da sua organização

   

3. Invocar o pipeline de email a partir de outros pipelines

   Em cadeias de processamento a jusante:

   • Adicionar uma atividade Invoke Pipeline
   • Selecione a ligação partilhada
   • Consulte o pipeline de emails reutilizáveis

   Isto permite que os pipelines desencadeem o envio de emails sem gerir as suas próprias ligações.

   

4. Parametrizar para maior flexibilidade

   Para abranger diferentes casos de uso, defina parâmetros no pipeline de e-mail, como:

   • Assunto
   • Corpo da mensagem
   • Destinatários
   • Entradas dinâmicas de conteúdo

   Passar parâmetros em tempo de execução permite a reutilização preservando a personalização.

Suporte de autenticação

A atividade Office 365 Outlook suporta os seguintes métodos de autenticação:

• Autenticação do Utilizador (OAuth)
• Identidade do Espaço de Trabalho (WI)
• Diretor de Serviço (SPN)

Ao utilizar o suporte Workspace Identity e Service Principal, a sua organização pode executar notificações por email usando identidades não de utilizador. Esta abordagem ajuda a reduzir a dependência de contas individuais de utilizador e suporta cenários de automação de nível de produção.

Quando utiliza a autenticação Workspace Identity ou Service Principal, precisa de configurar as permissões apropriadas do Microsoft Entra ID e Microsoft Graph para enviar emails em nome da caixa de correio desejada. Dependendo das necessidades da sua organização, poderá também precisar de estabelecer restrições adicionais para as caixas de correio do Exchange Online e políticas de governação.

Para mais informações sobre como configurar WI ou SPN, consulte Suporte para identidade da área de trabalho no Data Factory ou Suporte para principal de serviço no Data Factory.

Limitações conhecidas

• A atividade do Outlook não suporta etiquetas de sensibilidade. Não pode aplicar etiquetas de sensibilidade do Microsoft Purview a emails enviados através da atividade.

Conteúdo relacionado

• Executar, agendar e acionar pipelines
• Monitorize execuções de pipeline