Use 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

Verifique se você tem o seguinte:

Adicionar a atividade do Outlook do Office 365 a um pipeline

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

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

  2. Pesquise "Office 365 Outlook" no painel Atividades do pipeline e selecione-o para adicioná-lo ao painel 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.

    Captura de tela da interface do usuário do Fabric com o painel Atividades e a atividade do Outlook do Office 365 realçadas.

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

    Captura de tela mostrando a guia Configurações gerais da atividade do Outlook do Office 365.

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

Tip

Use uma atividade separada do Outlook para cada atividade que você deseja monitorar para falhas.

Se você anexar mais de uma atividade a uma atividade no Outlook, todos os status associados deverão ser atendidos para acioná-la. Por exemplo, se duas atividades de cópia estiverem conectadas a um conjunto de atividades do Outlook configurado para acionar "em caso de falha", ambas as atividades devem falhar para ativar a atividade do Outlook. Se apenas um falhar, a atividade do Outlook não será acionada.

Configurar a atividade do Outlook do Office 365

Para configurar a atividade do Outlook do Office 365:

  1. Adicione uma conexão à 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 do usuário e implantando o pipeline com a atividade do Outlook ou do Teams em outro workspace, a atividade ficará inativa no workspace 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á sendo enviado do email será enviado de sua conta.
  2. Forneça detalhes para o email, incluindo destinatários, assunto e corpo. Você também pode adicionar detalhes avançados, como um endereço personalizado "de", destinatários CC e CCO, confidencialidade e um endereço de resposta personalizado. Todos os campos dão suporte a expressões dinâmicas.

    Captura de tela mostrando as janelas de configurações na Atividade do Outlook.

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

A atividade Office 365 Email permite que os pipelines enviem notificações e mensagens automatizadas usando uma conexão autenticada.

Em cenários de desenvolvimento colaborativo, as equipes podem precisar reutilizar a lógica de email em vários pipelines e usuários. No entanto, as conexões de e-mail estão atualmente vinculadas a usuários individuais e não foram projetadas para compartilhamento direto entre autores.

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

  1. Criar um pipeline de email reutilizável

    Defina um pipeline que encapsula todo o comportamento relacionado ao email:

    • Configurar a atividade de E-mail do Office 365
    • Estabelecer a conexão necessária
    • Validar o pipeline de forma independente

    Esse pipeline atua como um serviço reutilizável para entrega de email.

    Screenshot mostrando a guia Configurações e configurando uma atividade de Office 365 Outlook reutilizável.

  2. Habilitar o acesso compartilhado por meio de uma conexão de pipeline

    Crie e configure uma conexão de pipeline que pode ser usada por vários usuários para invocar o pipeline de email por meio do portal Manage Connections and Gateways no Fabric.

    • Conceder acesso a desenvolvedores ou equipes que precisam enviar emails
    • Verifique se as permissões estão alinhadas com as políticas de segurança da sua organização

    Captura de tela mostrando como compartilhar uma conexão de Pipeline.

  3. Chamar o pipeline de e-mail a partir de outros pipelines

    Em pipelines downstream:

    • Adicionar uma atividade Invoke Pipeline
    • Selecione a conexão compartilhada
    • Fazer referência ao pipeline de e-mail reutilizável

    Isso permite que os pipelines disparem o envio de email sem gerenciar suas próprias conexões.

    Captura de tela mostrando uma atividade de pipeline de invocação para a atividade de email criada anteriormente.

  4. Parametrizar para flexibilidade

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

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

    Passar parâmetros em runtime permite a reutilização ao preservar a personalização.

Suporte à autenticação

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

  • Autenticação do Usuário (OAuth)
  • Identidade do Espaço de Trabalho (WI)
  • Diretor de Serviços (SPN)

Ao usar o suporte ao Identidade do Workspace e ao Service Principal, sua organização pode executar notificações por e-mail usando identidades que não sejam de usuário. Essa abordagem ajuda a reduzir a dependência de contas individuais de usuário e suporta cenários de automação em nível de produção.

Quando você usa a autenticação Workspace Identity ou Service Principal, é necessário configurar as permissões apropriadas do Microsoft Entra ID e Microsoft Graph para enviar e-mails em nome da caixa de correio desejada. Dependendo das necessidades da sua organização, você também pode precisar configurar restrições adicionais de caixa de correio Exchange Online e políticas de governança.

Para mais informações sobre como configurar WI ou SPN, veja Suporte à identidade de Workspace na Data Factory ou suporte a principal de serviço na Data Factory.

Limitações conhecidas

  • A atividade do Outlook não suporta rótulos de sensibilidade. Você não pode aplicar rótulos de sensibilidade do Microsoft Purview a e-mails enviados pela atividade.