> Kontinuierliche Prozessverbesserung > Hire to Retire Employee Lifecycle > UKG Pro > Datenvorlage

Daten-Template: Hire to Retire - Mitarbeiterlebenszyklus

UKG Pro

Hire to Retire - Employee Lifecycle-Attribute (22) Hire to Retire - Employee Lifecycle-Aktivitäten (15) Extraktionsleitfäden (1)

Ihre Datenvorlage für den Mitarbeiterlebenszyklus – Vom Recruiting bis zur Pensionierung

Dieses Template bietet einen umfassenden Überblick über die wesentlichen Datenelemente, die zur effektiven Analyse Ihres Hire-to-Retire-Prozesses erforderlich sind. Es skizziert die entscheidenden Attribute, die gesammelt werden müssen, die nachzuverfolgenden Schlüsselaktivitäten und praktische Anleitungen zur Extraktion dieser Daten aus UKG Pro. Nutzen Sie diese Ressource, um Ihre Datenaufbereitung zu optimieren und so einen reibungslosen Start in Ihre Process Mining-Reise zu gewährleisten.

Empfohlene Attribute zur Erfassung
Wichtige Aktivitäten zur Verfolgung
Extraktionsanleitung für UKG Pro

Neu bei Event Logs? Erfahren Sie wie man ein Process Mining Event Log erstellt.

Vorlage herunterladen

Hire to Retire - Employee Lifecycle-Attribute

Dies sind die empfohlenen Datenfelder, die Sie in Ihrem Event Log aufnehmen sollten, um eine umfassende Analyse und wertvolle Erkenntnisse für den Mitarbeiterlebenszyklus vom Eintritt bis zum Austritt zu gewinnen.

5 Erforderlich 7 Empfohlen 10 Optional

	Name	Beschreibung
	Ereignis-Timestamp EventTimestamp	Das genaue Datum und die Uhrzeit, zu der ein spezifisches Lifecycle-Event aufgetreten ist.
Beschreibung Der Event Timestamp liefert den chronologischen Kontext für jede Activity und bildet das Rückgrat des Process Flows. Er zeichnet den genauen Zeitpunkt auf, zu dem ein Event wie „Angebot angenommen“ oder „Beförderung genehmigt“ im System registriert wurde. In der Analyse werden diese Timestamps verwendet, um Dauern zwischen Activities zu berechnen, Verzögerungen zu identifizieren und Cycle Times für Schlüssel-Subprocesses wie Rekrutierung und Onboarding zu messen. Genaue Timestamps sind entscheidend für alle zeitbasierten KPIs und die Leistungsanalyse. Warum es wichtig ist Dieses Attribut ist unerlässlich für die chronologische Reihenfolge der Events und die Berechnung aller zeitbasierten Metriken, wie z.B. Durchlaufzeiten und Dauern. Woher erhalten Stammt aus Datums- oder Zeitstempelfeldern, die mit spezifischen Events in UKG Pro verknüpft sind, wie z.B. 'Einstellungsdatum', 'Kündigungsdatum' oder Zeitstempeln von Statusänderungen in Workflow-Modulen. Beispiele 2023-01-15T09:00:00Z2023-06-20T14:35:10Z2024-02-01T11:00:00Z
	Mitarbeiter-ID EmployeeId	Die jedem Mitarbeiter zugewiesene eindeutige ID, die als primäre Case ID für den gesamten Lifecycle innerhalb der Organisation dient.
Beschreibung Die Employee ID dient als zentraler Ankerpunkt, der alle Events im Zusammenhang mit einem Mitarbeiter verbindet – von der ersten Bewerbung bis zum endgültigen Austritt. Diese ID ist entscheidend für die Erstellung einer vollständigen End-to-End-Prozessansicht der Reise eines Individuums. In der Process Mining-Analyse wird jede Activity, wie „Mitarbeiter eingestellt“, „Beförderung genehmigt“ oder „Kündigung eingeleitet“, mit dieser eindeutigen ID verknüpft. Dies ermöglicht die Analyse individueller Mitarbeiterpfade, Kohortenanalysen basierend auf Mitarbeiter-Attributen und die genaue Berechnung von Lifecycle-Dauern. Warum es wichtig ist Dies ist der wesentliche Case Identifier, der alle mitarbeiterbezogenen Events miteinander verknüpft und so die Analyse des End-to-End Hire-to-Retire-Prozesses für jeden Einzelnen ermöglicht. Woher erhalten Dies ist ein Kernfeld in UKG Pro, das typischerweise in Mitarbeiterprofilen oder Stammdatensätzen zu finden ist. Konsultieren Sie die UKG Pro-Dokumentation für den spezifischen Tabellen- und Feldnamen, der oft als Employee Number oder Person ID bezeichnet wird. Beispiele 10052198345210047
	Aktivitätsname ActivityName	Der Name des spezifischen Events oder Meilensteins, der im Mitarbeiter-Lifecycle aufgetreten ist, z.B. „Mitarbeiter eingestellt“ oder „Leistungsbeurteilung durchgeführt“.
Beschreibung Der Activity Name beschreibt einen einzelnen Schritt oder eine Aufgabe innerhalb des Hire-to-Retire-Prozesses. Diese Events werden mit einem Timestamp versehen und geordnet, um den Process Flow zu erstellen, der im Process Mining visualisiert und analysiert wird. Die Analyse der Abfolge und Häufigkeit dieser Activities offenbart die tatsächliche Prozessausführung. Sie hilft dabei, gängige Pfade, Abweichungen vom Standardprozess und Bottlenecks zwischen Schlüsselaktivitäten wie „Onboarding eingeleitet“ und „Lohnabrechnung eingerichtet“ zu identifizieren. Warum es wichtig ist Dieses Attribut definiert die Schritte in der Prozesslandkarte und ermöglicht so die Visualisierung und Analyse des Mitarbeiterlebenszyklusflusses. Woher erhalten Dies wird typischerweise aus Event Logs, Workflow-Statusänderungen oder spezifischen Datumsfeldern innerhalb verschiedener UKG Pro-Module (z.B. Recruiting, Onboarding, Performance Management) abgeleitet. Eine Mapping-Logik ist normalerweise erforderlich, um standardisierte Aktivitätsnamen zu generieren. Beispiele Mitarbeiter eingestelltLeistungsbeurteilung durchgeführtAustritt eingeleitet
	Letzte Datenaktualisierung LastDataUpdate	Der Timestamp, der angibt, wann die Data für dieses Event zuletzt aktualisiert oder aus dem Quellsystem extrahiert wurde.
Beschreibung Dieses Attribut liefert den Timestamp der letzten Datenextraktion aus UKG Pro. Es ist nicht der Zeitpunkt, zu dem das Geschäftsereignis stattfand, sondern der Zeitpunkt, zu dem der Datensatz in das Process Mining Tool übernommen wurde. Diese Information ist entscheidend, um die Aktualität der analysierten Daten zu verstehen. Sie ermöglicht Analysten und Business Usern, den aktuellen Stand der Prozessansicht zu erkennen, und hilft bei der Verwaltung von Datenaktualisierungsplänen sowie der Validierung der Aktualität der Erkenntnisse. Warum es wichtig ist Zeigt die Aktualität der Daten an und ist entscheidend für das Vertrauen in die Analyse sowie für zeitnahe Geschäftsentscheidungen. Woher erhalten Dieser Timestamp wird während des Datenextraktions-, Transformations- und Ladeprozesses (ETL) generiert und an jeden Datensatz angehängt. Beispiele 2024-03-15T02:00:00Z2024-03-16T02:00:00Z2024-03-17T02:00:00Z
	Quellsystem SourceSystem	Identifiziert das System, aus dem die Daten extrahiert wurden; in diesem Fall UKG Pro.
Beschreibung Dieses Attribut spezifiziert den Ursprung der Prozessdaten. Während es in diesem Kontext primär UKG Pro ist, kann ein Hire to Retire Prozess Daten aus anderen Systemen wie einem Applicant Tracking System (ATS) oder einem Learning Management System (LMS) umfassen. In der Analyse hilft es, Datenquellen zu unterscheiden, wenn mehrere Systeme beteiligt sind, und ist entscheidend für Data Governance und Fehlerbehebung. Für eine Einzelsicht liefert es wesentlichen Kontext über die Datenherkunft. Warum es wichtig ist Bietet entscheidenden Kontext für Datengovernance, Qualitätssicherung und Nachverfolgbarkeit, indem der Ursprung der Event-Daten identifiziert wird. Woher erhalten Dies ist typischerweise ein statischer Wert ('UKG Pro'), der während des Datentransformations- und -extraktionsprozesses hinzugefügt wird. Beispiele UKG ProUKGPro_CoreHRUKG
	Abteilung EmployeeDepartment	Die Abteilung oder Organisationseinheit, der der Mitarbeiter zugeordnet ist.
Beschreibung Dieses Attribut enthält den Namen der zugewiesenen Abteilung des Mitarbeiters, wie beispielsweise 'Vertrieb', 'Entwicklung' oder 'Finanzen'. Es ist eine entscheidende organisatorische Dimension für die Segmentierung und den Vergleich der Prozessleistung. Die Analyse nach Abteilung ermöglicht den Vergleich der Prozessausführung über verschiedene Geschäftsbereiche hinweg. So lässt sich beispielsweise untersuchen, ob die 'Rekrutierungsdurchlaufzeit' für technische Abteilungen länger ist oder ob die 'Einhaltung von Leistungsbeurteilungen' zwischen Vertrieb und Betrieb erheblich variiert, was gezielte Verbesserungserkenntnisse liefert. Warum es wichtig ist Ermöglicht eine aussagekräftige Vergleichsanalyse, indem der Prozess basierend auf der Organisationsstruktur gefiltert und segmentiert werden kann, was abteilungsbezogene Variationen aufzeigt. Woher erhalten Dies ist ein Standardfeld im Stellen- oder Positionsdatensatz des Mitarbeiters innerhalb des Core HR-Moduls von UKG Pro. Beispiele EngineeringVertriebPersonalwesen
	Ausführender Benutzer ActioningUser	Der Name oder die ID des Benutzers, typischerweise eines HR-Vertreters oder Managers, der die Activity in UKG Pro durchgeführt hat.
Beschreibung Dieses Attribut identifiziert die Person, die für die Ausführung eines spezifischen Prozessschritts verantwortlich ist, z.B. den Recruiter, der ein Angebot unterbreitete, oder den Manager, der eine Beförderung genehmigte. Es verknüpft Prozessaktivitäten mit menschlichen Akteuren. In der Analyse ist dieses Attribut von unschätzbarem Wert für das Verständnis der Arbeitslastverteilung, die Identifizierung von Schulungsbedarfen und die Analyse der nutzerspezifischen Leistung. Es kann beispielsweise helfen, festzustellen, ob Dateneingabefehler nach 'Einrichtung der Gehaltsabrechnung abgeschlossen' bei bestimmten Benutzern konzentriert sind, und unterstützt so den KPI 'Nach-Onboarding-Daten-Nacharbeitsrate'. Warum es wichtig ist Verknüpft Process Activities mit spezifischen Nutzern und ermöglicht so eine Arbeitslastanalyse, Leistungsvergleiche sowie die Untersuchung von Nacharbeiten oder Fehlern. Woher erhalten Typischerweise in Audit-Trail-Logs oder 'Last Modified By'-Feldern innerhalb der UKG Pro-Module zu finden. Der genaue Feldname variiert je nach Modul. Beispiele j.does.smithhr_admin
	Beschäftigungsstatus EmploymentStatus	Der aktuelle oder historische Beschäftigungsstatus des Mitarbeiters, wie „Aktiv“, „Gekündigt“ oder „Beurlaubt“.
Beschreibung Dieses Attribut gibt den offiziellen Status des Mitarbeiters im Unternehmen zu einem bestimmten Zeitpunkt an. Es ist eine entscheidende Dimension für das Verständnis des Gesamtzustands der Belegschaft und zur Filterung von Analysen auf spezifische Mitarbeiterpopulationen. Die Analyse von Änderungen im Beschäftigungsstatus hilft, den Prozess korrekt zu modellieren, beispielsweise die Unterscheidung zwischen einer temporären Beurlaubung und einer dauerhaften Kündigung. Es ist grundlegend für die Berechnung von Fluktuationsraten und das Verständnis der Ergebnisse verschiedener Lebenszykluspfade. Warum es wichtig ist Bietet wesentlichen Kontext zum Status eines Mitarbeiters und ermöglicht eine genaue Abwanderungsanalyse sowie die Segmentierung der Belegschaft. Woher erhalten Dies ist ein Kernfeld im Stammsatz des Mitarbeiters im Core HR-Modul von UKG Pro. Beispiele AktivBeendetBeurlaubung
	Einstellungsdatum HireDate	Das offizielle Startdatum der Beschäftigung eines Mitarbeiters in der Organisation.
Beschreibung Das Hire Date markiert den Beginn der Betriebszugehörigkeit eines Mitarbeiters. Es ist ein grundlegendes Datumsfeld, das als Basis für viele zeitbasierte Berechnungen und Analysen im Zusammenhang mit dem Mitarbeiter-Lifecycle dient. Dieses Attribut wird zur Berechnung der Betriebszugehörigkeit verwendet, was entscheidend für die Analyse der „Frühen Mitarbeiterfluktuationsrate“ ist. Es unterstützt auch die Kohortenanalyse, indem es den Vergleich von Lifecycle-Mustern für Mitarbeiter ermöglicht, die in verschiedenen Zeiträumen eingestellt wurden. Warum es wichtig ist Dient als Basis zur Berechnung der Betriebszugehörigkeit von Mitarbeitern und ist essenziell für die Kohortenanalyse und Fluktuationsraten-KPIs. Woher erhalten Dies ist ein Standard-Pflichtfeld im primären Datensatz des Mitarbeiters im Core HR-Modul von UKG Pro. Beispiele 2022-08-152023-01-202021-05-10
	Jobtitel JobTitle	Der offizielle Job Title des Mitarbeiters, wie „Software Engineer“ oder „Sales Manager“.
Beschreibung Der Job Title beschreibt die Rolle oder Position des Mitarbeiters innerhalb der Organisation. Dieses Attribut ist eine Schlüsseldimension für die Analyse, wie sich Prozesse über verschiedene Rollen und Hierarchieebenen hinweg unterscheiden. In der Analyse kann der Job Title verwendet werden, um Onboarding-Zeiten für verschiedene Rollen zu vergleichen, Beförderungsgeschwindigkeiten zu bewerten oder festzustellen, ob bestimmte Job Titles höhere Raten an früher Fluktuation aufweisen. Dies hilft, HR-Prozesse und Unterstützungsprogramme auf die spezifischen Bedürfnisse verschiedener Mitarbeitergruppen zuzuschneiden. Warum es wichtig ist Ermöglicht eine rollenbasierte Analyse, um zu verstehen, wie Lebenszyklus-Prozesse über verschiedene Jobfunktionen und Hierarchieebenen variieren. Woher erhalten Dies ist ein Standardfeld, das mit der Positions- oder Stellenaufzeichnung des Mitarbeiters im Core HR-Modul von UKG Pro verknüpft ist. Beispiele Softwareentwickler IISenior ProduktmanagerHR Business Partner
	Name des Vorgesetzten ManagerName	Der Name des direkten Vorgesetzten des Mitarbeiters.
Beschreibung Dieses Attribut identifiziert den direkten Vorgesetzten des Mitarbeiters. Der Vorgesetzte spielt eine entscheidende Rolle bei vielen Lebenszyklusereignissen, einschließlich Leistungsbeurteilungen, Beförderungen und Schulungszuweisungen. Die Analyse nach Vorgesetzten hilft, Abweichungen in der Teamausführung und die Effektivität von Managern zu verstehen. Das Dashboard 'Auswirkungsanalyse bei Managerwechsel' beispielsweise stützt sich auf dieses Attribut, um zu sehen, wie sich ein Vorgesetztenwechsel auf nachfolgende Aktivitäten auswirkt. Es ist auch entscheidend für den KPI 'Zeit bis zur erneuten Manager-Einbindung'. Warum es wichtig ist Ermöglicht die Analyse der Prozessleistung auf Teamebene und hilft, den Einfluss von Managern auf Mitarbeiterlebenszyklus-Events zu bewerten. Woher erhalten Diese Information ist Teil der Berichtsstrukturdaten des Mitarbeiters im Core HR-Modul von UKG Pro. Beispiele John SmithMaria GarciaChen Wei
	Stellenanforderungs-ID JobRequisitionId	Die eindeutige Kennung der Stellenanforderung, die den Einstellungsprozess ausgelöst hat.
Beschreibung Die Job Requisition ID ist die eindeutige Referenz für eine bestimmte Stellenausschreibung. Sie verbindet alle frühen Rekrutierungsaktivitäten, von der Erstellung und Genehmigung über die Beschaffung von Kandidaten bis zur Angebotsunterbreitung. Diese ID ist essenziell für die Analyse des KPI „Rekrutierungs-Cycle Time“, da sie den wahren Beginn des Einstellungsprozesses markiert. Sie ermöglicht die Verfolgung des gesamten Funnels für eine einzelne Stellenausschreibung und die Analyse von Metriken wie der „Rate inaktiver Stellenausschreibungen“, indem sie Requisitionen identifiziert, die nicht vorankommen. Warum es wichtig ist Bietet einen klaren Ausgangspunkt für den Rekrutierungsprozess und ermöglicht die genaue Messung der Einstellungszykluszeiten und der Effektivität von Stellenanforderungen. Woher erhalten Zu finden im UKG Pro Recruiting-Modul oder im verbundenen Applicant Tracking System (ATS). Beispiele REQ-2023-015REQ-2024-112REQ-2023-504
	Austrittsdatum TerminationDate	Das offizielle Enddatum des Arbeitsverhältnisses eines Mitarbeiters.
Beschreibung Das Termination Date markiert den Abschluss der Betriebszugehörigkeit eines Mitarbeiters. Es ist der Endpunkt des Mitarbeiter-Lifecycle innerhalb der Organisation. Dieses Attribut ist notwendig für die Berechnung der endgültigen Betriebszugehörigkeit eines Mitarbeiters und eine Schlüsselkomponente der Fluktuationsanalyse. Die Zeit zwischen Hire Date und Termination Date bildet die Grundlage für das Dashboard „Early Tenure Churn Insights“ und die damit verbundenen KPIs. Warum es wichtig ist Definiert das Ende des Mitarbeiterlebenszyklus, ermöglicht die Berechnung der gesamten Betriebszugehörigkeit und unterstützt alle Fluktuationsanalysen. Woher erhalten Dies ist ein Standardfeld im primären Datensatz des Mitarbeiters in UKG Pro, das bei Abschluss des Kündigungsprozesses eingetragen wird. Beispiele 2023-11-302024-02-152022-12-31
	Austrittsgrund TerminationReason	Der dokumentierte Grund für den Austritt eines Mitarbeiters, z.B. „Freiwillig – Kündigung durch Mitarbeiter“ oder „Unfreiwillig – Leistungsbedingt“.
Beschreibung Dieses Attribut erfasst den Grund für die Beendigung des Arbeitsverhältnisses eines Mitarbeiters. Die Gründe werden typischerweise als freiwillig oder unfreiwillig kategorisiert, mit spezifischeren Unterkategorien. Dies ist ein entscheidendes Attribut für die Retention- und Churn Analysis. Durch die Segmentierung ausgeschiedener Mitarbeiter nach ihrem Austrittsgrund können Unternehmen tiefgreifende Einblicke in die Grundursachen der Fluktuation gewinnen. Beispielsweise kann die Analyse der 'Frühen Mitarbeiterfluktuationsrate' nach Kündigungsgrund zwischen schlechten Einstellungsentscheidungen und konkurrierenden Angeboten unterscheiden. Warum es wichtig ist Bietet entscheidende Einblicke in die Ursachen der Mitarbeiterfluktuation und ermöglicht gezielte Bindungsstrategien. Woher erhalten Dieses Feld wird typischerweise während des Kündigungs- oder Offboarding-Prozesses im Core HR-Modul von UKG Pro erfasst. Beispiele Freiwillig - Eine neue berufliche ChanceUnfreiwillig – LeistungsbedingtRentenantritt
	Bearbeitungszeit ProcessingTime	Die berechnete Dauer einer einzelnen Activity, vom Start- bis zum Endzeitpunkt.
Beschreibung Die Bearbeitungszeit misst die Zeit, die für eine spezifische Aufgabe aufgewendet wird, berechnet als Differenz zwischen der Event-Endzeit und dem Event-Zeitstempel (Startzeit). Sie repräsentiert die 'Servicezeit' für eine Aktivität. Diese Kennzahl ist entscheidend, um zu identifizieren, welche spezifischen Aktivitäten im Prozess die meiste Zeit in Anspruch nehmen. Zum Beispiel kann sie aufzeigen, dass die Aktivität 'Hintergrundprüfung initiiert' im Durchschnitt fünf Tage dauert, was sie zu einem klaren Ziel für Optimierungsbemühungen macht. Warum es wichtig ist Quantifiziert die Dauer einzelner Aufgaben und ermöglicht eine gezielte Optimierung der zeitaufwändigsten Aktivitäten im Prozess. Woher erhalten Dieses Attribut wird während der Datenaufbereitung berechnet, indem der Event Timestamp von der Event End Time subtrahiert wird. Beispiele 28800086400604800
	Endzeit des Events EventEndTime	Der Timestamp, der den Abschluss einer Activity markiert, die eine messbare Dauer hat.
Beschreibung Für Aktivitäten, die nicht sofort abgeschlossen werden, zeichnet der Event End Time den Zeitpunkt der Fertigstellung auf. Dies steht im Gegensatz zum Event Timestamp (StartTime), der den Beginn markiert. Ein Start- und ein Endzeitpunkt ermöglichen die präzise Berechnung der Bearbeitungszeit für einzelne Aktivitäten wie 'Background Check' oder 'Onboarding Task'. Dies unterstützt eine detailliertere Analyse des Zeitaufwands innerhalb des Prozesses. Warum es wichtig ist Ermöglicht die Berechnung präziser Verarbeitungszeiten für einzelne Aktivitäten, wodurch die zeitaufwändigsten Schritte im Prozess identifiziert werden können. Woher erhalten Stammt aus Abschlussdatumsfeldern in UKG Pro. Dies erfordert oft die Paarung eines Start-Events mit einem entsprechenden Abschluss-Event aus den Quelldaten. Beispiele 2023-01-15T17:30:00Z2023-06-21T10:00:00Z2024-02-01T11:05:00Z
	Gehaltsstufe SalaryGrade	Die Vergütungsstufe oder -bandbreite, die der Rolle des Mitarbeiters zugeordnet ist.
Beschreibung Die Gehaltsstufe repräsentiert das Vergütungsniveau für eine bestimmte Position. Sie ist ein zentrales Attribut für die Analyse vergütungsbezogener Aktivitäten und Trends. Dieses Attribut ist wichtig für Analysen wie 'Vergütung geändert' Events und kann zur Verfolgung der 'Post-Onboarding Data Rework Rate' KPI verwendet werden, wenn häufige Korrekturen der Gehaltsstufen beobachtet werden. Es ermöglicht auch eine Segmentierung, um festzustellen, ob sich Beförderungszykluszeiten oder Fluktuationsraten nach dem Vergütungsniveau unterscheiden. Warum es wichtig ist Bietet Kontext für vergütungsbezogene Aktivitäten und ermöglicht die Segmentierung des Prozesses nach Gehaltsstufe. Woher erhalten Verfügbar im Vergütungs- oder Stellenprofil des Mitarbeiters innerhalb des Core HR-Moduls von UKG Pro. Beispiele IC3M2D1
	Grund für Rollenwechsel RoleChangeReason	Der Grund für eine Änderung der Rolle eines Mitarbeiters, z.B. „Beförderung“, „Horizontaler Wechsel“ oder „Reorganisation“.
Beschreibung Dieses Attribut liefert den Kontext für Events der internen Mobilität. Es erklärt, warum die Rolle oder Position eines Mitarbeiters innerhalb der Organisation geändert wurde. Es ist unerlässlich für das Dashboard und den KPI 'Durchlaufzeit für interne Mobilität', da es die Unterscheidung zwischen Beförderungen und anderen Arten von Versetzungen ermöglicht. Die Analyse des Prozesses nach Grund kann aufzeigen, ob Beförderungsprozesse langsamer sind als seitliche Versetzungen, was zur Optimierung von Karriereentwicklungspfaden beiträgt. Warum es wichtig ist Erläutert den Kontext hinter internen Versetzungen und ermöglicht eine nuanciertere Analyse von internen Mobilitätsprozessen wie Beförderungen im Vergleich zu lateralen Versetzungen. Woher erhalten Diese Information wird typischerweise als Teil der Transaktion für Stellenwechsel oder Versetzung im Core HR-Modul von UKG Pro erfasst. Beispiele BeförderungLateraler TransferReorganisation
	Ist frühe Fluktuation IsEarlyChurn	Ein boolesches Flag, das anzeigt, ob die Beendigung des Arbeitsverhältnisses eines Mitarbeiters innerhalb einer vordefinierten frühen Betriebszugehörigkeitsperiode, wie 90 oder 180 Tage, erfolgte.
Beschreibung Dieses berechnete Attribut kennzeichnet Mitarbeiter, die das Unternehmen kurz nach ihrer Einstellung verlassen. Der Schwellenwert für 'frühzeitig' wird typischerweise vom Business definiert, z.B. innerhalb des ersten Jahres. Dieses Kennzeichen vereinfacht die für das Dashboard 'Einblicke in die Fluktuation von Kurzzeitmitarbeitern' und den KPI 'Frühe Mitarbeiterfluktuationenrate' erforderliche Analyse. Es ermöglicht eine schnelle Filterung und Segmentierung, um diese hochinteressante Gruppe zu isolieren und ihre Merkmale und Lebenszyklusmuster zu analysieren, was hilft, Probleme bei der Rekrutierung oder dem Onboarding zu identifizieren. Warum es wichtig ist Unterstützt direkt die Early Churn-Analyse, indem gefährdete Fälle gekennzeichnet werden, was bei der Identifizierung von Grundursachen für vorzeitige Mitarbeiteraustritte hilft. Woher erhalten Dieses Attribut wird während der Datenaufbereitung berechnet. Die Logik vergleicht die Differenz zwischen dem 'Austrittsdatum' und dem 'Einstellungsdatum' mit einem vordefinierten Schwellenwert (z.B. 365 Tage). Beispiele truefalsch
	Leistungsbewertung PerformanceRating	Das Rating, das einem Mitarbeiter während eines Performance Review Cycle zugewiesen wird.
Beschreibung Das Performance Rating ist das Ergebnis einer Performance Review Conducted-Activity, typischerweise auf einer Skala (z.B. 1-5) oder unter Verwendung beschreibender Bezeichnungen (z.B. „Erwartungen übertroffen“). Es quantifiziert die Leistungsbeurteilung eines Mitarbeiters. Dieses Attribut ist wertvoll, um Prozess-Events mit Leistungsergebnissen zu korrelieren. Die Analyse kann beispielsweise untersuchen, ob Leistungsträger schneller befördert werden oder ob ein Zusammenhang zwischen Performance Ratings und Mitarbeiterfluktuation besteht. Es ist zentral für das Dashboard „Performance Review Cycle Compliance“. Warum es wichtig ist Verknüpft Prozess-Events mit Leistungsergebnissen und ermöglicht so die Analyse der Effektivität des Talentmanagements sowie dessen Auswirkungen auf die Mitarbeiterbindung. Woher erhalten Zu finden im UKG Pro Performance Management-Modul und verknüpft mit spezifischen Beurteilungszyklen. Beispiele Übertrifft ErwartungenErwartungen erfülltVerbesserungsbedarf5
	Ort Location	Der geografische Standort oder das Büro, an dem der Mitarbeiter tätig ist.
Beschreibung Dieses Attribut spezifiziert den primären Arbeitsort des Mitarbeiters, welcher eine Stadt, ein Land oder ein spezifisches Bürogebäude sein kann. Es ist eine Schlüsseldimension für die geografische Analyse von HR-Prozessen. Die Analyse der Prozessleistung nach Standort kann regionale Unterschiede in der Rekrutierungseffizienz, Onboarding-Praktiken oder Fluktuationsraten aufdecken. So könnten Sie beispielsweise die 'Rekrutierungsdurchlaufzeit' zwischen den Büros in 'New York' und 'London' vergleichen, um Best Practices oder lokalisierte Engpässe zu identifizieren. Warum es wichtig ist Ermöglicht die geografische Segmentierung des Prozesses und deckt regionale Abweichungen bei Leistung und Compliance auf. Woher erhalten Diese Information ist Teil der Stellen- oder Personaldaten des Mitarbeiters im Core HR-Modul von UKG Pro. Beispiele New York, NYLondon, UKRemote
	Schulungsname TrainingName	Der Name oder Titel des dem Mitarbeiter zugewiesenen Schulungskurses.
Beschreibung Dieses Attribut identifiziert ein spezifisches Schulungs- oder Lernmodul, das einem Mitarbeiter zugewiesen wurde. Dies kann von verpflichtenden Compliance-Schulungen bis hin zur rollenspezifischen Kompetenzentwicklung reichen. Es ist ein Schlüsselattribut für das Dashboard 'Schulungszuweisung & -abschluss' und den KPI 'Schulungsabschlussrate'. Es ermöglicht die Verfolgung des Fortschritts und der Effektivität spezifischer Schulungsprogramme sowie die Analyse der Abschlusszeiten über verschiedene Kurse hinweg. Warum es wichtig ist Ermöglicht die Nachverfolgung und Analyse spezifischer Schulungsprogramme, wodurch die Compliance und Entwicklungseffektivität gemessen werden können. Woher erhalten Stammt aus dem UKG Pro Lernmodul oder einem verbundenen Lernmanagementsystem (LMS). Beispiele Verhaltenskodex 2024Fortgeschrittene ManagementfähigkeitenCybersicherheitsbewusstsein

Erforderlich Empfohlen Optional

Hire to Retire - Employee Lifecycle-Aktivitäten

Dies sind die entscheidenden Prozessschritte und Meilensteine, die Sie in Ihrem Event Log erfassen sollten, um eine präzise Process Discovery und Prozessoptimierung zu gewährleisten.

6 Empfohlen 9 Optional

	Aktivität	Beschreibung
	Austritt eingeleitet	Stellt den Beginn des Offboarding-Prozesses dar, der protokolliert wird, wenn ein zukünftiges Kündigungsdatum im System erfasst wird. Dieses Event löst Offboarding-Checklisten und Workflows aus.
Warum es wichtig ist Dies ist ein entscheidender Meilenstein, der den Austrittsprozess eines Mitarbeiters einleitet. Die Analyse der Zeitspanne zwischen diesem Event und der endgültigen Kündigung hilft, die Effizienz und Vollständigkeit der Offboarding-Verfahren zu bewerten. Woher erhalten Dies ist typischerweise die Erstellung eines Termination-Aktionsdatensatzes in den Jobdaten des Mitarbeiters, der ein zukünftiges Gültigkeitsdatum hat. Es kann auch der Beginn eines Offboarding-Workflows in einem spezifischen Modul sein. Erfassen Erfasst, wenn eine Kündigungstransaktion mit einem zukünftigen Datum eingereicht wird. Ereignistyp explicit
	Beförderung genehmigt	Zeigt die formelle Genehmigung einer Beförderung eines Mitarbeiters an, die typischerweise eine Änderung des Jobtitels und oft auch eine Anpassung der Vergütung beinhaltet. Dies ist ein eigenständiges Ereignis, das dem Gültigkeitsdatum der Änderung vorausgeht.
Warum es wichtig ist Diese Aktivität ist entscheidend für die Analyse der internen Mobilität und der Karriereentwicklung. Die Zeit zwischen der Genehmigung einer Beförderung und ihrem Wirksamkeitsdatum kann administrative Engpässe im System aufzeigen. Woher erhalten Als spezifische Jobaktion, wie z.B. 'Beförderung', in der Jobdaten-Historie des Mitarbeiters innerhalb des HR-Core-Moduls protokolliert. Der Datensatz hat eigene Genehmigungs- und Gültigkeitsdaten. Erfassen Erfasst vom Logdatum einer 'Beförderung'-Aktion in der Jobhistorie des Mitarbeiters. Ereignistyp explicit
	Leistungsbeurteilung durchgeführt	Stellt den Abschluss eines formellen Leistungsbeurteilungszyklus für einen Mitarbeiter dar. Dieses Event wird protokolliert, wenn das Beurteilungsformular vom Manager oder der Personalabteilung finalisiert und eingereicht wird.
Warum es wichtig ist Dies ist ein entscheidender wiederkehrender Meilenstein im Employee Lifecycle. Die Nachverfolgung seiner Häufigkeit und Pünktlichkeit hilft, die Performance Management Compliance und deren Auswirkungen auf die Karriereentwicklung zu beurteilen. Woher erhalten Zu finden im UKG Pro Performance Management-Modul. Die Identifizierung erfolgt über das Abschlussdatum des Leistungsbeurteilungsformulars oder eine Statusänderung auf 'Completed' für einen Beurteilungszyklus. Erfassen Erfasst vom Timestamp des Abschlusses der Leistungsbeurteilungs-Workflow-Instanz. Ereignistyp explicit
	Mitarbeiter eingestellt	Markiert die offizielle Erstellung des Mitarbeiterdatensatzes in UKG Pro, bei der eine Employee ID formal zugewiesen wird. Dieses Event wird typischerweise erfasst, wenn ein HR-Administrator den Einstellungsprozess für einen Kandidaten abschließt und diesen innerhalb des Systems in einen aktiven Mitarbeiter überführt.
Warum es wichtig ist Dies ist das definitive Start-Event für die Hire-to-Retire-Prozessanalyse. Es liefert die Basis für die Messung der Zeit bis zur Produktivität, der Onboarding-Effizienz und der gesamten Betriebszugehörigkeit des Mitarbeiters. Woher erhalten Dieses Event wird wahrscheinlich im HR Core- oder Personalverwaltungsmodul protokolliert. Es kann durch das Erstellungsdatum des primären Arbeitsdatensatzes des Mitarbeiters oder einen spezifischen 'Einstellungs'-Aktionsdatensatz in der Jobdatenhistorie des Mitarbeiters identifiziert werden. Erfassen Erfasst vom Gültigkeitsdatum der 'Einstellung'-Aktion in der Jobhistorientabelle des Mitarbeiters. Ereignistyp explicit
	Mitarbeiter entlassen	Das letzte Event im Mitarbeiter-Lifecycle, das das offizielle Ende des Arbeitsverhältnisses darstellt. Hierbei wird der Mitarbeiterdatensatz im System zum effektiven Kündigungsdatum inaktiv.
Warum es wichtig ist Dies ist das definitive End-Event für den Prozess, entscheidend für die Berechnung der endgültigen Betriebszugehörigkeit des Mitarbeiters und die Analyse der Fluktuation. Es schließt den Kreis der Mitarbeiterreise im Unternehmen. Woher erhalten Dies ist das effektive Datum der letzten Termination-Aktion in der Jobdatenhistorie des Mitarbeiters innerhalb des HR Core-Moduls. Das System ändert den Status des Mitarbeiters an diesem Datum typischerweise von aktiv auf inaktiv. Erfassen Erfasst vom Gültigkeitsdatum der 'Kündigung'-Aktion in der Jobhistorie des Mitarbeiters. Ereignistyp explicit
	Mitarbeiter Onboarded	Ein wichtiger Meilenstein, der den erfolgreichen Abschluss der initialen Einarbeitungscheckliste oder des Workflows markiert. Dies bedeutet in der Regel, dass alle erforderlichen Unterlagen für neue Mitarbeiter, Systemzugangsanfragen und anfängliche administrative Aufgaben erledigt sind.
Warum es wichtig ist Markiert das Ende der anfänglichen administrativen Einrichtung, was die Analyse der gesamten Onboarding-Cycle Time ermöglicht. Es kennzeichnet den Zeitpunkt, an dem der Mitarbeiter administrativ bereit ist, seine rollenspezifischen Aufgaben zu beginnen. Woher erhalten Befindet sich im Onboarding-Modul. Dies wird typischerweise vom Completion Timestamp des gesamten Onboarding-Workflows abgeleitet oder sobald die letzte obligatorische Onboarding-Task als abgeschlossen markiert ist. Erfassen Abgeleitet vom Abschluss-Timestamp der Master-Onboarding-Checkliste für den jeweiligen Mitarbeiter. Ereignistyp inferred
	Austrittsinterview durchgeführt	Dieses Event kennzeichnet den Abschluss des Austrittsgesprächs mit dem ausscheidenden Mitarbeiter. Es wird typischerweise als abgeschlossene Aufgabe in einer Offboarding-Checkliste erfasst.
Warum es wichtig ist Die Nachverfolgung des Abschlusses von Austrittsgesprächen ist wichtig, um die HR Compliance zu gewährleisten und wertvolles Feedback zu sammeln. Es hilft zu erkennen, ob dieser entscheidende Schritt im Offboarding-Prozess übersprungen wird. Woher erhalten Dieses Event findet sich wahrscheinlich im UKG Pro Onboarding- oder HR Help Desk-Modul als spezifische Aufgabe innerhalb eines Offboarding-Workflows. Seine Erfassung hängt davon ab, dass die Personalabteilung die Aufgabe manuell als erledigt markiert. Erfassen Als abgeschlossene Task innerhalb der Offboarding-Checkliste eines Mitarbeiters protokolliert. Ereignistyp explicit
	Beurlaubung begonnen	Markiert den Beginn einer genehmigten Beurlaubung eines Mitarbeiters, z.B. aus medizinischen oder persönlichen Gründen. Dies wird erfasst, wenn sich der Status des Mitarbeiters in einen inaktiven, beurlaubten Zustand ändert.
Warum es wichtig ist Es identifiziert Perioden der Inaktivität im Mitarbeiter-Lebenszyklus. Dies ist entscheidend für die genaue Berechnung der aktiven Betriebszugehörigkeit und das Verständnis der Auswirkungen von Beurlaubungen auf die Karriereentwicklung. Woher erhalten Zu finden in der Jobhistorie eines Mitarbeiters im HR Core-Modul. Dies entspricht einer Job-Aktion wie 'Beurlaubung' mit einem bestimmten Gültigkeitsdatum für den Beginn. Erfassen Erfasst vom Gültigkeitsdatum einer 'Beurlaubung beginnen'-Aktion in der Jobhistorie. Ereignistyp explicit
	Gehaltsabrechnungseinrichtung abgeschlossen	Zeigt an, dass alle notwendigen Informationen für die Gehaltsabrechnung des Mitarbeiters, wie Bankdaten und Steuerformulare, erfasst und überprüft wurden. Dies ist ein entscheidender Schritt, um sicherzustellen, dass der Mitarbeiter korrekt und pünktlich bezahlt wird.
Warum es wichtig ist Dieser Meilenstein ist entscheidend für die Messung der Einsatzbereitschaft neuer Mitarbeiter. Verzögerungen bei der Gehaltsabrechnung können zu Unzufriedenheit der Mitarbeiter und administrativem Nachbearbeitungsaufwand führen, was ihn zu einem Schlüsselindikator für das Onboarding macht. Woher erhalten Dieses Event kann aus dem UKG Pro Gehaltsabrechnungsmodul abgeleitet werden. Es lässt sich aus dem Abschlussdatum einer Checkliste zur Gehaltsabrechnungsbereitschaft oder dem Datum der Statusänderung des Mitarbeiters auf 'Bereit für die Gehaltsabrechnung' herleiten. Erfassen Abgeleitet von einer Statusänderung oder einem Abschluss-Timestamp im Gehaltsabrechnungsprofil des Mitarbeiters. Ereignistyp inferred
	Offboarding abgeschlossen	Ein Meilenstein, der anzeigt, dass alle obligatorischen Offboarding-Aufgaben abgeschlossen wurden. Dazu gehören Aktivitäten wie die Rückgabe von Vermögenswerten, die finale Gehaltsabrechnung und der Entzug von Systemzugriffen.
Warum es wichtig ist Dieses Event bestätigt, dass alle notwendigen Schritte unternommen wurden, um sich sicher und compliant vom Mitarbeiter zu trennen. Es hilft, die Offboarding-Durchlaufzeit zu messen und Compliance-Lücken zu identifizieren. Woher erhalten Dies würde vom Abschluss-Timestamp der gesamten Offboarding-Checkliste oder des Workflows abgeleitet, ähnlich dem Event 'Employee Onboarded', jedoch für den Austrittsprozess. Erfassen Abgeleitet vom Abschluss-Timestamp der Master-Offboarding-Checkliste für den jeweiligen Mitarbeiter. Ereignistyp inferred
	Onboarding initiiert	Stellt den Beginn des Einarbeitungsprozesses oder Workflows für neue Mitarbeiter innerhalb von UKG Pro dar. Dies ist typischerweise ein automatisch oder manuell ausgelöstes Event, das dem neuen Mitarbeiter, seinem Manager und der Personalabteilung eine Aufgaben-Checkliste zuweist.
Warum es wichtig ist Die Nachverfolgung dieser Aktivität hilft, die Zeitspanne zwischen dem offiziellen Einstellungsdatum und dem Beginn der administrativen und kulturellen Integration zu messen. Es ist der Ausgangspunkt für die Analyse der Onboarding-Prozesseffizienz und die Identifizierung von Verzögerungen. Woher erhalten Zu finden im UKG Pro Onboarding-Modul. Das Ereignis lässt sich aus dem Erstellungsdatum der Onboarding-Checkliste oder der Workflow-Instanz ableiten, die dem Mitarbeiter zugeordnet ist. Erfassen Abgeleitet vom Erstellungs-Timestamp des Onboarding-Workflows oder der Aufgabenliste eines Mitarbeiters. Ereignistyp inferred
	Rollenwechsel verarbeitet	Stellt eine Änderung der Position oder Funktion eines Mitarbeiters dar, die keine Beförderung ist, wie z.B. ein lateraler Wechsel oder ein Abteilungswechsel. Dies wird protokolliert, wenn die relevanten Jobdaten im System aktualisiert werden.
Warum es wichtig ist Die Analyse von Rollenwechseln liefert Einblicke in die interne Mobilität, den Talenteinsatz und die organisatorische Umstrukturierung. Sie hilft zu erkennen, wie sich Mitarbeiter innerhalb des Unternehmens bewegen. Woher erhalten Erfasst aus der Job Data History des Mitarbeiters im HR Core-Modul. Es kann durch Job Actions wie 'Versetzung', 'Neuzuordnung' oder 'Positionswechsel' zusammen mit ihren Gültigkeitsdaten identifiziert werden. Erfassen Identifiziert durch einen 'Transfer'- oder ähnlichen Aktionscode in den Jobhistoriedaten eines Mitarbeiters. Ereignistyp explicit
	Schulung zugewiesen	Erfasst den Moment, in dem ein spezifischer Trainingskurs oder Lernplan einem Mitarbeiter zugewiesen wird. Dies wird üblicherweise im Lernmanagementmodul des Systems erfasst.
Warum es wichtig ist Diese Aktivität unterstützt die Überwachung der Compliance bei verpflichtenden Schulungen und die Kontrolle der Mitarbeiterentwicklung. Eine Analyse der Zeitspanne zwischen Zuweisung und Abschluss kann Aufschluss über Engagement-Probleme oder die Effektivität der Schulung geben. Woher erhalten Aufgezeichnet in den Lernmanagement- oder Talentmanagement-Modulen von UKG Pro. Jede Zuweisung sollte einen entsprechenden Eintrag mit einem Zuweisungsdatum und einer Mitarbeiter-ID haben. Erfassen Protokolliert, wenn ein Kurs oder Lehrplan dem Lernplan eines Mitarbeiters zugewiesen wird. Ereignistyp explicit
	Vergütung geändert	Dieses Event erfasst jede Änderung des Grundgehalts eines Mitarbeiters, der Bonusstruktur oder anderer Vergütungsbestandteile. Es kann Teil einer Beförderung, einer Leistungserhöhung oder einer Marktanpassung sein.
Warum es wichtig ist Die Nachverfolgung von Vergütungsänderungen ist entscheidend für das Verständnis der Karriere- und Gehaltsentwicklung. Häufige Anpassungen nach der Einstellung können auf Dateneingabefehler oder Probleme bei der anfänglichen Gehaltsfestlegung hinweisen. Woher erhalten Zu finden in der Vergütungshistorie der Mitarbeiter im HR Core- oder Payroll-Modul. Jede Änderung wird typischerweise mit einem Gültigkeitsdatum und einem Grundcode erfasst. Erfassen Erfasst ab dem effektiven Datum eines neuen Eintrags im Vergütungshistorien-Datensatz des Mitarbeiters. Ereignistyp explicit
	Vorgesetzter gewechselt	Dieses Event wird generiert, wenn das Feld 'Reports To' oder 'Manager ID' für einen Mitarbeiter aktualisiert wird. Es stellt eine Änderung in der direkten Berichtslinie des Mitarbeiters dar.
Warum es wichtig ist Vorgesetztenwechsel können das Mitarbeiterengagement und die Leistung erheblich beeinflussen. Die Verfolgung dieses Events ermöglicht eine Analyse seiner Auswirkungen auf nachfolgende Aktivitäten wie Leistungsbeurteilungen oder die Mitarbeiterbindung. Woher erhalten Dieses Event muss durch die Verfolgung von Änderungen im Feld für Vorgesetzten oder Supervisor in den Jobdaten des Mitarbeiters über die Zeit abgeleitet werden. Es erfordert den Vergleich der Manager ID zwischen aufeinanderfolgenden Datensätzen für denselben Mitarbeiter. Erfassen Wird abgeleitet durch die Erkennung einer Änderung im Feld 'Reports To' in der Jobhistorie eines Mitarbeiters. Ereignistyp inferred

Extraktionsleitfäden

Wie Sie Ihre Daten aus UKG Pro erhalten

Schritte

Voraussetzungen: Stellen Sie sicher, dass Sie Python 3.6+ sowie die requests- und pandas-Bibliotheken installiert haben. Sie können diese mit pip installieren: pip install requests pandas.
API-Zugriff & Authentifizierung: Kontaktieren Sie Ihren UKG Pro Administrator, um ein Service Account zu erstellen. Sie benötigen den API Key, User Name und Password. Das Service Account muss über Berechtigungen verfügen, um auf alle erforderlichen API Endpoints zuzugreifen, einschließlich Personal-, Gehaltsabrechnungs-, Onboarding-, Leistungs- und Lerndaten.
Skript konfigurieren: Öffnen Sie das bereitgestellte Python-Skript in einem Texteditor oder einer IDE. Suchen Sie den Konfigurationsbereich am Anfang des Skripts und ersetzen Sie die Platzhalterwerte für UKG_BASE_URL, API_KEY, USERNAME, PASSWORD und COMPANY_ID durch Ihre spezifischen Anmeldeinformationen und Umgebungsdetails.
Extraktionszeitraum festlegen: Definieren Sie im Konfigurationsbereich die Variablen START_DATE und END_DATE. Dies bestimmt den Zeitrahmen, für den Mitarbeiteränderungen und Events extrahiert werden. Es wird empfohlen, mit einem kleineren Bereich, z.B. 3-6 Monate, zu beginnen, um das Skript zu testen.
Skript ausführen: Führen Sie das Skript von Ihrer Befehlszeile aus mit python your_script_name.py aus. Das Skript authentifiziert sich, ruft Daten von verschiedenen UKG Pro API Endpoints für jede Aktivität ab und zeigt Statusaktualisierungen in der Konsole an.
API-Drosselung handhaben: Das Skript enthält ein grundlegendes time.sleep(), um API Rate Limits zu respektieren. Wenn Sie Drosselungsfehler (HTTP 429) erhalten, müssen Sie möglicherweise die Sleep Duration zwischen API Calls erhöhen.
Daten transformieren und standardisieren: Jede Funktion innerhalb des Skripts ist darauf ausgelegt, Rohdaten für eine spezifische Aktivität abzurufen, die relevanten Felder auszuwählen und sie in das Standard-Event Log-Format (EmployeeId, ActivityName, EventTimestamp, etc.) umzubenennen.
Ereignisdaten kombinieren: Der Hauptteil des Skripts ruft jede aktivitätsspezifische Funktion auf und fügt die resultierenden Daten zu einer einzigen, übergeordneten Liste von Events hinzu.
Event Log generieren: Nach der Verarbeitung aller Aktivitäten konsolidiert das Skript die Daten in einem pandas DataFrame, sortiert sie nach EmployeeId und Timestamp und speichert sie als CSV-Datei mit dem Namen ukg_hire_to_retire_event_log.csv.
Überprüfen und hochladen: Öffnen Sie die generierte CSV-Datei, um sicherzustellen, dass die Daten vollständig und korrekt formatiert sind. Diese Datei ist nun bereit, in das Process Mining Tool hochgeladen zu werden.

Konfiguration

Authentifizierungsdaten: Für die API-Authentifizierung sind ein API Key für das Service-Konto, User Name und Password erforderlich.
Base URL: Die UKG_BASE_URL für Ihre UKG Pro Instanz (z. B. https://service[##].ultipro.com/api).
Unternehmens-ID: Die eindeutige COMPANY_ID Ihrer Organisation innerhalb von UKG Pro ist für viele API-Aufrufe notwendig.
Datumsbereich: Die Parameter START_DATE und END_DATE (im Format 'JJJJ-MM-TT') steuern den Extraktionszeitraum. Für den ersten Lauf wird ein Zeitraum von 3-6 Monaten empfohlen, um das Datenvolumen zu verwalten und die Ergebnisse zu überprüfen.
API-Endpunkt-Versionen: Das Skript verwendet spezifische Versionen der REST APIs (z. B. /personnel/v1/). Stellen Sie sicher, dass Ihre UKG Pro Instanz diese Versionen unterstützt.
Modulabhängigkeiten: Die Extraktion bestimmter Aktivitäten erfordert, dass Ihre Organisation die entsprechenden UKG Pro Module, wie Onboarding, Learning und Performance Management, lizenziert hat und aktiv nutzt. Falls ein Modul nicht verwendet wird, wird die entsprechende Aktivität nicht extrahiert.

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