🇮🇹 IT

🕐 Schedule Trigger

Lo Schedule Trigger avvia un workflow automaticamente a intervalli regolari definiti da un'espressione cron. Nessun sistema esterno deve inviare una richiesta — Flusso controlla l'orologio e avvia il workflow per te, rendendolo la scelta giusta per qualsiasi attività ricorrente: report giornalieri, sincronizzazioni dati notturne, controlli di integrità orari e altro.

Categoria: Trigger · Identificatore tipo: schedule_trigger

Panoramica

L'automazione pianificata è uno dei pattern più comuni negli strumenti di workflow. Piuttosto che affidarsi a una persona che ricordi di eseguire un'attività, o creare un cron job separato sul tuo server, puoi configurare un workflow Flusso per eseguirsi autonomamente con qualsiasi pianificazione ricorrente — da ogni minuto a una volta all'anno.

La pianificazione è definita usando un'espressione cron standard a cinque parti, la stessa sintassi usata dal cron di Linux, GitHub Actions e la maggior parte dei sistemi di pianificazione. Se non hai familiarità con la sintassi cron, gli esempi qui sotto coprono i pattern più comuni. Esistono anche strumenti online gratuiti come crontab.guru dove puoi digitare un'espressione e vederla descritta in italiano semplice.

Quando la pianificazione si attiva, il workflow viene eseguito con un contesto di input vuoto tranne un singolo timestamp scheduled_at che indica agli step successivi esattamente quando l'esecuzione è stata avviata. Il workflow deve essere in stato Attivo perché la pianificazione venga eseguita; se il workflow è in pausa o in bozza, le esecuzioni pianificate vengono silenziosamente ignorate.

Configurazione

Campo	Obbligatorio	Descrizione
Espressione Cron	Obbligatorio	Un'espressione cron standard a cinque parti che specifica quando il workflow deve essere eseguito. Le cinque parti rappresentano: minuto, ora, giorno del mese, mese e giorno della settimana.

Formato Espressione Cron

# ┌─────────── minuto (0–59) # │ ┌─────────── ora (0–23) # │ │ ┌─────────── giorno del mese (1–31) # │ │ │ ┌─────────── mese (1–12) # │ │ │ │ ┌─────────── giorno della settimana (0–7, 0 e 7 = Domenica) # │ │ │ │ │ * * * * *

Esempi Comuni

# 9:00 ogni giorno feriale (Lunedì–Venerdì) 0 9 * * 1-5 # Mezzanotte ogni giorno 0 0 * * * # Ogni 15 minuti */15 * * * * # 8:00 il primo giorno di ogni mese 0 8 1 * * # Ogni ora 0 * * * * # Ogni Domenica alle 18:00 0 18 * * 0 # Due volte al giorno: mezzanotte e mezzogiorno 0 0,12 * * *

Dati di Output

Variabile	Tipo	Descrizione
`trigger.output.scheduled_at`	String (ISO 8601)	Il timestamp ISO 8601 di quando l'esecuzione pianificata è stata avviata, es. `2026-03-12T09:00:00Z`.

// Usa il timestamp pianificato negli step successivi {{ trigger.output.scheduled_at }} // Esempio: includi nell'oggetto di un'email Report giornaliero del {{ trigger.output.scheduled_at }}

Esempio di Utilizzo

Esportazione dati notturna a mezzanotte

Aggiungi uno Schedule Trigger e inserisci l'espressione cron 0 0 * * * per eseguire a mezzanotte ogni giorno.
Aggiungi un nodo HTTP Request per recuperare i dati che vuoi esportare dalla tua API interna.
Aggiungi un nodo Google Drive (o Local File) per scrivere i dati recuperati in un file. Usa {{ trigger.output.scheduled_at }} nel nome del file così ogni esportazione notturna ottiene un nome file unico con timestamp.
Imposta il workflow su Attivo nelle impostazioni del workflow. La pianificazione inizierà ad attivarsi alla prossima mezzanotte.

Suggerimenti e Note

Il workflow deve essere Attivo. Le esecuzioni pianificate si attivano solo quando il workflow è in stato Attivo. I workflow in bozza e in pausa non verranno eseguiti, anche se arriva l'orario pianificato.

Usa crontab.guru per verificare la tua espressione. Visita crontab.guru, incolla la tua espressione cron e ti descriverà la pianificazione in inglese semplice mostrando i prossimi orari pianificati.

Tutti gli orari sono in UTC. Le espressioni cron vengono valutate in Coordinated Universal Time. Se devi eseguire alle 9:00 in un fuso orario locale specifico, converti prima quell'orario in UTC. Ad esempio, le 9:00 Eastern Standard Time (UTC-5) sarebbero 0 14 * * *.
L'intervallo minimo è un minuto. Non puoi pianificare un workflow per l'esecuzione più frequentemente di una volta al minuto.
Le esecuzioni mancate non vengono ritentate. Se un'esecuzione pianificata viene persa (ad esempio, perché il server era momentaneamente non disponibile all'orario pianificato), Flusso non recupererà l'esecuzione mancata. La prossima esecuzione avverrà al prossimo orario pianificato.
Usa un Manual Trigger per i test. Lo Schedule Trigger non ha un pulsante di test — aggiungi temporaneamente un Manual Trigger per testare il resto della logica del tuo workflow senza attendere l'attivazione della pianificazione.

Nodi Correlati

Manual Trigger — avvia il workflow immediatamente on demand.
Event Trigger — avvia il workflow quando un altro workflow emette un evento con nome.