🇮🇹 IT

📡 Event Trigger

L'Event Trigger attiva un workflow quando un altro workflow nel tuo account Flusso emette un evento con nome usando il nodo Emit Event. Questo ti permette di concatenare workflow — un workflow completa un'attività e segnala al successivo di iniziare — senza accoppiarli strettamente in un singolo workflow di grandi dimensioni.

Categoria: Trigger · Identificatore tipo: event_trigger

Panoramica

Man mano che la tua automazione cresce in complessità, diventa utile suddividere il lavoro su più workflow focalizzati anziché costruire un unico workflow enorme che fa tutto. L'Event Trigger, insieme al nodo Emit Event, è il meccanismo che connette quei workflow in fase di esecuzione.

Il pattern funziona così: il Workflow A completa la sua attività, poi usa un nodo Emit Event per trasmettere un evento con nome (ad esempio, order.processed) insieme a un payload di dati. Qualsiasi workflow nel tuo account che ha un Event Trigger in ascolto per quel nome evento esatto verrà avviato automaticamente, ricevendo il payload emesso come input.

Più workflow possono ascoltare lo stesso nome evento — tutti verranno avviati in parallelo quando l'evento viene emesso. Questo rende l'Event Trigger ideale per pattern di fan-out, dove un singolo evento upstream deve attivare diversi processi downstream indipendenti, come inviare un'email di conferma, aggiornare un record CRM e registrare dati in un sistema di analytics tutto in una volta.

Configurazione

Campo	Obbligatorio	Descrizione
Event Name	Obbligatorio	Il nome dell'evento che questo workflow ascolta. Deve corrispondere esattamente al nome evento emesso dal nodo Emit Event nel workflow upstream — incluse maiuscole/minuscole e punteggiatura. Ad esempio, se il workflow emittente usa `order.processed`, questo campo deve contenere anch'esso `order.processed`.

Suggerimento sulla convenzione di denominazione: Usa nomi con notazione a punti che descrivono il dominio e l'azione, ad esempio: user.registered, invoice.paid, report.generated. Questo rende immediatamente chiara la relazione tra i workflow emittenti e quelli in ascolto.

Dati di Output

L'Event Trigger espone il nome dell'evento e il payload emesso dal workflow upstream:

Variabile	Tipo	Descrizione
`trigger.output.event_name`	String	Il nome dell'evento che ha attivato questo trigger, esattamente come emesso.
`trigger.output.payload`	Object	I dati emessi dalla configurazione Payload Mapping del nodo Emit Event upstream.

// Accedi al nome dell'evento {{ trigger.output.event_name }} // Accedi ai campi del payload passati dal workflow emittente {{ trigger.output.payload.order_id }} {{ trigger.output.payload.customer_email }} {{ trigger.output.payload.total_amount }}

Esempio di Utilizzo

Concatenamento: dall'elaborazione ordine alla notifica

Hai due workflow: Elabora Ordine e Notifica Cliente. Quando un ordine finisce di essere elaborato, vuoi che il workflow di notifica si avvii automaticamente.

Nel workflow "Elabora Ordine", aggiungi un nodo Emit Event alla fine. Imposta il nome evento su order.processed e mappa order_id e customer_email nel Payload Mapping.
Crea un nuovo workflow "Notifica Cliente" e aggiungi un Event Trigger come primo nodo. Imposta l'Event Name su order.processed.
Nel workflow di notifica, aggiungi un nodo Email Notification. Imposta il destinatario su {{ trigger.output.payload.customer_email }} e includi l'ID dell'ordine nell'oggetto: Il tuo ordine {{ trigger.output.payload.order_id }} è pronto.
Imposta entrambi i workflow su Attivo. Ora ogni volta che il workflow Elabora Ordine finisce, il workflow Notifica Cliente si attiva automaticamente.

Suggerimenti & Note

I nomi degli eventi sono case-sensitive. Order.Processed e order.processed sono trattati come due eventi diversi. Usa sempre una convenzione di capitalizzazione coerente in tutti i tuoi workflow.
Nessun listener non è un errore. Se un workflow emette un evento per cui nessun altro workflow è in ascolto, Flusso scarta silenziosamente l'evento. Il workflow emittente si completa normalmente.
Sono supportati listener multipli. Diversi workflow possono tutti ascoltare lo stesso evento. Verranno tutti avviati quando l'evento viene emesso, eseguendosi in parallelo e indipendentemente l'uno dall'altro.
Le catene circolari eseguiranno un loop indefinitamente. Se il Workflow A emette un evento che attiva il Workflow B, e il Workflow B emette un evento che attiva il Workflow A, creerai un loop infinito. Verifica sempre che la tua catena di eventi abbia un punto finale definito.

Nodi Correlati

Emit Event — il nodo usato nei workflow upstream per emettere un evento.
Error Trigger — si attiva quando un qualsiasi workflow incontra un errore di esecuzione fatale.
Schedule Trigger — si attiva automaticamente secondo una pianificazione cron.