Integratiesynchronisatie
Haalt medewerkers, dienstverbanden en organisatie-eenheden op uit elke ingeschakelde integratie (Entra ID, SHR, Visma OM, Intega HR, …).
Hoe het werkt
De integratiesynchronisatie is één taak die elke synchroniseerbare integratie verwerkt:
- Laadt ingeschakelde integraties — alleen integraties die zijn ingeschakeld voor de werkruimte worden verwerkt; uitgeschakelde of niet-geconfigureerde integraties worden stilzwijgend overgeslagen
- Haalt gegevens op — roept de integratieprovider aan met het tijdstip van de laatste succesvolle synchronisatie, zodat providers die deltasynchronisatie ondersteunen alleen teruggeven wat er is gewijzigd
- Reconcilieert — maakt nieuwe entiteiten aan, werkt gewijzigde bij en rapporteert wat er is overgeslagen (bijv. onjuist gevormde bronrijen)
- Werkt de synchronisatiestatus bij — legt de begintijd van deze uitvoering vast als
last_sync_atbij succes, of het foutbericht bij mislukking. Door de begintijd (niet de eindtijd) vast te leggen, worden wijzigingen die stroomopwaarts zijn aangebracht tijdens het ophalen, meegenomen in de volgende uitvoering
Wanneer het wordt uitgevoerd
De taak wordt automatisch uitgevoerd en start alleen wanneer er minstens één synchroniseerbare integratie is ingeschakeld voor de werkruimte.
Parameters
| Parameter | Beschrijving |
|---|---|
| Integratie | Optioneel. Het ID van een specifieke integratie (bijv. entraid, shr, vom, integahr). Laat leeg om alle ingeschakelde integraties te synchroniseren |
| Proefuitvoering | Wanneer ingeschakeld, worden gegevens opgehaald en aantallen gerapporteerd zonder iets naar de database te schrijven. Handig voor het controleren van inloggegevens of om te zien wat een integratie zou doen |
Taakresultaten
Bij het synchroniseren van één integratie zijn de resultaten niet genest:
| Metriek | Beschrijving |
|---|---|
employees (met created, updated, skipped) | Aantallen per categorie voor medewerkers |
employments (met created, updated, skipped) | Aantallen per categorie voor dienstverbanden |
org_units (met created, updated) | Aantallen per categorie voor organisatie-eenheden |
errors | Door de provider gemelde fouten tijdens het ophalen of reconciliëren |
Bij het synchroniseren van alle integraties zijn de resultaten genest onder elk integratie-ID.
Proefuitvoeringsresultaten tonen het aantal opgehaalde items (employees, employments, org_units) en een markering dry_run: true.
Wanneer een uitvoering wordt overgeslagen omdat de integratie is uitgeschakeld of niet is geconfigureerd, is skipped: true zichtbaar met een reason.
Taakstatus
Een uitvoering die eindigt met overgeslagen rijen of fouten per item, wordt afgesloten met de status waarschuwing in plaats van voltooid. De gegevens die wel zijn gesynchroniseerd, worden opgeslagen; de waarschuwingen vestigen de aandacht op de rest.
Gerelateerd
- Integraties overzicht — integraties instellen en configureren
- Integratiestatus — het laatste synchronisatietijdstip en eventuele fouten per integratie bekijken
Probleemoplossing
| Probleem | Oplossing |
|---|---|
Overgeslagen met not configured | De integratie is nooit ingesteld voor deze werkruimte. Configureer deze via |
Overgeslagen met disabled | De integratie is geconfigureerd maar de schakelaar staat uit. Schakel deze in op de integratiepagina |
| Fout bij inloggegevens | Controleer de inloggegevens die zijn opgeslagen op de integratiepagina. De taak leest deze bij elke uitvoering opnieuw |
| Dezelfde medewerkers worden bij elke uitvoering opnieuw aangemaakt | De overeenkomstsleutel is per integratie. Raadpleeg de documentatie van de integratie voor het veld dat wordt gebruikt voor de overeenkomst (bijv. medewerkernummer, e-mailadres) |
| Proefuitvoering toont de verwachte gegevens, echte uitvoering doet niets | Een integratie kan skip doorgeven tijdens een uitvoering (bijv. wanneer de medewerkerssynchronisatie is uitgeschakeld in de geavanceerde instellingen). De uitvoering wordt succesvol afgerond maar er worden geen gegevens opgeslagen; last_sync_at wordt bewust niet bijgewerkt |