> Continue verbetering > Hire to retire Medewerkerscyclus > UKG Pro > datatemplate

Je Hire-to-retire - Levenscyclus van Medewerkers-datatemplate

UKG Pro

Hire-to-retire - Medewerkerscyclus Attributen (21) Hire-to-retire - Medewerkerscyclus Activiteiten (15) Extractiegidsen (1)

Je Hire-to-retire - Levenscyclus van Medewerkers-datatemplate

Dit template geeft een helder overzicht van de belangrijkste data-elementen die nodig zijn om je Hire-to-retire-proces effectief te analyseren. Het beschrijft de belangrijke attributen die moeten worden verzameld, de belangrijkste activiteiten die moeten worden bijgehouden en praktische begeleiding bij het extraheren van deze data uit UKG Pro. Gebruik dit hulpmiddel om je datavoorbereiding te vereenvoudigen en een goede start te garanderen voor je process mining-traject.

Aanbevolen attributen om vast te leggen
Belangrijkste activiteiten om te volgen
Extractiehandleiding voor UKG Pro

Nieuw met event logs? Leer hoe je een process mining event log creëert.

Template downloaden

Hire-to-retire - Medewerkerscyclus Attributen

Dit zijn de aanbevolen velden voor je event log, belangrijk voor gedetailleerde analyse en inzichten van de Hire to Retire-levenscyclus.

5 Verplicht 7 Aanbevolen 9 Optioneel

	Naam	Omschrijving
	Tijdstempel EventTimestamp	De exacte datum en tijd waarop een specifiek levenscyclus-gebeurtenis plaatsvond.
Omschrijving De Event Timestamp biedt de chronologische context voor elke activiteit en vormt de basis van de processtroom. Het registreert het exacte moment dat een gebeurtenis zoals 'Aanbod geaccepteerd' of 'Promotie goedgekeurd' in het systeem werd geregistreerd. In analyse worden deze tijdstempels gebruikt om doorlooptijden tussen activiteiten te berekenen, vertragingen te vinden en de doorlooptijden te meten voor belangrijke subprocessen zoals werving en inwerken. Nauwkeurige tijdstempels zijn belangrijk voor alle tijdgebonden KPI's en prestatieanalyse. Het belang Dit attribuut is belangrijk voor het chronologisch ordenen van gebeurtenissen en het berekenen van alle tijdsgebonden meetwaarden, zoals doorlooptijden en duurs. Vindplaats Afkomstig van datum- of timestamp-velden gekoppeld aan specifieke gebeurtenissen in UKG Pro, zoals 'HireDate', 'BeëindigingDate', of tijdstempels voor statuswijzigingen in workflow modules. Voorbeelden 2023-01-15T09:00:00Z2023-06-20T14:35:10Z2024-02-01T11:00:00Z
	Werknemer-ID EmployeeId	Het unieke ID die aan elke medewerker is toegewezen, dienend als de primaire case ID voor hun gehele levenscyclus binnen de organisatie.
Omschrijving De Medewerker ID is de belangrijkste link die alle gebeurtenissen van een medewerker met elkaar verbindt, van de eerste sollicitatie tot de uiteindelijke uitdiensttreding. Deze ID is belangrijk voor het construeren van een compleet end-to-end procesbeeld van de loopbaan van een individu. In process mining-analyse wordt elke activiteit, zoals 'Medewerker Aangenomen', 'Promotie Goedgekeurd' of 'Uitdiensttreding Gestart', gekoppeld aan deze unieke ID. Dit maakt de analyse van individuele medewerkerstrajecten, cohortanalyse op basis van medewerker-attributen en de precieze berekening van de doorlooptijden van de levenscyclus mogelijk. Het belang Dit is de essentiële case kenmerk die alle medewerkergerelateerde gebeurtenissen met elkaar verbindt, waardoor het mogelijk wordt om het end-to-end Hire-to-retire-proces voor elk individu te analyseren. Vindplaats Dit is een kernveld in UKG Pro, doorgaans te vinden in werknemersprofielen of stamgegevenss. Raadpleeg de UKG Pro-documentatie voor de specifieke tabel- en veldnaam, vaak gelabeld als Employee Number of Person ID. Voorbeelden 10052198345210047
	Activiteitsnaam ActivityName	De naam van het specifieke gebeurtenis of de mijlpaal die plaatsvond in de levenscyclus van de medewerker, zoals 'Medewerker Aangenomen' of 'Prestatiebeoordeling Uitgevoerd'.
Omschrijving De Activiteitsnaam beschrijft een enkele stap of taak binnen het Van Aanstelling tot Uitdiensttreding-proces. Deze gebeurtenissen zijn voorzien van een timestamp en chronologisch geordend om de processtroom op te bouwen die in process mining wordt gevisualiseerd en geanalyseerd. Het analyseren van de volgorde en frequentie van deze activiteiten onthult de feitelijke procesuitvoering. Het helpt bij het vinden van veelvoorkomende paden, afwijkingen van het standaardproces en knelpunten tussen belangrijke activiteiten zoals 'Inwerkproces gestart' en 'Salarisadministratie voltooid'. Het belang Dit attribuut definieert de stappen in de proceskaart, waardoor de visualisatie en analyse van de werknemerslevenscyclusstroom mogelijk worden. Vindplaats Dit is meestal gebaseerd op event logs, workflow statuswijzigingen of specifieke datumvelden binnen diverse UKG Pro-modules (bijv. Recruiting, Onboarding, Performance Management). Er is doorgaans mapping-logica vereist om gestandaardiseerde activiteitsnamen te genereren. Voorbeelden Werknemer aangenomenFunctieeringsgesprek uitgevoerdBeëindiging Geïnitieerd
	Bronsysteem SourceSystem	Identificeert het systeem waaruit de data is opgehaald, wat in dit geval UKG Pro is.
Omschrijving Dit attribuut specificeert de oorsprong van de procesdata. Hoewel het in deze context voornamelijk UKG Pro betreft, kan een Van Aanname tot Uitdiensttreding-procesdata van andere systemen omvatten, zoals een Applicant Tracking System (ATS) of een learning management system (LMS). In analyse helpt het databronnen te differentiëren als meerdere systemen betrokken zijn en is het belangrijk voor data governance en probleemoplossing. Voor een centraal overzicht biedt het essentiële context over de oorsprong van de data. Het belang Biedt belangrijke context voor data governance, kwaliteitsbewaking en traceerbaarheid door de oorsprong van de gebeurtenis data te vinden. Vindplaats Dit is doorgaans een statische waarde ('UKG Pro') die wordt toegevoegd tijdens het datatransformatie- en extractieproces. Voorbeelden UKG ProUKGPro_CoreHRUKG
	Tijdstip van extractie LastDataUpdate	De timestamp die aangeeft wanneer de data voor dit gebeurtenis voor het laatst is vernieuwd of opgehaald uit het bronsysteem.
Omschrijving Dit attribuut geeft de timestamp van de laatste data-extractie uit UKG Pro. Het is niet het moment waarop de business gebeurtenis plaatsvond, maar eerder wanneer de record in de process mining-tool werd geladen. Deze Informatie is belangrijk voor het begrijpen van hoe actueel de geanalyseerde data is. Het stelt analysesten en zakelijke gebruikers in staat om te weten hoe actueel de procesweergave is en helpt bij het beheren van verversingsschema's en het bevestigen van de relevantie van inzichten. Het belang Geeft de relevantie van de data aan, wat belangrijk is voor het vertrouwen in de analyse en het nemen van tijdige zakelijke beslissingen. Vindplaats Deze timestamp wordt gegenereerd en toegevoegd aan elk record tijdens het data-extractie-, transformatie- en laadproces (ETL). Voorbeelden 2024-03-15T02:00:00Z2024-03-16T02:00:00Z2024-03-17T02:00:00Z
	Afdeling EmployeeDepartment	De afdeling of onderdeel waaraan de medewerker is toegewezen.
Omschrijving Dit attribuut bevat de naam van de afdeling waaraan de medewerker is toegewezen, zoals 'Sales', 'Engineering' of 'Finance'. Het is een belangrijke organisatorische dimensie voor het segmenteren en vergelijken van procesprestaties. Analyse op basis van de afdeling maakt het mogelijk om de procesuitvoering tussen verschillende bedrijfsonderdelen te vergelijken. Zo kan men analyseren of de Recruitment Cycle Time langer is voor technische afdelingen, of dat de Performance Review Adherence significant verschilt tussen Sales en Operations, wat gerichte inzichten voor verbetering oplevert. Het belang Maakt krachtige vergelijkende analyse mogelijk doordat je het proces kunt filteren en segmenteren op basis van de organisatiestructuur, waardoor afdelingsvariaties worden onthuld. Vindplaats Dit is een standaard veld in het baan- of funcpakketecord van de medewerker binnen de Core HR-module van UKG Pro. Voorbeelden EngineeringVerkoopPersoneelszaken
	Datum indiensttreding HireDate	De officiële startdatum van het dienstverband van een medewerker bij de organisatie.
Omschrijving De Indiensttredingsdatum markeert het begin van het dienstverband van de medewerker. Het is een fundamenteel datumveld dat dient als basislijn voor vele tijdgebonden berekeningen en analyses gerelateerd aan de levenscyclus van de medewerker. Dit attribuut wordt gebruikt om de dienstverbandduur van medewerkers te berekenen, wat belangrijk is voor het analyseren van het 'percentage vroegtijdig verloop'. Het helpt ook bij cohortanalyse, waardoor de vergelijking van levenscycluspatronen voor medewerkers die in verschillende periodes zijn aangenomen mogelijk worden. Het belang Dient als basislijn voor het berekenen van werknemersanciënniteit en is belangrijk voor cohortanalyse en KPI's voor verloop. Vindplaats Dit is een standaard, verplicht veld in het primaire record van de medewerker in de Core HR-module van UKG Pro. Voorbeelden 2022-08-152023-01-202021-05-10
	Dienstverbandstatus EmploymentStatus	De huidige of historische arbeidsstatus van de medewerker, zoals 'Actief', 'Uit dienst' of 'Met verlof'.
Omschrijving Dit attribuut geeft de officiële status van de medewerker binnen het bedrijf aan op een bepaald moment. Het is een kritische dimensie voor het begrijpen van de algehele staat van het team en voor het filteren van analyses op specifieke medewerkerspopulaties. Het analyseren van veranderingen in de dienstverbandstatus helpt om het proces correct te modelleren, bijvoorbeeld door onderscheid te maken tussen tijdelijk verlof en een permanente beëindiging. Het is onmisbaar voor het berekenen van verlooppercentages en het begrijpen van de uitkomsten van verschillende levenscycluspaden. Het belang Biedt essentiële context over de status van een werknemer, wat een nauwkeurige churn-analyse en segmentatie van het team mogelijk maakt. Vindplaats Dit is een belangrijk veld in het stamrecord van de medewerker in de Core HR-module van UKG Pro. Voorbeelden ActiefBeëindigdVerlof
	Functietitel JobTitle	De officiële functietitel van de medewerker, zoals 'Software Engineer' of 'Sales Manager'.
Omschrijving De Functietitel beschrijft de rol of positie van de medewerker binnen de organisatie. Dit attribuut is een belangrijke dimensie voor het analyseren hoe processen verschillen tussen diverse rollen en senioriteitsniveaus. In analyse kan de Functietitel worden gebruikt om inwerktijden voor verschillende rollen te vergelijken, promotiesnelheden te beoordelen, of te vinden of bepaalde functietitels hogere percentages van vroegtijdig verloop hebben. Dit helpt bij het aanpassen van HR-processen en ondersteuningsprogramma's aan de specifieke behoeften van verschillende medewerkersgroepen. Het belang Maakt rolgebaseerde analyse mogelijk om te begrijpen hoe levenscyclusprocessen variëren tussen verschillende functieprofielen en senioriteitsniveaus. Vindplaats Dit is een standaard veld gekoppeld aan het functie- of baanrecord van de medewerker in de Core HR-module van UKG Pro. Voorbeelden Software Engineer IISenior ProductmanagerHR Business Partner
	Naam Manager ManagerName	De naam van de directe leidinggevende of supervisor van de medewerker.
Omschrijving Dit attribuut identificeert de directe manager van de medewerker. De manager speelt een belangrijke rol in veel levenscyclusgebeurtenissen, inclusief functioneringsgesprekken, promoties en trainingstoewijzingen. Analyse per manager helpt om variaties in uitvoering op teamniveau en manager effectiviteit te begrijpen. Het Manager Transition Impact Analysis dashboard is bijvoorbeeld afhankelijk van dit attribuut om te zien hoe een verandering van manager de daaropvolgende activiteiten beïnvloedt. Het is ook belangrijk voor de Time to Managerial Re-betrokkenheid KPI. Het belang Maakt analyse van procesprestaties op teamniveau mogelijk en helpt bij het beoordelen van de impact van managers op werknemerslevenscyclusgebeurtenissen. Vindplaats Deze Informatie maakt deel uit van de gegevens over de rapportagestructuur van de medewerker in de Core HR-module van UKG Pro. Voorbeelden John SmithMaria GarciaChen Wei
	Uitvoerende gebruiker ActioningUser	De naam of ID van de gebruiker, doorgaans een HR-vertegenwoordiger of manager, die de activiteit uitvoerde in UKG Pro.
Omschrijving Dit attribuut identificeert de persoon die verantwoordelijk is voor de uitvoering van een specifieke processtap, zoals de recruiter die een aanbod deed of de manager die een promotie goedkeurde. Het koppelt procesactiviteiten aan menselijke actoren. In analyse is dit attribuut zeer waardevol voor het begrijpen van de werkdrukverdeling, het vinden van trainingsbehoeften en het analyseren van gebruikersspecifieke prestaties. Het kan bijvoorbeeld helpen bepalen of data-entry-fouten na Payroll Setup Completed geconcentreerd zijn bij specifieke gebruikers, ter ondersteuning van de Post-Onboarding Data Rework Rate KPI. Het belang Koppelt procesactiviteiten aan specifieke gebruikers, wat workloadanalyse, prestatievergelijkingen en het onderzoeken van herstelwerk of fouten mogelijk maakt. Vindplaats Doorgaans te vinden in audit trail logs of velden 'Laatst gewijzigd door' binnen UKG Pro-modules. De exacte veldnaam varieert per module. Voorbeelden j.does.smithhr_admin
	Vacatureaanvraag-ID JobRequisitionId	De unieke ID voor de vacatureaanvraag die het aannameproces initieerde.
Omschrijving De Vacatureaanvraag ID is de unieke referentie voor een specifieke vacature. Het koppelt alle vroegtijdige wervingsactiviteiten, van creatie en goedkeuring tot het werven van kandidaten en het doen van aanbiedingen. Deze ID is belangrijk voor het analyseren van de 'Wervingsdoorlooptijd' KPI, aangezien het de werkelijke start van het wervingsproces markeert. Het maakt het mogelijk om het hele wervingstraject voor een enkele vacature te volgen en meetwaarden zoals het 'Percentage Inactieve Vacatureaanvragen' te analyseren door aanvragen te vinden die niet vorderen. Het belang Biedt een duidelijk startpunt voor het wervingsproces, en maakt een nauwkeurige meting van de doorlooptijden voor aanname en de effectiviteit van aanvragen mogelijk. Vindplaats Gevonden binnen de UKG Pro Recruiting-module of het gekoppelde Applicant Tracking System (ATS). Voorbeelden REQ-2023-015REQ-2024-112REQ-2023-504
	Eindtijd van het gebeurtenis EventEndTime	De timestamp die de voltooiing markeert van een activiteit met een meetbare duur.
Omschrijving Voor activiteiten die niet direct zijn, registreert de Event End Time wanneer de activiteit werd voltooid. Dit contrasteert met de Event Timestamp (Starttijd), die het begin markeert. Het hebben van zowel een start- als eindtijd maakt de precieze berekening mogelijk van de verwerkingstijd voor individuele activiteiten, zoals 'Achtergrondcheck' of 'Onboardingtaak'. Dit ondersteunt een gedetailleerdere analyse van waar tijd wordt besteed binnen het proces. Het belang Maakt de berekening van precieze verwerkingstijden mogelijk voor individuele activiteiten, en helpt zo bij het vinden van de meest tijdrovende stappen in het proces. Vindplaats Afkomstig van datumvelden voor voltooiing in UKG Pro. Dit vereist vaak het koppelen van een start gebeurtenis aan een overeenkomstig voltooiingsgebeurtenis van de brondata. Voorbeelden 2023-01-15T17:30:00Z2023-06-21T10:00:00Z2024-02-01T11:05:00Z
	Is Vroege Uitval IsEarlyChurn	Een booleaanse indicator die aangeeft of de beëindiging van het dienstverband van een medewerker plaatsvond binnen een vooraf gedefinieerde vroege dienstverbandperiode, zoals 90 of 180 dagen.
Omschrijving Dit berekende attribuut markeert medewerkers die de organisatie kort na indiensttreding verlaten. De drempelwaarde voor 'vroegtijdig' wordt doorgaans door de business gedefinieerd, bijvoorbeeld binnen het eerste jaar. Deze vlag vereenvoudigt de analyse die nodig is voor het Early Tenure Churn Insights dashboard en de Early Employee Churn Rate KPI. Het maakt snelle filtering en segmentatie mogelijk om deze belangrijke groep te isoleren en hun karakteristieken en levenscycluspatronen te analyseren, wat helpt bij het vinden van problemen in recruitment of onboarding. Het belang Ondersteunt direct vroege verloopanalyse door risicovolle cases te markeren, en helpt zo bij het vinden van grondoorzaken van voortijdig vertrek van medewerkers. Vindplaats Dit attribuut wordt berekend tijdens de databewerking. De logica vergelijkt het verschil tussen de BeëindigingDate en HireDate met een vooraf gedefinieerde drempelwaarde (bijv. 365 dagen). Voorbeelden truefalse
	Locatie Location	De geografische locatie of het kantoor waar de werknemer werkzaam is.
Omschrijving Dit attribuut specificeert de primaire werklocatie van de medewerker, wat een stad, land of specifiek kantoorgebouw kan zijn. Het is een belangrijke dimensie voor geografische analyse van HR-processen. Het analyseren van procesprestaties per locatie kan regionale verschillen in aanwervingsefficiëntie, onboardingpraktijken of verlooppercentages inzichtelijk maken. Zo kun je de Recruitment Cycle Time vergelijken tussen de kantoren in 'New York' en 'Londen' om best practices of lokale knelpunten te vinden. Het belang Maakt geografische segmentatie van het proces mogelijk, waardoor regionale variaties in prestaties en compliance worden onthuld. Vindplaats Deze Informatie maakt deel uit van de functie- of persoonsgegevens van de medewerker in de Core HR-module van UKG Pro. Voorbeelden New York, NYLonden, VKOp afstand
	Prestatiebeoordeling PerformanceRating	De beoordeling die aan een medewerker is toegewezen tijdens een prestatiebeoordelingscyclus.
Omschrijving De Prestatiebeoordeling is het resultaat van een 'Prestatiebeoordeling Uitgevoerd'-activiteit, doorgaans op een schaal (bijv. 1-5) of met beschrijvende labels (bijv. 'Voldoet ruimschoots aan verwachtingen'). Het kwantificeert de prestatiebeoordeling van een medewerker. Dit attribuut is waardevol voor het correleren van procesgebeurtenissen met prestapakketesultaten. Analyse kan bijvoorbeeld onderzoeken of hoog presterende medewerkers sneller worden gepromoveerd, of dat er een verband is tussen prestatiebeoordelingen en medewerkerverloop. Het staat centraal in het 'Compliance Prestatiebeoordelingscyclus' dashboard. Het belang Koppelt procesgebeurtenissen aan prestapakketesultaten, waardoor de analyse van de effectiviteit van talentmanagement en de impact ervan op retentie mogelijk worden. Vindplaats Gevonden binnen de UKG Pro Performance Management-module, gekoppeld aan specifieke beoordelingscycli. Voorbeelden Overtreft verwachtingenVoldoet aan de verwachtingenVerplicht verbetering5
	Reden Rolwijziging RoleChangeReason	De reden voor een wijziging in de rol van een medewerker, zoals 'Promotie', 'Horizontale overplaatsing' of 'Reorganisatie'.
Omschrijving Dit attribuut biedt context voor interne mobiliteitsgebeurtenissen. Het verklaart waarom de rol of positie van een medewerker binnen de organisatie is gewijzigd. Dit is belangrijk voor het Internal Mobility Cycle Time dashboard en de KPI, aangezien het onderscheid maakt tussen promoties en andere soorten transfers. Het analyseren van het proces op basis van reden kan aantonen of promotieprocessen trager zijn dan laterale verplaatsingen, wat helpt bij het vereenvoudigen van loopbaanontwikkelingspaden. Het belang Verklaart de context achter interne bewegingen, en maakt zo een genuanceerde analyse mogelijk van interne mobiliteitsprocessen zoals promoties versus horizontale overplaatsingen. Vindplaats Deze Informatie wordt doorgaans vastgelegd als onderdeel van de transactie voor functiewijziging of overplaatsing in de Core HR-module van UKG Pro. Voorbeelden PromotieLaterale OverplaatsingReorganisatie
	Reden van Beëindiging TerminationReason	De gedocumenteerde reden voor de uitdiensttreding van een medewerker, zoals 'Vrijwillig - Ontslagname' of 'Onvrijwillig - Prestaties'.
Omschrijving Dit attribuut legt de reden vast waarom het dienstverband van een medewerker is beëindigd. De redenen worden doorgaans gecategoriseerd als vrijwillig of onvrijwillig, met specifiekere subcategorieën. Dit is een onmisbaar attribuut voor retentie- en churn-analyse. Door beëindigde medewerkers te segmenteren op basis van hun vertrekreden, kunnen organisaties diepgaand inzicht verkrijgen in de grondoorzaken van verloop. Zo kan het analyseren van de Early Employee Churn Rate per beëindigingsreden onderscheid maken tussen slechte aanstellingskeuzes en concurrerende aanbiedingen. Het belang Biedt belangrijk inzicht in de drijfveren van personeelsverloop, waardoor gerichte retentiestrategieën mogelijk worden. Vindplaats Dit veld wordt doorgaans vastgelegd tijdens het beëindigings- of offboarding-proces binnen de Core HR-module van UKG Pro. Voorbeelden Vrijwillig - Een andere kansOnvrijwillig - PrestatiesPensioen
	Salary Grade SalaryGrade	De salarisschaal of salarisband die hoort bij de functie van de werknemer.
Omschrijving Salarisschaal vertegenwoordigt het compensatieniveau voor een bepaalde functie. Het is een belangrijk attribuut voor het analyseren van compensatiegerelateerde activiteiten en trends. Dit attribuut is belangrijk voor analyses zoals Compensatie Gewijzigd gebeurtenissen en kan worden gebruikt om de 'Post-Onboarding Data Rework Rate' KPI te volgen als frequente correcties aan salarisschalen worden waargenomen. Het maakt ook segmentatie mogelijk om te zien of doorlooptijden van promoties of verlooppercentages verschillen per compensatieniveau. Het belang Biedt context voor salarisgerelateerde activiteiten en maakt segmentatie van het proces per salarisniveau mogelijk. Vindplaats Beschikbaar in het salaris- of functieprofiel van de medewerker binnen de Core HR-module van UKG Pro. Voorbeelden IC3M2D1
	Trainingsnaam TrainingName	De naam of titel van de training die aan de medewerker is toegewezen.
Omschrijving Dit attribuut identificeert een specifieke training of leermodule die aan een medewerker is toegewezen. Dit kan variëren van verplichte compliance training tot rolspecifieke vaardigheidsontwikkeling. Dit is een onmisbaar attribuut voor het Training Assignment & Completion dashboard en de Training Completion Rate KPI. Het maakt het mogelijk om de voortgang en effectiviteit van specifieke trainingsprogramma's te volgen en voltooiingstijden over verschillende cursussen te analyseren. Het belang Maakt het volgen en analyseren van specifieke trainingsprogramma's mogelijk, en helpt zo bij het meten van compliance en ontwikkelingseffectiviteit. Vindplaats Afkomstig van de UKG Pro Learning module of een gekoppeld Learning Management System (LMS). Voorbeelden Gedragscode 2024Geavanceerde ManagementvaardighedenCyberbeveiligingsbewustzijn
	Uitdiensttredingsdatum TerminationDate	De officiële einddatum van het dienstverband van een medewerker.
Omschrijving De Uitdiensttredingsdatum markeert de afsluiting van het dienstverband van de medewerker. Het is het eindpunt van de levenscyclus van de medewerker binnen de organisatie. Dit attribuut is noodzakelijk voor het berekenen van de uiteindelijke dienstverbandduur van een medewerker en is een belangrijk onderdeel van churn-analyse. De tijd tussen de Indiensttredingsdatum en Uitdiensttredingsdatum vormt de basis voor het 'Inzichten in Vroegtijdig Verloop van Dienstverband'-dashboard en gerelateerde KPI's. Het belang Definieert het einde van de werknemerslevenscyclus, waardoor de berekening van de totale dienstverbandduur mogelijk wordt en alle verloopanalyses worden ondersteund. Vindplaats Dit is een standaard veld in het primaire record van de medewerker in UKG Pro, dat wordt ingevuld wanneer het uitdiensttredingsproces is voltooid. Voorbeelden 2023-11-302024-02-152022-12-31

Verplicht Aanbevolen Optioneel

Hire-to-retire - Medewerkerscyclus Activiteiten

Dit zijn de belangrijkste processtappen en mijlpalen die je in je event log moet vastleggen voor accurate process discovery en optimalisatie.

6 Aanbevolen 9 Optioneel

	Activiteit	Omschrijving
	Beëindiging Geïnitieerd	Vertegenwoordigt de start van het offboardingproces, geregistreerd wanneer een toekomstige einddatum van het dienstverband wordt ingevoerd in het systeem. Dit gebeurtenis activeert offboarding checklists en workflows.
Het belang Dit is een kritieke mijlpaal die het uitdiensttredingsproces van medewerkers initieert. Het analyseren van de tijd tussen deze gebeurtenis en de uiteindelijke beëindiging helpt bij het ewaarderen van de efficiëntie en volledigheid van offboarding procedures. Vindplaats Dit is doorgaans de creatie van een actie 'Uitdiensttreding'-record in de functiegegevens van de medewerker, met een toekomstige ingangsdatum. Het kan ook de start zijn van een offboarding workflow in een specifieke module. Vastleggen Vastgelegd wanneer een beëindigingstransactie met een toekomstige datum wordt ingediend. Gebeurtenistype explicit
	Dienstverband beëindigd	Het laatste stap in het proces van de medewerker, dat het officiële einde van het dienstverband vertegenwoordigt. Dit is wanneer het medewerkersdossier in het systeem inactief wordt per de ingangsdatum van uitdiensttreding.
Het belang Dit is de definitieve eind-gebeurtenis voor het proces, belangrijk voor het berekenen van de uiteindelijke dienstverbandduur van de medewerker en het analyseren van personeelsverloop. Het rondt de cyclus van de medewerker binnen het bedrijf af. Vindplaats Dit is de ingangsdatum van de definitieve actie 'Uitdiensttreding' in de functiedatahistorie van de medewerker binnen de HR Core-module. Het systeem wijzigt de status van de medewerker doorgaans van actief naar inactief op deze datum. Vastleggen Vastgelegd vanaf de ingangsdatum van de 'Beëindiging'-actie in de arbeidsgeschiedenis van de medewerker. Gebeurtenistype explicit
	Functieeringsgesprek uitgevoerd	Vertegenwoordigt de voltooiing van een formele functioneringsgesprekcyclus voor een werknemer. Dit gebeurtenis wordt geregistreerd wanneer het beoordelingsformulier is afgerond en ingediend door de manager of HR.
Het belang Dit is een kritieke, terugkerende mijlpaal in de levenscyclus van de medewerker. Het bijhouden van de frequentie en tijdigheid helpt bij het beoordelen van de compliance van prestatiemanagement en de impact ervan op loopbaanontwikkeling. Vindplaats Gevonden in de UKG Pro Performance Management-module. Het kan worden geïdentificeerd aan de hand van de voltooiingsdatum van het prestatiebeoordelingsformulier of een statuswijziging naar 'Voltooid' voor een beoordelingscyclus. Vastleggen Vastgelegd vanaf de voltooiings-timestamp van de workflow-instantie van de prestatiebeoordeling. Gebeurtenistype explicit
	Promotie Goedgekeurd	Geeft de formele goedkeuring aan van een promotie van een werknemer, wat typisch een wijziging van de functieomschrijving en vaak compensatie omvat. Dit is een afzonderlijk gebeurtenis dat voorafgaat aan de ingangsdatum van de wijziging.
Het belang Deze activiteit is belangrijk voor het analyseren van interne mobiliteit en loopbaanontwikkeling. De tijd tussen goedkeuring van een promotie en de ingangsdatum kan administratieve knelpunten in het systeem inzichtelijk maken. Vindplaats Geregistreerd als een specifieke werkactie, zoals 'Promotie', in de werkdatahistorie van de werknemer binnen de HR Core module. De registratie heeft zijn eigen goedkeurings- en ingangsdata. Vastleggen Vastgelegd vanaf de logdatum van een 'Promotie'-actie in de arbeidsgeschiedenis van de medewerker. Gebeurtenistype explicit
	Werknemer aangenomen	Markeert de officiële aanmaak van de werknemersregistratie in UKG Pro, waarbij formeel een Employee ID wordt toegewezen. Dit gebeurtenis wordt doorgaans vastgelegd wanneer een HR-beheerder het wervingsproces voor een kandidaat afrondt, en de kandidaat hiermee overgaat in de status van actieve werknemer binnen het systeem.
Het belang Dit is de definitieve start-gebeurtenis voor de Hire-to-retire-procesanalyse. Het biedt de basislijn voor het meten van tijd tot productiviteit, onboarding-efficiëntie en de totale dienstverbandduur van medewerkers. Vindplaats Dit gebeurtenis wordt waarschijnlijk vastgelegd in de HR Core- of Personeelsadministratie-module. Het kan worden geïdentificeerd aan de hand van de aanmaakdatum van het primaire dienstverbandrecord van de medewerker of een specifiek Hire-acpakketecord in de job data history van de medewerker. Vastleggen Vastgelegd vanaf de ingangsdatum van de 'Aanwerving'-actie in de arbeidsgeschiedenistabel van de medewerker. Gebeurtenistype explicit
	Werknemer onboarding voltooid	Een belangrijke mijlpaal die de succesvolle afronding van de initiële onboarding-checklist of -workflow aangeeft. Dit betekent doorgaans dat alle vereiste documenten voor nieuwe medewerkers, aanvragen voor systeemtoegang en initiële administratieve taken zijn voltooid.
Het belang Markeert het einde van de initiële administratieve setup en maakt analyse van de totale inwerk cycletime mogelijk. Dit moment duidt aan dat de werknemer administratief klaar is om te beginnen met diens rolspecifieke taken. Vindplaats Bevindt zich in de Onboarding module. Dit wordt doorgaans afgeleid van de completion timestamp van de algehele onboarding-workflow of wanneer de laatste verplichte onboardingtaak als voltooid is gemarkeerd. Vastleggen Afgeleid uit de voltooiings-timestamp van de hoofd-onboardingchecklist voor de werknemer. Gebeurtenistype inferred
	Compensatie gewijzigd	Dit gebeurtenis legt elke wijziging vast in het basissalaris, de bonusstructuur of andere compensatiecomponenten van een medewerker. Het kan deel uitmaken van een promotie, een verdienstelijke verhoging of een marktaanpassing.
Het belang Het bijhouden van salariswijzigingen is belangrijk voor het begrijpen van loopbaan- en salarisontwikkeling. Frequente aanpassingen na indiensttreding kunnen duiden op data-invoerfouten of problemen met de initiële salarisbepaling. Vindplaats Gevonden in de tabel met compensatiehistorie binnen de HR Core of Payroll-module. Elke wijziging wordt doorgaans vastgelegd met een ingangsdatum en een redencode. Vastleggen Geregistreerd vanaf de ingangsdatum van een nieuwe invoer in de compensatiehistorie van de werknemer. Gebeurtenistype explicit
	Exit Interview afgenomen	Dit gebeurtenis markeert de voltooiing van het exit-gesprek met de vertrekkende medewerker. Het wordt doorgaans vastgelegd als een voltooide taak in een offboarding checklist.
Het belang Het bijhouden van de voltooiing van exitgesprekken is belangrijk voor het waarborgen van HR compliance en het verzamelen van waardevolle feedback. Het helpt te vinden of deze belangrijke stap wordt overgeslagen in het offboarding-proces. Vindplaats Dit gebeurtenis zou waarschijnlijk worden gevonden in de UKG Pro Onboarding- of HR Help Desk-module als een specifieke taak binnen een offboarding workflow. De vastlegging ervan hangt af van het handmatig markeren van de taak als voltooid door HR. Vastleggen Geregistreerd als een voltooide taak binnen de uitdiensttredingschecklist van een werknemer. Gebeurtenistype explicit
	Manager gewijzigd	Dit gebeurtenis wordt gegenereerd wanneer het Reports To- of Manager ID-veld voor een medewerker wordt bijgewerkt. Het vertegenwoordigt een wijziging in de directe rapportagelijn van de medewerker.
Het belang Managerwisselingen kunnen een aanzienlijke impact hebben op de betrokkenheid en prestaties van werknemers. Het bijhouden van dit gebeurtenis maakt analyse mogelijk van de impact ervan op daaropvolgende activiteiten zoals functioneringsgesprekken of retentie. Vindplaats Dit gebeurtenis moet worden afgeleid door wijzigingen in het manager- of supervisor-veld in de job data van de medewerker over tijd te volgen. Het vereist het vergelijken van de manager ID tussen opeenvolgende records voor dezelfde medewerker. Vastleggen Afgeleid door een wijziging te detecteren in het 'Rapporteert Aan'-veld in de functiegegevenshistorie van de werknemer. Gebeurtenistype inferred
	Onboarding gestart	Vertegenwoordigt de start van het onboardingproces voor nieuwe medewerkers of workflow binnen UKG Pro. Dit is typisch een geautomatiseerd of handmatig geactiveerd gebeurtenis dat een checklist met taken toewijst aan de nieuwe werknemer, hun manager en HR.
Het belang Het bijhouden van deze activiteit helpt bij het meten van de tijd tussen de officiële indiensttredingsdatum en de start van de administratieve en culturele integratie. Het is het startpunt voor het analyseren van de efficiëntie van het onboarding proces en het vinden van vertragingen. Vindplaats Gevonden in de UKG Pro Onboarding-module. Dit gebeurtenis kan worden afgeleid uit de aanmaakdatum van de onboarding-checklist of workflow-instantie die aan de werknemer is gekoppeld. Vastleggen Afgeleid uit de aanmaak-timestamp van de onboarding-workflow of takenlijst van de werknemer. Gebeurtenistype inferred
	Rolwijziging Verwerkt	Vertegenwoordigt een wijziging in de functie of positie van de werknemer die geen promotie is, zoals een horizontale overplaatsing of afdelingsoverplaatsing. Dit wordt geregistreerd wanneer de relevante functiedata wordt bijgewerkt in het systeem.
Het belang Het analyseren van functieveranderingen biedt inzicht in interne mobiliteit, inzet van talent en organisatorische herstructurering. Het helpt vinden hoe medewerkers zich door de organisatie bewegen. Vindplaats Vastgelegd vanuit de arbeidsdatageschiedenis van de medewerker in de HR Core-module. Dit kan worden geïdentificeerd aan de hand van acties zoals 'Overplaatsing', 'Herindeling' of 'Functiewijziging', samen met hun ingangsdata. Vastleggen Geïdentificeerd door een 'Overplaatsing' of vergelijkbare actiecode in de functiehistoriegegevens van de werknemer. Gebeurtenistype explicit
	Salaris-setup voltooid	Geeft aan dat alle benodigde Informatie voor de verwerking van het salaris van de werknemer, zoals bankgegevens en belastingformulieren, is ingevoerd en geverifieerd. Dit is een kritieke stap om ervoor te zorgen dat de werknemer correct en op tijd wordt betaald.
Het belang Deze mijlpaal is belangrijk voor het meten van de inzetbaarheid van nieuwe aanwervingen. Vertragingen in de salarisadministratie kunnen leiden tot ontevredenheid bij medewerkers en administratieve reworking, waardoor het een key prestaties indicator is voor onboarding. Vindplaats Dit gebeurtenis kan worden afgeleid uit de UKG Pro Payroll-module. Het kan worden afgeleid uit de voltooiingsdatum van een payroll readiness checklist of de datum waarop de status van de medewerker verandert naar 'Ready for Payroll'. Vastleggen Afgeleid van een statuswijziging of voltooiingstijdstempel in het salarisprofiel van de medewerker. Gebeurtenistype inferred
	Training toegewezen	Vastgelegd op het moment dat een specifieke training of leerplan aan een medewerker wordt toegewezen. Dit wordt gewoonlijk vastgelegd in de learning management-module van het systeem.
Het belang Deze activiteit helpt bij het volgen van naleving van verplichte trainingen en monitort de ontwikkeling van medewerkers. Het analyseren van de tijd tussen toewijzing en voltooiing kan problemen met betrokkenheid of de effectiviteit van trainingen inzichtelijk maken. Vindplaats Geregistreerd in de learning management of talent management modules van UKG Pro. Elke toewijzing moet een overeenkomstige registratie hebben met een toewijzingsdatum en employee ID. Vastleggen Geregistreerd wanneer een cursus of curriculum wordt toegewezen aan het leerplan van een werknemer. Gebeurtenistype explicit
	Uitdiensttreding voltooid	Een mijlpaal die aangeeft dat alle verplichte offboarding-taken zijn voltooid. Dit omvat activiteiten zoals het inleveren van bedrijfsmiddelen, eindafrekeningen en de intrekking van systeemtoegang.
Het belang Dit gebeurtenis bevestigt dat alle noodzakelijke stappen zijn ondernomen om op een veilige en compliant wijze afscheid te nemen van de medewerker. Het helpt bij het meten van de offboarding doorlooptijd en het vinden van compliance gaps. Vindplaats Dit zou worden afgeleid van de completion timestamp van de algehele offboarding checklist of workflow, vergelijkbaar met de gebeurtenis 'Werknemer Onboarded' maar dan voor het uitdiensttredingsproces. Vastleggen Afgeleid uit de voltooiings-timestamp van de hoofd-uitdiensttredingschecklist voor de werknemer. Gebeurtenistype inferred
	Verlof Gestart	Markeert het begin van een goedgekeurd verlof van een werknemer, bijvoorbeeld om medische of persoonlijke redenen. Dit wordt geregistreerd wanneer de status van de werknemer verandert naar een inactieve verlofstatus.
Het belang Identificeert perioden van inactiviteit in de werknemerslevenscyclus. Het is belangrijk voor het nauwkeurig berekenen van de actieve diensttijd en het begrijpen van de impact van verlof op loopbaanontwikkeling. Vindplaats Gevonden in de functiegegevenshistorie van de werknemer binnen de HR Core-module. Dit komt overeen met een functieactie zoals 'Verlof' met een specifieke ingangsdatum. Vastleggen Vastgelegd vanaf de ingangsdatum van een 'Verlof starten'-actie in de arbeidsgeschiedenis. Gebeurtenistype explicit

Aanbevolen Optioneel

Extractiegidsen

Hoe je je data uit UKG Pro ophaalt

Stappen

Verplichten: Zorg ervoor dat Python 3.6+ en de requests en pandas libraries geïnstalleerd zijn. Je kunt ze installeren met pip: pip install requests pandas.
API Toegang & Authenticatie: Neem contact op met je UKG Pro-beheerder om een Service Account aan te maken. Je hebt de API Key, Gebruiker Naam en Password nodig. Het Service Account moet de juiste permissies hebben om toegang te krijgen tot alle vereiste API-endpoints, inclusief data over personeel, salarisadministratie, onboarding, prestaties en trainingen.
Configureer het Script: Open het meegeleverde Python-script in een teksteditor of IDE. Zoek het configuratiegedeelte bovenaan het script en vervang de placeholderwaarden voor UKG_BASE_URL, API_KEY, USERNAME, PASSWORD en COMPANY_ID met je specifieke inloggegevens en omgevingsdetails.
Stel het Datumbereik voor Extractie in: Definieer in het configuratiegedeelte de variabelen START_DATE en END_DATE. Dit bepaalt de periode waarvoor medewerkerswijzigingen en gebeurtenissen worden opgehaald. Het wordt aanbevolen om te beginnen met een kleiner bereik, zoals 3-6 maanden, om het script te testen.
Voer het Script uit: Voer het script uit via de commandoregel met python your_script_name.py. Het script zal authenticeren, data ophalen bij verschillende UKG Pro API-endpoints voor elke activiteit en voortgangsupdates weergeven in de console.
API Throttling Beheren: Het script bevat een time.sleep()-functie om de API-rate limits te respecteren. Als je throttling errors (HTTP 429) tegenkomt, moet je mogelijk de sleep-duur tussen API-aanroepen verlengen.
Transformeer en Standaardiseer Data: Elke functie binnen het script is ontworpen om ruwe data op te halen voor een specifieke activiteit, de relevante velden te selecteren en deze te hernoemen naar het standaard event log-formaat (EmployeeId, ActiviteitNaam, EventTimestamp, etc.).
Combineer Event Data: Het hoofdgedeelte van het script roept elke activiteitspecifieke functie aan en voegt de resulterende data toe aan een enkele masterlijst van gebeurtenissen.
Genereer het Event Log: Na het processen van alle activiteiten consolideert het script de data in een pandas DataFrame, sorteert deze op medewerker-ID en timestamp, en slaat deze op als een CSV-bestand met de naam ukg_hire_to_retire_gebeurtenis_log.csv.
Controleer en Upload: Open het gegenereerde CSV-bestand om ervoor te zorgen dat de data compleet en correct geformatteerd is. Dit bestand is nu klaar om te worden geüpload naar de process mining-tool.

Configuratie

Authenticatiegegevens: Een serviceaccount API Key, Gebruiker Naam en Password zijn vereist voor API-het inloggen.
Basis-URL: De UKG_BASE_URL voor je UKG Pro-instantie (bijv. https://service[##].ulTipro.com/api).
Bedrijfs-ID: De unieke COMPANY_ID voor je organisatie binnen UKG Pro is noodzakelijk voor veel API-aanroepen.
Datumbereik: De START_DATE- en END_DATE-parameters (in 'YYYY-MM-DD'-formaat) bepalen het extractievenster. Voor de initiële extractie wordt een periode van 3-6 maanden aanbevolen om het datavolume te beheren en de resultaten te verifiëren.
API Endpoint Versies: Het script gebruikt specifieke versies van de REST API's (bijv. /personnel/v1/). Zorg ervoor dat je UKG Pro-instantie deze versies ondersteunt.
Moduleafhankelijkheden: Voor de extractie van bepaalde activiteiten is vereist dat je organisatie de bijbehorende UKG Pro-modules heeft gelicentieerd en actief gebruikt, zoals Onboarding, Learning en Performance Management. Als een module niet in gebruik is, wordt de bijbehorende activiteit niet opgehaald.

a Voorbeeldquery python

import requests
import pandas as pd
import datetime
import time
import json

class=class="hl-string">"hl-comment"># --- CONFIGURATION --- #
UKG_BASE_URL = class="hl-string">"https://service[YourServiceNumber].ultipro.com/api"
API_KEY = class="hl-string">"[Your_API_Key]"
USERNAME = class="hl-string">"[Your_Service_Account_Username]"
PASSWORD = class="hl-string">"[Your_Service_Account_Password]"
COMPANY_ID = class="hl-string">"[Your_Company_ID]"
START_DATE = (datetime.date.today() - datetime.timedelta(days=180)).strftime(class="hl-string">'%Y-%m-%d')
END_DATE = datetime.date.today().strftime(class="hl-string">'%Y-%m-%d')

class=class="hl-string">"hl-comment"># --- API HELPER FUNCTION --- #

def get_ukg_data(endpoint, params=None):
    class="hl-string">"""Helper function to handle authentication and pagination for UKG API calls."""
    auth_data = json.dumps({
        class="hl-string">"username": USERNAME,
        class="hl-string">"password": PASSWORD,
        class="hl-string">"apiKey": API_KEY
    })
    headers = {class="hl-string">'Content-Type': class="hl-string">'application/json'}
    
    class=class="hl-string">"hl-comment"># Authenticate and get token
    try:
        auth_response = requests.post(fclass="hl-string">"{UKG_BASE_URL}/v1/login", data=auth_data, headers=headers)
        auth_response.raise_for_status()
        token = auth_response.json().get(class="hl-string">'token')
    except requests.exceptions.RequestException as e:
        print(fclass="hl-string">"Authentication failed: {e}")
        return []

    all_records = []
    page = 1
    per_page = 100
    
    api_headers = {class="hl-string">'Authorization': fclass="hl-string">'Bearer {token}'}
    
    while True:
        if params is None:
            params = {}
        params.update({class="hl-string">'page': page, class="hl-string">'per_page': per_page})
        
        try:
            response = requests.get(fclass="hl-string">"{UKG_BASE_URL}{endpoint}", headers=api_headers, params=params)
            response.raise_for_status()
            data = response.json()
            
            if isinstance(data, list) and data:
                all_records.extend(data)
                if len(data) < per_page:
                    break class=class="hl-string">"hl-comment"># Last page
                page += 1
            elif isinstance(data, dict) and class="hl-string">'results' in data:
                all_records.extend(data[class="hl-string">'results'])
                if len(data[class="hl-string">'results']) < per_page:
                    break class=class="hl-string">"hl-comment"># Last page
                page += 1
            else:
                 break class=class="hl-string">"hl-comment"># No more data

            time.sleep(1) class=class="hl-string">"hl-comment"># Respect rate limits

        except requests.exceptions.RequestException as e:
            print(fclass="hl-string">"Error fetching data from {endpoint}: {e}")
            break
            
    return all_records

class=class="hl-string">"hl-comment"># --- ACTIVITY EXTRACTION FUNCTIONS --- #

def get_employee_hired_events():
    print(class="hl-string">"Fetching 'Employee Hired' events...")
    events = []
    class=class="hl-string">"hl-comment"># Use employee changes API to find hire events
    params = {class="hl-string">'action': class="hl-string">'HIRE', class="hl-string">'effectiveDate': fclass="hl-string">'ge {START_DATE}'}
    data = get_ukg_data(class="hl-string">'/personnel/v1/employee-changes', params=params)
    for record in data:
        if record.get(class="hl-string">'effectiveDate') and record.get(class="hl-string">'effectiveDate') <= END_DATE:
            events.append({
                class="hl-string">'EmployeeId': record.get(class="hl-string">'employeeId'),
                class="hl-string">'ActivityName': class="hl-string">'Employee Hired',
                class="hl-string">'EventTimestamp': record.get(class="hl-string">'effectiveDate'),
                class="hl-string">'ActioningUser': record.get(class="hl-string">'changedByUserName'),
                class="hl-string">'EmployeeDepartment': record.get(class="hl-string">'department'),
                class="hl-string">'JobRequisitionId': record.get(class="hl-string">'jobRequisitionId'),
                class="hl-string">'EmploymentStatus': record.get(class="hl-string">'employmentStatus'),
                class="hl-string">'JobTitle': record.get(class="hl-string">'jobTitle'),
                class="hl-string">'ManagerName': record.get(class="hl-string">'supervisorName'),
                class="hl-string">'HireDate': record.get(class="hl-string">'hireDate')
            })
    return events

def get_onboarding_events():
    print(class="hl-string">"Fetching 'Onboarding' events...")
    events = []
    class=class="hl-string">"hl-comment"># Note: Requires Onboarding module. This is a conceptual endpoint.
    class=class="hl-string">"hl-comment"># You may need to adjust the endpoint based on your UKG configuration.
    data = get_ukg_data(fclass="hl-string">'/onboarding/v1/employee-onboarding-activities?start-date={START_DATE}&end-date={END_DATE}')
    for record in data:
        if record.get(class="hl-string">'workflow') == class="hl-string">'New Hire Onboarding':
            if record.get(class="hl-string">'dateAssigned'):
                events.append({
                    class="hl-string">'EmployeeId': record.get(class="hl-string">'employeeId'),
                    class="hl-string">'ActivityName': class="hl-string">'Onboarding Initiated',
                    class="hl-string">'EventTimestamp': record.get(class="hl-string">'dateAssigned'),
                    class="hl-string">'ActioningUser': record.get(class="hl-string">'assignedBy'),
                    class="hl-string">'EmployeeDepartment': record.get(class="hl-string">'department'),
                    class="hl-string">'JobTitle': record.get(class="hl-string">'jobTitle'),
                    class="hl-string">'ManagerName': record.get(class="hl-string">'managerName'),
                    class="hl-string">'HireDate': record.get(class="hl-string">'hireDate')
                })
            if record.get(class="hl-string">'dateCompleted'):
                events.append({
                    class="hl-string">'EmployeeId': record.get(class="hl-string">'employeeId'),
                    class="hl-string">'ActivityName': class="hl-string">'Employee Onboarded',
                    class="hl-string">'EventTimestamp': record.get(class="hl-string">'dateCompleted'),
                    class="hl-string">'ActioningUser': None,
                    class="hl-string">'EmployeeDepartment': record.get(class="hl-string">'department'),
                    class="hl-string">'JobTitle': record.get(class="hl-string">'jobTitle'),
                    class="hl-string">'ManagerName': record.get(class="hl-string">'managerName'),
                    class="hl-string">'HireDate': record.get(class="hl-string">'hireDate')
                })
    return events

def get_payroll_setup_events():
    print(class="hl-string">"Fetching 'Payroll Setup Completed' events...")
    events = []
    class=class="hl-string">"hl-comment"># Inferring this from direct deposit creation date
    params = {class="hl-string">'dateTimeCreated': fclass="hl-string">'ge {START_DATE}'}
    data = get_ukg_data(class="hl-string">'/personnel/v1/employees/direct-deposit', params=params)
    processed_employees = set()
    for record in data:
        if record.get(class="hl-string">'employeeId') not in processed_employees and record.get(class="hl-string">'dateTimeCreated') <= END_DATE:
            events.append({
                class="hl-string">'EmployeeId': record.get(class="hl-string">'employeeId'),
                class="hl-string">'ActivityName': class="hl-string">'Payroll Setup Completed',
                class="hl-string">'EventTimestamp': record.get(class="hl-string">'dateTimeCreated'),
                class="hl-string">'ActioningUser': record.get(class="hl-string">'userWhoModified'),
                class="hl-string">'EmploymentStatus': record.get(class="hl-string">'employeeStatus')
            })
            processed_employees.add(record.get(class="hl-string">'employeeId'))
    return events

def get_training_assigned_events():
    print(class="hl-string">"Fetching 'Training Assigned' events...")
    events = []
    class=class="hl-string">"hl-comment"># Note: Requires Learning module.
    params = {class="hl-string">'assignmentDate': fclass="hl-string">'ge {START_DATE}'}
    data = get_ukg_data(class="hl-string">'/learning/v1/enrollments', params=params)
    for record in data:
        if record.get(class="hl-string">'assignmentDate') <= END_DATE:
            events.append({
                class="hl-string">'EmployeeId': record.get(class="hl-string">'employee').get(class="hl-string">'id'),
                class="hl-string">'ActivityName': class="hl-string">'Training Assigned',
                class="hl-string">'EventTimestamp': record.get(class="hl-string">'assignmentDate'),
                class="hl-string">'ActioningUser': record.get(class="hl-string">'assignedBy').get(class="hl-string">'name'),
                class="hl-string">'JobTitle': record.get(class="hl-string">'employee').get(class="hl-string">'jobTitle')
            })
    return events

def get_performance_review_events():
    print(class="hl-string">"Fetching 'Performance Review' events...")
    events = []
    class=class="hl-string">"hl-comment"># Note: Requires Performance Management module.
    params = {class="hl-string">'completionDate': fclass="hl-string">'ge {START_DATE}'}
    data = get_ukg_data(class="hl-string">'/performance/v1/reviews', params=params)
    for record in data:
        if record.get(class="hl-string">'completionDate') <= END_DATE:
            events.append({
                class="hl-string">'EmployeeId': record.get(class="hl-string">'employee').get(class="hl-string">'id'),
                class="hl-string">'ActivityName': class="hl-string">'Performance Review Conducted',
                class="hl-string">'EventTimestamp': record.get(class="hl-string">'completionDate'),
                class="hl-string">'ActioningUser': record.get(class="hl-string">'manager').get(class="hl-string">'name'),
                class="hl-string">'ManagerName': record.get(class="hl-string">'manager').get(class="hl-string">'name')
            })
    return events

def get_job_change_events():
    print(class="hl-string">"Fetching job and compensation change events...")
    events = []
    params = {class="hl-string">'effectiveDate': fclass="hl-string">'ge {START_DATE}'}
    data = get_ukg_data(class="hl-string">'/personnel/v1/employee-changes', params=params)
    for record in data:
        if record.get(class="hl-string">'effectiveDate') > END_DATE: continue

        action = record.get(class="hl-string">'action', class="hl-string">'').upper()
        reason = record.get(class="hl-string">'reason', class="hl-string">'').upper()
        
        if action == class="hl-string">'PROMOTION' or reason == class="hl-string">'PROMOTION':
            events.append({
                class="hl-string">'EmployeeId': record.get(class="hl-string">'employeeId'),
                class="hl-string">'ActivityName': class="hl-string">'Promotion Approved',
                class="hl-string">'EventTimestamp': record.get(class="hl-string">'effectiveDate'),
                class="hl-string">'ActioningUser': record.get(class="hl-string">'changedByUserName'),
                class="hl-string">'JobTitle': record.get(class="hl-string">'jobTitle'),
                class="hl-string">'ManagerName': record.get(class="hl-string">'supervisorName')
            })

        if action == class="hl-string">'TRANSFER' or reason == class="hl-string">'TRANSFER' or reason == class="hl-string">'REASSIGNMENT':
            events.append({
                class="hl-string">'EmployeeId': record.get(class="hl-string">'employeeId'),
                class="hl-string">'ActivityName': class="hl-string">'Role Change Processed',
                class="hl-string">'EventTimestamp': record.get(class="hl-string">'effectiveDate'),
                class="hl-string">'ActioningUser': record.get(class="hl-string">'changedByUserName'),
                class="hl-string">'EmployeeDepartment': record.get(class="hl-string">'department'),
                class="hl-string">'JobTitle': record.get(class="hl-string">'jobTitle')
            })

        if record.get(class="hl-string">'isPayRateChanged') == class="hl-string">'true':
            events.append({
                class="hl-string">'EmployeeId': record.get(class="hl-string">'employeeId'),
                class="hl-string">'ActivityName': class="hl-string">'Compensation Changed',
                class="hl-string">'EventTimestamp': record.get(class="hl-string">'effectiveDate'),
                class="hl-string">'ActioningUser': record.get(class="hl-string">'changedByUserName'),
                class="hl-string">'EmploymentStatus': record.get(class="hl-string">'employmentStatus')
            })

        if record.get(class="hl-string">'isSupervisorChanged') == class="hl-string">'true':
            events.append({
                class="hl-string">'EmployeeId': record.get(class="hl-string">'employeeId'),
                class="hl-string">'ActivityName': class="hl-string">'Manager Changed',
                class="hl-string">'EventTimestamp': record.get(class="hl-string">'effectiveDate'),
                class="hl-string">'ActioningUser': record.get(class="hl-string">'changedByUserName'),
                class="hl-string">'ManagerName': record.get(class="hl-string">'supervisorName')
            })
    return events

def get_leave_events():
    print(class="hl-string">"Fetching 'Leave of Absence' events...")
    events = []
    params = {class="hl-string">'action': class="hl-string">'LEAVE', class="hl-string">'effectiveDate': fclass="hl-string">'ge {START_DATE}'}
    data = get_ukg_data(class="hl-string">'/personnel/v1/employee-changes', params=params)
    for record in data:
        if record.get(class="hl-string">'effectiveDate') and record.get(class="hl-string">'effectiveDate') <= END_DATE:
            events.append({
                class="hl-string">'EmployeeId': record.get(class="hl-string">'employeeId'),
                class="hl-string">'ActivityName': class="hl-string">'Leave of Absence Started',
                class="hl-string">'EventTimestamp': record.get(class="hl-string">'effectiveDate'),
                class="hl-string">'ActioningUser': record.get(class="hl-string">'changedByUserName'),
                class="hl-string">'EmploymentStatus': record.get(class="hl-string">'employmentStatus'),
                class="hl-string">'HireDate': record.get(class="hl-string">'hireDate')
            })
    return events

def get_termination_events():
    print(class="hl-string">"Fetching 'Termination' events...")
    events = []
    params = {class="hl-string">'action': class="hl-string">'TERM', class="hl-string">'effectiveDate': fclass="hl-string">'ge {START_DATE}'}
    data = get_ukg_data(class="hl-string">'/personnel/v1/employee-changes', params=params)
    for record in data:
        if record.get(class="hl-string">'effectiveDate') and record.get(class="hl-string">'effectiveDate') <= END_DATE:
            class=class="hl-string">"hl-comment"># Termination Initiated is when the record is created, Terminated is the effective date
            events.append({
                class="hl-string">'EmployeeId': record.get(class="hl-string">'employeeId'),
                class="hl-string">'ActivityName': class="hl-string">'Termination Initiated',
                class="hl-string">'EventTimestamp': record.get(class="hl-string">'dateCreated'),
                class="hl-string">'ActioningUser': record.get(class="hl-string">'changedByUserName'),
                class="hl-string">'EmploymentStatus': record.get(class="hl-string">'employmentStatus'),
                class="hl-string">'HireDate': record.get(class="hl-string">'hireDate')
            })
            events.append({
                class="hl-string">'EmployeeId': record.get(class="hl-string">'employeeId'),
                class="hl-string">'ActivityName': class="hl-string">'Employee Terminated',
                class="hl-string">'EventTimestamp': record.get(class="hl-string">'effectiveDate'),
                class="hl-string">'ActioningUser': record.get(class="hl-string">'changedByUserName'),
                class="hl-string">'EmploymentStatus': class="hl-string">'Terminated',
                class="hl-string">'HireDate': record.get(class="hl-string">'hireDate')
            })
    return events

def get_offboarding_events():
    print(class="hl-string">"Fetching 'Offboarding' events...")
    events = []
    class=class="hl-string">"hl-comment"># Note: Requires Onboarding module for offboarding checklists.
    class=class="hl-string">"hl-comment"># Conceptual endpoint, may need adjustment.
    data = get_ukg_data(fclass="hl-string">'/onboarding/v1/employee-onboarding-activities?start-date={START_DATE}&end-date={END_DATE}')
    for record in data:
        if record.get(class="hl-string">'workflow') == class="hl-string">'Employee Offboarding':
            if record.get(class="hl-string">'stepName') == class="hl-string">'Exit Interview' and record.get(class="hl-string">'dateCompleted'):
                events.append({
                    class="hl-string">'EmployeeId': record.get(class="hl-string">'employeeId'),
                    class="hl-string">'ActivityName': class="hl-string">'Exit Interview Conducted',
                    class="hl-string">'EventTimestamp': record.get(class="hl-string">'dateCompleted'),
                    class="hl-string">'ActioningUser': record.get(class="hl-string">'completedBy')
                })
            if record.get(class="hl-string">'dateCompleted') and record.get(class="hl-string">'isWorkflowComplete'):
                events.append({
                    class="hl-string">'EmployeeId': record.get(class="hl-string">'employeeId'),
                    class="hl-string">'ActivityName': class="hl-string">'Offboarding Completed',
                    class="hl-string">'EventTimestamp': record.get(class="hl-string">'dateCompleted'),
                    class="hl-string">'ActioningUser': None
                })
    return events

class=class="hl-string">"hl-comment"># --- MAIN EXECUTION --- #
if __name__ == class="hl-string">"__main__":
    all_events = []
    last_data_update = datetime.datetime.utcnow().isoformat() + class="hl-string">'Z'

    class=class="hl-string">"hl-comment"># Collect events from all functions
    all_events.extend(get_employee_hired_events())
    all_events.extend(get_onboarding_events())
    all_events.extend(get_payroll_setup_events())
    all_events.extend(get_training_assigned_events())
    all_events.extend(get_performance_review_events())
    all_events.extend(get_job_change_events())
    all_events.extend(get_leave_events())
    all_events.extend(get_termination_events())
    all_events.extend(get_offboarding_events())

    if not all_events:
        print(class="hl-string">"No events found for the specified period. Exiting.")
    else:
        class=class="hl-string">"hl-comment"># Create DataFrame
        df = pd.DataFrame(all_events)
        
        class=class="hl-string">"hl-comment"># Add required static columns
        df[class="hl-string">'SourceSystem'] = class="hl-string">'UKG Pro'
        df[class="hl-string">'LastDataUpdate'] = last_data_update
        
        class=class="hl-string">"hl-comment"># Standardize and clean up
        df = df.rename(columns={class="hl-string">'employeeId': class="hl-string">'EmployeeId', class="hl-string">'activityName': class="hl-string">'ActivityName', class="hl-string">'eventTimestamp': class="hl-string">'EventTimestamp'})
        df[class="hl-string">'EventTimestamp'] = pd.to_datetime(df[class="hl-string">'EventTimestamp']).dt.strftime(class="hl-string">'%Y-%m-%dT%H:%M:%S.%f')[:-3] + class="hl-string">'Z'
        df = df.sort_values(by=[class="hl-string">'EmployeeId', class="hl-string">'EventTimestamp'])
        
        class=class="hl-string">"hl-comment"># Reorder columns for clarity
        column_order = [
            class="hl-string">'EmployeeId', class="hl-string">'ActivityName', class="hl-string">'EventTimestamp', class="hl-string">'SourceSystem', class="hl-string">'LastDataUpdate',
            class="hl-string">'ActioningUser', class="hl-string">'EmployeeDepartment', class="hl-string">'JobRequisitionId', class="hl-string">'EmploymentStatus',
            class="hl-string">'JobTitle', class="hl-string">'ManagerName', class="hl-string">'HireDate'
        ]
        df = df.reindex(columns=column_axist)

        class=class="hl-string">"hl-comment"># Save to CSV
        output_filename = class="hl-string">'ukg_hire_to_retire_event_log.csv'
        df.to_csv(output_filename, index=False)
        print(fclass="hl-string">"\nExtraction complete. Event log saved to {output_filename}")

Je Hire-to-retire - Levenscyclus van Medewerkers-datatemplate

Je Hire-to-retire - Levenscyclus van Medewerkers-datatemplate

Hire-to-retire - Medewerkerscyclus Attributen

Hire-to-retire - Medewerkerscyclus Activiteiten

Extractiegidsen

Python Script Extractie via UKG Pro REST API's

Stappen

Configuratie

a Voorbeeldquery python

Klaar om te starten?

Start vandaag nog met het optimaliseren van je Medewerkerlevenscyclus van Aanname tot Uitdiensttreding!

Je Hire-to-retire - Levenscyclus van Medewerkers-datatemplate

Je Hire-to-retire - Levenscyclus van Medewerkers-datatemplate

Hire-to-retire - Medewerkerscyclus Attributen

Hire-to-retire - Medewerkerscyclus Activiteiten

Extractiegidsen

Python Script Extractie via UKG Pro REST API's

Stappen

Configuratie

a Voorbeeldquery python

Wij hechten veel waarde aan je privacy

Klaar om te starten?

Start vandaag nog met het optimaliseren van je Medewerkerlevenscyclus van Aanname tot Uitdiensttreding!