Attività programmate: esegui compiti a orari fissi
Un'attività programmata esegue qualcosa sul tuo sito a orari fissi senza che nessuno prema un pulsante: un riepilogo ogni mattina, una pulizia ogni domenica sera. La trovi nelle Settings del progetto, sotto Scheduled tasks. Questa pagina mostra come configurarne una, leggerne le esecuzioni e correggerne una che fallisce.
Cosa fa un'attività pianificata
Un'attività pianificata è una chiamata che Briks fa a orari stabiliti. Chiama una route del tuo sito (un indirizzo sotto /api/ che esegue codice invece di mostrare una pagina) oppure un altro indirizzo https pubblico, come un servizio che usi. È l'indirizzo a svolgere il lavoro. Briks fa la chiamata puntuale e registra ciò che torna indietro.
Quindi un'attività ha bisogno di qualcosa da chiamare. Se il tuo sito non ha ancora una route per quel lavoro, chiedine prima una nello studio, poi punta un'attività verso di essa. Se non ci sono ancora attività, la pagina dice No scheduled tasks e riassume i lavori più comuni: inviare un riepilogo giornaliero, ripulire i vecchi record o sincronizzarsi con un altro servizio.
Le attività vengono eseguite che il sito sia pubblicato o no, agli orari che imposti, nel fuso orario che scegli. La sezione ha tre viste: Tasks, Runs e Settings.
Limiti di ogni piano
| Piano | Attività programmate per progetto | Chiamate al giorno per progetto |
|---|---|---|
| Free | 1 | 2.000 |
| Starter | 5 | 5.000 |
| Pro | 10 | 10.000 |
| Studio | 25 | 50.000 |
| Agency | 50 | 100.000 |
La vista Tasks mostra a che punto sei, per esempio 2 su 5 nel tuo piano, e Add task diventa grigio quando raggiungi il limite. Accanto al conteggio compare allora un link Get more, che apre la finestra di upgrade e indica il piano più piccolo con spazio per un'altra attività. Un'esecuzione che supererebbe le chiamate del giorno viene segnata come Skipped. I piani si confrontano in Billing.
Aggiungi un'attività programmata
Premi Add task
Dove: Settings, Scheduled tasks
Si apre la finestra Add a scheduled task. Editor, Admin e Owner possono aggiungere attività.
Dagli un nome
Dove: Add a scheduled task
Dagli un nome breve che riconoscerai nell'elenco delle esecuzioni, come
Daily digest. Fino a 60 caratteri.Imposta la pianificazione
Dove: Add a scheduled task
Scrivi una pianificazione in Schedule oppure premi uno dei pulsanti sotto. La prossima sezione spiega il formato.
Scegli il fuso orario
Dove: Add a scheduled task
Time zone parte dal tuo fuso. Un riquadro qui sotto mostra la programmazione a parole e le prossime cinque volte in cui verrà eseguita, così puoi controllarla prima di salvare.
Indica cosa richiama
Dove: Add a scheduled task
Sotto What it calls, scegli A route on this site e scrivi il suo percorso (inizia con
/api/), oppure Another address e scrivi un indirizzo https completo. Per una route, il suggerimento sotto il campo mostra l'indirizzo completo che verrà chiamato.Scegli POST o GET
Dove: Add a scheduled task
POST invia un breve messaggio con la chiamata, come si aspettano la maggior parte dei percorsi pensati per un compito. GET chiede solo l'indirizzo. Se hai dubbi, lascia POST.
Salva
Dove: Add a scheduled task
Premi Add task. Viene salvata solo dopo che l'utilità di pianificazione l'ha accettata, quindi ogni attività in elenco è una che gira davvero.
Scrivere una pianificazione
Una pianificazione è composta da cinque valori separati da spazi: minuto, ora, giorno del mese, mese e giorno della settimana. Un * significa ogni. Se ciò che scrivi non si può leggere, la casella dice cosa non va, per esempio quale valore è fuori intervallo.
| Vuoi | Tipo | L'anteprima dice |
|---|---|---|
| Ogni mattina alle 7 | 0 7 * * * | Ogni giorno alle 07:00 |
| Nei giorni feriali alle sei e mezza di sera | 30 18 * * 1-5 | Ogni giorno feriale alle 18:30 |
| Ogni 15 minuti | */15 * * * * | Ogni 15 minuti |
| Ogni due ore, all'ora esatta | 0 */2 * * * | Ogni 2 ore, in punto |
| La domenica sera alle 11 | 0 23 * * 0 | Ogni domenica alle 23:00 |
| Il 1° di ogni mese alle 6 del mattino | 0 6 1 * * | Il 1° di ogni mese alle 06:00 |
I giorni della settimana vanno da 0 (domenica) a 6 (sabato), e anche 7 è domenica. Puoi scrivere anche nomi come mon o jan, elenchi come 1,3,5, intervalli come 1-5 e passi come */10. Funzionano anche le scorciatoie: @hourly, @daily, @weekly, @monthly e @yearly.
I pulsanti sotto la casella la compilano al posto tuo: Every 5 minutes, Every hour, Every day at 09:00, Mondays at 09:00 e First of the month.
Cosa comporta ogni chiamata
Un'attività attende fino a 30 secondi una risposta. Ogni chiamata porta uno user-agent pari a Briks-Cron/1.0 e un'intestazione x-briks-cron con l'id dell'attività, così la route può capire da dove arriva la chiamata. Una chiamata POST invia anche un breve messaggio JSON (JSON è un formato di testo semplice che i programmi leggono) che indica il nome dell'attività:
{"cron":{"id":"…","name":"Daily digest"},"trigger":"schedule","scheduledFor":"2026-10-09T06:00:00.000Z"}
trigger è manual quando qualcuno ha premuto Run now, e allora scheduledFor è null.
Briks non chiama un indirizzo su una rete privata, un indirizzo scritto con numeri o uno dei suoi stessi indirizzi, e non segue i reindirizzamenti, quindi indica l'indirizzo finale. Le chiamate a una route del tuo sito vanno al suo indirizzo briks.live, e se cambi quell'indirizzo lo seguono.
Le esecuzioni e il significato di ogni stato
Runs elenca ogni esecuzione degli ultimi trenta giorni, dalla più recente, programmata o avviata a mano. Un'esecuzione avviata a mano ha l'etichetta By hand. Con più di un'attività, scegline una nella casella sopra l'elenco e premi Show. Fai clic su un'esecuzione per vedere il metodo e l'indirizzo chiamato, l'eventuale errore e l'inizio della risposta ricevuta.
| Stato | Cosa è successo |
|---|---|
| Succeeded | L'indirizzo ha risposto con uno stato 2xx, il codice del web per indicare successo. |
| Failed | Qualsiasi altra cosa: uno stato diverso (404 significa non trovato, 500 significa che il codice sottostante ha fallito), nessuna risposta entro 30 secondi, un reindirizzamento o un indirizzo non raggiungibile. |
| Skipped | Le chiamate del giorno per il progetto sono esaurite. L'esecuzione dice: Today's calls for this project are used up. Le esecuzioni ricominciano dopo la mezzanotte (UTC). |
La vista Tasks mostra lo stesso a colpo d'occhio: Next con l'ora della prossima esecuzione, Last con l'ultimo stato, oppure Not run yet.
Quando un'esecuzione fallisce
Un'esecuzione fallita viene registrata e non ripetuta. La successiva arriva all'orario consueto. Anche le esecuzioni perse mentre nulla poteva eseguirle non vengono recuperate: l'attività viene eseguita una volta e prosegue da lì.
Dopo aver risolto la causa, apri i tre puntini dell'attività e scegli Run now. Il risultato appare subito, per esempio: Daily digest ran: the address answered 200 in 312 ms. Puoi eseguire un'attività a mano fino a 20 volte all'ora, e ogni esecuzione conta nelle chiamate del giorno.
| Cosa dice l'esecuzione | Cosa fare |
|---|---|
| ha risposto 404 | Non c'è nessuna route a quel percorso. Controlla l'ortografia e che la versione con la route sia stata pubblicata. |
| ha risposto a 500 | È la route stessa ad aver avuto un errore. Apri Logs, scegli Requests e cerca il percorso per leggere l'errore. |
| Nessuna risposta entro 30 secondi. | L'operazione richiede troppo tempo in un'unica volta. Chiedi nello studio la strada per fare meno a ogni chiamata, ed eseguila più spesso. |
| I reindirizzamenti non vengono seguiti: usa l'indirizzo finale. | Apri l'indirizzo in un browser, copia l'indirizzo a cui porta e cambia l'attività con quello. |
| Quell'indirizzo punta a una rete privata e non può essere chiamato. | Usa un indirizzo pubblico. Briks non si collega mai a reti private. |
Metti in pausa, modifica o elimina
L'interruttore accanto a ogni attività la mette in pausa (compare l'etichetta Paused) e la riavvia. Nei suoi tre puntini, Change apre lo stesso modulo, intitolato Change task, e Delete la ferma ed elimina la cronologia delle esecuzioni. Per tutto questo servono i permessi di modifica.
La vista Settings ha Download JSON, un file con nome, programmazione, fuso orario e destinazione di ogni attività. La sua zona pericolosa contiene Clear history (le attività continuano a girare) e Delete all (per confermare scrivi il nome del progetto). Entrambi sono riservati a Owner e Admin.
Esempi pratici
Aggiungi una route su /api/daily-summary che mi mandi per email in un unico messaggio le richieste di appuntamento di ieri.
Dopo la pubblicazione della modifica, la clinica aggiunge un'attività programmata di nome Daily summary con la pianificazione 0 7 * * *, fuso orario Europe/London, che chiama POST /api/daily-summary. Ogni mattina alle sette arriva il riepilogo.
Il riepilogo parte dall'email del sito, che resta disattivata finché non la attivi. Vedi Email del sito per sapere come fare e per il limite mensile.
Aggiungi una route in /api/tidy-enquiries che elimina le richieste più vecchie di 90 giorni.
Un'attività chiamata Tidy enquiries la esegue con 0 23 * * 0, ogni domenica alle 23:00. Il lunedì, Runs mostra Succeeded, e aprendo l'esecuzione vedi cosa ha risposto la route.
Prima che una pulizia come questa giri per la prima volta, salva un punto di ripristino nelle impostazioni della scheda Database. Se la route elimina più del dovuto, puoi tornare indietro. Vedi Backups.