Docs / Flow Editor

Flow Editor

Il Flow Editor è uno strumento di automazione visuale che permette di orchestrare workflow complessi attraverso un’interfaccia drag-and-drop. Ogni nodo rappresenta un’operazione specifica che può essere configurata e connessa ad altri nodi per creare flussi di lavoro automatizzati.

Concetti Fondamentali

Nodi e Connessioni

Un workflow è composto da nodi collegati tramite edges (connessioni). I dati fluiscono da sinistra a destra, partendo da un nodo Trigger.

┌─────────┐     ┌─────────┐     ┌─────────┐
│ Trigger │────▶│  Node   │────▶│  Node   │
└─────────┘     └─────────┘     └─────────┘

Flusso dei Dati

Ogni nodo riceve dati in input dal nodo precedente e produce dati in output per il nodo successivo. I dati sono accessibili tramite variabili template:

{{nodeId.output.campo}}

Categorie di Nodi

Triggers

Avvia i workflow: manuale, schedulato, webhook, eventi

Infrastructure

Blueprint, Deployment, Database, Terminal

Security

Scansioni porte, SSL, vulnerabilità, headers

Monitoring

Uptime, performance, health check, alerting

Integration

API calls, n8n workflows, notifiche

Tunnels

Quick Tunnel, FRP Client/Server, esposizione servizi

Cloud & DevOps

Docker Build, Cloud Deploy multi-provider

AI & Machine Learning

ML Inference, OpenAPI, Test Suite

Logic & Flow Control

Condition, Transform, Merge, Split, Delay

Examples & Recipes

Workflow pronti all'uso e pattern comuni

Quick Start

1. Crea un nuovo workflow

Dalla sidebar, clicca su Flow Editor e poi New Flow.

2. Aggiungi un Trigger

Ogni workflow inizia con un nodo Trigger. Trascina un nodo Trigger dalla palette e configuralo:

  • Manual: esecuzione on-demand
  • Cron: schedulazione (es: 0 9 * * * = ogni giorno alle 9:00)
  • Webhook: attivazione da URL esterno
  • Event: reazione a eventi della piattaforma

3. Aggiungi nodi operativi

Collega i nodi necessari per il tuo workflow. Esempio di workflow base:

Trigger ──▶ API Call ──▶ Condition ──▶ Notification
                              │
                              └──▶ Logger

4. Salva ed esegui

Clicca Save per salvare il workflow, poi Run per eseguirlo.

Best Practices

Nomenclatura dei nodi

Usa nomi descrittivi per i nodi che spieghino cosa fanno:

  • ✅ Fetch User Data
  • ✅ Check SSL Certificate
  • ❌ API Call 1
  • ❌ Node
Gestione degli errori

Ogni nodo ha l’opzione Continue on error. Usala per:

  • Nodi non critici (logging, metriche)
  • Workflow che devono completare anche con errori parziali

Per gestione avanzata, usa il nodo Condition per verificare lo stato:

{{previousNode.status}} === 'error'
Variabili e riferimenti

I dati fluiscono tra i nodi. Usa la sintassi template:

{{nodeId.output.campo}}
{{trigger.data.body.email}}
{{apiCall.response.data.id}}
Testing
  1. Usa il nodo Logger per debug
  2. Testa ogni nodo singolarmente prima di collegare
  3. Usa il tab Logs del Flow Editor per monitorare l’esecuzione

Prossimi passi