Integrations-synkronisering
Henter medarbejdere, ansættelser og organisationsenheder fra hver aktiveret integration (Entra ID, SHR, Visma OM, Intega HR, …).
Sådan virker det
Integrations-synkroniseringen er ét enkelt job, der håndterer alle sync-kapable integrationer:
- Indlæser aktiverede integrationer — kun integrationer, der er slået til for arbejdsområdet, behandles; deaktiverede eller ukonfigurerede springes lydløst over
- Henter data — kalder integrationsudbyderen med tidsstemplet for den sidste succesfulde sync, så udbydere der understøtter delta-sync, kun returnerer hvad der er ændret
- Afstemmer — opretter nye entiteter, opdaterer ændrede og rapporterer, hvad der blev sprunget over (f.eks. fejlbehæftede kilde-rækker)
- Opdaterer sync-status — registrerer kørslens starttidspunkt som
last_sync_atved succes, eller fejlmeddelelsen ved fejl. At gemme starttidspunktet (ikke sluttidspunktet) betyder, at ændringer foretaget hos kilden under hentningen kommer med ved næste kørsel
Hvornår det kører
Jobbet kører automatisk og udløses kun, når mindst én sync-kapabel integration er aktiveret for arbejdsområdet.
Parametre
| Parameter | Beskrivelse |
|---|---|
| Integration | Valgfri. ID’et på en specifik integration (f.eks. entraid, shr, vom, integahr). Lad være tom for at synkronisere alle aktiverede integrationer |
| Tørkørsel | Når aktiveret, hentes data og statistik rapporteres uden at skrive noget til databasen. Nyttigt til at verificere credentials eller se hvad en integration ville gøre |
Jobresultater
Når én integration synkroniseres, er resultaterne flade:
| Metrik | Beskrivelse |
|---|---|
employees (med created, updated, skipped) | Tællere pr. bucket for medarbejdere |
employments (med created, updated, skipped) | Tællere pr. bucket for ansættelser |
org_units (med created, updated) | Tællere pr. bucket for enheder |
errors | Udbyder-rapporterede fejl under hentning eller afstemning |
Når alle integrationer synkroniseres, er resultaterne indlejret under hver integrations-ID.
Tørkørsels-resultater viser antallet af hentede poster (employees, employments, org_units) og et dry_run: true-flag.
Når en kørsel springes over, fordi integrationen er deaktiveret eller ukonfigureret, ses skipped: true med en reason.
Jobstatus
En kørsel der afsluttes med oversprungne rækker eller pr.-post-fejl, slutter med status advarsel snarere end fuldført. De data der blev synkroniseret, er committet; advarslerne henleder opmærksomheden på resten.
Relateret
- Oversigt over integrationer — opsæt og konfigurer hver integration
- Integrationsstatus — se det seneste sync-tidsstempel og fejl for hver integration
Fejlfinding
| Problem | Løsning |
|---|---|
| Spring over “ikke konfigureret” | Integrationen er aldrig blevet sat op for dette arbejdsområde. Konfigurer den under |
| Spring over “deaktiveret” | Integrationen er konfigureret, men slået fra. Slå den til på integrations-siden |
| Credentials-fejl | Tjek de gemte credentials på integrations-siden. Jobbet genlæser dem ved hver kørsel |
| Samme medarbejdere genoprettes ved hver kørsel | Match-nøglen er pr. integration. Tjek integrationens dokumentation for det felt, den bruger til match (f.eks. medarbejdernummer, e-mail) |
| Tørkørsel viser de forventede data, rigtig kørsel gør intet | En integration kan signalere skip midt i kørslen (f.eks. når medarbejder-sync er slået fra i avancerede indstillinger). Kørslen fuldfører succesfuldt, men intet committes; last_sync_at rykker bevidst ikke |