Integrationssynchronisierung
Ruft Mitarbeitende, Anstellungen und Organisationseinheiten aus jeder eingeschalteten Integration ab (Entra ID, SHR, Visma OM, Intega Løn, …).
So funktioniert es
Die Integrationssynchronisierung ist ein einziger Job, der jede synchronisierungsfähige Integration behandelt:
- Lädt aktive Integrationen — nur Integrationen, die für den Arbeitsbereich eingeschaltet sind, werden verarbeitet; ausgeschaltete oder nicht eingerichtete Integrationen werden übersprungen
- Ruft Daten ab — fragt das externe System nach seinen Daten und übergibt dabei den Zeitpunkt der letzten erfolgreichen Synchronisierung, sodass Systeme, die das unterstützen, nur Änderungen liefern
- Aktualisiert mTime — legt neue Datensätze an, aktualisiert geänderte und meldet alles, was übersprungen wurde (z. B. ungültige Datensätze im externen System)
- Aktualisiert den Synchronisierungsstatus — hält bei Erfolg die Startzeit dieses Laufs als
last_sync_atfest, bei einem Fehler die Fehlermeldung. Da die Startzeit (nicht die Endzeit) festgehalten wird, werden Änderungen, die während des Abrufs im externen System vorgenommen wurden, beim nächsten Lauf übernommen
Wann er läuft
Der Job läuft automatisch und wird nur ausgelöst, wenn für den Arbeitsbereich mindestens eine synchronisierungsfähige Integration eingeschaltet ist.
Parameter
| Parameter | Beschreibung |
|---|---|
| Integration | Optional. Die ID einer bestimmten Integration (z. B. entraid, shr, vom, integahr). Leer lassen, um alle eingeschalteten Integrationen zu synchronisieren |
| Probelauf | Wenn eingeschaltet, werden Daten abgerufen und Anzahlen gemeldet, ohne in mTime etwas zu ändern. Nützlich, um Zugangsdaten zu prüfen oder zu sehen, was eine Integration tun würde |
Jobergebnisse
Bei der Synchronisierung einer einzelnen Integration sind die Ergebnisse flach:
| Kennzahl | Beschreibung |
|---|---|
employees (mit created, updated, skipped) | Anzahlen je Gruppe für Mitarbeitende |
employments (mit created, updated, skipped) | Anzahlen je Gruppe für Anstellungen |
org_units (mit created, updated) | Anzahlen je Gruppe für Organisationseinheiten |
errors | Fehler, die das externe System beim Abrufen oder Aktualisieren gemeldet hat |
Bei der Synchronisierung aller Integrationen sind die Ergebnisse unter der jeweiligen Integrations-ID verschachtelt.
Ergebnisse eines Probelaufs zeigen die Anzahl der abgerufenen Elemente (employees, employments, org_units) und das Kennzeichen dry_run: true.
Wird ein Lauf übersprungen, weil die Integration ausgeschaltet oder nicht eingerichtet ist, sehen Sie skipped: true mit einem reason.
Jobstatus
Ein Lauf, der mit übersprungenen Zeilen oder Fehlern bei einzelnen Elementen endet, erhält den Status Warnung statt Abgeschlossen. Die synchronisierten Daten werden gespeichert; die Warnungen lenken die Aufmerksamkeit auf den Rest.
Verwandte Themen
- Integrationen im Überblick — jede Integration einrichten und konfigurieren
- Integrationsstatus — den letzten Synchronisierungszeitpunkt und Fehler jeder Integration anzeigen