> Kontinuierliche Prozessverbesserung > Mitarbeiterlebenszyklus von der Einstellung bis zum Austritt > UKG Pro > Daten Template

Ihr Daten-Template für den Hire-to-Retire-Prozess im Mitarbeiterlebenszyklus

UKG Pro

← Zurück zum Leitfaden zur Prozessverbesserung

Attribute für den Hire-to-Retire-Prozess im Mitarbeiterlebenszyklus(21) Aktivitäten im Hire-to-Retire-Prozess des Mitarbeiterlebenszyklus(15) Anleitungen zum Extrahieren von Daten(1)

Ihr Daten-Template für den Hire-to-Retire-Prozess im Mitarbeiterlebenszyklus

Dieses Template bietet einen umfassenden Überblick über die Daten, die Sie für eine aussagekräftige Analyse des Hire-to-Retire-Prozesses benötigen. Es zeigt, welche wichtigen Attribute Sie erfassen und welche Aktivitäten Sie verfolgen sollten. Außerdem enthält es praktische Hinweise zum Extrahieren der Daten aus UKG Pro. So können Sie Ihre Daten effizient vorbereiten und mit Process Mining starten.

Empfohlene Attribute für die Datenerfassung
Wichtige Aktivitäten für die Nachverfolgung
Anleitung zum Extrahieren von Daten aus UKG Pro

Neu bei Event Logs? Erfahren Sie, wie Sie ein Event Log für Process Mining erstellen.

Template herunterladen

Attribute für den Hire-to-Retire-Prozess im Mitarbeiterlebenszyklus

Diese Datenfelder sollten Sie in Ihr Event Log aufnehmen, um den Hire-to-Retire-Prozess im Mitarbeiterlebenszyklus umfassend zu analysieren und Erkenntnisse daraus zu gewinnen.

5 Erforderlich 7 Empfohlen 9 Optional

	Name	Beschreibung
	Event-Timestamp EventTimestamp	Das genaue Datum und die Uhrzeit, zu denen ein bestimmtes Event im Mitarbeiterlebenszyklus eingetreten ist.
Beschreibung Der Event-Timestamp ordnet jede Aktivität zeitlich ein und bildet die Grundlage für den Prozessfluss. Er erfasst den genauen Zeitpunkt, zu dem ein Event wie „Angebot angenommen“ oder „Beförderung genehmigt“ im System registriert wurde. Bei der Analyse dienen diese Timestamps dazu, Zeitspannen zwischen Aktivitäten zu berechnen, Verzögerungen zu erkennen und Durchlaufzeiten wichtiger Teilprozesse wie Recruiting und Onboarding zu messen. Präzise Timestamps sind für alle zeitbezogenen KPIs und Leistungsanalysen entscheidend. Warum das wichtig ist Dieses Attribut ist erforderlich, um Events chronologisch zu ordnen und alle zeitbezogenen Kennzahlen wie Durchlaufzeiten und Zeitspannen zu berechnen. Woher beziehen Stammt aus Datums- oder Timestamp-Feldern zu bestimmten Events in UKG Pro, etwa „HireDate“ oder „TerminationDate“, oder aus Timestamps von Statusänderungen in Workflow-Modulen. Beispiele 2023-01-15T09:00:00Z2023-06-20T14:35:10Z2024-02-01T11:00:00Z
	Mitarbeiter-ID EmployeeId	Die eindeutige Kennung für jede Person im Unternehmen. Sie dient als zentrale Case-ID für den gesamten Mitarbeiterlebenszyklus.
Beschreibung Die Mitarbeiter-ID verknüpft alle Events einer Person, von der ersten Bewerbung bis zum abgeschlossenen Offboarding. Diese Kennung ist entscheidend, um den gesamten Prozessverlauf für eine einzelne Person abzubilden. Bei der Process-Mining-Analyse wird jede Aktivität, etwa „Mitarbeiter eingestellt“, „Beförderung genehmigt“ oder „Beendigung eingeleitet“, mit dieser eindeutigen ID verknüpft. So lassen sich individuelle Prozessverläufe und Kohorten anhand von Mitarbeiterattributen analysieren sowie die Dauer des Mitarbeiterlebenszyklus präzise berechnen. Warum das wichtig ist Diese zentrale Case-ID verknüpft alle Events zu einer Person. So lässt sich der gesamte Hire-to-Retire-Prozess für jede einzelne Person analysieren. Woher beziehen Dies ist ein zentrales Feld in UKG Pro, das üblicherweise in Mitarbeiterprofilen oder Stammdatensätzen zu finden ist. Die genaue Tabelle und den Feldnamen, häufig „Employee Number“ oder „Person ID“, entnehmen Sie der Dokumentation von UKG Pro. Beispiele 10052198345210047
	Aktivitätsname ActivityName	Der Name des konkreten Events oder Meilensteins im Mitarbeiterlebenszyklus, etwa „Mitarbeiter eingestellt“ oder „Leistungsbeurteilung durchgeführt“.
Beschreibung Der Aktivitätsname bezeichnet einen einzelnen Schritt oder eine Aufgabe im Hire-to-Retire-Prozess. Die Events werden mit einem Timestamp versehen und chronologisch geordnet. So entsteht der Prozessfluss, der in Process Mining visualisiert und analysiert wird. Die Analyse der Reihenfolge und Häufigkeit dieser Aktivitäten zeigt, wie der Prozess tatsächlich abläuft. Sie macht häufige Abläufe, Abweichungen vom Standardprozess und Engpässe zwischen wichtigen Aktivitäten wie „Onboarding gestartet“ und „Gehaltsabrechnung eingerichtet“ sichtbar. Warum das wichtig ist Dieses Attribut legt die Schritte in der Prozessdarstellung fest und ermöglicht es, den Ablauf des Mitarbeiterlebenszyklus zu visualisieren und zu analysieren. Woher beziehen Wird üblicherweise aus Event Logs, Änderungen des Workflow-Status oder bestimmten Datumsfeldern in verschiedenen UKG-Pro-Modulen abgeleitet, etwa Recruiting, Onboarding oder Performance Management. Für einheitliche Aktivitätsnamen ist in der Regel eine Zuordnungslogik erforderlich. Beispiele Mitarbeiter eingestelltLeistungsbeurteilung durchgeführtBeendigung eingeleitet
	Letzte Datenaktualisierung LastDataUpdate	Der Timestamp gibt an, wann die Daten zu diesem Event zuletzt aktualisiert oder aus dem Quellsystem extrahiert wurden.
Beschreibung Dieses Attribut enthält den Timestamp der letzten Datenextraktion aus UKG Pro. Er gibt nicht an, wann das Geschäftsereignis eingetreten ist, sondern wann der Datensatz in das Process-Mining-Tool übernommen wurde. Diese Information ist wichtig, um die Aktualität der analysierten Daten einzuschätzen. Analysten und Benutzer aus den Fachbereichen können damit beurteilen, wie aktuell die Prozessdarstellung ist. Außerdem unterstützt sie die Planung von Datenaktualisierungen und die Prüfung, wie aktuell die Erkenntnisse sind. Warum das wichtig ist Zeigt an, wie aktuell die Daten sind. Das ist wichtig, um den Analyseergebnissen zu vertrauen und rechtzeitig Geschäftsentscheidungen zu treffen. Woher beziehen Dieser Timestamp wird während der Datenextraktion, -transformation und -ladung (ETL) erzeugt und jedem Datensatz hinzugefügt. Beispiele 2024-03-15T02:00:00Z2024-03-16T02:00:00Z2024-03-17T02:00:00Z
	Quellsystem SourceSystem	Gibt an, aus welchem System die Daten extrahiert wurden, in diesem Fall aus UKG Pro.
Beschreibung Dieses Attribut gibt die Herkunft der Prozessdaten an. In diesem Fall handelt es sich hauptsächlich um UKG Pro. Für einen Hire-to-Retire-Prozess können jedoch auch Daten aus anderen Systemen einfließen, etwa aus einem Bewerbermanagementsystem (ATS) oder einem Lernmanagementsystem (LMS). Bei der Analyse hilft das Attribut, Datenquellen zu unterscheiden, wenn mehrere Systeme beteiligt sind. Es ist außerdem wichtig für Data Governance und die Fehlerbehebung. Bei einer Auswertung aus nur einer Quelle liefert es wichtige Informationen zur Herkunft der Daten. Warum das wichtig ist Gibt wichtige Informationen für Data Governance, Qualitätssicherung und Rückverfolgbarkeit, indem die Herkunft der Event-Daten ausgewiesen wird. Woher beziehen Üblicherweise ein statischer Wert („UKG Pro“), der bei der Datentransformation und -extraktion hinzugefügt wird. Beispiele UKG ProUKGPro_CoreHRUKG
	Abteilung EmployeeDepartment	Die Abteilung oder Organisationseinheit, der die betreffende Person zugeordnet ist.
Beschreibung Dieses Attribut enthält den Namen der Abteilung, der die betreffende Person zugeordnet ist, etwa „Vertrieb“, „Technik“ oder „Finanzen“. Es ist eine wichtige organisatorische Dimension, um die Prozessleistung aufzuschlüsseln und zu vergleichen. Mithilfe der Abteilung lassen sich Prozessabläufe in verschiedenen Geschäftseinheiten vergleichen. So können Sie beispielsweise untersuchen, ob die „Recruiting-Durchlaufzeit“ in technischen Abteilungen länger ist oder ob die „Einhaltung von Leistungsbeurteilungen“ zwischen Vertrieb und Betrieb deutlich variiert. Daraus ergeben sich gezielte Ansatzpunkte für Verbesserungen. Warum das wichtig ist Ermöglicht aussagekräftige Vergleiche: Sie können den Prozess nach der Organisationsstruktur filtern und aufschlüsseln, um Unterschiede zwischen Abteilungen sichtbar zu machen. Woher beziehen Dies ist ein Standardfeld im Beschäftigungs- oder Positionsdatensatz der betreffenden Person im Core-HR-Modul von UKG Pro. Beispiele TechnikVertriebPersonalwesen
	Ausführender Benutzer ActioningUser	Der Name oder die ID des Benutzers, in der Regel einer HR-Fachkraft oder einer Führungskraft, der die Aktivität in UKG Pro ausgeführt hat.
Beschreibung Dieses Attribut gibt an, wer für die Ausführung eines bestimmten Prozessschritts verantwortlich war, etwa der Recruiter, der ein Angebot unterbreitet hat, oder die Führungskraft, die eine Beförderung genehmigt hat. Es verknüpft Prozessaktivitäten mit den beteiligten Personen. Bei der Analyse hilft dieses Attribut, die Arbeitslast zu verstehen, Schulungsbedarf zu erkennen und die Leistung einzelner Benutzer auszuwerten. So lässt sich beispielsweise feststellen, ob Dateneingabefehler nach „Gehaltsabrechnung eingerichtet“ bei bestimmten Benutzern gehäuft auftreten. Das unterstützt die Kennzahl „Nacharbeitsquote bei Daten nach dem Onboarding“. Warum das wichtig ist Verknüpft Prozessaktivitäten mit bestimmten Benutzern und ermöglicht so die Analyse der Arbeitslast, Leistungsvergleiche sowie die Untersuchung von Nacharbeit und Fehlern. Woher beziehen Üblicherweise in Audit-Trail-Protokollen oder in Feldern wie „Last Modified By“ in den UKG-Pro-Modulen zu finden. Der genaue Feldname hängt vom Modul ab. Beispiele j.does.smithhr_admin
	Beschäftigungsstatus EmploymentStatus	Der aktuelle oder frühere Beschäftigungsstatus der betreffenden Person, etwa „Aktiv“, „Beendet“ oder „Beurlaubt“.
Beschreibung Dieses Attribut gibt den offiziellen Beschäftigungsstatus einer Person im Unternehmen zu einem bestimmten Zeitpunkt an. Es ist eine wichtige Dimension, um den Zustand der Belegschaft zu verstehen und die Analyse auf bestimmte Gruppen von Mitarbeitenden einzugrenzen. Die Analyse von Änderungen des Beschäftigungsstatus hilft dabei, den Prozess korrekt abzubilden, etwa eine vorübergehende Beurlaubung von einer endgültigen Beendigung zu unterscheiden. Das Attribut ist grundlegend für die Berechnung von Fluktuationsraten und das Verständnis der Ergebnisse verschiedener Verläufe im Mitarbeiterlebenszyklus. Warum das wichtig ist Liefert wichtige Informationen zum Beschäftigungsstatus einer Person und ermöglicht eine präzise Fluktuationsanalyse sowie die Aufschlüsselung der Belegschaft. Woher beziehen Dies ist ein zentrales Feld im Mitarbeiterstammdatensatz des Core-HR-Moduls von UKG Pro. Beispiele AktivBeschäftigung beendetBeurlaubung
	Einstellungsdatum HireDate	Das offizielle Datum, an dem das Beschäftigungsverhältnis mit der Organisation beginnt.
Beschreibung Das Einstellungsdatum markiert den Beginn der Beschäftigungsdauer. Als grundlegendes Datumsfeld dient es als Ausgangspunkt für zahlreiche zeitbezogene Berechnungen und Analysen zum Beschäftigungslebenszyklus. Mit diesem Attribut lässt sich die Beschäftigungsdauer berechnen, die für die Analyse der „Frühfluktuationsrate“ entscheidend ist. Es unterstützt außerdem Kohortenanalysen, mit denen sich die Lebenszyklusmuster von Beschäftigten vergleichen lassen, die in unterschiedlichen Zeiträumen eingestellt wurden. Warum das wichtig ist Dient als Ausgangspunkt für die Berechnung der Beschäftigungsdauer und ist für Kohortenanalysen sowie KPIs zur Fluktuationsrate unverzichtbar. Woher beziehen Dieses Standardfeld ist im primären Beschäftigtendatensatz des Core-HR-Moduls von UKG Pro verpflichtend. Beispiele 2022-08-152023-01-202021-05-10
	ID der Stellenausschreibung JobRequisitionId	Die eindeutige Kennung der Stellenausschreibung, mit der der Einstellungsprozess begonnen hat.
Beschreibung Die ID der Stellenausschreibung ist die eindeutige Referenz für eine bestimmte offene Stelle. Sie verknüpft alle frühen Recruiting-Aktivitäten, von der Erstellung und Genehmigung der Ausschreibung bis zur Suche nach Kandidaten und der Unterbreitung von Angeboten. Diese ID ist wichtig für die Analyse der Kennzahl „Recruiting-Durchlaufzeit“, da sie den tatsächlichen Beginn des Einstellungsprozesses markiert. Sie ermöglicht es, den gesamten Recruiting-Trichter für eine einzelne Stelle nachzuverfolgen und Kennzahlen wie die „Quote inaktiver Stellenausschreibungen“ zu analysieren, indem nicht weiterverfolgte Ausschreibungen erkannt werden. Warum das wichtig ist Liefert einen klaren Ausgangspunkt für den Recruiting-Prozess und ermöglicht eine präzise Messung der Einstellungsdauer und der Wirksamkeit von Stellenausschreibungen. Woher beziehen Zu finden im Recruiting-Modul von UKG Pro oder im angebundenen Bewerbermanagementsystem (ATS). Beispiele REQ-2023-015REQ-2024-112REQ-2023-504
	Name der Führungskraft ManagerName	Der Name der direkten Führungskraft oder des Vorgesetzten der beschäftigten Person.
Beschreibung Dieses Attribut bezeichnet die direkte Führungskraft der beschäftigten Person. Sie spielt bei vielen Ereignissen im Beschäftigungslebenszyklus eine wichtige Rolle, etwa bei Leistungsbeurteilungen, Beförderungen und der Zuweisung von Schulungen. Eine Auswertung nach Führungskraft zeigt Unterschiede in der Umsetzung auf Teamebene und gibt Aufschluss über die Wirksamkeit der Führung. Das Dashboard „Auswirkungen eines Führungswechsels“ verwendet dieses Attribut beispielsweise, um zu untersuchen, wie sich ein Wechsel der Führungskraft auf nachfolgende Aktivitäten auswirkt. Auch für die KPI „Zeit bis zur erneuten Einbindung durch die Führungskraft“ ist es entscheidend. Warum das wichtig ist Ermöglicht die Analyse der Prozessleistung auf Teamebene und hilft dabei, die Auswirkungen von Führungskräften auf Ereignisse im Beschäftigungslebenszyklus zu bewerten. Woher beziehen Diese Information ist Teil der Berichtsliniendaten der beschäftigten Person im Core-HR-Modul von UKG Pro. Beispiele John SmithMaria GarciaChen Wei
	Stellenbezeichnung JobTitle	Die offizielle Berufsbezeichnung der beschäftigten Person, zum Beispiel „Softwareentwickler“ oder „Vertriebsleiter“.
Beschreibung Die Berufsbezeichnung beschreibt die Funktion oder Position der beschäftigten Person innerhalb der Organisation. Dieses Attribut ist eine wichtige Dimension, um zu analysieren, wie sich Prozesse je nach Funktion und Hierarchieebene unterscheiden. In Analysen lässt sich die Berufsbezeichnung beispielsweise verwenden, um Einarbeitungszeiten verschiedener Funktionen zu vergleichen, Beförderungsgeschwindigkeiten zu bewerten oder festzustellen, ob Beschäftigte mit bestimmten Berufsbezeichnungen häufiger frühzeitig ausscheiden. So können HR-Prozesse und Unterstützungsangebote gezielt auf die Bedürfnisse verschiedener Beschäftigtengruppen abgestimmt werden. Warum das wichtig ist Ermöglicht eine funktionsbezogene Analyse, um Unterschiede in den Lebenszyklusprozessen nach Aufgabenbereich und Hierarchieebene zu untersuchen. Woher beziehen Dieses Standardfeld gehört zum Positions- oder Beschäftigungsdatensatz im Core-HR-Modul von UKG Pro. Beispiele Softwareentwickler IISenior-ProduktmanagerHR-Business-Partner
	Beendigungsdatum TerminationDate	Das offizielle Datum, an dem das Beschäftigungsverhältnis endet.
Beschreibung Das Beendigungsdatum markiert das Ende der Beschäftigungsdauer und damit den Abschluss des Beschäftigungslebenszyklus innerhalb der Organisation. Dieses Attribut ist erforderlich, um die gesamte Beschäftigungsdauer zu berechnen, und spielt eine zentrale Rolle bei der Fluktuationsanalyse. Der Zeitraum zwischen Einstellungs- und Beendigungsdatum bildet die Grundlage für das Dashboard „Erkenntnisse zur Frühfluktuation“ und die zugehörigen KPIs. Warum das wichtig ist Legt das Ende des Beschäftigungslebenszyklus fest, ermöglicht die Berechnung der gesamten Beschäftigungsdauer und unterstützt alle Analysen zur Fluktuation. Woher beziehen Dieses Standardfeld im primären Beschäftigtendatensatz von UKG Pro wird ausgefüllt, sobald der Beendigungsprozess abgeschlossen ist. Beispiele 2023-11-302024-02-152022-12-31
	Beendigungsgrund TerminationReason	Der dokumentierte Grund für das Ausscheiden einer beschäftigten Person, zum Beispiel „Freiwillig: Kündigung“ oder „Unfreiwillig: Leistung“.
Beschreibung Dieses Attribut erfasst den Grund für die Beendigung des Beschäftigungsverhältnisses. Die Gründe werden üblicherweise in freiwillige und unfreiwillige Beendigungen unterteilt und durch spezifischere Unterkategorien ergänzt. Für Analysen zu Mitarbeiterbindung und Fluktuation ist dieses Attribut besonders wichtig. Werden ausgeschiedene Beschäftigte nach ihrem Austrittsgrund segmentiert, können Organisationen die Ursachen der Fluktuation besser verstehen. Eine Analyse der „Frühfluktuationsrate“ nach Beendigungsgrund kann beispielsweise zeigen, ob ungeeignete Einstellungsentscheidungen oder attraktivere Angebote anderer Arbeitgeber ausschlaggebend waren. Warum das wichtig ist Liefert wichtige Erkenntnisse zu den Ursachen der Mitarbeiterfluktuation und ermöglicht gezielte Maßnahmen zur Mitarbeiterbindung. Woher beziehen Dieses Feld wird üblicherweise während der Beendigung des Beschäftigungsverhältnisses oder des Offboardings im Core-HR-Modul von UKG Pro erfasst. Beispiele Freiwillig: Neue berufliche ChanceUnfreiwillig: LeistungRuhestand
	Endzeit des Ereignisses EventEndTime	Der Timestamp, der den Abschluss einer Aktivität mit messbarer Dauer kennzeichnet.
Beschreibung Bei Aktivitäten, die nicht unmittelbar abgeschlossen sind, erfasst die Endzeit des Ereignisses den Zeitpunkt ihres Abschlusses. Sie unterscheidet sich vom Ereignis-Timestamp (Startzeit), der den Beginn markiert. Mit Start- und Endzeit lässt sich die Verarbeitungszeit einzelner Aktivitäten präzise berechnen, etwa für „Hintergrundüberprüfung“ oder „Einarbeitungsaufgabe“. So können Sie genauer analysieren, wofür innerhalb des Prozesses Zeit aufgewendet wird. Warum das wichtig ist Ermöglicht die präzise Berechnung der Verarbeitungszeit einzelner Aktivitäten und hilft, die zeitaufwendigsten Prozessschritte zu ermitteln. Woher beziehen Stammt aus Datumsfeldern für den Abschluss in UKG Pro. Häufig müssen dazu ein Start-Event und das zugehörige Abschlussereignis aus den Quelldaten miteinander verknüpft werden. Beispiele 2023-01-15T17:30:00Z2023-06-21T10:00:00Z2024-02-01T11:05:00Z
	Frühfluktuation IsEarlyChurn	Ein boolesches Kennzeichen, das angibt, ob eine beschäftigte Person innerhalb eines festgelegten Zeitraums nach der Einstellung, etwa 90 oder 180 Tagen, ausgeschieden ist.
Beschreibung Dieses berechnete Attribut kennzeichnet Beschäftigte, die kurz nach ihrer Einstellung aus der Organisation ausscheiden. Die Organisation legt fest, was als „frühzeitig“ gilt, zum Beispiel ein Ausscheiden innerhalb des ersten Jahres. Das Kennzeichen vereinfacht die Analyse für das Dashboard „Erkenntnisse zur Frühfluktuation“ und die KPI „Frühfluktuationsrate“. Damit lässt sich diese besonders relevante Gruppe schnell filtern und segmentieren, um ihre Merkmale und Lebenszyklusmuster zu untersuchen. So können Probleme bei der Personalbeschaffung oder Einarbeitung erkannt werden. Warum das wichtig ist Unterstützt direkt die Analyse der Frühfluktuation, indem es gefährdete Fälle kennzeichnet und dabei hilft, die Ursachen eines vorzeitigen Ausscheidens zu ermitteln. Woher beziehen Dieses Attribut wird bei der Datenaufbereitung berechnet. Dabei wird die Differenz zwischen „TerminationDate“ und „HireDate“ mit einem festgelegten Schwellenwert verglichen, zum Beispiel 365 Tagen. Beispiele truefalse
	Gehaltsstufe SalaryGrade	Die Gehaltsstufe oder Gehaltsbandbreite, die der Funktion der beschäftigten Person zugeordnet ist.
Beschreibung Die Gehaltsstufe gibt das Vergütungsniveau einer bestimmten Stelle an. Sie ist ein wichtiges Attribut für die Analyse vergütungsbezogener Aktivitäten und Trends. Dieses Attribut ist für Analysen von Ereignissen wie „Vergütung geändert“ relevant. Werden häufig Gehaltsstufen korrigiert, kann es auch zur Überwachung der KPI „Nachbearbeitungsrate von Daten nach dem Onboarding“ dienen. Außerdem lässt sich damit untersuchen, ob sich Beförderungszyklen oder Fluktuationsraten je nach Vergütungsniveau unterscheiden. Warum das wichtig ist Liefert Kontext zu vergütungsbezogenen Aktivitäten und ermöglicht die Segmentierung des Prozesses nach Gehaltsniveau. Woher beziehen Im Vergütungs- oder Stellenprofil der beschäftigten Person im Core-HR-Modul von UKG Pro verfügbar. Beispiele IC3M2D1
	Grund für Funktionswechsel RoleChangeReason	Der Grund für einen Wechsel der Funktion einer beschäftigten Person, zum Beispiel „Beförderung“, „Wechsel auf eine gleichwertige Position“ oder „Umstrukturierung“.
Beschreibung Dieses Attribut liefert Kontext zu internen Wechseln. Es erklärt, warum sich die Funktion oder Position einer beschäftigten Person innerhalb der Organisation geändert hat. Für das Dashboard und die KPI „Dauer interner Wechsel“ ist es unverzichtbar, da sich damit Beförderungen von anderen Arten interner Wechsel unterscheiden lassen. Eine Analyse nach Wechselgrund kann zeigen, ob Beförderungsprozesse länger dauern als Wechsel auf gleichwertige Positionen. So lassen sich Karrierewege gezielter gestalten. Warum das wichtig ist Erklärt den Hintergrund interner Wechsel und ermöglicht eine differenzierte Analyse von internen Mobilitätsprozessen, etwa von Beförderungen im Vergleich zu Wechseln auf gleichwertige Positionen. Woher beziehen Diese Information wird üblicherweise im Rahmen einer Stellenänderung oder eines Versetzungsvorgangs im Core-HR-Modul von UKG Pro erfasst. Beispiele BeförderungWechsel auf eine gleichwertige PositionUmstrukturierung
	Leistungsbewertung PerformanceRating	Die Bewertung, die einer beschäftigten Person im Rahmen eines Leistungsbeurteilungszyklus zugewiesen wird.
Beschreibung Die Leistungsbewertung ist das Ergebnis der Aktivität „Leistungsbeurteilung durchgeführt“. Sie erfolgt üblicherweise anhand einer Skala, zum Beispiel von 1 bis 5, oder beschreibender Kategorien wie „Übertrifft die Erwartungen“. Damit wird die Beurteilung der Leistung einer beschäftigten Person quantifiziert. Dieses Attribut hilft dabei, Prozessereignisse mit Leistungsergebnissen in Beziehung zu setzen. So lässt sich beispielsweise untersuchen, ob leistungsstarke Beschäftigte schneller befördert werden oder ob ein Zusammenhang zwischen Leistungsbewertungen und Mitarbeiterfluktuation besteht. Es ist ein zentrales Element des Dashboards „Einhaltung des Leistungsbeurteilungszyklus“. Warum das wichtig ist Setzt Prozessereignisse mit Leistungsergebnissen in Beziehung und ermöglicht so die Analyse der Wirksamkeit des Talentmanagements und seiner Auswirkungen auf die Mitarbeiterbindung. Woher beziehen Im Performance-Management-Modul von UKG Pro zu finden und bestimmten Beurteilungszyklen zugeordnet. Beispiele Übertrifft die ErwartungenErfüllt die ErwartungenVerbesserungsbedarf5
	Name der Schulung TrainingName	Der Name oder Titel des Schulungskurses, der der beschäftigten Person zugewiesen wurde.
Beschreibung Dieses Attribut bezeichnet eine bestimmte Schulung oder ein Lernmodul, das einer beschäftigten Person zugewiesen wurde. Dazu gehören sowohl verpflichtende Compliance-Schulungen als auch funktionsspezifische Weiterbildungen. Das Attribut ist wichtig für das Dashboard „Zuweisung und Abschluss von Schulungen“ und die KPI „Abschlussquote von Schulungen“. Damit lassen sich Fortschritt und Wirksamkeit einzelner Schulungsprogramme verfolgen und Abschlusszeiten verschiedener Kurse analysieren. Warum das wichtig ist Ermöglicht die Nachverfolgung und Analyse einzelner Schulungsprogramme und hilft, die Einhaltung von Vorgaben sowie den Lernerfolg zu messen. Woher beziehen Stammt aus dem Learning-Modul von UKG Pro oder einem angebundenen Learning Management System (LMS). Beispiele Verhaltenskodex 2024Fortgeschrittene FührungskompetenzenCybersecurity-Bewusstsein
	Standort Location	Der geografische Standort oder das Büro, an dem die beschäftigte Person arbeitet.
Beschreibung Dieses Attribut gibt den primären Arbeitsort der beschäftigten Person an. Dabei kann es sich um eine Stadt, ein Land oder ein bestimmtes Bürogebäude handeln. Es ist eine wichtige Dimension für die geografische Analyse von HR-Prozessen. Eine Analyse der Prozessleistung nach Standort kann regionale Unterschiede bei der Effizienz der Personalbeschaffung, den Einarbeitungspraktiken oder den Fluktuationsraten aufdecken. So können Sie beispielsweise die „Dauer des Einstellungsprozesses“ in den Büros „New York“ und „London“ vergleichen, um bewährte Vorgehensweisen oder lokale Engpässe zu erkennen. Warum das wichtig ist Ermöglicht die geografische Segmentierung des Prozesses und macht regionale Unterschiede bei Leistung und Compliance sichtbar. Woher beziehen Diese Information gehört zu den Beschäftigungs- oder Personaldaten im Core-HR-Modul von UKG Pro. Beispiele New York, NYLondon, Vereinigtes KönigreichRemote

Erforderlich Empfohlen Optional

Aktivitäten im Hire-to-Retire-Prozess des Mitarbeiterlebenszyklus

Diese wichtigen Prozessschritte und Meilensteine sollten Sie in Ihrem Event Log erfassen, um den Prozess präzise zu entdecken und zu optimieren.

6 Empfohlen 9 Optional

	Aktivität	Beschreibung
	Beendigung eingeleitet	Kennzeichnet den Beginn des Offboarding-Prozesses und wird protokolliert, wenn ein zukünftiges Beendigungsdatum im System eingetragen wird. Dieses Event löst Offboarding-Checklisten und Workflows aus.
Warum das wichtig ist Dieser wichtige Meilenstein leitet den Austrittsprozess ein. Die Analyse der Zeit zwischen diesem Event und der endgültigen Beendigung zeigt, wie effizient und vollständig die Offboarding-Verfahren sind. Woher beziehen Dabei handelt es sich üblicherweise um die Anlage eines „Termination“-Datensatzes in den Beschäftigungsdaten der betreffenden Person, der ein zukünftiges Wirksamkeitsdatum enthält. Alternativ kann es der Beginn eines Offboarding-Workflows in einem bestimmten Modul sein. Erfassung Erfasst, wenn ein Beendigungsvorgang mit einem zukünftigen Datum eingereicht wird. Ereignistyp explicit
	Beförderung genehmigt	Kennzeichnet die formelle Genehmigung einer Beförderung, die in der Regel eine Änderung der Stellenbezeichnung und häufig auch der Vergütung umfasst. Dieses Event tritt vor dem Wirksamkeitsdatum der Änderung ein.
Warum das wichtig ist Diese Aktivität ist wichtig für die Analyse interner Wechsel und der beruflichen Entwicklung. Die Zeit zwischen der Genehmigung einer Beförderung und ihrem Wirksamkeitsdatum kann auf administrative Engpässe im System hinweisen. Woher beziehen Wird im Beschäftigungsverlauf der betreffenden Person im HR-Core-Modul als bestimmte Personalmaßnahme, etwa „Promotion“, protokolliert. Der Datensatz enthält ein eigenes Genehmigungs- und Wirksamkeitsdatum. Erfassung Erfasst anhand des Protokolldatums einer „Promotion“-Aktion im Beschäftigungsverlauf. Ereignistyp explicit
	Beschäftigung beendet	Das letzte Event im Mitarbeiterlebenszyklus. Es kennzeichnet das offizielle Ende des Beschäftigungsverhältnisses. Zum Wirksamkeitsdatum der Beendigung wird der Datensatz der betreffenden Person im System inaktiv.
Warum das wichtig ist Dies ist das maßgebliche End-Event des Prozesses. Es ist entscheidend, um die endgültige Beschäftigungsdauer zu berechnen und die Fluktuation zu analysieren. Damit endet der Beschäftigungsverlauf im Unternehmen. Woher beziehen Dies ist das Wirksamkeitsdatum der abschließenden „Termination“-Aktion im Beschäftigungsverlauf der betreffenden Person im HR-Core-Modul. An diesem Datum ändert das System den Status üblicherweise von aktiv zu inaktiv. Erfassung Erfasst anhand des Wirksamkeitsdatums der „Termination“-Aktion im Beschäftigungsverlauf der betreffenden Person. Ereignistyp explicit
	Leistungsbeurteilung durchgeführt	Kennzeichnet den Abschluss eines formellen Leistungsbeurteilungszyklus für eine Person. Dieses Event wird protokolliert, wenn die Führungskraft oder HR das Beurteilungsformular fertigstellt und einreicht.
Warum das wichtig ist Dies ist ein wichtiger, regelmäßig wiederkehrender Meilenstein im Mitarbeiterlebenszyklus. Die Häufigkeit und fristgerechte Durchführung zeigen, ob die Vorgaben für das Leistungsmanagement eingehalten werden und wie sich dies auf die berufliche Entwicklung auswirkt. Woher beziehen Zu finden im Performance-Management-Modul von UKG Pro. Erkennbar ist das Event am Abschlussdatum des Beurteilungsformulars oder an der Statusänderung des Beurteilungszyklus zu „Completed“. Erfassung Erfasst anhand des Abschluss-Timestamps der Workflow-Instanz für die Leistungsbeurteilung. Ereignistyp explicit
	Mitarbeiter eingestellt	Kennzeichnet die offizielle Anlage des Mitarbeiterdatensatzes in UKG Pro, bei der eine Mitarbeiter-ID vergeben wird. Dieses Event wird in der Regel erfasst, wenn ein HR-Administrator den Einstellungsprozess für eine Person abschließt und sie im System als aktive Mitarbeiterin oder aktiven Mitarbeiter führt.
Warum das wichtig ist Dies ist das maßgebliche Start-Event für die Analyse des Hire-to-Retire-Prozesses. Es bildet die Grundlage, um die Zeit bis zur Produktivität, die Effizienz des Onboardings und die gesamte Beschäftigungsdauer zu messen. Woher beziehen Dieses Event wird wahrscheinlich im HR-Core- oder Personalverwaltungsmodul protokolliert. Es lässt sich am Erstellungsdatum des primären Beschäftigungsdatensatzes oder an einem bestimmten „Hire“-Eintrag im Verlauf der Beschäftigungsdaten erkennen. Erfassung Erfasst anhand des Wirksamkeitsdatums der Aktion „Hire“ in der Tabelle mit dem Beschäftigungsverlauf. Ereignistyp explicit
	Onboarding abgeschlossen	Ein wichtiger Meilenstein, der den erfolgreichen Abschluss der ersten Onboarding-Checkliste oder des zugehörigen Workflows kennzeichnet. In der Regel sind damit alle erforderlichen Unterlagen für neue Mitarbeitende, Anfragen für Systemzugriffe und erste Verwaltungsaufgaben erledigt.
Warum das wichtig ist Kennzeichnet das Ende der ersten administrativen Einrichtung und ermöglicht die Analyse der gesamten Onboarding-Durchlaufzeit. Ab diesem Zeitpunkt ist die betreffende Person administrativ bereit, ihre aufgabenspezifische Tätigkeit aufzunehmen. Woher beziehen Zu finden im Onboarding-Modul. Das Event lässt sich in der Regel aus dem Abschluss-Timestamp des gesamten Onboarding-Workflows oder dem Abschluss der letzten verpflichtenden Onboarding-Aufgabe ableiten. Erfassung Abgeleitet aus dem Abschluss-Timestamp der übergeordneten Onboarding-Checkliste für die betreffende Person. Ereignistyp inferred
	Austrittsgespräch durchgeführt	Dieses Event kennzeichnet den Abschluss des Austrittsgesprächs mit der ausscheidenden Person. Üblicherweise wird es als erledigte Aufgabe in einer Offboarding-Checkliste erfasst.
Warum das wichtig ist Die Nachverfolgung abgeschlossener Austrittsgespräche ist wichtig, um die Einhaltung der HR-Vorgaben sicherzustellen und wertvolles Feedback zu erhalten. So lässt sich erkennen, ob dieser wichtige Schritt im Offboarding ausgelassen wird. Woher beziehen Dieses Event ist wahrscheinlich im Onboarding- oder HR-Help-Desk-Modul von UKG Pro als bestimmte Aufgabe in einem Offboarding-Workflow zu finden. Es wird erfasst, wenn HR die Aufgabe manuell als erledigt markiert. Erfassung Als erledigte Aufgabe in der Offboarding-Checkliste der betreffenden Person protokolliert. Ereignistyp explicit
	Beurlaubung begonnen	Kennzeichnet den Beginn einer genehmigten Beurlaubung, etwa aus medizinischen oder persönlichen Gründen. Das Event wird erfasst, wenn sich der Status der betreffenden Person zu inaktiv oder beurlaubt ändert.
Warum das wichtig ist Macht Zeiten sichtbar, in denen eine Person im Mitarbeiterlebenszyklus nicht aktiv ist. Das ist wichtig, um die aktive Beschäftigungsdauer korrekt zu berechnen und die Auswirkungen einer Beurlaubung auf die berufliche Entwicklung zu verstehen. Woher beziehen Zu finden im Beschäftigungsverlauf der betreffenden Person im HR-Core-Modul. Das Event entspricht einer Personalmaßnahme wie „Leave of Absence“ mit einem bestimmten Wirksamkeitsdatum für den Beginn. Erfassung Erfasst anhand des Wirksamkeitsdatums einer „Start Leave“-Aktion im Beschäftigungsverlauf. Ereignistyp explicit
	Führungskraft geändert	Dieses Event wird ausgelöst, wenn das Feld „Reports To“ oder „Manager ID“ einer Person aktualisiert wird. Es kennzeichnet eine Änderung der direkten Berichtslinie.
Warum das wichtig ist Ein Wechsel der Führungskraft kann sich deutlich auf die Zufriedenheit und Leistung von Mitarbeitenden auswirken. Durch die Nachverfolgung dieses Events lässt sich untersuchen, wie sich der Wechsel auf spätere Aktivitäten wie Leistungsbeurteilungen oder die Mitarbeiterbindung auswirkt. Woher beziehen Dieses Event muss abgeleitet werden, indem Änderungen am Feld für Führungskraft oder Vorgesetzte in den Beschäftigungsdaten der betreffenden Person über einen längeren Zeitraum nachverfolgt werden. Dazu wird die Manager-ID in aufeinanderfolgenden Datensätzen derselben Person verglichen. Erfassung Abgeleitet aus einer Änderung des Felds „Reports To“ im Beschäftigungsverlauf der betreffenden Person. Ereignistyp inferred
	Gehaltsabrechnung eingerichtet	Zeigt an, dass alle erforderlichen Angaben für die Gehaltsabrechnung der betreffenden Person, etwa Bankdaten und Steuerformulare, erfasst und geprüft wurden. Dieser wichtige Schritt stellt sicher, dass die Gehaltszahlung korrekt und pünktlich erfolgt.
Warum das wichtig ist Dieser Meilenstein ist entscheidend, um die Einsatzbereitschaft neuer Mitarbeitender zu messen. Verzögerungen bei der Einrichtung der Gehaltsabrechnung können zu Unzufriedenheit und zusätzlicher Verwaltungsarbeit führen. Daher ist dieser Schritt eine wichtige Kennzahl für das Onboarding. Woher beziehen Dieses Event lässt sich möglicherweise aus dem Payroll-Modul von UKG Pro ableiten. Als Grundlage kann das Abschlussdatum einer Checkliste zur Vorbereitung der Gehaltsabrechnung oder der Zeitpunkt dienen, an dem sich der Status der betreffenden Person zu „Ready for Payroll“ ändert. Erfassung Abgeleitet aus einer Statusänderung oder dem Abschluss-Timestamp im Gehaltsabrechnungsprofil der betreffenden Person. Ereignistyp inferred
	Offboarding abgeschlossen	Ein Meilenstein, der anzeigt, dass alle verpflichtenden Offboarding-Aufgaben erledigt sind. Dazu gehören beispielsweise die Rückgabe von Arbeitsmitteln, die abschließende Gehaltsabrechnung und der Entzug von Systemzugriffen.
Warum das wichtig ist Dieses Event bestätigt, dass alle erforderlichen Schritte für einen sicheren und regelkonformen Austritt der betreffenden Person abgeschlossen sind. Es hilft dabei, die Offboarding-Durchlaufzeit zu messen und Lücken bei der Compliance zu erkennen. Woher beziehen Lässt sich anhand des Abschluss-Timestamps der gesamten Offboarding-Checkliste oder des Workflows ableiten, ähnlich wie beim Event „Onboarding abgeschlossen“, jedoch für den Austrittsprozess. Erfassung Abgeleitet aus dem Abschluss-Timestamp der übergeordneten Offboarding-Checkliste für die betreffende Person. Ereignistyp inferred
	Onboarding gestartet	Kennzeichnet den Beginn des Onboarding-Prozesses oder Workflows für neue Mitarbeitende in UKG Pro. Dabei handelt es sich in der Regel um ein automatisch oder manuell ausgelöstes Event, das neuen Mitarbeitenden, ihren Führungskräften und HR eine Aufgaben-Checkliste zuweist.
Warum das wichtig ist Mit dieser Aktivität lässt sich die Zeit zwischen dem offiziellen Einstellungsdatum und dem Beginn der administrativen und kulturellen Integration messen. Sie bildet den Ausgangspunkt für die Analyse der Onboarding-Effizienz und das Erkennen von Verzögerungen. Woher beziehen Zu finden im Onboarding-Modul von UKG Pro. Das Event lässt sich anhand des Erstellungsdatums der Onboarding-Checkliste oder der zugehörigen Workflow-Instanz für die betreffende Person ableiten. Erfassung Abgeleitet aus dem Erstellungs-Timestamp des Onboarding-Workflows oder der Aufgabenliste der betreffenden Person. Ereignistyp inferred
	Rollenwechsel verarbeitet	Kennzeichnet eine Änderung der Stelle oder Position, die keine Beförderung ist, etwa einen Wechsel auf eine gleichrangige Position oder in eine andere Abteilung. Das Event wird protokolliert, wenn die entsprechenden Beschäftigungsdaten im System aktualisiert werden.
Warum das wichtig ist Die Analyse von Rollenwechseln liefert Erkenntnisse zu internen Wechseln, zum Einsatz von Talenten und zu organisatorischen Veränderungen. Sie zeigt, wie sich Mitarbeitende innerhalb des Unternehmens bewegen. Woher beziehen Erfasst anhand des Beschäftigungsverlaufs der betreffenden Person im HR-Core-Modul. Erkennbar ist das Event an Personalmaßnahmen wie „Transfer“, „Re-assignment“ oder „Position Change“ sowie den jeweiligen Wirksamkeitsdaten. Erfassung Erkennbar an einem Aktionscode wie „Transfer“ im Beschäftigungsverlauf der betreffenden Person. Ereignistyp explicit
	Schulung zugewiesen	Erfasst den Zeitpunkt, zu dem einer Person ein bestimmter Schulungskurs oder Lernplan zugewiesen wird. Dies wird üblicherweise im Lernmanagementmodul des Systems protokolliert.
Warum das wichtig ist Mit dieser Aktivität lässt sich die Einhaltung verpflichtender Schulungen nachverfolgen und die Entwicklung der Mitarbeitenden beobachten. Die Analyse der Zeit zwischen Zuweisung und Abschluss kann auf mangelnde Beteiligung oder eine geringe Wirksamkeit der Schulung hinweisen. Woher beziehen Wird in den Lernmanagement- oder Talentmanagementmodulen von UKG Pro erfasst. Für jede Zuweisung sollte ein Datensatz mit Zuweisungsdatum und Mitarbeiter-ID vorliegen. Erfassung Protokolliert, wenn einer Person ein Kurs oder Lehrplan für den Lernplan zugewiesen wird. Ereignistyp explicit
	Vergütung geändert	Dieses Event erfasst Änderungen am Grundgehalt, an der Bonusstruktur oder an anderen Vergütungsbestandteilen einer Person. Es kann sich um eine Beförderung, eine leistungsbezogene Gehaltserhöhung oder eine Marktanpassung handeln.
Warum das wichtig ist Die Nachverfolgung von Vergütungsänderungen ist wichtig, um die berufliche Entwicklung und Gehaltsentwicklung zu verstehen. Häufige Anpassungen nach der Einstellung können auf Fehler bei der Dateneingabe oder bei der ursprünglichen Gehaltsfestlegung hinweisen. Woher beziehen Zu finden in der Tabelle zum Vergütungsverlauf der betreffenden Person im HR-Core- oder Payroll-Modul. Jede Änderung wird üblicherweise mit einem Wirksamkeitsdatum und einem Grundcode erfasst. Erfassung Protokolliert anhand des Wirksamkeitsdatums eines neuen Eintrags im Vergütungsverlauf der betreffenden Person. Ereignistyp explicit

Anleitungen zum Extrahieren von Daten

So exportieren Sie Ihre Daten aus UKG Pro

Schritte

Voraussetzungen: Installieren Sie Python 3.6 oder höher sowie die Bibliotheken requests und pandas. Installieren Sie diese mit pip: pip install requests pandas.
API-Zugriff und Authentifizierung: Bitten Sie Ihren UKG-Pro-Administrator, ein Servicekonto einzurichten. Sie benötigen den API Key, User Name und das Password. Das Servicekonto muss auf alle erforderlichen API-Endpunkte zugreifen können, darunter Personal-, Gehaltsabrechnungs-, Onboarding-, Leistungs- und Lerndaten.
Skript konfigurieren: Öffnen Sie das bereitgestellte Python-Skript in einem Texteditor oder einer IDE. Suchen Sie den Konfigurationsabschnitt am Anfang des Skripts und ersetzen Sie die Platzhalter für UKG_BASE_URL, API_KEY, USERNAME, PASSWORD und COMPANY_ID durch Ihre Zugangsdaten und Umgebungsinformationen.
Zeitraum für die Extraktion festlegen: Definieren Sie im Konfigurationsabschnitt die Variablen START_DATE und END_DATE. Damit legen Sie den Zeitraum fest, aus dem Änderungen und Ereignisse zu Mitarbeitenden extrahiert werden. Testen Sie das Skript zunächst mit einem kürzeren Zeitraum, zum Beispiel 3 bis 6 Monaten.
Skript ausführen: Starten Sie das Skript über die Befehlszeile mit python your_script_name.py. Das Skript authentifiziert sich, ruft für jede Aktivität Daten über verschiedene UKG-Pro-API-Endpunkte ab und zeigt den Fortschritt in der Konsole an.
API-Drosselung berücksichtigen: Das Skript enthält einen einfachen Aufruf von time.sleep(), um die API-Ratenbegrenzungen einzuhalten. Bei Drosselungsfehlern (HTTP 429) müssen Sie möglicherweise die Wartezeit zwischen API-Aufrufen verlängern.
Daten umwandeln und vereinheitlichen: Jede Funktion im Skript ruft Rohdaten für eine bestimmte Aktivität ab, wählt die relevanten Felder aus und benennt sie entsprechend dem Standardformat des Event Logs um (EmployeeId, ActivityName, EventTimestamp usw.).
Ereignisdaten zusammenführen: Der Hauptteil des Skripts ruft die Funktionen für die einzelnen Aktivitäten auf und fügt die resultierenden Daten zu einer zentralen Ereignisliste zusammen.
Event Log erstellen: Nach der Verarbeitung aller Aktivitäten führt das Skript die Daten in einem pandas-DataFrame zusammen, sortiert sie nach Mitarbeiter-ID und Timestamp und speichert sie als CSV-Datei mit dem Namen ukg_hire_to_retire_event_log.csv.
Prüfen und hochladen: Öffnen Sie die erstellte CSV-Datei und prüfen Sie, ob die Daten vollständig und korrekt formatiert sind. Anschließend können Sie die Datei in das Process-Mining-Tool hochladen.

Konfiguration

Authentifizierungsdaten: Für die API-Authentifizierung benötigen Sie den API Key, User Name und das Password eines Servicekontos.
Basis-URL: Die UKG_BASE_URL Ihrer UKG-Pro-Instanz, zum Beispiel https://service[##].ultipro.com/api.
Company ID: Für viele API-Aufrufe benötigen Sie die eindeutige COMPANY_ID Ihrer Organisation in UKG Pro.
Datumsbereich: Mit den Parametern START_DATE und END_DATE im Format „YYYY-MM-DD“ legen Sie den Extraktionszeitraum fest. Für den ersten Durchlauf empfiehlt sich ein Zeitraum von 3 bis 6 Monaten, damit die Datenmenge überschaubar bleibt und Sie die Ergebnisse prüfen können.
Versionen der API-Endpunkte: Das Skript verwendet bestimmte Versionen der REST-APIs, zum Beispiel /personnel/v1/. Prüfen Sie, ob Ihre UKG-Pro-Instanz diese Versionen unterstützt.
Modulabhängigkeiten: Für die Extraktion bestimmter Aktivitäten muss Ihre Organisation die entsprechenden UKG-Pro-Module lizenziert haben und aktiv einsetzen, etwa Onboarding, Learning und Performance Management. Wird ein Modul nicht verwendet, werden die zugehörigen Aktivitäten nicht extrahiert.

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

Möchten Sie loslegen?

Mit diesem Template bereiten Sie Ihre Daten gezielt vor und gewinnen wichtige Erkenntnisse zu Ihren HR-Prozessen. Beginnen Sie noch heute damit, den Hire-to-Retire-Prozess zu optimieren.

Zurück zum Leitfaden zur Prozessverbesserung

Template herunterladen

Optimieren Sie noch heute den Hire-to-Retire-Prozess im Mitarbeiterlebenszyklus!

Verkürzen Sie die Durchlaufzeit des Hire-to-Retire-Prozesses um 30 % und steigern Sie die Effizienz im Personalwesen.

Starten Sie Ihre kostenlose Testphase

Keine Kreditkarte erforderlich. Schnell eingerichtet.

Ihr Daten-Template für den Hire-to-Retire-Prozess im Mitarbeiterlebenszyklus

Ihr Daten-Template für den Hire-to-Retire-Prozess im Mitarbeiterlebenszyklus

Attribute für den Hire-to-Retire-Prozess im Mitarbeiterlebenszyklus

Aktivitäten im Hire-to-Retire-Prozess des Mitarbeiterlebenszyklus

Anleitungen zum Extrahieren von Daten

Datenextraktion mit einem Python-Skript über die UKG-Pro-REST-APIs

Schritte

Konfiguration

Beispielabfrage python

Möchten Sie loslegen?

Optimieren Sie noch heute den Hire-to-Retire-Prozess im Mitarbeiterlebenszyklus!