Problemen oplossen bij mislukte synchronisatiestappen

Het synchronisatieproces kan soms stoppen of mislukken om verschillende redenen. Dit artikel beschrijft veelvoorkomende oorzaken voor een mislukte synchronisatie en beschrijft de acties die je als beheerder kunt ondernemen om het probleem op te lossen en het proces opnieuw te starten.



De synchronisatiestatus begrijpen

De weergave Synchronisatiecyclus toont de status van elke stap in het proces. Kijk naar deze pictogrammen om de huidige status te begrijpen:

  • Groen vinkje: De synchronisatiestap is met succes voltooid.

  • Rode Kruis: De stap is mislukt met een fout.

  • Roterende cirkel: De stap is momenteel bezig of staat in de wachtrij voor de volgende stap.


Problemen oplossen per synchronisatiestap

De volgende tabel beschrijft elke stap van de synchronisatiecyclus en geeft acties die u kunt ondernemen als een stap mislukt of niet start.

Synchronisatiestap

Beschrijving

Mogelijke acties

HR importeren

eAdm haalt werknemersgegevens op uit uw HRM-systeem.

  • Als dit niet lukt: Neem contact op met ondersteuning.

  • Als er geen nieuwe cyclus wordt gestart (alle stappen zijn voltooid): Voer het eAdm-synchronisatiescript uit via de Taakplanner op de server waarop de client is geïnstalleerd. Als de synchronisatie niet start, controleer dan of er fouten staan in de Gebeurtenisviewer en de c:/eadm/logg bestanden voordat u contact opneemt met ondersteuning.

HR-toekomst importeren

eAdm haalt gegevens voor werknemers met een toekomstige startdatum op uit uw HRM systeem.

  • Indien mislukt: U kunt dit niet zelf oplossen. Neem contact op met Identum support voor assistentie.

Hiërarchie importeren

eAdm haalt de organisatiestructuur op uit uw HRM-systeem.

  • Als hij niet start: Voer het eAdm uit vanuit de taakplanner en controleer op fouten in de Event Viewer en c:/eadm/logg bestanden. Neem contact op met ondersteuning als u geen oplossing kunt vinden.

  • Als het programma is vastgelopen en er een foutmelding is verschenen: neem dan contact op met de helpdesk. Zie ook „Beschadigd of onvolledig importbestand” hieronder als de foutmelding betrekking heeft op het parseren of een onverwacht einde van het bestand.

AD importeren

eAdm haalt gegevens over bestaande gebruikersaccounts op uit de lokale Active Directory.

Opmerking: AD is de enige primaire bron voor account- en identiteitsgegevens, zoals samAccountName en Lastlogin. Persoonsgegevens zoals de volledige naam, het telefoonnummer of het adres worden ontleend aan het HRM-systeem, niet aan AD. Als een gebruiker onjuiste persoonsgegevens meldt (bijvoorbeeld een verkeerd gespelde naam) en deze rechtstreeks in AD zijn gecorrigeerd, is dit niet het juiste systeem om de fout te herstellen — de wijziging moet in plaats daarvan in het HRM-systeem worden aangebracht. Zie Gebruikersgegevens bijwerken in eADM voor de juiste werkwijze.

Als hij niet start: Voer het eAdm uit vanuit de taakplanner en controleer op fouten in de Event Viewer en c:/eadm/logg bestanden. Neem contact op met ondersteuning als u geen oplossing kunt vinden.

Als het is gecrasht met een fout: Neem contact op met ondersteuning.

Synchronisatie

eAdm verwerkt alle binnenkomende wijzigingen, past regels toe en kent machtigingen toe.

  • Als het importeren is gestopt vanwege een veiligheidsdrempelfout: dit betekent dat het importeren preventief is gestopt vanwege te veel wijzigingen. Zie „Wat te doen als het importeren door het importfilter is gestopt” (EID-ruimte).

  • Als het na de vorige stap nog niet is gestart: Voer het eAdm uit en controleer op fouten in de Event Viewer en c:/eadm/logg bestanden. Neem indien nodig contact op met ondersteuning.

  • Als het is gestart maar nooit is voltooid: Neem contact op met ondersteuning.

  • Als het programma stopt met een andere foutmelding: Neem contact op met ondersteuning.

AD exporteren

eAdm stuurt de verwerkte gegevens naar de lokale Active Directory.

Indien mislukt: Voer het eAdm uit en controleer op fouten in de Event Viewer en c:/eadm/logg bestanden. Neem contact op met ondersteuning als u geen oplossing kunt vinden.

AD-resultaten importeren

eAdm ontvangt feedback van de lokale klant nadat de Export AD stap is voltooid. Een mislukking hier geeft vaak aan dat er iets mis is gegaan tijdens de gegevensoverdracht naar de lokale AD.

  • Indien mislukt: Controleer de logbestanden in c:/eadm/logg en neem contact op met Identum support.

  • Als het proces stopt met de foutmelding "Time-out bij uitvoering verstreken": Controleer de logbestanden van de lokale eADM-client in c:/eadm/log en de Gebeurtenisviewer op de server op foutmeldingen. Neem contact op met de ondersteuning van Identum als u de oorzaak niet kunt achterhalen.

Andere integraties

Dit omvat exportstappen naar andere geconfigureerde doelsystemen (bijv. Export Azure, Export eFeide).

  • Als hij niet start: Voer het eAdm uit en controleer op fouten in de Event Viewer en c:/eadm/logg bestanden. Neem contact op met ondersteuning als u geen oplossing kunt vinden.

  • Als het is gecrasht met een fout: Neem contact op met ondersteuning.

Export Compilo


Foutmelding: "Het ophalen van de lijst met afdelingen uit Compilo is mislukt" → Dit betekent dat de Compilo-API niet beschikbaar is.

Neem contact op met Identum Support, dan nemen wij contact op met Compilo voor verdere probleemoplossing. Zodra de Compilo API weer beschikbaar is, zullen wij uw synchronisatie opnieuw starten.


De synchronisatie is sinds de vorige cyclus helemaal niet uitgevoerd

In sommige gevallen stopt de gehele synchronisatiecyclus met werken, in plaats van dat er één enkele stap mislukt. Er verschijnt niets nieuws in het venster ‘Synchronisatiecyclus’, de knop ‘Synchronisatie starten’ kan grijs zijn, en eADM zelf geeft geen foutmelding weer, omdat het probleem ligt bij de geplande taak op de server van de klant en niet bij eADM.

Stappen voor het oplossen van problemen

  1. Controleer de Taakplanner op de server waarop de lokale eADM-client draait. Controleer of de geplande synchronisatietaak (meestal met de naam \eAdm deltasynk) is aanwezig en is wel opgestart.

  2. Als de taak niet is gestart, probeer deze dan handmatig uit te voeren via de Taakplanner. Als dat het probleem niet oplost, start de server dan opnieuw op en probeer het nogmaals.

  3. Controleer de Gebeurtenisviewer op dezelfde server op fouten die zijn vastgelegd rond het tijdstip waarop de synchronisatie is gestopt.

  4. Als het lokale eADM-serviceaccount in Visma Enterprise (VEP) is uitgeschakeld of geblokkeerd, mislukt het ophalen van gegevens uit VEP doorgaans met een foutmelding wegens onbevoegdheid, in plaats van dat de geplande taak niet van start gaat. Controleer de accountstatus in Visma Enterprise als dit type foutmelding verschijnt.

Bekende oorzaak: het wachtwoord van het lokale serviceaccount is verlopen

Een veelvoorkomende oorzaak waarom de geplande taak niet van start gaat, is een verlopen Windows-wachtwoord voor het lokale serviceaccount dat wordt gebruikt om de taak uit te voeren (bijvoorbeeld DOMAIN\eadmservice1).

Opmerking: Taakplanner registreert een gebeurtenis die er ongeveer zo uitziet: Task Scheduler failed to start "\eAdm deltasynk" task for user "DOMAIN\serviceaccount". Additional Data: Error Value: 2147943730. Deze foutmelding duidt erop dat het wachtwoord van het account waarop de taak wordt uitgevoerd, is verlopen of ongeldig is.

Om dit op te lossen:

  1. Controleer de status van de rekening, bijvoorbeeld met Get-ADUser -Identity serviceaccount -Properties PasswordExpired,Enabled,LockedOut, en controleer of PasswordExpired is True.

  2. Stel het wachtwoord van het serviceaccount opnieuw in en werk de inloggegevens bij die zijn opgeslagen in de taak van de Taakplanner.

  3. Start de geplande taak opnieuw en controleer of deze met het resultaat wordt voltooid 0. De synchronisatie wordt vanaf dat punt automatisch hervat.


Veelvoorkomende foutmeldingen in de verschillende stappen

Sommige foutmeldingen kunnen bij elke synchronisatiestap verschijnen waarbij gegevens worden opgehaald uit of verzonden naar een extern bron- of doelsysteem, en zijn dus niet specifiek voor één bepaalde stap.

Foutmelding: The remote server returned an unexpected response: (502) Bad Gateway.

Dit betekent dat de server van het bron- of doelsysteem niet bereikbaar is en dat eAdm geen verbinding ermee kan maken.

Gebruikers met eADM-toegang op het niveau van partnerbeheerder of hoger kunnen de synchronisatie resetten en het opnieuw proberen zodra het probleem aan de kant van de leverancier is opgelost.

Opmerking: Dit kan doorgaans gebeuren wanneer eAdm probeert gegevens op te halen of te verzenden tijdens de onderhoudsperiodes van de systeemleverancier.


Beschadigd of onvolledig importbestand

Sommige bronsystemen, zoals ERP Kommune / Unit4 / Agresso, genereren een stamgegevensbestand (een „stamdatafil”) dat in een aparte stap naar eADM wordt overgebracht voordat de import wordt uitgevoerd. Dit generatieproces kan soms halverwege mislukken, waardoor er een onvolledig of beschadigd bestand naar eADM wordt overgebracht in plaats van een volledig bestand.

Hoe herken je dit?

Een import die is gestopt vanwege een beschadigd of onvolledig bestand, wordt op de pagina ‘Synchronisatiestatus’ weergegeven met een foutmelding die verwijst naar een probleem met het parseren of de bestandsstructuur, en niet naar een veiligheidsdrempel. Bijvoorbeeld:

Gestopt! Er is een fout opgetreden tijdens het opbouwen van de hiërarchie: er is een onverwacht einde van het bestand opgetreden tijdens het parseren van de naam. Regel 146106, positie 42.

De specifieke regel, positie en veldnaam (in dit geval, Name) zal van geval tot geval verschillen, maar het patroon — een onverwacht einde van het bestand of een soortgelijke parseerfout, in plaats van een melding over een veiligheidsdrempel — geeft aan dat het bronbestand zelf onvolledig is, en niet dat het filter ingrepen heeft.

Hoe dit op te lossen

  1. Neem contact op met uw ERP Kommune / Unit4 / Agresso-beheerder en vraag hem of haar om de export van de stamgegevens opnieuw uit te voeren en vervolgens te controleren of deze succesvol is voltooid.

  2. Zodra er een volledig bestand is gegenereerd en overgedragen, kunt u de synchronisatie opnieuw starten via de statuspagina.

  3. Als de fout zich blijft voordoen nadat een bestand waarvan de volledige overdracht is bevestigd, is overgedragen, neem dan contact op met de klantenservice van Identum voor nader onderzoek.

Laatst bijgewerkt: