O que é Execution?

O que é uma execution

Execution é uma ocorrência do processamento de um workflow. O workflow define o processo, enquanto a execução corresponde ao que aconteceu com uma entrada em determinado momento, incluindo as etapas percorridas e o resultado alcançado.

Duas inscrições recebidas pelo mesmo formulário podem iniciar execuções diferentes. Uma pode criar um contato novo, e a outra pode encontrar o email já cadastrado e seguir por um caminho que atualiza a inscrição existente.

O que observar no histórico

O histórico de execuções do n8n permite localizar ocorrências pelo status ou horário. Ao abrir um registro mantido pelo workflow, você pode examinar os detalhes disponíveis das etapas e comparar a entrada recebida com o resultado de cada Node.

A disponibilidade depende das configurações que mantêm ou removem registros e protegem os campos. A ausência de um registro antigo não demonstra, sozinha, que o workflow nunca executou. Um histórico também pode ocultar campos sensíveis e preservar o status sem mostrar a entrada completa.

Para relacionar uma execução ao fato que a originou, preserve um identificador adequado ao processo. Se o formulário, a execução e o contato gravado carregam o código da inscrição, você pode procurar esse mesmo valor nos três locais. Horários próximos ajudam a localizar o intervalo, mas podem reunir inscrições diferentes.

Execuções manuais, parciais e de produção

Uma execução manual começa por uma ação no editor e permite acompanhar o fluxo durante o desenvolvimento. A execução parcial restringe o teste a uma parte do workflow, embora possa precisar executar etapas anteriores para obter a entrada do Node escolhido.

As execuções de produção começam automaticamente pelos triggers configurados. No n8n, informações fixadas para teste com data pinning podem ser usadas durante o desenvolvimento, mas são ignoradas em produção, onde as etapas buscam as entradas reais.

Por isso, um teste com uma resposta fixa de consulta não comprova que a integração está acessível naquele momento. Ao conferir o fluxo completo, observe quais resultados vieram de serviços externos e quais foram fornecidos apenas para desenvolver a automação.

Status concluído e resultado do processo

O status da execução descreve como o workflow terminou segundo seu tratamento de erros. Se uma falha foi encaminhada para um caminho alternativo que registra a inscrição para correção, a execução pode concluir sem que a confirmação tenha sido enviada.

Você precisa comparar o status com o efeito esperado no sistema de destino. No exemplo da inscrição, isso significa verificar se o contato foi criado, atualizado ou apenas separado para revisão, e não interpretar todos esses resultados como equivalentes.

O cuidado ao executar novamente

Uma execução que falhou no final pode ter realizado ações nas etapas anteriores. Antes de repetir o processamento, confira se já houve cadastro ou envio, pois uma nova tentativa não desfaz automaticamente a anterior.

Quando o mesmo evento pode ser processado novamente, o workflow deve reconhecer os efeitos já concluídos. A idempotência permite planejar essa repetição sem transformar uma tentativa de recuperação em duplicação de cadastros.

Aplicação na formação

n8n Experts

Cada execution permite acompanhar uma ocorrência do workflow, com entradas, etapas e resultados próprios.

Conhecer a formação →