Identificar erros

Encaminhe nós com falha para manipuladores de erros, registre detalhes do erro, tente novamente falhas transitórias e encerre erros não recuperáveis corretamente.

O que você criará: um fluxo de trabalho que roteia um nó com falha para um caminho separado, registra a falha com contexto útil, tenta novamente falhas transitórias onde faz sentido e termina corretamente quando o erro não é recuperável. Após este guia, você terá um padrão que pode soltar em qualquer fluxo de trabalho existente.

O que você precisa

• Uma conta do UiPath Automation Cloud com acesso ao Maestro Flow.
• Um fluxo de trabalho Fluxo existente com pelo menos um nó que pode falhar e expõe um identificador de erro — por exemplo, uma Solicitação HTTP ou um nó Extração.

Nós usados

• Solicitação HTTP — o nó propenso a falhas neste exemplo
• Script — registra os detalhes do erro
• Encerrar — termina o fluxo de trabalho com um status Failed em erros não recuperáveis

Etapas

1. Conecte o identificador de erro do nó

Por padrão, um nó com falha interrompe todo o processo. Em vez disso, para lidar com 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 no canto inferior direito do nó — para um novo nó de Script .

Isso cria um caminho de erro. Quando o nó falhar, a execução roteia ao longo desse caminho em vez de interromper o processo. (Os nós que não expõem um identificador de erro não são compatíveis com o tratamento de erros — uma falha interrompe o processo e aparece na guia Incidentes .)

2. Registre o erro

No nó 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 de erro. Para obter sua referência de campo completa, consulte Tratamento de erros.

3. Tente novamente falhas transitórias (opcional)

Se a falha for provável que seja transitória — um sinal de rede ou um limite de taxa — tente novamente antes de parar. O nó HTTP Request tem novas tentativas integradas: configure a contagem de novas tentativas em suas propriedades e ele repete a solicitação muitas vezes antes de disparar o identificador de erro. Apenas a falha final roteia para o caminho do erro.

AVISO:

Tentar novamente apenas operações idempotentes. Tentar novamente um nó com efeitos colaterais (gravar dados, enviar uma mensagem) pode criar duplicatas.

4. Encerrar se não puder ser recuperado

No caminho do erro, após o nó Script, adicione um nó Encerrar . Definir:

• 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 depure

Para disparar o caminho de erro intencionalmente:

1. Defina temporariamente a URL no nó HTTP Request para um valor inválido (por exemplo, https://this-will-fail.example.com).
2. Execute o teste e verifique as rotas do trace de execução 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 se os detalhes do erro foram registrados.

Resultado

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

Estender este fluxo de trabalho

• Enviar um alerta em caso de falha — No caminho do erro, antes do nó Encerrar, 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 com que o caminho de erro defina um valor de fallback e participe novamente do caminho principal em vez de encerrar.
• Aplique 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 .