Schedule (Cron)

Descrizione

Scheduler enterprise per esecuzione pianificata di workflow su base cron — l'innesco di tutte le pipeline di automation ricorrente tempo-based che dominano i workflow business (reporting giornaliero, cleanup notturno, sync periodici, email settimanali, alerting orario). Implementa il modello cron Unix classico (sintassi posizionale "min hour day month dow") esteso con builder visuale no-code per non-developer commercialisti/marketer che vogliono "ogni lunedì alle 09:00" senza dover ricordare la sintassi `0 9 * * 1`. Builder UI con tre modalità complementari: frequenza preset (ogni N minuti/ore/giorni/settimane con spinner numerico — pattern "ogni 15 minuti", "ogni 6 ore", "ogni 3 giorni"), regolazione fine (combinator visuale di minute+hour+day_of_week+day_of_month+month con dropdown selettivi), expressione cron string libera per power user che conoscono la sintassi ("0 9 1-15 * *" = "ore 9:00 dei giorni 1-15 di ogni mese"). Anteprima umana sempre visibile sotto il widget ("Ogni lunedì alle 09:00 UTC", "Il 1 di ogni mese alle 03:00 Europe/Rome") per confidence-check dell'utente prima del save. Timezone-aware: default UTC ma il tenant può configurare timezone preferita (Europe/Rome standard per business italiano) — il cron è valutato secondo quella timezone, gestendo correttamente DST transition (ora legale/ora solare 2x l'anno) per evitare il classico bug "il report delle 09:00 oggi è arrivato alle 10:00 perché è cambiata l'ora legale". Architettura distribuita: lo scheduler vive nel portal centrale (non nel container tenant) — questo significa che cron continuano a partire anche con container in pausa (lifecycle sweeper sospende i container idle), e il portal fa wake-up automatico del container quando arriva l'ora di execution (no sleep penalty su piano Free). Il portal mantiene il last_fired_at di ogni cron e gestisce missed_runs detection (se il container era down per > 1 schedule, il portal sa quanti runs sono stati persi e può decidere catch-up o skip in base a policy configurable). Input al workflow downstream: { triggeredAt (ISO timestamp del firing), scheduledFor (l'orario nominale configurato — può differire da triggeredAt per pochi secondi su scheduler delay), missedRuns? (count se sono stati saltati run precedenti), timezone, cronExpression }. Use case: report giornaliero KPI mattina inviato al CEO via email/Telegram con summary del business precedente (cron "0 8 * * 1-5" = ore 8 dei giorni feriali); polling cron orario su API third-party che non hanno webhook (controllo nuovi ordini su marketplace, cambi di tasso di cambio per pricing dinamico, updates da gestionale legacy); cleanup periodico DB del tenant per rimozione record obsoleti GDPR compliance (cron daily 03:00); sync nightly CRM bidirezionale tra Pipedrive e Salesforce/HubSpot per multi-CRM strategy; email summary settimanale del team performance ogni domenica sera per i manager.

⚙️ Parametri di configurazione

Campi mostrati nell’editor quando si configura il nodo. Generati direttamente dal NodeDefconfigFields.

💡 Esempio configurazione

Snippet JSON del nodo come compare nel workflow. I valori sono derivati daidefaultValue e dai parametri required.

{
  "id": "node-trigger_cron-1",
  "defId": "trigger_cron",
  "label": "Schedule (Cron)",
  "config": {
    "cronExpression": "0 9 * * 1-5",
    "timezone": "Europe/Rome"
  }
}

🔗 Nodi correlati nella stessa categoria