Integrationssynkronisering

Hämtar medarbetare, anställningar och organisationsenheter från varje aktiverad integration (Entra ID, SHR, Visma OM, Intega HR, …).

Så fungerar det

Integrationssynkroniseringen är ett enda jobb som hanterar alla integrationer med synkroniseringsstöd:

  1. Laddar aktiverade integrationer — endast integrationer som är påslagna för arbetsytan bearbetas; inaktiverade eller okonfigurerade hoppas över i tysthet
  2. Hämtar data — anropar integrationsleverantören med tidsstämpeln för den senaste lyckade synkroniseringen, så att leverantörer som stöder deltasynkronisering bara returnerar det som har ändrats
  3. Stämmer av — skapar nya entiteter, uppdaterar ändrade och rapporterar allt som hoppades över (t.ex. felaktiga källrader)
  4. Uppdaterar synkroniseringsstatusen — registrerar körningens starttid som last_sync_at vid lyckat resultat, eller felmeddelandet vid misslyckande. Att stämpla starttiden (inte sluttiden) gör att ändringar uppströms som gjordes under hämtningen plockas upp vid nästa körning

När jobbet körs

Jobbet körs automatiskt och startar bara när minst en integration med synkroniseringsstöd är aktiverad för arbetsytan.

Parametrar

ParameterBeskrivning
IntegrationValfri. ID:t för en specifik integration (t.ex. entraid, shr, vom, integahr). Lämna tomt för att synkronisera alla aktiverade integrationer
Dry RunNär den är aktiverad hämtas data och antal rapporteras utan att något skrivs till databasen. Användbart för att verifiera inloggningsuppgifter eller se vad en integration skulle göra

Jobbresultat

Vid synkronisering av en enskild integration är resultatet platt:

MätvärdeBeskrivning
employees (med created, updated, skipped)Antal per kategori för medarbetare
employments (med created, updated, skipped)Antal per kategori för anställningar
org_units (med created, updated)Antal per kategori för organisationsenheter
errorsFel som leverantören rapporterade under hämtning eller avstämning

Vid synkronisering av alla integrationer grupperas resultatet under respektive integrations-ID.

Resultat från testkörningar (dry run) visar antalet hämtade objekt (employees, employments, org_units) och flaggan dry_run: true.

När en körning hoppas över för att integrationen är inaktiverad eller inte konfigurerad ser du skipped: true med en reason.

Jobbstatus

En körning som slutförs med överhoppade rader eller fel per objekt får statusen varning i stället för slutförd. De data som synkroniserades har sparats; varningarna uppmärksammar resten.

Relaterat

Felsökning

ProblemLösning
Hoppas över med not configuredIntegrationen har aldrig satts upp för den här arbetsytan. Konfigurera den under AdminIntegrationer
Hoppas över med disabledIntegrationen är konfigurerad men reglaget är avstängt. Aktivera den på integrationssidan
Fel med inloggningsuppgifterKontrollera inloggningsuppgifterna som finns sparade på integrationssidan. Jobbet läser om dem vid varje körning
Samma medarbetare skapas på nytt vid varje körningMatchningsnyckeln är specifik per integration. Läs integrationens dokumentation för att se vilket fält den matchar på (t.ex. anställningsnummer, e-post)
Testkörningen visar förväntade data, en riktig körning gör ingentingEn integration kan signalera skip mitt i körningen (t.ex. när medarbetarsynkronisering är avstängd i de avancerade inställningarna). Körningen slutförs utan fel men inga data sparas; last_sync_at flyttas avsiktligt inte fram