🇮🇹 IT

🛑 Stop

Termina esplicitamente l'esecuzione del workflow con uno stato specificato — completato o fallito. Da utilizzare alla fine dei rami condizionali per segnalare chiaramente gli esiti definitivi.

Categoria: Controllo di Flusso · Identificatore tipo: stop

Panoramica

Quando un workflow raggiunge un nodo Stop, l'esecuzione termina immediatamente. Nessun ulteriore passaggio viene eseguito, indipendentemente da ciò che segue nel grafo o nella sequenza lineare. L'esecuzione viene registrata nello storico con lo stato e il messaggio che specifichi.

Sebbene un workflow che semplicemente "esaurisce i passaggi" termini comunque, il nodo Stop rende l'intenzione esplicita. Questo è particolarmente importante alla fine dei rami condizionali, dove vuoi essere chiaro se il ramo rappresenta un esito positivo, un'uscita anticipata deliberata o una condizione di errore.

Stop viene più comunemente posizionato alla fine del ramo false di un Logic Gate, alla fine di ogni ramo di uno Switch, e ovunque rilevi un errore irrecuperabile e vuoi mostrare un messaggio di errore chiaro nel log delle esecuzioni.

Stop non produce output. Poiché l'esecuzione termina immediatamente, non ci sono variabili di output da referenziare nei passaggi successivi — non ce ne sono.

Configurazione

Campo	Stato	Descrizione
Status	Obbligatorio	`completed` — l'esecuzione termina e viene contrassegnata come riuscita. Usa questo per uscite anticipate intenzionali dove tutto è andato come previsto. `failed` — l'esecuzione termina e viene contrassegnata come fallita. Usa questo per condizioni di errore o violazioni delle regole di business che devono essere visibili come fallimenti nello storico delle esecuzioni.
Message	Opzionale	Una spiegazione leggibile registrata insieme al risultato dell'esecuzione. Visibile nella vista dettaglio dell'esecuzione. Supporta i riferimenti `{{ variable }}`. Mantienila breve e informativa — è ciò che leggerai quando rivedi lo storico delle esecuzioni.

Dati di Output

Nessuno. Il nodo Stop termina l'esecuzione. Non produce alcuna variabile di output.

Esempio di Utilizzo

Rifiutare un'esecuzione quando l'approvazione viene negata

Un workflow di approvazione verifica se un revisore ha approvato una richiesta. Se l'ha rifiutata, il workflow deve fermarsi e registrare un chiaro messaggio di errore.

Aggiungi un nodo Logic Gate che verifica:
Field: {{ review.output.decision }} Operator: equals Value: rejected
Collega la porta true (decisione uguale a rejected) a un nodo Stop.
Configura il nodo Stop:
Status: failed Message: Richiesta rifiutata da {{ review.output.reviewer_name }} il {{ review.output.reviewed_at }}
Collega la porta false (non rifiutata) al passaggio successivo nel workflow di approvazione, che evade la richiesta.

Uscita anticipata per dati mancanti

Prima di elaborare un ordine, verifica che i campi obbligatori siano presenti. Se dati critici mancano, fermati in modo pulito piuttosto che lasciare che i passaggi successivi falliscano con errori criptici.

// Logic Gate: order.output.customer_id è null → ramo true → Stop Status: failed Message: L'ordine {{ trigger.output.order_id }} non ha un customer ID. Elaborazione interrotta.

Suggerimenti e Note

Usa lo stato failed per violazioni delle regole di business. Uno stato failed fa risaltare l'esecuzione nello storico e può attivare integrazioni di allerta. Riservalo a condizioni che richiedono genuinamente attenzione.
Usa completed per uscite anticipate deliberate. Se salti intenzionalmente il resto del workflow perché non c'è nulla da fare (ad esempio, "nessun ordine da elaborare oggi"), contrassegnalo come completed in modo che non appaia come un errore.
Includi contesto nel messaggio. Un messaggio come "Utente non idoneo" è meno utile nello storico delle esecuzioni rispetto a "Utente 4821 non idoneo: piano free, richiesto premium". Usa i riferimenti {{ variable }} per inserire valori dinamici.
Non è necessario alla fine di ogni workflow. Hai bisogno di un nodo Stop solo quando vuoi controllare esplicitamente lo stato o il messaggio. Se un workflow esaurisce semplicemente i passaggi, viene automaticamente registrato come completed.

Nodi Correlati

Logic Gate — il nodo più comune da posizionare prima di uno Stop, per instradare in base a una condizione.
Switch — posiziona uno Stop alla fine di ogni ramo Switch che deve terminare l'esecuzione.