> Continue procesverbetering > Hire to Retire Employee Lifecycle > UKG Pro > Datatemplate

Data Template: Hire to Retire - Werknemerslevenscyclus

UKG Pro

Hire to Retire - Employee Lifecycle Attributes (22) Hire to Retire - Employee Lifecycle Activiteiten (15) Extractie Guides (1)

Uw Van Werving tot Uittreding - Medewerker Levenscyclus Data Template.

Deze template biedt een uitgebreid overzicht van de essentiële data-elementen die nodig zijn om uw Hire to Retire-proces effectief te analyseren. Het beschrijft de cruciale attributes die moeten worden verzameld, de belangrijkste activiteiten die moeten worden bijgehouden en praktische begeleiding bij het extraheren van deze data uit UKG Pro. Gebruik deze resource om uw data preparation te stroomlijnen en een soepele start te garanderen voor uw process mining journey.

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

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

Template downloaden

Hire to Retire - Employee Lifecycle Attributes

Dit zijn de aanbevolen data fields voor uw event log, essentieel voor diepgaande analyse en inzichten van de Van Aanstelling tot Uitdiensttreding-levenscyclus.

5 Verplicht 7 Aanbevolen 10 Optioneel

	Naam	Beschrijving
	Gebeurtenistijdstempel EventTimestamp	De exacte datum en tijd waarop een specifiek levenscyclus-event plaatsvond.
Beschrijving De Event Timestamp biedt de chronologische context voor elke activiteit en vormt de ruggengraat van de processtroom. Het registreert het exacte moment dat een event zoals 'Aanbod geaccepteerd' of 'Promotie goedgekeurd' in het systeem werd geregistreerd. In analyse worden deze timestamps gebruikt om doorlooptijden tussen activiteiten te berekenen, vertragingen te identificeren en de doorlooptijden te meten voor belangrijke subprocessen zoals werving en inwerken. Nauwkeurige timestamps zijn cruciaal voor alle tijdgebaseerde KPI's en prestatieanalyse. Waarom het belangrijk is Dit attribute is essentieel voor het chronologisch ordenen van events en het berekenen van alle tijdsgebonden metrics, zoals cycle times en durations. Waar te verkrijgen Afkomstig van datum- of timestamp-velden gekoppeld aan specifieke events in UKG Pro, zoals 'HireDate', 'TerminationDate', of timestamps voor statuswijzigingen in workflow modules. Voorbeelden 2023-01-15T09:00:00Z2023-06-20T14:35:10Z2024-02-01T11:00:00Z
	Werknemer-ID EmployeeId	De unieke ID die aan elke medewerker is toegewezen, dienend als de primaire case ID voor hun gehele levenscyclus binnen de organisatie.
Beschrijving De Medewerker ID is de centrale draad die alle events van een medewerker met elkaar verbindt, van de eerste sollicitatie tot de uiteindelijke uitdiensttreding. Deze ID is cruciaal 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-attributes en de nauwkeurige berekening van de doorlooptijden van de levenscyclus mogelijk. Waarom het belangrijk is Dit is de essentiële case identifier die alle medewerkergerelateerde events met elkaar verbindt, waardoor het mogelijk wordt om het end-to-end Hire to Retire-proces voor elk individu te analyseren. Waar te verkrijgen Dit is een kernveld in UKG Pro, doorgaans te vinden in werknemersprofielen of stamdata records. 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 event of de mijlpaal die plaatsvond in de levenscyclus van de medewerker, zoals 'Medewerker Aangenomen' of 'Prestatiebeoordeling Uitgevoerd'.
Beschrijving De Activiteitsnaam beschrijft een enkele stap of taak binnen het Van Aanstelling tot Uitdiensttreding-proces. Deze events 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 identificeren van veelvoorkomende paden, afwijkingen van het standaardproces en knelpunten tussen belangrijke activiteiten zoals 'Inwerkproces gestart' en 'Salarisadministratie voltooid'. Waarom het belangrijk is Dit attribute definieert de stappen in de proceskaart, waardoor de visualisatie en analyse van de werknemerslevenscyclusstroom mogelijk wordt. Waar te verkrijgen Dit is doorgaans afgeleid van event logs, workflow statuswijzigingen of specifieke datumvelden binnen diverse UKG Pro-modules (bijv. Recruiting, Onboarding, Performance Management). Er is doorgaans mapping logic vereist om gestandaardiseerde activiteitsnamen te genereren. Voorbeelden Werknemer aangenomenFunctioneringsgesprek uitgevoerdBeëindiging Gestart
	Bronsysteem SourceSystem	Identificeert het systeem waaruit de data is geëxtraheerd, wat in dit geval UKG Pro is.
Beschrijving Dit attribute specificeert de oorsprong van de procesdata. Hoewel het in deze context voornamelijk UKG Pro betreft, kan een Van Aanname tot Uitdiensttreding-proces data 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 cruciaal voor data governance en troubleshooting. Voor een single-source weergave biedt het essentiële context over de oorsprong van de data. Waarom het belangrijk is Biedt cruciale context voor data governance, quality assurance en traceerbaarheid door de oorsprong van de event data te identificeren. Waar te verkrijgen Dit is doorgaans een statische waarde ('UKG Pro') die wordt toegevoegd tijdens het data transformatie- en extractieproces. Voorbeelden UKG ProUKGPro_CoreHRUKG
	Laatste data-update LastDataUpdate	De timestamp die aangeeft wanneer de data voor dit event voor het laatst is vernieuwd of geëxtraheerd uit het bronsysteem.
Beschrijving Dit attribute geeft de timestamp van de laatste data-extractie uit UKG Pro. Het is niet het moment waarop de business event plaatsvond, maar eerder wanneer de record in de process mining tool werd geladen. Deze informatie is cruciaal voor het begrijpen van de versheid van de geanalyseerde data. Het stelt analisten en zakelijke gebruikers in staat om te weten hoe actueel de procesweergave is en helpt bij het beheren van datarefreshschema's en het valideren van de actualiteit van inzichten. Waarom het belangrijk is Geeft de actualiteit van de data aan, wat essentieel is voor het vertrouwen in de analyse en het nemen van tijdige zakelijke beslissingen. Waar te verkrijgen 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 organisatorische eenheid waaraan de medewerker is toegewezen.
Beschrijving Dit attribute 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. Waarom het belangrijk is Maakt krachtige vergelijkende analyse mogelijk doordat u het proces kunt filteren en segmenteren op basis van de organisatiestructuur, waardoor afdelingsvariaties worden onthuld. Waar te verkrijgen Dit is een standaard veld in het baan- of functierecord 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.
Beschrijving De Indiensttredingsdatum markeert het begin van het dienstverband van de medewerker. Het is een fundamenteel datumveld dat dient als basislijn voor vele tijdgebaseerde berekeningen en analyses gerelateerd aan de levenscyclus van de medewerker. Deze attribute wordt gebruikt om de dienstverbandduur van medewerkers te berekenen, wat cruciaal is voor het analyseren van het 'Vroegtijdig Medewerkerverloop percentage'. Het helpt ook bij cohortanalyse, waardoor de vergelijking van levenscycluspatronen voor medewerkers die in verschillende periodes zijn aangenomen mogelijk wordt. Waarom het belangrijk is Dient als basislijn voor het berekenen van werknemersanciënniteit en is essentieel voor cohortanalyse en KPI's voor verloop. Waar te verkrijgen 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'.
Beschrijving Dit attribute 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 personeelsbestand 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 fundamenteel voor het berekenen van churn rates en het begrijpen van de uitkomsten van verschillende levenscycluspaden. Waarom het belangrijk is Biedt essentiële context over de status van een werknemer, wat een nauwkeurige churn-analyse en segmentatie van het personeelsbestand mogelijk maakt. Waar te verkrijgen Dit is een essentieel 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'.
Beschrijving De Functietitel beschrijft de rol of positie van de medewerker binnen de organisatie. Deze attribute 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 identificeren 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. Waarom het belangrijk is Maakt rolgebaseerde analyse mogelijk om te begrijpen hoe levenscyclusprocessen variëren tussen verschillende functieprofielen en senioriteitsniveaus. Waar te verkrijgen 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.
Beschrijving Dit attribute identificeert de directe manager van de medewerker. De manager speelt een cruciale 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 attribute om te zien hoe een verandering van manager de daaropvolgende activiteiten beïnvloedt. Het is ook cruciaal voor de Time to Managerial Re-engagement KPI. Waarom het belangrijk is Maakt analyse van procesprestaties op teamniveau mogelijk en helpt bij het beoordelen van de impact van managers op werknemerslevenscyclusgebeurtenissen. Waar te verkrijgen 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.
Beschrijving Dit attribute 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 attribute van onschatbare waarde voor het begrijpen van de werkdrukverdeling, het identificeren 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. Waarom het belangrijk is Koppelt procesactiviteiten aan specifieke gebruikers, wat workloadanalyse, prestatievergelijkingen en het onderzoeken van herbewerking of fouten mogelijk maakt. Waar te verkrijgen 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 wervingsproces initieerde.
Beschrijving 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 essentieel 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 metrics zoals het 'Percentage Inactieve Vacatureaanvragen' te analyseren door aanvragen te identificeren die niet vorderen. Waarom het belangrijk is Biedt een duidelijk startpunt voor het wervingsproces, en maakt een nauwkeurige meting van de doorlooptijden voor aanname en de effectiviteit van aanvragen mogelijk. Waar te verkrijgen Gevonden binnen de UKG Pro Recruiting-module of het gekoppelde Applicant Tracking System (ATS). Voorbeelden REQ-2023-015REQ-2024-112REQ-2023-504
	Bewerkingstijd ProcessingTime	De berekende doorlooptijd van een enkele activiteit, van de start- tot de eindtijd.
Beschrijving Verwerkingstijd meet de tijd die besteed wordt aan een specifieke taak, berekend als het verschil tussen de Event End Time en de Event Timestamp (StartTime). Het vertegenwoordigt de 'diensttijd' voor een activiteit. Deze metriek is cruciaal om te identificeren welke specifieke activiteiten de meeste tijd in beslag nemen in het proces. Het kan bijvoorbeeld benadrukken dat de activiteit 'Achtergrondcontrole Gestart' gemiddeld vijf dagen in beslag neemt om te voltooien, wat het een duidelijk doelwit maakt voor optimalisatie-inspanningen. Waarom het belangrijk is Kwantificeert de duur van individuele taken, wat gerichte optimalisatie van de meest tijdrovende activiteiten in het proces mogelijk maakt. Waar te verkrijgen Dit attribute wordt berekend tijdens de databewerking door de Event Timestamp af te trekken van de Event End Time. Voorbeelden 28800086400604800
	Eindtijd van het event EventEndTime	De timestamp die de voltooiing markeert van een activiteit met een meetbare duur.
Beschrijving 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. Waarom het belangrijk is Maakt de berekening van precieze verwerkingstijden mogelijk voor individuele activiteiten, en helpt zo bij het identificeren van de meest tijdrovende stappen in het proces. Waar te verkrijgen Afkomstig van datumvelden voor voltooiing in UKG Pro. Dit vereist vaak het koppelen van een start event aan een overeenkomstig voltooiingsevent 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.
Beschrijving Dit berekende attribute 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 identificeren van problemen in recruitment of onboarding. Waarom het belangrijk is Ondersteunt direct vroege verloopanalyse door risicovolle cases te markeren, en helpt zo bij het identificeren van grondoorzaken van voortijdig vertrek van medewerkers. Waar te verkrijgen Dit attribute wordt berekend tijdens de databewerking. De logica vergelijkt het verschil tussen de TerminationDate en HireDate met een vooraf gedefinieerde drempelwaarde (bijv. 365 dagen). Voorbeelden truefalse
	Locatie Location	De geografische locatie of het kantoor waar de medewerker is gevestigd.
Beschrijving Dit attribute 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 aan het licht brengen. Zo kunt u de Recruitment Cycle Time vergelijken tussen de kantoren in 'New York' en 'Londen' om best practices of lokale knelpunten te identificeren. Waarom het belangrijk is Maakt geografische segmentatie van het proces mogelijk, waardoor regionale variaties in prestaties en compliance worden onthuld. Waar te verkrijgen 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.
Beschrijving 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. Deze attribute is waardevol voor het correleren van procesevents met prestatieresultaten. 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. Waarom het belangrijk is Koppelt procesgebeurtenissen aan prestatieresultaten, waardoor de analyse van de effectiviteit van talentmanagement en de impact ervan op retentie mogelijk wordt. Waar te verkrijgen Gevonden binnen de UKG Pro Performance Management-module, gekoppeld aan specifieke beoordelingscycli. Voorbeelden Overtreft verwachtingenVoldoet aan de verwachtingenVereist verbetering5
	Reden Rolwijziging RoleChangeReason	De reden voor een wijziging in de rol van een medewerker, zoals 'Promotie', 'Horizontale overplaatsing' of 'Reorganisatie'.
Beschrijving Dit attribute biedt context voor interne mobiliteitsevents. Het verklaart waarom de rol of positie van een medewerker binnen de organisatie is gewijzigd. Dit is essentieel 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 stroomlijnen van loopbaanontwikkelingspaden. Waarom het belangrijk is Verklaart de context achter interne bewegingen, en maakt zo een genuanceerde analyse mogelijk van interne mobiliteitsprocessen zoals promoties versus horizontale overplaatsingen. Waar te verkrijgen 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'.
Beschrijving Dit attribute 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 cruciaal attribute voor retentie- en churn-analyse. Door beëindigde medewerkers te segmenteren op basis van hun vertrekreden, kunnen organisaties diepgaande inzichten 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. Waarom het belangrijk is Biedt cruciaal inzicht in de drijfveren van personeelsverloop, waardoor gerichte retentiestrategieën mogelijk worden. Waar te verkrijgen 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
	Salarisschaal SalaryGrade	Het salarisniveau of de schaal gekoppeld aan de functie van de medewerker.
Beschrijving Salarisschaal vertegenwoordigt het compensatieniveau voor een bepaalde functie. Het is een belangrijk attribute voor het analyseren van compensatiegerelateerde activiteiten en trends. Dit attribute is belangrijk voor analyses zoals Compensatie Gewijzigd events 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. Waarom het belangrijk is Biedt context voor salarisgerelateerde activiteiten en maakt segmentatie van het proces per salarisniveau mogelijk. Waar te verkrijgen 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.
Beschrijving Dit attribute 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 cruciaal attribute 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. Waarom het belangrijk is Maakt het volgen en analyseren van specifieke trainingsprogramma's mogelijk, en helpt zo bij het meten van compliance en ontwikkelingseffectiviteit. Waar te verkrijgen 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.
Beschrijving De Uitdiensttredingsdatum markeert de afsluiting van het dienstverband van de medewerker. Het is het eindpunt van de levenscyclus van de medewerker binnen de organisatie. Deze attribute 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. Waarom het belangrijk is Definieert het einde van de werknemerslevenscyclus, waardoor de berekening van de totale dienstverbandduur mogelijk wordt en alle verloopanalyses worden ondersteund. Waar te verkrijgen 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 - Employee Lifecycle Activiteiten

Dit zijn de belangrijke processtappen en mijlpalen om vast te leggen in uw event log voor nauwkeurige procesontdekking en -optimalisatie.

6 Aanbevolen 9 Optioneel

	Activiteit	Beschrijving
	Beëindiging Gestart	Vertegenwoordigt de start van het offboardingproces, geregistreerd wanneer een toekomstige einddatum van het dienstverband wordt ingevoerd in het systeem. Dit event activeert offboarding checklists en workflows.
Waarom het belangrijk is Dit is een kritieke mijlpaal die het uitdiensttredingsproces van medewerkers initieert. Het analyseren van de tijd tussen deze event en de uiteindelijke beëindiging helpt bij het evalueren van de efficiëntie en volledigheid van offboarding procedures. Waar te verkrijgen 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 event in de levenscyclus 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.
Waarom het belangrijk is Dit is de definitieve eind-event voor het proces, cruciaal 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. Waar te verkrijgen 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
	Functioneringsgesprek uitgevoerd	Vertegenwoordigt de voltooiing van een formele functioneringsgesprekcyclus voor een werknemer. Dit event wordt geregistreerd wanneer het beoordelingsformulier is afgerond en ingediend door de manager of HR.
Waarom het belangrijk is 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. Waar te verkrijgen 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 event dat voorafgaat aan de ingangsdatum van de wijziging.
Waarom het belangrijk is Deze activiteit is cruciaal voor het analyseren van interne mobiliteit en loopbaanontwikkeling. De tijd tussen goedkeuring van een promotie en de ingangsdatum kan administratieve knelpunten in het systeem aan het licht brengen. Waar te verkrijgen 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 event 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.
Waarom het belangrijk is Dit is de definitieve start-event voor de Hire to Retire-procesanalyse. Het biedt de baseline voor het meten van tijd tot productiviteit, onboarding-efficiëntie en de totale dienstverbandduur van medewerkers. Waar te verkrijgen Dit event 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-actierecord 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.
Waarom het belangrijk is 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. Waar te verkrijgen 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 event 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.
Waarom het belangrijk is Het bijhouden van salariswijzigingen is essentieel voor het begrijpen van loopbaan- en salarisontwikkeling. Frequente aanpassingen na indiensttreding kunnen duiden op data-invoerfouten of problemen met de initiële salarisbepaling. Waar te verkrijgen 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
	Exitgesprek afgenomen	Dit event markeert de voltooiing van het exit-gesprek met de vertrekkende medewerker. Het wordt doorgaans vastgelegd als een voltooide taak in een offboarding checklist.
Waarom het belangrijk is Het bijhouden van de voltooiing van exitgesprekken is belangrijk voor het waarborgen van HR compliance en het verzamelen van waardevolle feedback. Het helpt te identificeren of deze cruciale stap wordt overgeslagen in het offboarding-proces. Waar te verkrijgen Dit event 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 event 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.
Waarom het belangrijk is Managerwisselingen kunnen een aanzienlijke impact hebben op de betrokkenheid en prestaties van werknemers. Het bijhouden van dit event maakt analyse mogelijk van de impact ervan op daaropvolgende activiteiten zoals functioneringsgesprekken of retentie. Waar te verkrijgen Dit event 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 event dat een checklist met taken toewijst aan de nieuwe werknemer, hun manager en HR.
Waarom het belangrijk is 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 identificeren van vertragingen. Waar te verkrijgen Gevonden in de UKG Pro Onboarding-module. Dit event 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.
Waarom het belangrijk is Het analyseren van functieveranderingen biedt inzicht in interne mobiliteit, inzet van talent en organisatorische herstructurering. Het helpt identificeren hoe medewerkers zich door de organisatie bewegen. Waar te verkrijgen 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.
Waarom het belangrijk is Deze mijlpaal is cruciaal voor het meten van de inzetbaarheid van nieuwe aanwervingen. Vertragingen in de salarisadministratie kunnen leiden tot ontevredenheid bij medewerkers en administratieve herwerking, waardoor het een key performance indicator is voor onboarding. Waar te verkrijgen Dit event 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.
Waarom het belangrijk is Deze activiteit helpt bij het volgen van compliance met 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 aan het licht brengen. Waar te verkrijgen 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.
Waarom het belangrijk is Dit event 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 cycle time en het identificeren van compliance gaps. Waar te verkrijgen Dit zou worden afgeleid van de completion timestamp van de algehele offboarding checklist of workflow, vergelijkbaar met de event '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.
Waarom het belangrijk is Identificeert perioden van inactiviteit in de werknemerslevenscyclus. Het is cruciaal voor het nauwkeurig berekenen van de actieve diensttijd en het begrijpen van de impact van verlof op loopbaanontwikkeling. Waar te verkrijgen 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

Extractie Guides

Hoe u uw data uit UKG Pro ophaalt

Stappen

Vereisten: Zorg ervoor dat Python 3.6+ en de requests en pandas libraries geïnstalleerd zijn. U kunt ze installeren met pip: pip install requests pandas.
API Toegang & Authenticatie: Neem contact op met uw UKG Pro-beheerder om een Service Account aan te maken. U hebt de API Key, User Name 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 uw 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 events worden geëxtraheerd. 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 u throttling errors (HTTP 429) tegenkomt, moet u 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, ActivityName, 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 events.
Genereer het Event Log: Na het verwerken 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_event_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, User Name en Password zijn vereist voor API-authenticatie.
Basis-URL: De UKG_BASE_URL voor uw UKG Pro-instantie (bijv. https://service[##].ultipro.com/api).
Bedrijfs-ID: De unieke COMPANY_ID voor uw 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 uw UKG Pro-instantie deze versies ondersteunt.
Moduleafhankelijkheden: Voor de extractie van bepaalde activiteiten is vereist dat uw 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 geëxtraheerd.

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}")