O editor

O editor é a tela onde você monta o fluxo arrastando nós e ligando um ao outro. É o coração do NEXUS Flow.

Montando o grafo

1. Adicione nós com ＋ Adicionar nó, escolhendo no catálogo. Comece sempre por um gatilho.
2. Ligue os nós: arraste uma conexão da saída de um nó até a entrada do próximo. A informação flui na direção das setas.
3. Configure cada nó: clique nele para abrir os parâmetros (o que consultar, qual condição aplicar, para quem enviar etc.).
4. Salve sempre que terminar uma alteração.

A ordem das ligações define a ordem de execução: cada nó só roda depois que o anterior entregou os seus itens.

Usando valores dos itens

Vários campos aceitam expressões — referências a valores que vêm dos itens, escritas entre chaves duplas. Por exemplo, num endereço de API você pode escrever:

https://api.exemplo.com/clientes/{{ ID }}

Na hora de rodar, {{ ID }} é trocado pelo valor do campo ID de cada item. Assim o mesmo nó atende a todos os itens, cada um com os seus dados. Enquanto você digita, o editor mostra ao lado do campo (marcado com fx) o resultado da expressão para o item de exemplo — e o erro, quando a expressão não fecha.

Na aba Parâmetros do nó, os campos do item que chegou aparecem como etiquetas: arraste a etiqueta para dentro de um campo e a expressão é escrita para você.

Dentro das chaves você pode calcular, e não só inserir um valor: contas ({{ quantidade * preco }}), condições ({{ status == "OK" ? "pronto" : "—" }}) e funções prontas, por exemplo:

• Texto: upper, lower, trim, capitalize, replace, split, join, padStart, contains, startsWith.
• Número: round, floor, ceil, abs, min, max, sum, avg, clamp.
• Listas: length, first, last, slice, unique, sort, reverse, includes, flatten.
• Objetos: get, has, keys, values, pick, omit, merge.
• Datas: now, today, format, dateAdd, dateDiff, startOf, weekday.
• Padrões/nulos: default, coalesce, ifEmpty, isEmpty.

Também dá para escrever listas ({{ [1, 2, 3] }}) e objetos ({{ {"nome": NOME, "total": qtd * preco} }}) direto na expressão.

Caminhos diferentes (portas)

Nós de decisão têm mais de uma saída. O IF (condição) separa os itens em duas saídas, escritas no desenho como true (os que atendem à condição) e false (os demais); o Switch (rotear) cria uma porta por caso, mais a default. Ligue cada saída a um trecho diferente do fluxo para tratar cada situação do seu jeito. Veja Dados e lógica.

Ajustando o comportamento do nó

Ao abrir um nó você tem quatro abas: Input (o que chegou), Parâmetros (a configuração), Output (o que saiu) e Config. É em Config que você decide o que acontece em caso de erro, quantas tentativas fazer, o que fazer quando não vem nenhum resultado e se os itens podem ser processados em paralelo — veja Ajustes do nó.

Testar antes de ativar

Use ▶ Executar fluxo para salvar e rodar ali mesmo, vendo em cada nó o que ele recebeu e o que produziu. Ajuste e execute quantas vezes precisar; só ative o fluxo quando o resultado estiver correto.

Para conferir um trecho específico, abra o nó e use ▶ Este nó: roda só até ele e os passos anteriores, sem executar o resto do fluxo.

Na aba Output do nó, 📌 Pinar esta saída guarda o resultado atual. Nos testes seguintes o fluxo entrega esse resultado guardado aos próximos nós, em vez de consultar o sistema de novo — o ajuste fica bem mais rápido, e você evita repetir uma consulta pesada ou um envio. Use ✎ Editar saída para escrever o resultado à mão e Despinar para voltar ao normal. A saída fixada vale apenas nos testes: nas execuções de verdade o nó sempre roda.

Trabalhando no canvas

Com o mouse, no espaço vazio do canvas:

Pelo teclado:

Um nó desabilitado deixa de rodar e apenas repassa adiante o que recebeu — útil para isolar um trecho enquanto você investiga.

No menu ⋯ da barra superior você encontra:

• Organizar fluxo — reposiciona os nós automaticamente, da esquerda para a direita.
• Adicionar nota — um bilhete no canvas para explicar o fluxo a quem for mexer depois.
• Exportar PNG — a imagem do fluxo inteiro, para apresentar ou anexar.
• Documentação — a documentação do fluxo, descrita a seguir.

A documentação do fluxo

📄 Documentação, na barra superior do editor ou no menu ⋯, abre um painel com o fluxo explicado por escrito: um resumo do que ele faz, os passos em ordem e o diagrama do desenho. Serve para apresentar a automação a quem não vai abrir o editor e para deixar registrado o que foi combinado.

A documentação é montada a partir do desenho atual e refeita sempre que o fluxo muda, então ela não envelhece sozinha. A data em que foi gerada aparece no alto do painel.

No painel você tem:

• ⬇ Baixar PDF — gera o documento com o logo e o nome da sua organização no cabeçalho, e quem o emitiu.
• Copiar markdown — leva o texto para colar num e-mail, num chamado ou na sua própria base de documentos.
• ↻ Regenerar — refaz a partir do fluxo como ele está agora. Disponível para quem pode editar o fluxo.

Quando a instância não tem o recurso de escrita automática configurado, o painel avisa e mostra apenas o diagrama dos passos.