Editor de Fluxos — Visão Geral

O Editor de Fluxos é o coração do QANode. É nele que você cria, configura e executa seus cenários de teste de forma visual.

Interface do Editor

O editor é dividido em quatro áreas principais:

Imagem: Editor de fluxos mostrando as quatro áreas: barra superior, paleta de nós, canvas e painel de propriedades

1. Barra Superior

A barra superior contém:

2. Paleta de Nós (Lado Esquerdo)

A paleta exibe todos os nós disponíveis organizados por categoria:

• Controle de Fluxo — If, Switch, Loop, Merge
• Web — Smart Web Flow, Web Flow, Smart Locators
• API — HTTP Request
• Banco de Dados — PostgreSQL, MySQL, MariaDB, SQL Server, Oracle, MongoDB
• Infraestrutura — SSH Command
• Utilitários — Set Variable, Log, Wait, Stop and Fail, Custom JavaScript
• Nós Customizados — Nós de provedores registrados (se houver)

Para adicionar um nó, arraste-o da paleta para o canvas.

3. Canvas (Área Central)

O canvas é a área de trabalho onde você posiciona e conecta os nós. Funcionalidades:

4. Painel de Propriedades (Lado Direito)

Ao selecionar um nó, o painel de propriedades aparece à direita com:

• Executar: Execução do node em modo isolado
• Variáveis: Abre as propriedades de nodes anteriores, variáveis locais, variáveis globais e, quando aplicável, variáveis do projeto
• Configuração: Campos específicos do tipo de nó
• Outputs: Schema de saída do nó (após execução, mostra os dados reais)
• Continuar em Falha: Toggle para continuar o fluxo mesmo se o nó falhar

Fluxo de Trabalho Típico

1. Crie o cenário a partir de um projeto
2. Arraste os nós da paleta para o canvas
3. Conecte os nós arrastando entre handles
4. Configure cada nó usando o painel de propriedades
5. Salve o fluxo (Ctrl+S)
6. Execute e verifique os resultados

Ordem de Execução

O QANode executa os nós em ordem topológica, determinada pelas conexões:

[A] → [B] → [D]
         ↘
[C] ──────→ [E]

Neste exemplo:

• A executa primeiro
• B e C podem executar em seguida (após A)
• D executa após B
• E executa após B e C

Nota: Se um nó tem múltiplas entradas, ele só executa quando todos os nós anteriores forem concluídos.

Indicadores Visuais

Após uma execução, os nós exibem indicadores de status:

Atalhos de Teclado

Anotações no Canvas

As anotações ajudam a documentar partes do fluxo diretamente no canvas. Use-as para explicar pré-condições, regras de negócio, agrupamentos lógicos, pendências ou observações importantes para o time.

As anotações suportam:

• texto livre;
• formatação simples em estilo Markdown;
• cores;
• redimensionamento;
• arrastar e posicionar no canvas;
• copiar, colar, duplicar e excluir.

Você pode criar uma anotação pelo menu de contexto do canvas ou pelo atalho Shift+A.

Alterações Não Salvas

O editor detecta automaticamente quando há alterações não salvas. Ao tentar sair da página (pelo botão voltar, navegação ou fechamento da aba), um aviso será exibido:

"Sair sem salvar?" Você tem alterações não salvas. Se sair, suas alterações serão perdidas.

Isso protege contra perda acidental de trabalho. O aviso só aparece quando há alterações reais — não ao abrir um fluxo sem modificá-lo.

Histórico de Versões — Enterprise

O QANode Enterprise pode manter snapshots do cenário ao salvar alterações relevantes no fluxo. O histórico ajuda a auditar mudanças, comparar versões e voltar para uma versão anterior quando necessário.

Para acessar:

1. Abra o cenário no editor.
2. Clique no ícone de Histórico de Versões na barra superior.
3. Selecione uma versão para visualizar.

Ao abrir uma versão antiga, o cenário é exibido em modo de consulta. Você pode navegar pelo canvas, selecionar nós e conferir parâmetros, mas não edita diretamente o snapshot.

Para voltar a uma versão anterior, use Restaurar esta versão. O QANode aplica aquele snapshot como a versão atual do cenário e preserva a rastreabilidade da operação.

O histórico de versões fica disponível apenas no Enterprise. A quantidade de versões mantidas é definida pelo Super Admin em Configurações → Geral.

Próximos Passos

• Trabalhando com Nós — Detalhes sobre adicionar, conectar e configurar nós
• Execução e Depuração — Como executar fluxos e diagnosticar falhas