Materializzazione maturazioni
Converte le maturazioni previste in eventi effettivi del conto ore, accreditando i saldi assenze dei dipendenti.
Come funziona
Il job di materializzazione delle maturazioni viene eseguito ogni giorno e svolge le seguenti operazioni:
- Individua le maturazioni in scadenza — previsioni con data di prossima maturazione pari o precedente alla data di esecuzione
- Crea gli eventi — converte ogni voce di previsione in scadenza in un evento effettivo del conto ore
- Aggiorna il tracciamento — registra l’ultima data di materializzazione per evitare elaborazioni duplicate
Questo è il job che accredita effettivamente i saldi assenze. Fino alla materializzazione, le maturazioni esistono solo come proiezioni nella previsione.
Elaborazione giornaliera e in recupero
Il job gestisce due scenari:
Elaborazione giornaliera
Per i dipendenti con uno storico di materializzazione esistente, il job:
- Individua le maturazioni con
next_accrual_date <= run_date - Crea eventi solo per le maturazioni in scadenza
- Aggiorna il campo
last_materialized_datedella previsione
Elaborazione in recupero
Per i dipendenti senza uno storico di materializzazione (nuove configurazioni o migrazioni), il job:
- Materializza tutte le maturazioni dalla data di inizio previsione fino alla data di esecuzione
- Consente di recuperare le maturazioni storiche in un’unica esecuzione
Comportamento della data di esecuzione
La data di esecuzione è fondamentale per questo job:
| Scenario | Data di esecuzione | Effetto |
|---|---|---|
| Esecuzione giornaliera normale | Oggi | Materializza le maturazioni in scadenza fino ad oggi |
| Esecuzione di recupero | Data passata | Materializza solo fino a quella data (utile per un’attivazione controllata) |
| Data futura | Data futura | Materializza le maturazioni nel futuro (usare con cautela) |
Recupero delle maturazioni storiche
Per materializzare le maturazioni relative a periodi passati:
- Verificare che il job Previsione maturazioni sia stato eseguito per il periodo storico
- Avviare manualmente questo job con la data di esecuzione impostata sulla data storica desiderata
- Eseguire nuovamente con date progressivamente più recenti per una materializzazione incrementale e controllata
Risultati del job
| Metrica | Descrizione |
|---|---|
forecasts_processed | Numero di previsioni dipendente valutate |
accruals_materialized | Numero di eventi di maturazione creati (elaborazione giornaliera) |
accruals_backfilled | Numero di eventi di maturazione creati (elaborazione in recupero) |
errors | Numero di errori durante la materializzazione |
Tempistica delle maturazioni
Le maturazioni vengono assegnate al primo del mese successivo. Ad esempio:
- Lavoro di gennaio → maturazione con data 1° febbraio
- Lavoro di dicembre → maturazione con data 1° gennaio (dell’anno successivo)
Ciò significa che il job di materializzazione eseguito il 1° febbraio creerà l’evento di maturazione per le assenze maturate a gennaio.
Risoluzione dei problemi
| Problema | Soluzione |
|---|---|
| Le maturazioni non compaiono | Verificare che il job Previsione maturazioni sia stato eseguito in precedenza |
| Maturazioni storiche mancanti | Verificare che last_materialized_date sia null per attivare il recupero oppure rieseguire la previsione con la data di esecuzione storica |
| Maturazioni duplicate | Non dovrebbe verificarsi — il job è idempotente. Controllare la presenza di eventi creati manualmente |
| Il saldo sembra errato | Verificare la configurazione del plugin di maturazione e le impostazioni di proporzionamento |