Compartilhar via


Use a atividade de Falha 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 tanto a mensagem de erro quanto o código de erro.

Pré-requisitos

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

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

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

Criando a atividade

  1. Crie um pipeline no seu workspace.

  2. Procure por atividade de 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 browser.

    Screenshot of the Fabric UI with the Activities pane and Fail activity highlighted.

  3. Selecione a nova atividade de Falha no painel da tela se ela ainda não estiver selecionada.

    Screenshot showing the General settings tab of the Fail activity.

Consulte as diretrizes de Configurações Geraispara definir a guia Configurações Gerais.

Configurações da atividade de Falha

Selecione a guia Configurações e forneça uma mensagem de erro personalizada e o código de erro que você gostaria que o pipeline relatasse quando a atividade fosse invocada.

Screenshot showing the Fail activity Settings tab, and highlighting the tab.

Salvar e executar ou agendar o pipeline

A atividade de Falha normalmente é ser usada com outras atividades. Após configurar quaisquer outras atividades exigidas pelo pipeline, alterne para a guia Página Inicial na parte superior do editor do 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 exibir o histórico de execuções aqui ou definir outras configurações.

Screenshot showing the Home tab in the pipeline editor with the tab name, Save, Run, and Schedule buttons highlighted.

Como monitorar execuções de pipeline