Usar a atividade Fail para fazer com que a execução do pipeline falhe com uma mensagem de erro personalizada e um código de erro

Ocasionalmente, você pode querer lançar um erro em um pipeline intencionalmente. Uma atividade de pesquisa pode não retornar dados correspondentes ou uma atividade de script pode ser concluída com um erro interno. Seja qual for o motivo, agora você pode usar uma atividade Fail em um pipeline e personalizar tanto a mensagem de erro quanto o código de erro.

Quando usar a atividade Fail

A atividade Fail é comumente usada em cenários condicionais em que você deseja que o pipeline falhe com base em condições específicas:

• Falhas de validação de dados: quando os dados não atendem aos padrões de qualidade
• Violações de lógica de negócios: quando as regras de negócios não são atendidas
• Verificações de dependência: quando recursos ou fontes de dados necessários não estão disponíveis
• Tratamento de erros personalizados: quando você deseja fornecer informações de erro específicas em vez de erros genéricos do sistema

A atividade Fail normalmente está conectada a outras atividades usando a lógica condicional (atividade If Condition) ou colocada após atividades que podem produzir condições de erro.

Pré-requisitos

Para começar, você deve concluir os seguintes pré-requisitos:

• Uma conta de locatário com uma assinatura ativa. Crie uma contagratuita.
• Um espaço de trabalho é criado.

Adicionar uma atividade Fail a um pipeline com a interface do usuário

Para usar uma atividade Fail em um pipeline, siga estas etapas:

1. Crie um pipeline em seu workspace.

2. Pesquise pela atividade Fail no painel Atividades do pipeline e selecione-a para adicioná-la à área de trabalho do pipeline. Talvez seja necessário expandir a lista de atividades no lado direito do painel ou o ícone do Outlook pode ser compactado sem rotular o texto abaixo dele, conforme mostrado nesta imagem, dependendo da largura da janela do navegador.

   

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

   

   Confira as diretrizes de Configurações geraispara definir a guia de configurações Gerais.

4. Selecione a guia Configurações e forneça uma mensagem de erro personalizada e um código de erro que você gostaria que o pipeline relatasse quando a atividade for invocada. Esses valores serão exibidos no histórico de execução do pipeline e nos logs quando a atividade Fail for executada, ajudando você a identificar a condição de erro específica que causou a falha do pipeline.

   

Salvar e executar ou agendar o pipeline

A atividade Fail normalmente é usada com outras atividades. Depois de configurar outras atividades necessárias para o pipeline, alterne para a guia Página Inicial na parte superior do editor de pipeline e selecione o botão Salvar para salvar o pipeline. Selecione Executar para executá-la diretamente ou Agendar para agendá-la. Você também pode exibir o histórico de execuções aqui ou definir outras configurações.

Exemplo: falha de pipeline condicional

Aqui está um padrão comum para falha em um pipeline com base em condições personalizadas:

1. Utilize uma atividade If Condition para avaliar sua condição de erro personalizada
2. No branch True da Condição If, adicione a atividade Fail
3. Configure a atividade de falha com sua mensagem de erro personalizada que descreva a condição específica que foi satisfeita
4. Na ramificação Falsa, continue com a execução normal do fluxo

Esse padrão permite que seu pipeline falhe de forma controlada, com mensagens de erro significativas, quando são encontradas condições específicas de dados ou de negócios.

Conteúdo relacionado

Como monitorar execuções de pipeline