Execução e Depuração

Aprenda como executar seus fluxos, interpretar resultados e diagnosticar falhas.

Executando um Fluxo

Execução Completa

Para executar todo o fluxo:

1. Certifique-se de que o fluxo está salvo
2. Clique no botão Executar (▶️) na barra superior
3. Aguarde a conclusão — os nós exibirão indicadores de status em tempo real

Imagem: Canvas mostrando nós com indicadores de status durante a execução

Status de Execução

Cancelando Execuções

Execuções em andamento podem ser canceladas por usuários com permissão run.cancel.

Onde cancelar:

• Editor do cenário: durante a execução, o botão de executar muda para um botão de parada.
• Lista de execuções: use o menu de ações da execução em andamento.
• Execução de suíte: cancelar a execução principal também cancela os cenários pendentes ou em execução daquela suíte.

Ao cancelar, o status final fica como Cancelado. Evidências e logs já gerados até aquele ponto permanecem disponíveis para consulta.

O cancelamento acontece em pontos seguros da execução. Nós web, Smart Web, mobile, API, banco de dados, SSH, carga e JavaScript customizado verificam o pedido de cancelamento durante o processamento. Em nós com navegador ou sessão mobile, o QANode também tenta encerrar recursos abertos para evitar sessões presas.

Uma ação externa muito longa pode terminar o trecho atual antes de reconhecer o cancelamento. Nesses casos, o QANode cancela assim que a execução volta para um ponto seguro.

Analisando Resultados

Após a execução, clique em qualquer nó para ver seus resultados no painel de propriedades:

Aba de Resultados

Outputs

Os outputs de cada nó ficam acessíveis para nós seguintes via expressões. Por exemplo, após executar um HTTP Request, os outputs serão:

{
  "status": 200,
  "body": {
    "id": 1,
    "name": "João",
    "email": "joao@exemplo.com"
  }
}

Você pode então acessar esses dados em nós seguintes:

{{ steps["http-request"].outputs.body.name }}  →  "João"
{{ steps["http-request"].outputs.status }}     →  200

Quando o output é um arquivo, o valor principal é um fileRef:

{{ steps["http-request"].outputs.fileRef }}
{{ steps["file-generate"].outputs.fileRef }}

No painel de variáveis, arquivos mostram nome, MIME type e tamanho em detalhes. Campos internos como caminho no storage ficam ocultos da visualização principal.

Screenshots (Evidências)

Para nós web (Smart Web Flow, Web Flow e Smart Locators), screenshots capturados aparecem como miniaturas clicáveis. Clique para ver em tamanho completo.

Arquivos

Arquivos gerados ou capturados durante a execução aparecem na seção Arquivos do detalhe da execução. Ao baixar, o navegador usa o nome real do arquivo quando disponível, em vez de um identificador interno da execução.

Arquivos de teste isolado criados no editor são temporários e podem ser limpos automaticamente quando o usuário sai do fluxo ou por rotina de limpeza.

Depurando Falhas

Identificando o Nó com Problema

1. Procure nós com borda vermelha (🔴) no canvas
2. Clique no nó com falha
3. Verifique a mensagem de erro e os logs

Dicas Amigáveis de Falha

Quando um passo falha por um erro conhecido, o detalhe da execução pode mostrar uma seção Possível causa com uma sugestão objetiva. Ela aparece apenas em passos com falha e o QANode mostra uma dica por vez para evitar mensagens conflitantes.

As dicas cobrem problemas comuns como sessão expirada, credenciais, expressões quebradas, arquivos ausentes, alvo ambíguo, campo oculto, desabilitado ou somente leitura, clique bloqueado, timeout, assert que não bateu e efeito esperado que não apareceu depois da ação.

Use a dica como ponto de partida e confirme nas evidências, logs e screenshots antes de alterar o fluxo.

Mensagens de Erro Comuns

Web Flow / Smart Locators

HTTP Request

Banco de Dados

SSH

Usando Logs para Diagnóstico

Os logs de cada nó fornecem detalhes sobre cada passo executado. Para nós web, os logs mostram:

Navigated to: https://exemplo.com/login
Filled: "usuario@exemplo.com" on [getByLabel("E-mail")]
Clicked: [getByRole("button", { name: "Entrar" })]
Assert passed: textContains "Bem-vindo" — true

Se um passo falhou, o log mostrará exatamente qual passo e por quê:

Navigated to: https://exemplo.com/login
Filled: "usuario@exemplo.com" on [getByLabel("E-mail")]
ERROR: Click failed after 3 attempts: [getByRole("button", { name: "Login" })] — element not found

Dicas de Depuração

1. Desative o Modo Headless

Para testes web, desative o modo headless no nó para ver o navegador em ação:

• No nó Smart Web Flow, Web Flow ou Smart Locators, desmarque Headless
• Execute o fluxo e observe o navegador

2. Adicione Passos de Wait

Se elementos aparecem com atraso, adicione passos de wait antes de interagir:

• wait com modo visible aguarda o elemento aparecer
• wait com modo networkIdle aguarda todas as requisições de rede terminarem

3. Capture Screenshots para Diagnóstico

Ative screenshots no modo antes para ver o estado da página antes de cada ação. Isso ajuda a identificar se a página estava no estado esperado.

4. Verifique Expressões

Se um nó falha com valor inesperado, adicione um nó Log antes dele para inspecionar os valores:

Valor do token: {{ steps.login.outputs.body.token }}
Status: {{ steps["http-request"].outputs.status }}

5. Use o Toggle "Continuar em Falha"

Para diagnosticar múltiplas falhas de uma vez, ative Continuar em Falha nos nós de verificação. Isso permite que o fluxo continue e você veja todas as falhas em uma única execução.

Abrindo um Defeito a partir de uma Execução — Enterprise

Quando uma execução termina com falha, o botão Abrir Defeito fica disponível no detalhe da execução. Ao clicar, um modal abre para preencher as informações do defeito — título, descrição, severidade, prioridade e demais campos definidos pelo workflow.

O defeito criado fica automaticamente vinculado à execução, ao cenário e ao step que originou a falha.

Permissão necessária: bug.create

Defeitos relacionados

O detalhe da execução também exibe a seção Defeitos Relacionados com a lista de todos os defeitos vinculados àquela execução — bug key, título, status e severidade — com link direto para cada defeito.

Relatório de Execução

Após cada execução, o QANode disponibiliza um relatório PDF com:

• Resumo da execução (status, duração, data)
• Detalhes de cada passo (status, logs, outputs, duração)
• Screenshots capturados
• Erros encontrados

O relatório fica disponível na lista de execuções do projeto e pode ser baixado ou enviado por e-mail. Dependendo do template ativo, o PDF pode ser gerado automaticamente ao fim da execução ou apenas quando alguém solicita o download.

Próximos Passos

• Referência de Nós — Detalhes completos de cada tipo de nó
• Expressões — Domine o sistema de dados dinâmicos