Use 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 terminar com um erro interno. Seja qual for o motivo, agora você pode usar uma atividade Fail em um pipeline e personalizar sua mensagem de erro e 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 na validação de dados: quando os dados não atendem aos padrões de qualidade
• Violações da lógica de negócios: quando as regras de negócios não são satisfeitas
• Verificações de dependência: quando os recursos ou fontes de dados necessários não estão disponíveis
• Tratamento de erros personalizado: quando você deseja fornecer informações de erro específicas em vez de erros genéricos do sistema

A atividade Fail normalmente é conectada a outras atividades usando 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 preencher os seguintes pré-requisitos:

• Uma conta de locatário com uma assinatura ativa. Crie uma conta gratuitamente.
• 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, conclua as seguintes etapas:

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

2. Pesquise a atividade Falha no painel Atividades do pipeline e selecione-a para adicioná-la à tela do pipeline. Pode ser 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, como mostrado nesta imagem, dependendo da largura da janela do seu navegador.

   

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

   

   Consulte as orientações de configurações gerais para configurar a guia 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 e nos logs do pipeline quando a atividade Fail for executada, ajudando a identificar a condição de erro específica que causou a falha do pipeline.

   

Guardar e executar ou agendar o pipeline

A atividade falha é normalmente usada com outras atividades. Depois de configurar quaisquer 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á-lo diretamente ou Agendar para agendá-lo. Você também pode visualizar o histórico de execução aqui ou definir outras configurações.

Exemplo: Falha condicional do pipeline

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

1. Usar uma atividade If Condition para avaliar sua condição de erro personalizada
2. Na ramificação True da condição If, adicione a atividade Fail
3. Configurar a atividade de falha com a sua mensagem personalizada de erro que descreve a condição específica que foi satisfeita
4. Na ramificação False , continue com a execução normal do pipeline

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

Conteúdo relacionado

Como monitorizar as execuções de pipeline