Tratar erros

Roteie nós com falha para identificadores de erro, registre detalhes de erro, tentar novamente falhas transitórias e finalize erros irrecuperáveis de forma correta.

O que você criará: um fluxo de trabalho que roteia um nó com falha para um caminho separado, registra a falha com contexto útil, realiza NovasTentativas de falhas transitórias quando fizer sentido e finaliza de forma limpa quando o erro não puder ser recuperado. Após este guia, você terá um padrão que pode colocar em qualquer fluxo de trabalho existente.

O que você precisa

• Uma conta do UiPath Automation Cloud com acesso ao Fluxo do Maestro.
• 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 — registra os detalhes do erro
• 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. Arraste de seu identificador de erro — o conector na parte inferior direita do nó — para um novo nó do Script.

Isso cria um caminho de erro. Quando o nó falha, a execução segue esse caminho em vez de interromper o processo. (Os nós que não expõem um identificador de erro não oferecem suporte ao tratamento de erros — uma falha ali interrompe o processo e aparece na guia Incidentes.)

2. Registre o erro

No nó do Script no caminho do erro, leia o objeto de erro em $vars.<node>.error:

const error = $vars.httpRequest1.error;
console.log('Step failed:', error.message);
console.log('Code:', error.code, '| HTTP status:', error.status);
return { logged: true };

O objeto de erro é preenchido apenas no caminho do erro. Para obter sua referência de campo completa, consulte Tratamento de erros.

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.

Verifique a saída do console do nó do Script no trace para confirmar que os detalhes do erro estão registrados.

Resultado

Seu fluxo de trabalho roteia falhas para o caminho do erro, registra os detalhes do erro, opcionalmente faz NovasTentativas de falhas transitórias e encerra de forma limpa com um status de falha descritivo. Você pode confirmar que o caminho do erro funciona usando um URL inválido no nó de Solicitação HTTP e inspecionando a saída do console do nó de Script no trace de execução.

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.
• Aplicar esse padrão em todos os lugares — Para obter mais padrões (registrar e continuar, valores de fallback, escalonamento), consulte a referência de Tratamento de erro.