> Amélioration continue des processus > Cycle de vie de l'employé : de l'embauche au départ > UKG Pro > Modèle de données

Modèle de données : Du recrutement au départ - Cycle de vie des employés

UKG Pro

← Retour au Guide d'amélioration

Attributs du cycle de vie de l'employé : de l'embauche au départ (22) Activités du cycle de vie de l'employé : de l'embauche au départ (15) Guides d'extraction (1)

Votre template de données du cycle de vie de l'employé « Hire to Retire ».

Ce template offre un aperçu complet des éléments de données essentiels requis pour analyser efficacement votre processus De l'embauche à la retraite. Il décrit les attributs cruciaux à collecter, les activités clés à suivre et des conseils pratiques pour extraire ces données de UKG Pro. Utilisez cette ressource pour rationaliser votre préparation des données et assurer un démarrage en douceur de votre parcours de Process Mining.

Attributs recommandés à collecter
Activités clés à suivre
Guide d'extraction pour UKG Pro

Nouveau dans les journaux d'événements ? Apprenez comment créer un journal d'événements Process Mining.

Télécharger le modèle

Attributs du cycle de vie de l'employé : de l'embauche au départ

Voici les champs de données recommandés à inclure dans votre journal d'événements pour une analyse complète et des aperçus pertinents du cycle de vie de l'employé, de l'embauche au départ.

5 Obligatoire 7 Recommandé 10 Facultatif

	Nom	Description
	ID employé EmployeeId	L'identifiant unique attribué à chaque employé, servant d'ID de cas principal pour l'ensemble de son cycle de vie au sein de l'organisation.
Description L'Employee ID est le fil conducteur qui relie tous les événements concernant un employé, depuis sa candidature initiale jusqu'à son offboarding. Cet identifiant est essentiel pour construire une vue de bout en bout de son parcours. En Process Mining, chaque activité — comme 'Employee Hired', 'Promotion Approved' ou 'Termination Initiated' — est rattachée à cet ID unique. Cela permet d'analyser les parcours individuels, de réaliser des analyses par cohortes selon les attributs des employés et de calculer avec précision les durées de cycle de vie. Pourquoi c'est important Il s'agit de l'identifiant de case essentiel qui relie tous les événements liés aux employés, rendant possible l'analyse du processus de bout en bout De l'embauche à la retraite pour chaque individu. Où obtenir Il s'agit d'un champ essentiel dans UKG Pro, généralement trouvé dans les profils d'employés ou les enregistrements de données maîtres. Consultez la documentation UKG Pro pour connaître le nom spécifique de la table et du champ, souvent désigné comme Employee Number ou Person ID. Exemples 10052198345210047
	Timestamp de l'événement EventTimestamp	La date et l'heure précises auxquelles un événement du cycle de vie s'est produit.
Description L'horodatage de l'événement apporte le contexte chronologique de chaque activité : il constitue l'ossature du flux du processus. Il enregistre le moment exact où un événement comme 'Offer Accepted' ou 'Promotion Approved' a été saisi dans le système. En analyse, ces horodatages servent à calculer les durées entre activités, à identifier les retards et à mesurer les temps de cycle pour des sous-processus clés comme le recrutement et l'onboarding. Des horodatages fiables sont indispensables à tous les KPI basés sur le temps et à l'analyse de performance. Pourquoi c'est important Cet attribut est essentiel pour ordonner les événements chronologiquement et calculer toutes les métriques basées sur le temps, telles que les temps de cycle et les durées. Où obtenir Provient des champs de date ou d'horodatage associés à des événements spécifiques dans UKG Pro, tels que « Date d'embauche », « Date de fin de contrat » ou les horodatages de changement de statut dans les modules de flux de travail. Exemples 2023-01-15T09:00:00Z2023-06-20T14:35:10Z2024-02-01T11:00:00Z
	Dernière mise à jour des données LastDataUpdate	L'horodatage indiquant la dernière actualisation ou extraction des données de cet événement depuis le système source.
Description Cet attribut fournit le timestamp de la dernière extraction de données d'UKG Pro. Ce n'est pas le moment où l'événement commercial s'est produit, mais plutôt le moment où l'enregistrement a été importé dans l'outil de Process Mining. Cette information est vitale pour comprendre la fraîcheur des données analysées. Elle permet aux analystes et aux utilisateurs métier de savoir à quel point la vue du processus est actuelle et aide à gérer les calendriers de rafraîchissement des données et à valider la récence des aperçus. Pourquoi c'est important Indique la fraîcheur des données, ce qui est essentiel pour la fiabilité de l'analyse et la prise de décisions commerciales opportunes. Où obtenir Cet timestamp est généré et ajouté à chaque enregistrement lors du processus d'extraction, de transformation et de chargement des données (ETL). Exemples 2024-03-15T02:00:00Z2024-03-16T02:00:00Z2024-03-17T02:00:00Z
	Nom de l'activité ActivityName	Le nom de l'événement ou du jalon survenu dans le cycle de vie de l'employé, par exemple 'Employee Hired' ou 'Performance Review Conducted'.
Description Le nom de l'activité correspond à une étape ou une tâche précise du processus Hire to Retire. Chaque événement est horodaté et ordonné pour construire le flux du processus, visualisé et analysé en Process Mining. L'analyse de la séquence et de la fréquence de ces activités révèle l'exécution réelle du processus. Elle permet d'identifier les parcours courants, les écarts par rapport au processus de référence et les goulots d'étranglement entre des activités clés comme 'Onboarding Initiated' et 'Payroll Setup Completed'. Pourquoi c'est important Cet attribut définit les étapes de la carte des processus, permettant la visualisation et l'analyse du flux du cycle de vie de l'employé. Où obtenir Ceci est généralement dérivé des Event Logs, des changements de statut de workflow ou de champs de dates spécifiques au sein de divers modules UKG Pro (par exemple, Recrutement, Intégration, Gestion de la performance). Une logique de mappage est généralement requise pour générer des noms d'activités standardisés. Exemples Employé embauchéÉvaluation de la performance EffectuéeRésiliation initiée
	Système source SourceSystem	Identifie le système à partir duquel les données ont été extraites, qui est dans ce cas UKG Pro.
Description Cet attribut spécifie l'origine des données du processus. Bien que dans ce contexte, il provienne principalement d'UKG Pro, un processus de cycle de vie de l'employé (de l'embauche au départ) peut également impliquer des données issues d'autres systèmes tels qu'un Applicant Tracking System (ATS) ou un Learning Management System (LMS). En analyse, il aide à différencier les sources de données si plusieurs systèmes sont impliqués et est crucial pour la gouvernance des données et le dépannage. Pour une vue à source unique, il fournit un contexte essentiel sur l'origine des données. Pourquoi c'est important Fournit un contexte crucial pour la gouvernance des données, l'assurance qualité et la traçabilité en identifiant l'origine des données d'événements. Où obtenir Il s'agit généralement d'une valeur statique ('UKG Pro') ajoutée lors du processus de transformation et d'extraction des données. Exemples UKG ProUKGPro_CoreHRUKG
	Actioning User ActioningUser	Le nom ou l'ID de l'utilisateur — généralement un représentant RH ou un manager — ayant réalisé l'activité dans UKG Pro.
Description Cet attribut identifie l'individu responsable de l'exécution d'une étape spécifique du processus, tel que le recruteur qui a fait une offre ou le responsable qui a approuvé une promotion. Il relie les activités du processus aux acteurs humains. En analyse, cet attribut est inestimable pour comprendre la distribution de la charge de travail, identifier les besoins en formation et analyser la performance spécifique aux utilisateurs. Par exemple, il peut aider à déterminer si les erreurs de saisie de données après 'Configuration de la paie terminée' sont concentrées chez des utilisateurs spécifiques, soutenant l'ICP 'Taux de reprise des données post-intégration'. Pourquoi c'est important Permet de lier les activités de processus à des utilisateurs spécifiques, facilitant l'analyse de la charge de travail, la comparaison des performances et l'identification des retouches ou des erreurs. Où obtenir Généralement trouvé dans les journaux de piste d'audit ou les champs 'Dernière modification par' au sein des modules UKG Pro. Le nom exact du champ varie selon le module. Exemples j.does.smithhr_admin
	Date d'embauche HireDate	La date officielle de début de contrat de l'employé au sein de l'organisation.
Description La Date d'embauche marque le début de l'ancienneté de l'employé. C'est un champ de date fondamental, qui sert de référence à de nombreux calculs et analyses temporels liés à son cycle de vie. Cet attribut sert à calculer l'ancienneté, essentielle pour analyser le 'Taux d'attrition précoce des employés'. Il facilite aussi les analyses par cohortes afin de comparer les schémas de cycle de vie des employés embauchés à différentes périodes. Pourquoi c'est important Sert de base de référence pour le calcul de l'ancienneté des employés et est essentiel pour l'analyse de cohorte et les KPI de taux d'attrition. Où obtenir Il s'agit d'un champ standard et obligatoire du dossier principal de l'employé dans le module RH Core de UKG Pro. Exemples 2022-08-152023-01-202021-05-10
	Département EmployeeDepartment	Le service ou l’unité organisationnelle de rattachement de l’employé.
Description Cet attribut contient le nom du service auquel l'employé est affecté, comme 'Ventes', 'Ingénierie' ou 'Finance'. C'est une dimension organisationnelle clé pour segmenter et comparer la performance des processus. L'analyse par service permet de comparer l'exécution des processus entre différentes unités commerciales. Par exemple, on peut analyser si le temps de cycle de recrutement est plus long pour les départements techniques ou si la conformité aux revues de performance varie significativement entre les ventes et les opérations, fournissant des aperçus ciblés pour l'amélioration. Pourquoi c'est important Permet une analyse comparative puissante en filtrant et segmentant le processus en fonction de la structure organisationnelle, révélant les variations départementales. Où obtenir Il s'agit d'un champ standard dans l'enregistrement d'emploi ou de poste de l'employé au sein du module RH Core de UKG Pro. Exemples IngénierieVentesRessources Humaines
	ID de la demande de poste JobRequisitionId	L'identifiant unique de la demande de poste qui a initié le processus de recrutement.
Description L'ID de la demande de recrutement est la référence unique d'une ouverture de poste. Il relie toutes les activités amont du recrutement, de la création et de l'approbation jusqu'au sourcing des candidats et à l'envoi des offres. Cet ID est indispensable pour analyser le KPI 'Temps de cycle de recrutement', car il marque le véritable démarrage du processus d'embauche. Il permet de suivre tout l'entonnoir pour un poste donné et de mesurer des indicateurs comme le 'Taux de demandes d'ouverture de poste inactives' en identifiant les demandes qui n'avancent pas. Pourquoi c'est important Fournit un point de départ clair pour le processus de recrutement, permettant une mesure précise des temps de cycle de recrutement et de l'efficacité des demandes de personnel. Où obtenir Présent au sein du module de recrutement UKG Pro ou du système de suivi des candidatures (ATS) connecté. Exemples REQ-2023-015REQ-2024-112REQ-2023-504
	Nom du Responsable ManagerName	Le nom du manager ou responsable hiérarchique direct de l'employé.
Description Cet attribut identifie le responsable direct de l'employé. Le responsable joue un rôle crucial dans de nombreux événements du cycle de vie, y compris les revues de performance, les promotions et les attributions de formation. L'analyse par responsable permet de comprendre les variations dans l'exécution au niveau de l'équipe et l'efficacité du responsable. Le dashboard 'Analyse de l'impact de la transition de responsable', par exemple, s'appuie sur cet attribut pour voir comment un changement de responsable affecte les activités ultérieures. Il est également clé pour l'ICP 'Temps de réengagement managérial'. Pourquoi c'est important Permet l'analyse de la performance des processus au niveau de l'équipe et aide à évaluer l'impact des managers sur les événements du cycle de vie des employés. Où obtenir Cette information fait partie des données de structure hiérarchique de l'employé dans le module RH Core de UKG Pro. Exemples John SmithMaria GarciaChen Wei
	Statut d'emploi EmploymentStatus	Le statut d’emploi actuel ou passé de l’employé, par exemple 'Active', 'Terminated' ou 'On Leave'.
Description Cet attribut indique le statut officiel de l'employé au sein de l'entreprise à un moment donné. C'est une dimension critique pour comprendre l'état général de la main-d'œuvre et pour filtrer l'analyse à des populations d'employés spécifiques. L'analyse des changements de statut d'emploi aide à modéliser correctement le processus, par exemple, en distinguant un congé temporaire d'une résiliation permanente. Il est fondamental pour calculer les taux de churn et comprendre les résultats des différents parcours du cycle de vie. Pourquoi c'est important Fournit un contexte essentiel sur la situation d'un employé, permettant une analyse précise de l'attrition et une segmentation de la main-d'œuvre. Où obtenir Il s'agit d'un champ essentiel du dossier principal de l'employé dans le module RH Core de UKG Pro. Exemples ActifTerminéCongé
	Titre de poste JobTitle	L'intitulé de poste officiel de l'employé, par exemple 'Software Engineer' ou 'Sales Manager'.
Description L'intitulé de poste décrit le rôle ou la fonction de l'employé dans l'organisation. Cet attribut est une dimension clé pour analyser comment les processus varient selon les rôles et les niveaux de séniorité. En analyse, l'intitulé de poste permet de comparer les temps d'onboarding entre rôles, d'évaluer la rapidité des promotions, ou d'identifier si certains postes affichent des taux d'attrition précoce plus élevés. Cela aide à adapter les processus RH et les dispositifs d'accompagnement aux besoins des différents groupes d'employés. Pourquoi c'est important Permet une analyse basée sur les rôles pour comprendre comment les processus du cycle de vie varient selon les différentes fonctions et niveaux d'ancienneté. Où obtenir Il s'agit d'un champ standard associé au poste ou à l'enregistrement d'emploi de l'employé dans le module RH Core de UKG Pro. Exemples Ingénieur logiciel IIChef de produit seniorPartenaire d'affaires RH
	Date de résiliation TerminationDate	La date officielle de fin de contrat d'un employé.
Description La Date de fin de contrat marque la fin de la période d'emploi de l'employé. C'est le point final de son cycle de vie au sein de l'organisation. Cet attribut est nécessaire pour calculer l'ancienneté finale et constitue un élément clé de l'analyse d'attrition. Le temps écoulé entre la Date d'embauche et la Date de fin de contrat sert de base au dashboard 'Insights sur l'attrition en début d'ancienneté' et aux KPI associés. Pourquoi c'est important Définit la fin du cycle de vie des employés, permettant le calcul de l'ancienneté totale et soutenant toutes les analyses liées à l'attrition. Où obtenir Il s'agit d'un champ standard du dossier principal de l'employé dans UKG Pro, renseigné lorsque le processus de cessation d'emploi est terminé. Exemples 2023-11-302024-02-152022-12-31
	Emplacement Location	L'emplacement géographique ou le bureau où l'employé est basé.
Description Cet attribut spécifie le lieu de travail principal de l'employé, qui peut être une ville, un pays ou un bâtiment de bureau spécifique. C'est une dimension clé pour l'analyse géographique des processus RH. L'analyse de la performance des processus par localisation peut révéler des différences régionales en matière d'efficacité de recrutement, de pratiques d'onboarding ou de taux de rotation. Par exemple, vous pourriez comparer le temps de cycle de recrutement entre les bureaux de 'New York' et 'Londres' pour identifier les meilleures pratiques ou les goulots d'étranglement localisés. Pourquoi c'est important Permet la segmentation géographique du processus, révélant les variations régionales en termes de performance et de conformité. Où obtenir Cette information fait partie des données d'emploi ou personnelles de l'employé dans le module RH Core de UKG Pro. Exemples New York, NYLondres, Royaume-UniÀ distance
	Est une attrition précoce IsEarlyChurn	Un indicateur booléen qui indique si la résiliation du contrat d'un employé est survenue au cours d'une période de début d'ancienneté prédéfinie, par exemple, 90 ou 180 jours.
Description Cet attribut calculé identifie les employés qui quittent l'organisation peu après avoir été embauchés. Le seuil de 'précoce' est généralement défini par l'entreprise, par exemple, au cours de la première année. Ce drapeau simplifie l'analyse requise pour le dashboard 'Aperçus du churn précoce des employés' et l'ICP 'Taux de churn précoce des employés'. Il permet un filtrage et une segmentation rapides pour isoler ce groupe d'intérêt élevé et analyser leurs caractéristiques et leurs modèles de cycle de vie, aidant à identifier les problèmes de recrutement ou d'onboarding. Pourquoi c'est important Soutient directement l'analyse précoce du turnover en signalant les cas à risque, aidant à identifier les causes profondes des départs prématurés d'employés. Où obtenir Cet attribut est calculé lors de la préparation des données. La logique compare la différence entre la 'TerminationDate' et la 'HireDate' par rapport à un seuil prédéfini (par exemple, 365 jours). Exemples truefaux
	Évaluation de la Performance PerformanceRating	La note attribuée à un employé lors d'un cycle d'évaluation de la performance.
Description La note de performance est le résultat d'une activité 'Performance Review Conducted', généralement sur une échelle (par exemple 1-5) ou avec des libellés descriptifs (par exemple 'Exceeds Expectations'). Elle quantifie l'évaluation de la performance d'un employé. Cet attribut sert à relier les événements du processus aux résultats de performance. Par exemple, l'analyse peut montrer si les meilleurs éléments sont promus plus vite, ou s'il existe un lien entre les notes et la rotation du personnel. Cette mesure est au cœur du dashboard 'Conformité du cycle d'évaluation de la performance'. Pourquoi c'est important Relie les événements du processus aux résultats de performance, permettant d'analyser l'efficacité de la gestion des talents et son impact sur la rétention. Où obtenir Présent au sein du module de gestion de la performance UKG Pro, lié à des cycles d'évaluation spécifiques. Exemples Dépasse les attentesRépond aux attentesNécessite des Améliorations5
	Heure de fin de l'événement EventEndTime	L'horodatage qui marque la fin d'une activité dont la durée est mesurable.
Description Pour les activités non instantanées, l'Heure de fin de l'événement enregistre le moment où l'activité a été achevée. Cela contraste avec l'Horodatage de l'événement (Heure de début), qui marque le début. Avoir à la fois une heure de début et une heure de fin permet de calculer précisément le temps de traitement des activités individuelles, telles que la « Vérification des antécédents » ou la « Tâche d'intégration ». Cela facilite une analyse plus granulaire de la répartition du temps au sein du processus. Pourquoi c'est important Permet le calcul des temps de traitement précis pour les activités individuelles, aidant à identifier les étapes les plus chronophages du processus. Où obtenir Provient des champs de date de fin dans UKG Pro. Cela nécessite souvent d'associer un événement de début à un événement de fin correspondant à partir des données source. Exemples 2023-01-15T17:30:00Z2023-06-21T10:00:00Z2024-02-01T11:05:00Z
	Motif de résiliation TerminationReason	Le motif documenté du départ d'un employé, par exemple 'Voluntary - Resignation' ou 'Involuntary - Performance'.
Description Cet attribut saisit la raison pour laquelle l'emploi d'un employé a été résilié. Les raisons sont généralement classées comme volontaires ou involontaires, avec des sous-catégories plus spécifiques. Il s'agit d'un attribut essentiel pour l'analyse de la rétention et du churn. En segmentant les employés partis par leur motif de départ, les organisations peuvent obtenir des informations approfondies sur les causes profondes de l'attrition. Par exemple, l'analyse du 'Taux de churn précoce des employés' par motif de résiliation peut aider à distinguer les mauvais choix d'embauche des offres concurrentielles. Pourquoi c'est important Offre un aperçu critique des facteurs de la rotation du personnel, permettant des stratégies de rétention ciblées. Où obtenir Ce champ est généralement enregistré pendant le processus de cessation d'emploi ou de départ au sein du module RH Core de UKG Pro. Exemples Départ volontaire - Autre opportunitéInvolontaire - PerformanceRetraite
	Niveau de salaire SalaryGrade	Le niveau ou la fourchette de rémunération associés au rôle de l'employé.
Description Le Niveau de salaire représente le niveau de rémunération pour un poste particulier. C'est un attribut clé pour l'analyse des activités et des tendances liées à la rémunération. Cet attribut est important pour des analyses telles que les événements « Rémunération modifiée » et peut être utilisé pour suivre le KPI « Taux de retouche des données après intégration » si des corrections fréquentes des niveaux de salaire sont observées. Il permet également une segmentation pour voir si les temps de cycle de promotion ou les taux de rotation diffèrent par niveau de rémunération. Pourquoi c'est important Fournit un contexte pour les activités liées à la rémunération et permet la segmentation du processus par niveau de rémunération. Où obtenir Disponible dans le profil de rémunération ou d'emploi de l'employé au sein du module RH Core d'UKG Pro. Exemples IC3M2D1
	Nom de la formation TrainingName	Le nom ou l'intitulé de la formation attribuée à l'employé.
Description Cet attribut identifie un module de formation ou d'apprentissage spécifique qui a été attribué à un employé. Cela peut aller de la formation obligatoire de conformité au développement de compétences spécifiques à un rôle. Il s'agit d'un attribut clé pour le dashboard 'Attribution et achèvement de la formation' et l'ICP 'Taux d'achèvement de la formation'. Il permet de suivre les progrès et l'efficacité de programmes de formation spécifiques et d'analyser les temps d'achèvement pour différents cours. Pourquoi c'est important Permet le suivi et l'analyse de programmes de formation spécifiques, aidant à mesurer la conformité et l'efficacité du développement. Où obtenir Provient du module d'apprentissage d'UKG Pro ou d'un Système de Gestion de l'Apprentissage (LMS) connecté. Exemples Code de conduite 2024Compétences avancées en gestionSensibilisation à la cybersécurité
	Raison du changement de rôle RoleChangeReason	Le motif d'un changement de rôle pour un employé, par exemple 'Promotion', 'Lateral Transfer' ou 'Reorganization'.
Description Cet attribut fournit un contexte pour les événements de mobilité interne. Il explique pourquoi le rôle ou le poste d'un employé a été modifié au sein de l'organisation. Ceci est essentiel pour le dashboard 'Temps de cycle de la mobilité interne' et l'ICP, car il permet de différencier les promotions des autres types de transferts. L'analyse du processus par motif peut révéler si les processus de promotion sont plus lents que les mouvements latéraux, aidant ainsi à rationaliser les parcours de développement de carrière. Pourquoi c'est important Explique le contexte des mouvements internes, permettant une analyse plus nuancée des processus de mobilité interne, tels que les promotions par rapport aux transferts latéraux. Où obtenir Cette information est généralement saisie dans le cadre de la transaction de changement de poste ou de transfert dans le module RH Core de UKG Pro. Exemples PromotionTransfert latéralRéorganisation
	Temps de traitement ProcessingTime	La durée calculée d'une activité, de son début à sa fin.
Description Le Temps de traitement mesure le temps passé sur une tâche spécifique, calculé comme la différence entre l'Heure de fin de l'événement et l'Horodatage de l'événement (Heure de début). Il représente le temps de service pour une activité. Cet indicateur est crucial pour identifier les activités spécifiques qui consomment le plus de temps dans le processus. Par exemple, il peut révéler que l'activité « Vérification des antécédents lancée » prend, en moyenne, cinq jours à se terminer, ce qui en fait une cible claire pour les efforts d'optimisation. Pourquoi c'est important Quantifie la durée des tâches individuelles, permettant une optimisation ciblée des activités les plus chronophages du processus. Où obtenir Cet attribut est calculé lors de la préparation des données en soustrayant l'Event Timestamp de l'Event End Time. Exemples 28800086400604800

Obligatoire Recommandé Facultatif

Activités du cycle de vie de l'employé : de l'embauche au départ

Voici les étapes clés du processus et les jalons à enregistrer dans votre journal d'événements pour une découverte et une optimisation précises des processus.

6 Recommandé 9 Facultatif

	Activité	Description
	Contrat de l'employé terminé	L'événement final du cycle de vie d'un employé, qui marque la fin officielle de la relation d'emploi. À compter de la date de fin effective, le dossier de l'employé devient inactif dans le système.
Pourquoi c'est important Il s'agit de l'event de fin définitif pour le processus, crucial pour le calcul de l'ancienneté finale de l'employé et l'analyse de l'attrition. Il boucle la boucle du parcours de l'employé au sein de l'entreprise. Où obtenir Il s'agit de la date d'effet de l'action finale de 'Cessation d'emploi' dans l'historique des données d'emploi de l'employé au sein du module HR Core. Le système modifie généralement le statut de l'employé d'actif à inactif à cette date. Capture Capturé à partir de la date d'effet de l'action 'Licenciement' dans l'historique d'emploi de l'employé. Type d'événement explicit
	Employé embauché	Marque la création officielle du dossier de l'employé dans UKG Pro, où un ID Employé est formellement attribué. Cet événement est généralement capturé lorsqu'un administrateur RH finalise le processus d'embauche pour un candidat, le faisant passer au statut d'employé actif au sein du système.
Pourquoi c'est important Il s'agit de l'event de début définitif pour l'analyse du processus De l'embauche à la retraite. Il fournit la base pour mesurer le délai d'atteinte de la productivité, l'efficacité de l'intégration et l'ancienneté globale des employés. Où obtenir Cet événement est probablement enregistré dans le module RH Core ou Administration du personnel. Il peut être identifié par la date de création de l'enregistrement d'emploi principal de l'employé ou un enregistrement d'action 'Hire' spécifique dans l'historique des données d'emploi de l'employé. Capture Capturé à partir de la date d'effet de l'action 'Embauche' dans la table de l'historique d'emploi de l'employé. Type d'événement explicit
	Employé intégré	Un jalon clé signifiant l'achèvement réussi de la liste de contrôle ou du workflow d'intégration (onboarding) initial. Cela signifie généralement que toutes les formalités administratives requises pour les nouvelles recrues, les demandes d'accès au système et les tâches administratives initiales sont terminées.
Pourquoi c'est important Marque la fin de la configuration administrative initiale, permettant l'analyse du temps de cycle total de l'onboarding. Il indique le moment où l'employé est administrativement prêt à commencer ses fonctions spécifiques à son rôle. Où obtenir Situé dans le module d'onboarding. Il est généralement déduit de l'horodatage de l'achèvement du workflow global d'onboarding ou lorsque la dernière tâche d'onboarding obligatoire est marquée comme terminée. Capture Déduit de l'horodatage d'achèvement de la liste de contrôle principale d'intégration pour l'employé. Type d'événement inferred
	Évaluation de la performance Effectuée	Représente l'achèvement d'un cycle formel d'évaluation des performances pour un employé. Cet événement est enregistré lorsque le formulaire d'évaluation est finalisé et soumis par le responsable ou les RH.
Pourquoi c'est important Il s'agit d'un jalon récurrent essentiel dans le cycle de vie de l'employé. Le suivi de sa fréquence et de sa ponctualité aide à évaluer la conformité de la gestion de la performance et son impact sur la progression de carrière. Où obtenir Présent dans le module de gestion de la performance UKG Pro. Il peut être identifié par la date d'achèvement du formulaire d'évaluation de la performance ou un changement de statut à « Terminé » pour un cycle d'évaluation. Capture Capturé à partir de l'horodatage de fin de l'instance du workflow d'évaluation de performance. Type d'événement explicit
	Promotion approuvée	Indique l'approbation formelle de la promotion d'un employé, qui inclut généralement un changement de titre de poste et souvent une modification de la rémunération. C'est un événement distinct qui précède la date d'effet du changement.
Pourquoi c'est important Cette activité est essentielle pour analyser la mobilité interne et la progression de carrière. Le délai entre l'approbation d'une promotion et sa date d'effet peut révéler des goulots d'étranglement administratifs dans le système. Où obtenir Enregistré comme une action spécifique liée à l'emploi, telle qu'une « Promotion », dans l'historique des données d'emploi de l'employé au sein du module HR Core. L'enregistrement aura ses propres dates d'approbation et d'entrée en vigueur. Capture Capturé à partir de la date d'enregistrement d'une action 'Promotion' dans l'historique d'emploi de l'employé. Type d'événement explicit
	Résiliation initiée	Représente le début du processus de départ de l'employé, enregistré lorsqu'une date de fin de contrat future est saisie dans le système. Cet événement déclenche les listes de contrôle de départ et les flux de travail associés.
Pourquoi c'est important Il s'agit d'un jalon essentiel qui marque le début du processus de départ de l'employé. L'analyse du temps écoulé entre cet event et la cessation d'emploi finale permet d'évaluer l'efficacité et l'exhaustivité des procédures de départ. Où obtenir Il s'agit généralement de la création d'un enregistrement d'action de 'Cessation d'emploi' dans les données d'emploi de l'employé, avec une date d'effet future. Il peut également s'agir du début d'un workflow de départ dans un module spécifique. Capture Capturé lorsqu'une transaction de licenciement avec une date future est soumise. Type d'événement explicit
	Changement de Responsable Hiérarchique	Cet événement est généré lorsque le champ 'Reports To' ou 'Manager ID' d'un employé est mis à jour. Il représente un changement dans la ligne hiérarchique directe de l'employé.
Pourquoi c'est important Les changements de responsables hiérarchiques peuvent avoir un impact significatif sur l'engagement et la performance des employés. Le suivi de cet événement permet d'analyser son effet sur les activités subséquentes comme les évaluations de performance ou la rétention. Où obtenir Cet événement doit être déduit en suivant les changements apportés au champ du responsable ou du superviseur dans les données d'emploi de l'employé au fil du temps. Il nécessite de comparer l'ID du responsable entre les enregistrements consécutifs pour le même employé. Capture Déduit en détectant un changement dans le champ « Rapporte à » de l'historique des données d'emploi de l'employé. Type d'événement inferred
	Changement de rôle traité	Représente un changement de poste ou de fonction de l'employé qui n'est pas une promotion, comme une mutation latérale ou un changement de service. Ceci est enregistré lorsque les données d'emploi pertinentes sont mises à jour dans le système.
Pourquoi c'est important L'analyse des changements de rôle fournit des informations sur la mobilité interne, le déploiement des talents et la restructuration organisationnelle. Elle aide à identifier comment les employés évoluent au sein de l'organisation. Où obtenir Capturé à partir de l'historique des données d'emploi de l'employé dans le module HR Core. Il peut être identifié par des actions d'emploi telles que 'Transfert', 'Réaffectation' ou 'Changement de poste', ainsi que leurs dates d'effet. Capture Identifié par un code d'action tel que « Transfert » ou similaire dans les données d'historique d'emploi de l'employé. Type d'événement explicit
	Configuration de la Paie Terminée	Indique que toutes les informations nécessaires au traitement de la paie de l'employé, telles que les coordonnées bancaires et les formulaires fiscaux, ont été saisies et vérifiées. C'est une étape critique pour s'assurer que l'employé est payé correctement et à temps.
Pourquoi c'est important Ce jalon est crucial pour mesurer la préparation des nouvelles recrues. Les retards dans la configuration de la paie peuvent entraîner l'insatisfaction des employés et des reprises administratives, ce qui en fait un indicateur clé de performance pour l'intégration. Où obtenir Cet événement peut être déduit du module de paie UKG Pro. Il peut être dérivé de la date de complétion d'une checklist de préparation de la paie ou de la date à laquelle le statut de l'employé passe à 'Prêt pour la paie'. Capture Dérivé d'un changement de statut ou d'un timestamp de complétion dans le profil de paie de l'employé. Type d'événement inferred
	Début du Congé	Marque le début d'un congé approuvé pour un employé, comme pour des raisons médicales ou personnelles. Ceci est enregistré lorsque le statut de l'employé passe à un état inactif, en congé.
Pourquoi c'est important Identifie les périodes d'inactivité dans le cycle de vie d'un employé. C'est essentiel pour calculer avec précision l'ancienneté active et comprendre l'impact des congés sur la progression de carrière. Où obtenir Présent dans l'historique des données d'emploi de l'employé au sein du module RH Core. Cela correspond à une action liée à l'emploi, comme un « Congé », avec une date de début d'effet spécifique. Capture Capturé à partir de la date d'effet d'une action 'Début de congé' dans l'historique d'emploi. Type d'événement explicit
	Départ Terminé	Un jalon indiquant que toutes les tâches de départ (offboarding) obligatoires ont été accomplies. Cela inclut des activités telles que la restitution des biens, le calcul final de la paie et la révocation de l'accès au système.
Pourquoi c'est important Cet événement confirme que toutes les étapes nécessaires ont été prises pour se séparer de l'employé de manière sécurisée et conforme. Il aide à mesurer le temps de cycle de l'offboarding et à identifier les lacunes en matière de conformité. Où obtenir Ceci serait déduit du timestamp de complétion de la liste de contrôle ou du workflow global de départ, similaire à l'événement 'Employé Intégré' mais pour le processus de sortie. Capture Déduit de l'horodatage d'achèvement de la liste de contrôle principale de départ pour l'employé. Type d'événement inferred
	Entretien de départ mené	Cet événement marque la complétion de l'entretien de départ avec l'employé sortant. Il est généralement enregistré comme une tâche terminée dans une checklist d'offboarding.
Pourquoi c'est important Le suivi de la réalisation des entretiens de départ est important pour garantir la conformité RH et recueillir des retours précieux. Il aide à identifier si cette étape cruciale est ignorée dans le processus de départ. Où obtenir Cet event se trouverait probablement dans le module UKG Pro Onboarding ou HR Help Desk, en tant que tâche spécifique au sein d'un workflow de départ. Sa saisie dépend de la validation manuelle de la tâche comme terminée par les RH. Capture Enregistré comme une tâche terminée dans la liste de contrôle de départ d'un employé. Type d'événement explicit
	Formation attribuée	Capture le moment où un cours de formation ou un plan d'apprentissage spécifique est attribué à un employé. Ceci est généralement enregistré dans le module de gestion de l'apprentissage du système.
Pourquoi c'est important Cette activité permet de suivre la conformité aux formations obligatoires et de surveiller le développement des employés. L'analyse du temps entre l'attribution et l'achèvement peut mettre en évidence des problèmes d'engagement ou l'efficacité de la formation. Où obtenir Enregistré dans les modules de gestion de l'apprentissage ou de gestion des talents d'UKG Pro. Chaque attribution doit avoir un enregistrement correspondant avec une date d'attribution et un ID d'employé. Capture Enregistré lorsqu'un cours ou un programme est attribué au plan de formation d'un employé. Type d'événement explicit
	Onboarding Initié	Représente le début du processus d'intégration des nouvelles recrues ou du flux de travail au sein d'UKG Pro. Il s'agit généralement d'un événement déclenché automatiquement ou manuellement qui attribue une liste de contrôle des tâches au nouvel employé, à son responsable et aux RH.
Pourquoi c'est important Le suivi de cette activité aide à mesurer le temps entre la date d'embauche officielle et le début de l'intégration administrative et culturelle. C'est le point de départ pour analyser l'efficacité du processus d'intégration et identifier les retards. Où obtenir Présent dans le module d'intégration UKG Pro. L'événement peut être déduit de la date de création de la liste de contrôle d'intégration ou de l'instance de workflow associée à l'employé. Capture Déduit de l'horodatage de création du workflow ou de la liste de tâches d'intégration de l'employé. Type d'événement inferred
	Rémunération modifiée	Cet événement capture tout changement apporté au salaire de base d'un employé, à la structure des primes ou à d'autres composantes de la rémunération. Il peut faire partie d'une promotion, d'une augmentation au mérite ou d'un ajustement de marché.
Pourquoi c'est important Le suivi des changements de rémunération est vital pour comprendre la progression de carrière et salariale. Des ajustements fréquents après l'embauche pourraient indiquer des erreurs de saisie de données ou des problèmes avec la fixation du salaire initial. Où obtenir Présent dans le tableau de l'historique des rémunérations de l'employé au sein du module RH Core ou du module de paie. Chaque changement est généralement enregistré avec une date d'effet et un code motif. Capture Enregistré à partir de la date d'entrée en vigueur d'une nouvelle entrée dans l'historique des rémunérations de l'employé. Type d'événement explicit

Recommandé Facultatif

Guides d'extraction

Comment obtenir vos données d'UKG Pro

Étapes

Prérequis : Assurez-vous que Python 3.6+ ainsi que les bibliothèques requests et pandas sont installés. Vous pouvez les installer via pip : pip install requests pandas.
Accès et authentification API : Contactez votre administrateur UKG Pro pour créer un compte de service. Vous aurez besoin de la clé API, du nom d'utilisateur et du mot de passe. Le compte de service doit disposer des autorisations nécessaires pour accéder à tous les points de terminaison API requis, y compris les données relatives au personnel, à la paie, à l'intégration (onboarding), à la performance et à la formation.
Configurer le script : Ouvrez le script Python fourni dans un éditeur de texte ou un IDE. Localisez la section de configuration au début du script et remplacez les valeurs de remplacement pour UKG_BASE_URL, API_KEY, USERNAME, PASSWORD et COMPANY_ID par vos identifiants et détails d'environnement spécifiques.
Définir la période d'extraction des données : Dans la section de configuration, définissez les variables START_DATE et END_DATE. Cela détermine la fenêtre temporelle pour laquelle les modifications et les événements des employés seront extraits. Il est recommandé de commencer par une période plus courte, telle que 3 à 6 mois, pour tester le script.
Exécuter le script : Exécutez le script depuis votre ligne de commande à l'aide de python your_script_name.py. Le script s'authentifiera, récupérera les données de divers points de terminaison API UKG Pro pour chaque activité et affichera les mises à jour de progression dans la console.
Gérer la limitation de l'API : Le script inclut une fonction time.sleep() de base pour respecter les limites de débit de l'API. Si vous rencontrez des erreurs de limitation (HTTP 429), vous devrez peut-être augmenter la durée de la pause entre les appels API.
Transformer et standardiser les données : Chaque fonction du script est conçue pour récupérer les données brutes d'une activité spécifique, sélectionner les champs pertinents et les renommer au format standard du journal d'événements (EmployeeId, ActivityName, EventTimestamp, etc.).
Combiner les données d'événements : La partie principale du script appelle chaque fonction spécifique à une activité et ajoute les données résultantes à une liste principale unique d'événements.
Générer le journal d'événements : Après le traitement de toutes les activités, le script consolide les données dans un DataFrame pandas, les trie par ID d'employé et par horodatage, et les enregistre sous forme de fichier CSV nommé ukg_hire_to_retire_event_log.csv.
Examiner et télécharger : Ouvrez le fichier CSV généré pour vous assurer que les données sont complètes et correctement formatées. Ce fichier est maintenant prêt à être téléchargé dans l'outil de Process Mining.

Configuration

Informations d'authentification : Une clé API d'un compte de service, un nom d'utilisateur et un mot de passe sont nécessaires pour l'authentification API.
URL de base : L'UKG_BASE_URL de votre instance UKG Pro (par exemple, https://service[##].ultipro.com/api).
ID d'entreprise : L'COMPANY_ID unique de votre organisation au sein de UKG Pro est indispensable pour de nombreux appels API.
Période : Les paramètres START_DATE et END_DATE (au format 'AAAA-MM-JJ') définissent la fenêtre d'extraction. Pour le premier lancement, une période de 3 à 6 mois est recommandée pour gérer le volume de données et vérifier les résultats.
Versions des points d'accès API : Le script utilise des versions spécifiques des API REST (par exemple, /personnel/v1/). Assurez-vous que votre instance UKG Pro prend en charge ces versions.
Dépendances de module : L'extraction de certaines activités nécessite que votre organisation ait licencié et utilise activement les modules UKG Pro correspondants, tels que Onboarding, Learning et Performance Management. Si un module n'est pas utilisé, l'activité correspondante ne sera pas extraite.

a Exemple de requête 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}")