Noções básicas de depuração

Depuração no Fluxo na tela de compilação, abrangendo períodos de execução, incidentes, inspeção de falhas e saída simulada para testar fluxos de trabalho isoladamente.

A depuração no Fluxo acontece na mesma tela em que você cria. Não há visualização de depuração separada — você executa seu processo, inspeciona resultados no painel de execução e faz alterações quando detecta um problema.

Iniciar uma sessão de debug

O botão Debug na barra de ferramentas executa o processo. O painel de execução aparece na parte inferior da tela e preenche os intervalos em tempo real à medida que cada nó é executado.

O botão Parar encerra a sessão explicitamente. Qualquer alteração no processo também encerra a sessão de depuração automaticamente.

Consulte The Canvas para obter uma visão geral completa dos controles de depuração e do layout do painel de execução.

Leitura do painel de execução

O painel de execução tem três guias. Cada uma responde a uma pergunta diferente.

Spans

A guia Spans mostra o trace de execução — cada nó que foi executado, em ordem, com tempo e um indicador de sucesso ou falha. Selecionar um intervalo destaca o nó correspondente na tela, facilitando a visualização exatamente onde a execução chegou.

Incidentes

A aba Incidentes coleta erros que ocorreram durante a execução, agrupados por nó. Cada grupo é expandido por padrão, então os erros e avisos dentro dele são visíveis imediatamente. Cada incidente nomeia o nó que falhou e inclui a mensagem de erro. Se seu processo parou de forma inesperada, verifique aqui primeiro.

Variáveis

A aba Variáveis mostra valores de variáveis de runtime, divididos em três seções: Entradas (valores passados para o fluxo de trabalho), Saídas (valores produzidos) e Variáveis (variáveis de fluxo de trabalho internas). Selecione um período na guia Períodos e a guia Variáveis será atualizada para mostrar o estado nesse ponto da execução. Use isso para verificar se os nós upstream produziu os dados que você esperava.

Identificação de falhas

Após uma execução de depuração, cada nó na tela mostra um indicador de sucesso ou falha. O intervalo do nó com falha na guia Spans o destaca na tela. A guia Incidentes mostra a mensagem de erro. O painel de propriedades do nó com falha mostra o objeto de erro completo na seção de saída.

O objeto do erro inclui um campo message (descrição legível por humanos) e um campo detail (causa técnica). Comece com message porque ele contém o resumo da falha para o usuário.

Uso de nós simulados

A saída simulada permite que você teste parte de um processo de forma isolada. Quando você define a saída simulada em um nó, ele pula a execução real e injeta seus dados de teste a jusante.

Isso é útil quando um nó anterior é lento, requer credenciais não disponíveis localmente ou depende de sistemas externos. Clicar duas vezes no nó abre sua visualização expandida, onde você pode definir a saída simulada como quaisquer dados que os nós subsequentes esperam.

Simular vários nós de uma só vez permite que a sessão de depuração se concentre em uma seção específica do processo.

Dicas

• Intervalos primeiro, incidentes depois. Os intervalos mostram a imagem de execução completa; os incidentes mostram apenas o que falhou.
• Os valores de variáveis revelam incompatibilidades de dados. Compare os dados que um nó recebeu com os dados que o próximo nó esperava.
• A simulação de dependências externas permite uma iteração mais rápida. Simular um nó que chama uma API ou dispara um processo de RPA permite que você faça Debug da lógica sem precisar esperar por sistemas externos.
• Pequenas iterações são mais rápidas. Uma correção por ciclo de depuração é mais eficiente do que tentar corrigir tudo de uma só vez.
• Os nomes de nós descritivos melhoram a legibilidade do trace. Intervalos e incidentes fazem referência a nomes de nós — nomes que descrevem o que um nó faz facilitam a verificação dos traces de execução.

Páginas relacionadas

• The Canvas — controles de depuração completa e referência do painel de execução
• Tratamento de erros — configuração de ramificações de erro em nós
• Variáveis e fluxo de dados — como as variáveis funcionam entre nós