Trabalhando com Nós

Este guia detalha como adicionar, conectar, configurar e gerenciar nós no editor de fluxos.

Adicionando Nós

Arrastar da Paleta

A forma principal de adicionar nós é arrastando da paleta de nós (lado esquerdo) para o canvas:

1. Localize a categoria desejada na paleta
2. Clique e arraste o nó para o canvas
3. Solte na posição desejada

Imagem: Nó sendo arrastado da paleta de nós para o canvas

Colar JSON (Gravador Chrome)

Você também pode colar nós copiados do Gravador Chrome (extensão):

1. No Gravador Chrome, clique em Copiar JSON
2. No editor de fluxos, pressione Ctrl+V
3. O nó correspondente ao modo do recorder será adicionado com todos os passos gravados

O QANode Recorder pode gerar nós Smart Web Flow, Web Flow ou Smart Locators, conforme o modo selecionado na extensão.

Adicionar Componentes Reutilizáveis

Quando existem componentes publicados, o editor de cenários exibe a aba Componentes na paleta lateral.

1. Abra a aba Componentes.
2. Busque pelo nome ou categoria.
3. Arraste o componente para o canvas.
4. Conecte-o como um nó comum.
5. Preencha os campos de entrada no painel de propriedades.

Componentes são úteis para reutilizar blocos como login, preparação de massa, consultas auxiliares ou validações compartilhadas.

Para criar, testar e publicar componentes, consulte Componentes Reutilizáveis.

Conectando Nós

Criando Conexões

Para conectar dois nós:

1. Passe o mouse sobre o handle de saída (●) do nó de origem
2. Clique e arraste até o handle de entrada (●) do nó de destino
3. Solte para criar a conexão

Imagem: Linha sendo arrastada de um handle de saída para um handle de entrada

Handles de Entrada e Saída

Alguns nós possuem múltiplos handles de saída:

• If → true e false
• Switch → Um handle por case + default
• Loop → loop (corpo do loop) e done (saída do loop)

Removendo Conexões

Para remover uma conexão:

1. Clique na linha de conexão para selecioná-la
2. Pressione Delete ou Backspace

Configurando Nós

Painel de Propriedades

Ao clicar em um nó, o painel de propriedades abre à direita. Cada tipo de nó tem campos específicos, mas todos compartilham:

Usando Expressões nos Campos

A maioria dos campos aceita expressões com a sintaxe {{ }}:

{{ steps["Nome do Nó"].outputs.propriedade }}
{{ variables.minhaVariavel }}

Isso permite que nós usem dados produzidos por nós anteriores. Por exemplo:

• URL de navegação: {{ variables.BASE_URL }}/login
• Texto para preencher: {{ steps["Nome do Nó"].outputs.result.email }}
• SQL: SELECT * FROM users WHERE email = '{{ steps.extract.outputs.extracts.email }}'

Para mais detalhes, veja Expressões.

Nós com Múltiplos Passos

Alguns nós suportam múltiplos passos internos, tornando-os mais poderosos:

Smart Web Flow, Web Flow e Smart Locators

Esses nós permitem adicionar vários passos de automação web dentro de um único nó:

1. No painel de propriedades, clique em + Adicionar Passo
2. Selecione o tipo de ação (navigate, click, fill, assert, etc.)
3. Configure os parâmetros do passo
4. Repita para adicionar mais passos

Os passos são executados sequencialmente, na ordem em que aparecem na lista.

Você pode:

• Reordenar passos arrastando
• Expandir/Recolher passos para ver detalhes
• Remover passos clicando no ícone de lixeira
• Configurar evidências (screenshots) individualmente por passo
• Copiar apenas um passo pelo menu de contexto
• Colar o passo acima ou abaixo de outro passo compatível

Dica: O copiar/colar de passos respeita o tipo do nó. Um passo copiado de Smart Web Flow só deve ser colado em outro Smart Web Flow, evitando misturar formatos incompatíveis.

Smart Web Flow

O Smart Web Flow é o nó recomendado para novas automações web. Ele armazena mais contexto por passo, incluindo localizadores, seletores alternativos, identidade do alvo, texto de escopo, efeitos esperados e metadados da gravação.

Use-o principalmente quando o fluxo foi criado pela extensão Chrome ou quando a aplicação possui componentes dinâmicos como menus, modais, iframes, grids, tabelas, cards e drag/drop.

Para detalhes completos, consulte Nó Smart Web Flow.

SSH Command

O nó SSH também suporta múltiplos passos (comandos):

1. Cada passo é um comando a ser executado
2. Passos são executados sequencialmente na mesma conexão SSH
3. Opcionalmente, aguarde por um texto específico na saída (match string)

Nós de Controle de Fluxo

Criando Desvios Condicionais

Para criar um desvio condicional:

1. Adicione um nó If ao canvas
2. Configure a condição no painel de propriedades
3. Conecte a saída true ao caminho que deve ser executado quando a condição for verdadeira
4. Conecte a saída false ao caminho alternativo

Exemplo:

[HTTP Request] → [If status === 200]
                       │ true → [Log "Sucesso"]
                       │ false → [Log "Erro"] → [Stop and Fail]

Condição Simples vs Visual Builder

O nó If oferece dois modos de configuração:

Modo Simples:

{{ steps["http-request"].outputs.status === 200 }} 

Modo Visual Builder:

• Campo: steps["http-request"].outputs.status
• Operador: ===
• Valor: 200

O modo visual builder é mais amigável e não requer conhecimento de JavaScript.

Nós com Query Builder Visual

Os nós de banco de dados (PostgreSQL, MySQL, MariaDB, SQL Server, Oracle, etc.) oferecem um query builder visual além da opção de SQL direto:

Presets Disponíveis

O query builder permite selecionar tabelas, colunas, condições WHERE, ORDER BY e LIMIT sem escrever SQL.

Dicas e Boas Práticas

Nomeie seus Nós

Dê nomes descritivos aos seus nós alterando o label. Isso facilita a leitura do fluxo e torna as expressões mais claras:

{{ steps.login.outputs.json.token }}

é mais legível que:

{{ steps["HTTP Request 2"].outputs.json.token }}

Use Grupos Lógicos

Organize nós relacionados próximos uns dos outros no canvas. Por exemplo, agrupe nós de login em uma área e nós de verificação em outra.

Configure Evidências

Para testes web, ative screenshots nos passos críticos. Isso facilita a depuração e gera evidências nos relatórios.

Use Continuar em Falha com Cuidado

O toggle Continuar em Falha é útil para nós de verificação (assert) onde você quer registrar todas as falhas em vez de parar na primeira. Use com moderação — em geral, falhas devem interromper o fluxo.

Próximos Passos

• Execução e Depuração — Como executar e diagnosticar problemas
• Referência de Nós — Detalhes de cada tipo de nó