Atividade de aprovação nos pipelines do Fabric Data Factory

A atividade de aprovação pausa um pipeline e envia uma solicitação de aprovação para um ou mais revisores. O fluxo aguarda uma resposta e, em seguida, segue por caminhos diferentes, dependendo de se a solicitação é aprovada ou rejeitada.

Isso é útil quando seu fluxo de trabalho precisa de uma decisão humana antes de avançar, por exemplo, para aprovar uma carga de dados, aprovar um relatório para publicação ou garantir a segregação de funções.

A atividade de aprovação

Quando o pipeline atinge uma atividade de aprovação, ele:

  1. Envia uma solicitação de aprovação para os revisores especificados.
  2. Pausa e aguarda uma resposta.
  3. Continua no caminho de sucesso ou falha com base na decisão do revisor. Para obter detalhes, consulte os resultados do Pipeline.

Pré-requisitos

Antes de começar, verifique se você tem estes itens:

Adicionar uma atividade de aprovação a um pipeline

  1. Crie um novo pipeline ou abra um existente.

  2. Pesquise por Aprovação no painel Atividades e selecione-a para adicioná-la à tela.

    Captura de tela do painel Atividades do pipeline com a atividade de aprovação realçada.

  3. Selecione a atividade de aprovação na tela.

    Captura de tela da atividade de aprovação no canvas do pipeline.

  4. Na guia Geral , defina o nome da atividade e outras configurações gerais. Para obter diretrizes, consulte as configurações gerais.

Selecione o tipo de aprovação

Na guia Configurações , escolha o tipo de solicitação de aprovação:

  • Outlook 365
  • Equipes da Microsoft
  • Ponto de extremidade personalizado

Note

Outlook 365 e Microsoft Teams não dão suporte ao RBAC (controle de acesso baseado em função) para aprovações. Se você precisar de suporte a RBAC, use o tipo endpoint personalizado.

Definir configurações para Outlook 365

Captura de tela das configurações da atividade de aprovação para Outlook 365.

  1. Selecione uma Conexão existente na lista suspensa ou crie uma nova.
  2. Insira um título de solicitação . Isso aparece na linha de assunto do email. Mantenha-o curto e descritivo.
  3. (Opcional) Insira uma descrição. Isso aparece no corpo do email. Inclua contexto suficiente para que o revisor entenda o que está aprovando e por quê.
  4. Insira o endereço de email do Aprovador . Isso pode ser um usuário individual ou um grupo.

Para obter mais informações sobre conexões de e-mail, consulte atividade do Outlook do Office 365.

Definir configurações para Microsoft Teams

Captura de tela das configurações da atividade de aprovação do Microsoft Teams.

  1. Selecione uma Conexão existente na lista suspensa ou crie uma nova.
  2. Insira um título de solicitação . Isso aparece como a primeira linha da mensagem do Teams.
  3. (Opcional) Insira uma descrição. Isso aparece no corpo da mensagem.
  4. Na configuração Postar, escolha se deseja postar em um canal ou em um chat de grupo.
  5. Defina as configurações restantes para especificar o aprovador.

Para obter mais informações sobre conexões do Teams, consulte a atividade do Teams.

Configurar as definições de um endpoint personalizado

  1. Selecione uma Conexão existente na lista suspensa ou crie uma nova.
  2. Insira o payload do Body a ser enviado ao endpoint.

Configurar o comportamento do tempo limite

Para definir um limite de tempo para a aprovação, use o valor tempo limite na guia Geral . Se nenhuma resposta for recebida antes do tempo limite, a atividade falhará e seguirá o caminho de rejeição.

Note

O solicitante (a pessoa que está enviando a solicitação de aprovação) é automaticamente a última pessoa a modificar o pipeline.

Experiência do aprovador

Quando o pipeline atinge uma atividade de aprovação, os revisores recebem uma notificação com base no tipo de aprovação:

  • Outlook 365 - um email com botões Approve e Reject.
  • Microsoft Teams - uma mensagem do Teams com links de ação de aprovação.
  • Ponto de extremidade personalizado – uma solicitação HTTP para o ponto de extremidade configurado.

Captura de tela do email de solicitação de aprovação recebido por um revisor.

A notificação inclui um link para a Central de Monitoramento do pipeline.

Responder a uma solicitação de aprovação

  1. Selecione o link na notificação para abrir o Hub de Monitoramento.

  2. Vá para a guia Revisão e envie sua decisão.

    Captura de tela da guia Revisão no Hub de Monitoramento para uma atividade de aprovação.

Se o pipeline tiver várias atividades de Aprovação e você for o responsável pela aprovação de mais de uma, poderá aprovar ou rejeitar todas de uma só vez na guia Revisão.

Depois de enviar uma decisão, o pipeline é retomado automaticamente.

Resultados do pipeline

A atividade de aprovação tem dois resultados:

  • Aprovado - o pipeline segue pelo caminho de sucesso.

    Captura de tela de uma execução de pipeline aprovada com êxito.

  • Rejeitado - o aprovador rejeitou a solicitação ou a atividade expirou. O pipeline segue o caminho de falha.

    Captura de tela de uma execução de pipeline rejeitada.

Conecte atividades downstream aos caminhos de êxito ou falha para controlar o que acontece a seguir.

Monitorar execuções de aprovação

As execuções da atividade de aprovação aparecem no histórico de execuções do pipeline. Você pode ver:

  • Quando as solicitações de aprovação foram criadas e resolvidas.
  • Quem aprovou ou rejeitou cada solicitação.
  • Resultados das aprovações juntamente com o status geral do pipeline.

Para exibir aprovações pendentes e concluídas, acesse a página Monitoramento e abra a guia Revisão .

Captura de tela da guia Revisão mostrando solicitações de aprovação pendentes e concluídas.

Práticas recomendadas para atividades de aprovação

  • Incluir contexto claro – dê aos revisores detalhes suficientes para que eles não precisem fazer perguntas de acompanhamento.
  • Mantenha os escopos de aprovação restritos - submeta à aprovação apenas as etapas que exigem uma decisão humana.
  • Criar caminhos de rejeição claros – lidar com rejeições com notificações ou etapas de correção.
  • Refletir processos comerciais reais – evite usar aprovações como atrasos genéricos ou pausas.