Integrasjonssynkronisering
Henter ansatte, ansettelser og organisasjonsenheter fra hver aktiverte integrasjon (Entra ID, SHR, Visma OM, Intega HR, …).
Hvordan det fungerer
Integrasjonssynkroniseringen er en enkelt jobb som håndterer hver synkroniseringsdyktig integrasjon:
- Laster inn aktiverte integrasjoner — bare integrasjoner som er slått på for arbeidsområdet behandles; deaktiverte eller ukonfigurerte hoppes stille over
- Henter data — kaller integrasjonsleverandøren med tidsstemplet for siste vellykkede synkronisering, slik at leverandører som støtter delta-synkronisering bare returnerer det som ble endret
- Avstemmer — oppretter nye enheter, oppdaterer endrede, og rapporterer alt den hoppet over (f.eks. feilformaterte kilderader)
- Oppdaterer synkroniseringsstatusen — registrerer starttidspunktet for denne kjøringen som
last_sync_atved suksess, eller feilmeldingen ved mislykkethet. Å stemple starttidspunktet (ikke fullføringstidspunktet) betyr at oppstrøms endringer gjort under hentingen plukkes opp ved neste kjøring
Når den kjører
Jobben kjører automatisk og utløses bare når minst én synkroniseringsdyktig integrasjon er aktivert for arbeidsområdet.
Parametere
| Parameter | Beskrivelse |
|---|---|
| Integration | Valgfri. ID-en til en bestemt integrasjon (f.eks. entraid, shr, vom, integahr). La stå tom for å synkronisere alle aktiverte integrasjoner |
| Dry Run | Når aktivert henter den data og rapporterer antall uten å skrive noe til databasen. Nyttig for å verifisere legitimasjon eller se hva en integrasjon ville gjort |
Jobbresultater
Når en enkelt integrasjon synkroniseres, er resultatene flate:
| Måltall | Beskrivelse |
|---|---|
employees (med created, updated, skipped) | Antall per kategori for ansatte |
employments (med created, updated, skipped) | Antall per kategori for ansettelser |
org_units (med created, updated) | Antall per kategori for organisasjonsenheter |
errors | Leverandørrapporterte feil under henting eller avstemming |
Når alle integrasjoner synkroniseres, er resultatene nestet under hver integrasjons-ID.
Tørrkjøringsresultater eksponerer antallet hentede elementer (employees, employments, org_units) og et dry_run: true-flagg.
Når en kjøring hopper over fordi integrasjonen er deaktivert eller ikke konfigurert, vil du se skipped: true med en reason.
Jobbstatus
En kjøring som fullføres med overhoppede rader eller feil per element avsluttes med status advarsel i stedet for fullført. Dataene som faktisk ble synkronisert blir lagret; advarslene retter oppmerksomheten mot resten.
Relatert
- Oversikt over integrasjoner — sett opp og konfigurer hver integrasjon
- Integrasjonsstatus — se siste synkroniseringstidsstempel og feil for hver integrasjon
Feilsøking
| Problem | Løsning |
|---|---|
not configured-overhopping | Integrasjonen ble aldri satt opp for dette arbeidsområdet. Konfigurer den under |
disabled-overhopping | Integrasjonen er konfigurert, men bryteren er av. Aktiver den på integrasjonssiden |
| Legitimasjonsfeil | Sjekk legitimasjonen som er lagret på integrasjonssiden på nytt. Jobben leser den på nytt ved hver kjøring |
| Samme ansatte opprettes på nytt ved hver kjøring | Matchingsnøkkelen er per integrasjon. Sjekk integrasjonens dokumentasjon for feltet den bruker til å matche (f.eks. ansattnummer, e-post) |
| Tørrkjøring viser forventede data, men reell kjøring gjør ingenting | En integrasjon kan signalisere skip midt i en kjøring (f.eks. når ansattsynkronisering er slått av i avanserte innstillinger). Kjøringen fullføres vellykket, men ingen data lagres; last_sync_at rykkes med vilje ikke frem |