# Come funziona la programmazione

> Programmazioni, tempistica, modifiche, periodi ed esecuzioni: le idee alla base di Metascheduler e cosa succede a ogni momento.

Documentazione · 3 min di lettura · Aggiornato il 4 novembre 2026

## Gli elementi di base

Una **programmazione** è una voce del tuo calendario. Ha un nome, una **tempistica** e un elenco di **modifiche**.

Una **modifica** è un tipo di intervento su un insieme di elementi: "applica il 20% di sconto a queste 140 varianti", oppure "sostituisci il menu principale con il menu del Black Friday". Ogni modifica ha:

- un **tipo di modifica**, come Prezzi delle varianti o Menu di navigazione ([tutti i tipi](https://metascheduler.app/it/help/change-types.md));
- gli **elementi** che modifica, come prodotti, voci o un menu;
- cosa fa all'**inizio**;
- cosa succede **alla fine**: **Ripristina**, **Imposta un altro valore** o **Mantieni**.

Le modifiche vengono eseguite nell'ordine in cui sono elencate.

## Tempistica

> **Provalo:** [Come viene eseguita una programmazione](https://metascheduler.app/it/help/how-scheduling-works)

| Tempistica | Viene eseguita | Alla fine |
| --- | --- | --- |
| **Una volta** | Una sola volta, a una data e un'ora. | Niente: le sue modifiche restano, come un Lancio dei rollout. |
| **Periodo** | Da un inizio fino a una fine. | Ogni modifica segue la sua scelta finale, come un Evento dei rollout. |
| **Ripeti** | Un periodo che si ripete ogni giorno, settimana o mese. | Ogni periodo si ripristina alla sua fine. |
| **Segui un rollout** | Quando un rollout di Shopify diventa attivo. | Quando il rollout termina, come hai scelto. |

Ogni programmazione ha il suo **fuso orario**. Gli orari vengono salvati con precisione e mostrati nel fuso della programmazione.

## Stati

Una programmazione passa attraverso questi stati:

1. **Bozza**: in preparazione. Non viene mai eseguita.
2. **Programmata**: in attesa del suo inizio.
3. **In corso**: le sue modifiche sono applicate ora.
4. **Terminata**: è stata eseguita e non c'è più nulla in programma.

Puoi anche usare **Sospendi** (non parte più nulla di nuovo; ciò che è in corso viene comunque ripristinato alla fine) o **Archivia** (la programmazione non verrà più eseguita; ciò che è in corso viene comunque ripristinato). Una programmazione terminata o archiviata non si può modificare: seleziona **Duplica** per eseguirla di nuovo.

## Cosa succede all'inizio

Per ogni elemento, Metascheduler:

1. legge il valore attuale e lo salva (l'istantanea);
2. scrive il nuovo valore;
3. salva ciò che ha scritto.

Se un elemento ha già il valore, non viene scritto nulla. Una percentuale viene sempre calcolata a partire dal valore salvato, quindi un nuovo tentativo non applica mai il 20% di sconto due volte.

## Cosa succede alla fine

Per ogni elemento, in base alla scelta finale della modifica:

- **Ripristina**: se il valore attuale è ancora quello scritto da Metascheduler, rimette il valore salvato. Se qualcuno l'ha modificato, lo lascia stare e te lo chiede. Vedi [Come funziona il ripristino](https://metascheduler.app/it/help/undo-and-drift.md).
- **Imposta un altro valore**: scrive il valore finale che hai scelto.
- **Mantieni**: non fa nulla.

## Esecuzioni in ritardo

Metascheduler esegue ogni inizio e ogni fine una sola volta, in orario. Se non riesce a eseguirli in orario (ad esempio, Shopify non era disponibile), segue queste regole:

| Situazione | Cosa succede |
| --- | --- |
| Un inizio in ritardo fino a 5 minuti | Viene eseguito normalmente. |
| Un inizio più in ritardo, dentro il suo periodo | Viene eseguito e contrassegnato come **In ritardo**. |
| Un inizio il cui periodo è già terminato | Viene saltato e compare in **Da gestire**. La sua fine viene annullata. |
| Una fine, per quanto in ritardo | Viene sempre eseguita. Rimettere a posto le cose è la direzione sicura. |
| Una modifica singola in ritardo di più di un giorno | Aspetta la tua decisione in **Da gestire**: **Esegui ora** o **Salta**. |

**Esegui ora**, **Riprova** e gli inizi dei rollout non sono trattenuti da queste regole.

## Nuovi tentativi

Quando Shopify è occupato o non raggiungibile, Metascheduler aspetta e riprova, fino a 5 volte, con attese sempre più lunghe. Una modifica che Shopify rifiuta (un valore non consentito, un elemento che non esiste più) non viene ritentata: quell'elemento non riesce e gli altri proseguono, e l'esecuzione mostra **Completata in parte**.

## Conflitti

Quando due programmazioni modificano lo stesso elemento in momenti che si sovrappongono, l'editor lo elenca in **Conflitti** e il calendario le segnala entrambe. È un avviso, non un blocco: le regole di ripristino sicuro evitano che la sovrapposizione sovrascriva l'una o l'altra.

## Articoli correlati

- [Come funziona il ripristino](https://metascheduler.app/it/help/undo-and-drift.md): Metascheduler salva ciò che sostituisce e controlla prima di rimetterlo, così non sovrascrive mai una modifica fatta da qualcuno nel frattempo.
- [Programma la tua prima modifica](https://metascheduler.app/it/help/first-schedule.md): Crea una programmazione con un inizio e una fine, aggiungi una modifica, controlla l'anteprima e programmala.
- [Glossario](https://metascheduler.app/it/help/glossary.md): Le parole che usa Metascheduler e gli stati che vedrai su programmazioni, esecuzioni ed elementi.