Tratar erros

Route failed nodes to error handlers, return error details, retry transient failures, and terminate unrecoverable errors gracefully.

What you'll build: A workflow that routes a failing node to a separate path, records the failure with useful context, retries transient failures where it makes sense, and terminates cleanly when the error is unrecoverable. After this guide, you have a pattern you can drop into any existing workflow.

O que você precisa

• A UiPath Automation Cloud account with access to Flow.
• Um fluxo de trabalho existente com pelo menos um nó que pode apresentar falha e expõe um identificador de erro — por exemplo, uma Solicitação HTTP ou um nó de extração.

Nós usados

• Solicitação HTTP — o nó propenso a falhas neste exemplo
• Script — returns the error details
• Finalizar — encerra o fluxo de trabalho com um status Failed em erros irrecuperáveis

Etapas

1. Conecte o identificador de erro do nó

Por padrão, um nó com falha interrompe todo o processo. Para identificar a falha:

1. Abra seu fluxo de trabalho na tela e selecione o nó propenso a falhas.

2. Abra a guia Tratamento de erros e ative Habilitar tratamento de erros. Um identificador de erro aparece abaixo do identificador de saída principal.

   

3. Selecione o + no identificador de Erro , pesquise Script e selecione-o.

This creates an error path. When the node fails, execution routes along this path instead of stopping the process. (Nodes without an Error handling tab don't support error handling — a failure there stops the process and surfaces under the Incidents tab.)

2. Return the error details

In the Script node on the error path, read the error object at $vars.<node>.error and return the details:

const error = $vars.httpRequest1.error;
return {
  message: "Error raised: " + error.message,
  code: error.code,
  status: error.status
};

The Script node's output appears in the execution trace, so the error details are visible when you inspect the run. The error object is only populated on the error path. For its full field reference, see Error handling.

3. Tente novamente em caso de falhas transitórias (opcional)

Se a falha for transitória — um blip de rede ou limite de taxa — tente novamente antes de desistir. O nó de Solicitação HTTP tem NovasTentativas integradas: configure a contagem de tentativas em suas propriedades, e ele tenta novamente solicitar esse número de vezes antes de disparar o identificador de erro. Apenas a falha final é roteada para o caminho de erro.

AVISO:

Tente novamente apenas operações idempotentes. Tentar novamente um nó com efeitos colaterais (gravação de dados, envio de uma mensagem) pode criar duplicatas.

4. Encerre se for irrecuperável

No caminho do erro, após o nó do Script, adicione um nó de Finalização. Defina:

• Status → Failed
• Mensagem → uma descrição que inclui o erro, por exemplo, $vars.httpRequest1.error.message

Isso registra a falha no histórico de execução com uma descrição útil, visível em Observação de execuções.

5. Teste e Debug

Para disparar o caminho do erro intencionalmente:

1. Defina temporariamente o URL no nó de Solicitação HTTP para um valor inválido (por exemplo, https://this-will-fail.example.com).
2. Execute o teste e verifique se o trace de execução é roteado ao longo do caminho do erro.
3. Restaure o URL correto.

In the trace, select the Script node and check its output for the error message.

Resultado

Your workflow routes failures to the error path, returns the error details, optionally retries transient failures, and terminates cleanly with a descriptive failure status. You can confirm the error path works by using an invalid URL in the HTTP Request node and inspecting the Script node's output in the execution trace.

Estender este fluxo de trabalho

• Enviar um alerta sobre falha — No caminho do erro, antes do nó Finalizar, adicione uma Solicitação HTTP ou nó de integração para notificar um canal do Slack ou criar um tíquete de incidente
• Continuar em vez de encerrar — Se a etapa não for crítica, faça o caminho do erro definir um valor de fallback e reingressar no caminho principal em vez de encerrar.
• Apply this pattern everywhere — For more patterns (return error details and continue, fallback values, escalation), see the Error handling reference.