Sincronizzazione integrazioni
Recupera dipendenti, rapporti di lavoro e unità organizzative da ogni integrazione abilitata (Entra ID, SHR, Visma OM, Intega HR, …).
Come funziona
La sincronizzazione integrazioni è un singolo job che gestisce tutte le integrazioni abilitate alla sincronizzazione:
- Carica le integrazioni abilitate — vengono elaborate solo le integrazioni attive nell’area di lavoro; quelle disabilitate o non configurate vengono ignorate senza notifica
- Recupera i dati — richiama il provider dell’integrazione con il timestamp dell’ultima sincronizzazione riuscita, in modo che i provider che supportano la sincronizzazione incrementale restituiscano solo i dati modificati
- Riconcilia — crea le nuove entità, aggiorna quelle modificate e segnala gli elementi ignorati (ad esempio, righe sorgente non valide)
- Aggiorna lo stato della sincronizzazione — in caso di successo, registra l’ora di avvio dell’esecuzione come
last_sync_at; in caso di errore, registra il messaggio di errore. L’utilizzo dell’ora di avvio (anziché di completamento) garantisce che le modifiche effettuate a monte durante il recupero vengano incluse nell’esecuzione successiva
Quando viene eseguito
Il job viene eseguito automaticamente e si attiva solo quando almeno un’integrazione abilitata alla sincronizzazione è attiva nell’area di lavoro.
Parametri
| Parametro | Descrizione |
|---|---|
| Integrazione | Facoltativo. L’ID di una specifica integrazione (ad esempio entraid, shr, vom, integahr). Lasciare vuoto per sincronizzare tutte le integrazioni abilitate |
| Dry Run | Se abilitato, recupera i dati e restituisce i conteggi senza scrivere nulla nel database. Utile per verificare le credenziali o per vedere cosa farebbe un’integrazione |
Risultati del job
Quando si sincronizza una singola integrazione, i risultati sono in formato piatto:
| Metrica | Descrizione |
|---|---|
employees (con created, updated, skipped) | Conteggi per bucket relativi ai dipendenti |
employments (con created, updated, skipped) | Conteggi per bucket relativi ai rapporti di lavoro |
org_units (con created, updated) | Conteggi per bucket relativi alle unità organizzative |
errors | Errori segnalati dal provider durante il recupero o la riconciliazione |
Quando si sincronizzano tutte le integrazioni, i risultati sono nidificati sotto l’ID di ciascuna integrazione.
I risultati di un dry run mostrano il numero di elementi recuperati (employees, employments, org_units) e un indicatore dry_run: true.
Quando un’esecuzione viene saltata perché l’integrazione è disabilitata o non configurata, verrà visualizzato skipped: true con un campo reason.
Stato del job
Un’esecuzione che si completa con righe ignorate o errori per singolo elemento termina con stato warning anziché completed. I dati sincronizzati vengono salvati; gli avvisi segnalano le anomalie rimanenti.
Correlati
- Panoramica delle integrazioni — configurare e impostare ciascuna integrazione
- Stato dell’integrazione — visualizzare il timestamp dell’ultima sincronizzazione e gli eventuali errori per ciascuna integrazione
Risoluzione dei problemi
| Problema | Soluzione |
|---|---|
Salto not configured | L’integrazione non è mai stata configurata per quest’area di lavoro. Configurarla in |
Salto disabled | L’integrazione è configurata ma il toggle è disattivato. Abilitarla nella pagina dell’integrazione |
| Errore di credenziali | Verificare nuovamente le credenziali memorizzate nella pagina dell’integrazione. Il job le rilegge a ogni esecuzione |
| Gli stessi dipendenti vengono ricreati a ogni esecuzione | La chiave di corrispondenza è specifica per ogni integrazione. Consultare la documentazione dell’integrazione per verificare il campo utilizzato per la corrispondenza (ad esempio numero dipendente, e-mail) |
| Il dry run mostra i dati attesi, ma l’esecuzione reale non fa nulla | Un’integrazione può segnalare skip a metà esecuzione (ad esempio quando la sincronizzazione dei dipendenti è disattivata nelle impostazioni avanzate). L’esecuzione si completa correttamente ma nessun dato viene salvato; last_sync_at non viene aggiornato intenzionalmente |