OIIdentity en access management
ADP iHCM One Identity koppeling: ADP iHCM als HR-bron voor One Identity Manager
Een koppeling tussen ADP iHCM en One Identity Manager zet medewerkers, afdelingen en leidinggevenden uit iHCM klaar in vaste bestanden, die de CSV-connector van One Identity Manager inleest als Person en Department. One Identity heeft geen connector voor iHCM; KoppelHet leest iHCM via de Worker API van ADP en houdt vertrekdatums en herindiensttredingen in het bestand bij.
Wat de koppeling doet
Organisaties die salaris en HR in meerdere Europese landen met ADP iHCM regelen en One Identity Manager voor accounts en rechten, krijgen nieuwe collega's vaak via een export van ADP binnen. Die export bevat alleen wie op dat moment in dienst is, zodat One Identity Manager een vertrekker niet ziet vertrekken maar alleen ziet verdwijnen.
- ADP voegt de Worker API en de meldingen voor KoppelHet toe aan de applicatieregistratie van jullie iHCM-omgeving.
- KoppelHet leest alle medewerkers in delen van honderd en verwerkt daarna de meldingen over in- en uitdiensttreding en werktoewijzing.
- KoppelHet zet een medewerker- en een afdelingsbestand klaar op een map die de synchronisatieserver van One Identity Manager leest.
- One Identity Manager leest eerst de afdelingen en daarna de medewerkers met de CSV-connector.
- KoppelHet controleert elke set bestanden voordat de synchronisatie start en meldt ontbrekende velden.
Waar je op let bij ADP iHCM en One Identity
- One Identity Manager heeft via Starling Connect HR-connectoren voor onder meer Workday, SuccessFactors en Dayforce, maar niet voor ADP iHCM. De CSV-connector zit standaard in One Identity Manager en vraagt geen extra abonnement. Daarom levert KoppelHet de iHCM-gegevens als bestand aan, in een vorm die vastligt in het synchronisatieproject.
- Niet elke medewerker in iHCM heeft een associateOID, zegt ADP zelf; dan is het workerID de manier om iemand op te vragen. KoppelHet gebruikt het workerID als sleutelkolom voor One Identity Manager, zodat geen medewerker zonder sleutel in het bestand komt en de CSV-connector nooit hoeft te kiezen tussen dubbele regels.
- Filteren op werktoewijzing ondersteunt de Worker API van iHCM niet. Een selectie op land of entiteit kan KoppelHet dus niet bij ADP vragen, maar maakt hem na het ophalen. Alleen medewerkers van de landen die in One Identity Manager horen, komen in het bestand.
- Een herindiensttreding meldt ADP met dezelfde melding als een nieuwe medewerker. Omdat het workerID gelijk blijft, staat de terugkerende collega in het bestand onder dezelfde sleutel met een nieuwe datum in dienst. One Identity Manager pakt dan de bestaande Person weer op in plaats van een tweede aan te maken.
- Voor een gewijzigde vertrekdatum heeft iHCM geen eigen melding; ADP stuurt de vertrekmelding opnieuw als datum of reden verandert. KoppelHet leest bij elke vertrekmelding de actuele datum, zodat ExitDate in het bestand verschuift en One Identity Manager rechten op de juiste dag intrekt.
- In iHCM kan een medewerker zowel een 'Reports to' als een supervisor hebben. ADP stuurt verlofaanvragen naar 'Reports to'; de supervisor is alleen ter registratie. KoppelHet zet 'Reports to' in de managerkolom, zodat attestaties in One Identity Manager bij dezelfde persoon uitkomen als de verlofaanvragen.
- Omdat de bestanden van een andere bron komen, draait de synchronisatie in One Identity Manager als data-import, en dan kan een ontbrekende medewerker niet als openstaand worden gemarkeerd. KoppelHet haalt vertrekkers daarom niet uit het bestand maar laat ze staan met hun ExitDate, tot na de termijn die jullie voor accounts aanhouden.
Deze koppeling hoort ook bij in-, door- en uitstroom.
Hoe we het bouwen en beheren
- De koppeling draait op het KoppelHet platform, gehost in een datacenter in de EU.
- Elke synchronisatie en elke fout is zichtbaar in de functionele logging; bij een fout krijgt jullie beheerder een melding.
- Een mutatie die niet door kan, wordt niet half doorgezet maar klaargezet om opnieuw te proberen.
- KoppelHet is ISO 27001-gecertificeerd. Gegevens gaan versleuteld over en blijven niet langer op het platform dan nodig.
- Na livegang beheren wij de koppeling en passen we hem aan als jullie proces verandert.
- De koppeling past naast je bestaande integratielaag. Alleen de velden uit het ontwerp gaan over; het platform houdt geen eigen registratie bij.
Implementatie en prijs
Dit is geen app die je aanzet. We bouwen de koppeling voor jullie organisatie op ons platform, met bouwstenen die we steeds opnieuw gebruiken. Zo is het maatwerk, zonder dat we bij nul beginnen.
Een consultant bereidt de intake voor en analyseert beide systemen. Daarna leggen we de mapping en uitzonderingen per veld vast, testen we in de test- of acceptatieomgeving en gaan we live op een moment dat jij kiest. De kosten bestaan uit een eenmalig bedrag voor de inrichting en een maandbedrag voor platform, monitoring en beheer.
Veelgestelde vragen
Wat moet ADP doen?
ADP voegt de Worker API en de meldingen toe aan de applicatieregistratie van jullie omgeving. Zonder die stap geeft de API geen gegevens.
Technische details voor IT
Voor wie wil weten hoe het onder de motorkap werkt: gebruikte API's, velden en bronnen.
- ADP iHCM via de Worker Management API: GET /hr/v2/workers met $skip en $top (maximaal 100, daarboven een fout; einde bij een lege workers-lijst of 204), per persoon op associateOID of workerID; geen filters op WorkAssignment. Meldingen worker.hire (ook bij terugkeer), worker.terminate (ook bij gewijzigde datum of reden; worker.workerTerminationDate.change niet ondersteund), worker.legalName.change, worker.businessCommunication.email.change en worker.workAssignment.modify. API's en meldingen pas na toevoeging in de Consumer Application Registry (CAR).
- One Identity Manager CSV-connector: systeemverbinding met een medewerker- en een afdelingsbestand, UTF-8 met kopregel en tekstbegrenzers, sleutelkolom per bestand, Hierarchical sort order op het afdelingspad, Uniqueness violation behavior op Throw error, Read-only access, synchronisatiestap als Data import (geen MarkAsOutstanding), zo nodig via een remote connection server.
Welke velden overgaan
De belangrijkste velden. De volledige mapping stellen we per klant vast.
| Veld in ADP iHCM | Veld in One Identity | Toelichting |
|---|---|---|
workerID (Employee Reference Number) | Sleutelkolom PersonnelNumber | Ook als een medewerker geen associateOID heeft |
legalName (voornaam, achternaam) | FirstName, LastName | |
workAssignments.jobTitle | Kolom functie | |
homeOrganizationalUnits | Afdelingspad (hiërarchische sortering) | |
reportsTo ('Reports to') | Kolom manager (PersonnelNumber) | |
homeWorkLocation.address.countryCode | Kolom land | |
workerDates (hire, termination) | EntryDate, ExitDate | Altijd JJJJ-MM-DD |
businessCommunication.email | Kolom zakelijk e-mailadres |
Gerelateerd
ADP iHCM → Active Directory
ADP iHCM Active Directory koppeling: netwerkaccounts per land, met vervaldatum bij tijdelijke contracten
ADP iHCM → Coupa
ADP iHCM Coupa koppeling: goedgekeurde onkosten uit Coupa als variabel looncomponent in ADP iHCM NL
DyADP iHCM → Dyflexis
ADP iHCM Dyflexis koppeling: medewerkers en contracten in de planning, uren terug naar ADP
ADP iHCM → Microsoft Entra ID
ADP iHCM Entra ID koppeling: accounts uit de ADP-payroll, in elk Europees land met de juiste licentie