> Amélioration continue des processus > Hire to Retire, cycle de vie des collaborateurs > UKG Pro > Modèle de données

Votre template de données Hire to Retire, cycle de vie des collaborateurs

UKG Pro

Hire to Retire, attributs du cycle de vie des collaborateurs (21) Hire to Retire, activités du cycle de vie des collaborateurs (15) Guides d'extraction (1)

Votre template de données Hire to Retire, cycle de vie des collaborateurs

Ce template présente une vue d'ensemble des éléments de données essentiels à l'analyse efficace de votre processus Hire to Retire. Il précise les attributs importants à collecter, les activités clés à suivre et fournit des indications pratiques pour extraire ces données d'UKG Pro. Utilisez cette ressource pour simplifier la préparation de vos données et démarrer votre démarche de Process Mining dans de bonnes conditions.

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

Vous découvrez les journaux d’événements ? En savoir plus sur la création d’un journal d’événements pour le Process Mining.

Télécharger le modèle

Hire to Retire, attributs du cycle de vie des collaborateurs

Voici les champs de données recommandés à inclure dans votre journal d’événements pour analyser de manière complète le cycle de vie des collaborateurs, de l’embauche au départ, et obtenir des analyses pertinentes.

5 Obligatoire 7 Recommandé 9 Facultatif

	Nom	Description
	Horodatage de l’événement EventTimestamp	Date et heure précises auxquelles un événement donné du cycle de vie s’est produit.
Description L’horodatage de l’événement fournit le contexte chronologique de chaque activité et constitue la base du flux de processus. Il enregistre le moment exact où un événement tel que « Offer Accepted » ou « Promotion Approved » a été enregistré dans le système. Dans le cadre de l’analyse, ces horodatages servent à calculer les durées entre les activités, à repérer les retards et à mesurer les temps de cycle de sous-processus clés comme le recrutement et l’intégration. Des horodatages précis sont essentiels pour tous les KPI fondés sur le temps et pour l’analyse des performances. Pourquoi c’est important Cet attribut est essentiel pour classer les événements par ordre chronologique et calculer toutes les métriques temporelles, notamment les temps de cycle et les durées. Où les obtenir Provient des champs de date ou d’horodatage associés à des événements précis dans UKG Pro, tels que « HireDate », « TerminationDate » 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
	Identifiant de l’employé EmployeeId	Identifiant unique attribué à chaque employé, qui sert d'identifiant de cas principal pendant tout son cycle de vie au sein de l'organisation.
Description L'Employee ID constitue le fil conducteur qui relie tous les événements associés à un employé, de sa candidature initiale à la fin de son départ. Cet identifiant est essentiel pour reconstituer une vue complète de bout en bout du parcours d'une personne. Dans une analyse de Process Mining, chaque activité, comme « Employee Hired », « Promotion Approved » ou « Termination Initiated », est rattachée à cet identifiant unique. Vous pouvez ainsi analyser les parcours individuels, constituer des cohortes selon les attributs des employés et calculer précisément la durée des cycles de vie. Pourquoi c’est important Il s'agit de l'identifiant de cas essentiel qui relie tous les événements associés à un employé et permet d'analyser le processus Hire to Retire de bout en bout pour chaque personne. Où les obtenir Il s’agit d’un champ essentiel dans UKG Pro, généralement présent dans les fiches de profil des employés ou les enregistrements de données de référence. Consultez la documentation de UKG Pro pour connaître le nom exact de la table et du champ, souvent intitulé Employee Number ou Person ID. Exemples 10052198345210047
	Dernière mise à jour des données LastDataUpdate	Horodatage indiquant la dernière actualisation ou extraction des données associées à cet événement depuis le système source.
Description Cet attribut fournit l’horodatage de la dernière extraction des données depuis UKG Pro. Il ne correspond pas au moment où l’événement métier s’est produit, mais à celui où l’enregistrement a été importé dans l’outil de Process Mining. Cette information est essentielle pour évaluer l’actualité des données analysées. Elle permet aux analystes et aux utilisateurs métier de savoir dans quelle mesure la vue du processus est à jour, tout en facilitant la gestion des calendriers d’actualisation et la vérification de la récence des analyses. Pourquoi c’est important Indique l’actualité des données, un élément essentiel pour accorder sa confiance à l’analyse et prendre des décisions métier en temps utile. Où les obtenir Cet horodatage 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	Nom de l’événement ou du jalon qui s’est produit à une étape donnée du cycle de vie de l’employé, par exemple « Employee Hired » ou « Performance Review Conducted ».
Description Le nom de l’activité décrit une étape ou une tâche précise du processus Hire to Retire. Ces événements sont horodatés et classés afin de constituer le flux de processus visualisé et analysé dans le 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 les plus courants, les écarts par rapport au processus standard et les goulots d’étranglement entre des activités clés telles que « Onboarding Initiated » et « Payroll Setup Completed ». Pourquoi c’est important Cet attribut définit les étapes de la cartographie du processus et permet de visualiser et d’analyser le parcours du cycle de vie de l’employé. Où les obtenir Cet élément est généralement dérivé des journaux d’événements, des changements de statut des flux de travail ou de champs de date précis dans différents modules de UKG Pro, par exemple Recruiting, Onboarding et Performance Management. Une logique d’association est généralement nécessaire pour générer des noms d’activités normalisés. Exemples Employé recrutéÉvaluation de performance réaliséeDépart initié
	Système source SourceSystem	Identifie le système depuis lequel les données ont été extraites, en l’occurrence UKG Pro.
Description Cet attribut précise l’origine des données du processus. Dans ce contexte, il s’agit principalement de UKG Pro, mais un processus Hire to Retire peut également intégrer des données provenant d’autres systèmes, comme un Applicant Tracking System (ATS) ou un système de gestion de l’apprentissage (LMS). Dans le cadre de l’analyse, il permet de distinguer les sources de données lorsque plusieurs systèmes sont concernés. Il est également essentiel pour la gouvernance des données et le dépannage. Pour une vue provenant d’une seule source, il fournit un contexte indispensable sur l’origine des données. Pourquoi c’est important Fournit un contexte important pour la gouvernance des données, l’assurance qualité et la traçabilité en identifiant l’origine des données d’événements. Où les obtenir Il s’agit généralement d’une valeur statique (« UKG Pro ») ajoutée lors de l’extraction et de la transformation des données. Exemples UKG ProUKGPro_CoreHRUKG
	Date d’embauche HireDate	Date officielle de début de l’emploi de l’employé dans l’organisation.
Description La date d’embauche marque le début de l’ancienneté de l’employé. Il s’agit d’un champ de date fondamental, qui sert de référence à de nombreux calculs et analyses temporels liés au cycle de vie de l’employé. Cet attribut sert à calculer l’ancienneté, essentielle pour analyser l’« Early Employee Churn Rate ». Il facilite également l’analyse par cohortes, en permettant de comparer les parcours du cycle de vie d’employés embauchés à différentes périodes. Pourquoi c’est important Sert de référence pour calculer l’ancienneté et constitue un élément essentiel de l’analyse par cohortes et des KPI liés au taux de rotation. Où les obtenir Il s’agit d’un champ standard et obligatoire de l’enregistrement principal de l’employé dans le module Core HR de UKG Pro. Exemples 2022-08-152023-01-202021-05-10
	Identifiant de la demande de recrutement JobRequisitionId	Identifiant unique de la demande de recrutement à l’origine du processus d’embauche.
Description L’identifiant de la demande de recrutement est la référence unique d’un poste à pourvoir. Il relie toutes les activités initiales du recrutement, de la création et de l’approbation de la demande à la recherche de candidats et à l’envoi des offres. Cet identifiant est essentiel pour analyser le KPI « Recruitment Cycle Time », car il marque le véritable début du processus d’embauche. Il permet de suivre l’ensemble du parcours associé à un poste donné et d’analyser des métriques telles que le « Inactive Job Requisition Rate », en identifiant les demandes qui n’aboutissent pas. Pourquoi c’est important Fournit un point de départ clair pour le processus de recrutement, permettant de mesurer précisément les temps de cycle d’embauche et l’efficacité des demandes. Où les obtenir Présent dans le module Recruiting de UKG Pro ou dans l’Applicant Tracking System (ATS) connecté. Exemples REQ-2023-015REQ-2024-112REQ-2023-504
	Intitulé du poste JobTitle	Intitulé officiel du poste de l’employé, par exemple « Software Engineer » ou « Sales Manager ».
Description L’intitulé du poste décrit le rôle ou la fonction de l’employé dans l’organisation. Cet attribut constitue une dimension importante pour analyser les différences entre les processus selon les fonctions et les niveaux hiérarchiques. Dans le cadre de l’analyse, l’intitulé du poste peut servir à comparer les durées d’intégration selon les fonctions, à évaluer la rapidité des promotions ou à déterminer si certains postes présentent des taux de rotation précoce plus élevés. Ces analyses permettent d’adapter les processus RH et les programmes d’accompagnement aux besoins de chaque groupe d’employés. Pourquoi c’est important Permet une analyse par rôle afin de comprendre comment les processus du cycle de vie varient selon les fonctions et les niveaux hiérarchiques. Où les obtenir Il s’agit d’un champ standard associé à la fonction ou à la fiche de poste de l’employé dans le module Core HR de UKG Pro. Exemples Ingénieur logiciel IIResponsable produit seniorPartenaire RH
	Nom du responsable ManagerName	Nom du responsable hiérarchique direct de l’employé.
Description Cet attribut identifie le responsable hiérarchique direct de l’employé. Celui-ci intervient dans de nombreux événements du cycle de vie, notamment les évaluations de performance, les promotions et les affectations de formation. L’analyse par responsable permet de comprendre les écarts d’exécution au niveau des équipes et d’évaluer l’efficacité managériale. Le Dashboard « Manager Transition Impact Analysis », par exemple, s’appuie sur cet attribut pour mesurer l’effet d’un changement de responsable sur les activités suivantes. Il est également essentiel pour le KPI « Time to Managerial Re-engagement ». Pourquoi c’est important Permet d’analyser les performances du processus au niveau des équipes et d’évaluer l’influence des responsables sur les événements du cycle de vie des employés. Où les obtenir Ces informations font partie des données relatives à la structure hiérarchique de l’employé dans le module Core HR de UKG Pro. Exemples John SmithMaria GarciaChen Wei
	Service EmployeeDepartment	Service ou unité organisationnelle auquel l’employé est rattaché.
Description Cet attribut contient le nom du service auquel l’employé est rattaché, par exemple « Sales », « Engineering » ou « Finance ». Il constitue une dimension organisationnelle essentielle pour segmenter et comparer les performances du processus. L’analyse par service permet de comparer l’exécution du processus entre différentes unités métier. Vous pouvez par exemple vérifier si le « Recruitment Cycle Time » est plus long dans les services techniques, ou si le « Performance Review Adherence » varie sensiblement entre Sales et Operations, afin de cibler les améliorations. Pourquoi c’est important Permet une analyse comparative détaillée en offrant la possibilité de filtrer et de segmenter le processus selon la structure organisationnelle, et de mettre en évidence les écarts entre services. Où les obtenir Il s’agit d’un champ standard de la fiche de poste ou de fonction de l’employé dans le module Core HR de UKG Pro. Exemples IngénierieVentesRessources humaines
	Statut d’emploi EmploymentStatus	Statut actuel ou historique de l’emploi de l’employé, par exemple « Active », « Terminated » ou « On Leave ».
Description Cet attribut indique le statut officiel de l’employé dans l’entreprise à un moment donné. Il constitue une dimension essentielle pour comprendre l’état global des effectifs et filtrer l’analyse sur des populations d’employés précises. L’analyse des changements de statut d’emploi aide à modéliser correctement le processus, par exemple en distinguant un congé temporaire d’une rupture définitive. Elle est fondamentale pour calculer les taux de rotation et comprendre les résultats des différents parcours du cycle de vie. Pourquoi c’est important Fournit un contexte essentiel sur la situation de l’employé, permettant d’analyser précisément la rotation et de segmenter les effectifs. Où les obtenir Il s’agit d’un champ essentiel de l’enregistrement de référence de l’employé dans le module Core HR de UKG Pro. Exemples ActifEmploi terminéCongé autorisé
	Utilisateur à l’origine de l’action ActioningUser	Nom ou identifiant de l’utilisateur, généralement un représentant des ressources humaines ou un responsable, qui a effectué l’activité dans UKG Pro.
Description Cet attribut identifie la personne responsable de l’exécution d’une étape précise du processus, par exemple le recruteur qui a envoyé une offre ou le responsable qui a approuvé une promotion. Il relie les activités du processus aux intervenants humains. Dans le cadre de l’analyse, cet attribut est particulièrement utile pour comprendre la répartition de la charge de travail, identifier les besoins de formation et analyser les performances propres à chaque utilisateur. Il peut notamment aider à déterminer si les erreurs de saisie survenant après « Payroll Setup Completed » sont concentrées chez certains utilisateurs, ce qui contribue au suivi du KPI « Post-Onboarding Data Rework Rate ». Pourquoi c’est important Relie les activités du processus à des utilisateurs précis et permet ainsi d’analyser la charge de travail, de comparer les performances et d’examiner les reprises ou les erreurs. Où les obtenir Généralement présent dans les journaux de piste d’audit ou dans les champs « Last Modified By » des modules de UKG Pro. Le nom exact du champ varie selon le module. Exemples j.does.smithhr_admin
	Date de fin d’emploi TerminationDate	Date officielle de fin de l’emploi de l’employé.
Description La date de fin d’emploi marque la fin de l’ancienneté de l’employé. Elle constitue le point final de son cycle de vie dans l’organisation. Cet attribut est nécessaire pour calculer l’ancienneté totale et constitue un élément clé de l’analyse de la rotation. La période comprise entre la date d’embauche et la date de fin d’emploi sert de base au Dashboard « Early Tenure Churn Insights » et aux KPI associés. Pourquoi c’est important Définit la fin du cycle de vie de l’employé, permet de calculer l’ancienneté totale et contribue à toutes les analyses liées à l’attrition. Où les obtenir Il s’agit d’un champ standard de l’enregistrement principal de l’employé dans UKG Pro, renseigné lorsque le processus de départ est terminé. Exemples 2023-11-302024-02-152022-12-31
	Évaluation de la performance PerformanceRating	Évaluation attribuée à un employé au cours d’un cycle d’évaluation de la performance.
Description L’évaluation de la performance est le résultat de l’activité « Performance Review Conducted ». Elle repose généralement sur une échelle, par exemple de 1 à 5, ou sur des libellés descriptifs tels que « Exceeds Expectations ». Elle quantifie l’évaluation de la performance de l’employé. Cet attribut est utile pour mettre en relation les événements du processus et les résultats de performance. L’analyse peut notamment déterminer si les employés les plus performants sont promus plus rapidement ou s’il existe un lien entre les évaluations et la rotation des employés. Il constitue un élément central du Dashboard « Performance Review Cycle Compliance ». Pourquoi c’est important Relie les événements du processus aux résultats de performance et permet d’analyser l’efficacité de la gestion des talents ainsi que son incidence sur la fidélisation. Où les obtenir Présent dans le module Performance Management de UKG Pro, associé à des cycles d’évaluation précis. Exemples Dépasse les attentesRépond aux attentesDoit progresser5
	Heure de fin de l’événement EventEndTime	Horodatage marquant la fin d’une activité dont la durée peut être mesurée.
Description Pour les activités qui ne sont pas instantanées, l’heure de fin de l’événement indique le moment où l’activité a été achevée. Elle se distingue de l’horodatage de l’événement (StartTime), qui marque le début. La présence d’une heure de début et d’une heure de fin permet de calculer précisément le temps de traitement d’activités individuelles, telles que « Background Check » ou « Onboarding Task ». Elle permet une analyse plus détaillée du temps consacré à chaque étape du processus. Pourquoi c’est important Permet de calculer précisément les temps de traitement des activités individuelles et d’identifier les étapes qui prennent le plus de temps dans le processus. Où les obtenir Issu des champs de date d’achèvement de UKG Pro. Il est souvent nécessaire d’associer un événement de début à l’événement d’achèvement correspondant dans les données sources. Exemples 2023-01-15T17:30:00Z2023-06-21T10:00:00Z2024-02-01T11:05:00Z
	Lieu Location	Lieu géographique ou bureau où l’employé est basé.
Description Cet attribut précise le lieu de travail principal de l’employé, qui peut être une ville, un pays ou un bâtiment de bureaux donné. Il constitue une dimension essentielle pour l’analyse géographique des processus RH. L’analyse des performances du processus par lieu peut révéler des écarts régionaux en matière d’efficacité du recrutement, de pratiques d’intégration ou de taux de rotation. Vous pouvez par exemple comparer le « Recruitment Cycle Time » des bureaux de « New York » et de « London » afin d’identifier les bonnes pratiques ou les goulots d’étranglement locaux. Pourquoi c’est important Permet de segmenter géographiquement le processus et de mettre en évidence les écarts régionaux de performance et de conformité. Où les obtenir Ces informations font partie des données professionnelles ou personnelles de l’employé dans le module Core HR de UKG Pro. Exemples New York, NYLondres, Royaume-UniÀ distance
	Motif de départ TerminationReason	Motif documenté du départ de l’employé, par exemple « Voluntary - Resignation » ou « Involuntary - Performance ».
Description Cet attribut enregistre le motif de la fin de l’emploi de l’employé. Les motifs sont généralement classés comme volontaires ou involontaires, avec des sous-catégories plus précises. Il s’agit d’un attribut essentiel pour l’analyse de la fidélisation et de la rotation. En segmentant les employés partis selon leur motif de départ, les organisations peuvent mieux comprendre les causes profondes de l’attrition. Par exemple, l’analyse de l’« Early Employee Churn Rate » par motif de départ peut distinguer les erreurs de recrutement des offres concurrentes. Pourquoi c’est important Fournit des informations importantes sur les facteurs à l’origine de la rotation des employés et permet de mettre en place des stratégies de fidélisation ciblées. Où les obtenir Ce champ est généralement renseigné lors du processus de départ ou d’offboarding dans le module Core HR de UKG Pro. Exemples Volontaire, autre opportunitéInvolontaire, performance insuffisanteRetraite
	Motif du changement de rôle RoleChangeReason	Motif du changement de rôle de l’employé, par exemple « Promotion », « Lateral Transfer » ou « Reorganization ».
Description Cet attribut fournit le contexte des événements de mobilité interne. Il explique pourquoi le rôle ou le poste d’un employé a changé au sein de l’organisation. Il est essentiel pour le Dashboard et le KPI « Internal Mobility Cycle Time », car il permet de distinguer les promotions des autres types de mobilité. L’analyse du processus par motif peut révéler si les promotions sont plus lentes que les changements de poste latéraux et contribuer à optimiser les parcours d’évolution professionnelle. Pourquoi c’est important Explique le contexte des mobilités internes et permet une analyse plus précise des processus de mobilité, notamment en distinguant les promotions des changements de poste latéraux. Où les obtenir Ces informations sont généralement enregistrées dans le cadre de la transaction de changement de poste ou de transfert dans le module Core HR de UKG Pro. Exemples PromotionMutation latéraleRéorganisation
	Niveau de rémunération SalaryGrade	Niveau ou tranche de rémunération associé au poste de l’employé.
Description Le niveau de rémunération représente le niveau de salaire associé à un poste donné. Il s’agit d’un attribut essentiel pour analyser les activités et les tendances liées à la rémunération. Cet attribut est utile pour analyser les événements « Compensation Changed » et peut servir à suivre le KPI « Post-Onboarding Data Rework Rate » lorsque des corrections fréquentes des niveaux de rémunération sont observées. Il permet également de segmenter le processus afin de déterminer si les temps de cycle des promotions ou les taux de rotation varient selon le niveau de rémunération. Pourquoi c’est important Fournit un contexte pour les activités liées à la rémunération et permet de segmenter le processus selon le niveau de salaire. Où les obtenir Disponible dans la fiche de rémunération ou le profil professionnel de l’employé, dans le module Core HR de UKG Pro. Exemples IC3M2D1
	Nom de la formation TrainingName	Nom ou intitulé du cours de formation attribué à l’employé.
Description Cet attribut identifie une formation ou un module d’apprentissage précis attribué à un employé. Il peut s’agir d’une formation obligatoire sur la conformité ou du développement de compétences propres à un poste. Il constitue un attribut essentiel pour le Dashboard « Training Assignment & Completion » et le KPI « Training Completion Rate ». Il permet de suivre l’avancement et l’efficacité de programmes de formation précis, ainsi que de comparer les délais d’achèvement entre différents cours. Pourquoi c’est important Permet de suivre et d’analyser des programmes de formation précis, afin de mesurer la conformité et l’efficacité du développement des compétences. Où les obtenir Issu du module Learning de UKG Pro ou d’un Learning Management System (LMS) connecté. Exemples Code de conduite 2024Compétences avancées en managementSensibilisation à la cybersécurité
	Rotation précoce IsEarlyChurn	Indicateur booléen précisant si le départ de l’employé a eu lieu au cours d’une période d’ancienneté précoce prédéfinie, par exemple 90 ou 180 jours.
Description Cet attribut calculé signale les employés qui quittent l’organisation peu après leur embauche. Le seuil définissant le caractère « précoce » est généralement fixé par l’entreprise, par exemple au cours de la première année. Cet indicateur simplifie l’analyse nécessaire au Dashboard « Early Tenure Churn Insights » et au KPI « Early Employee Churn Rate ». Il permet de filtrer et de segmenter rapidement cette population particulièrement suivie, puis d’analyser ses caractéristiques et ses parcours du cycle de vie afin d’identifier d’éventuels problèmes de recrutement ou d’intégration. Pourquoi c’est important Contribue directement à l’analyse de la rotation précoce en signalant les cas à risque et en aidant à identifier les causes profondes des départs prématurés. Où les obtenir Cet attribut est calculé lors de la préparation des données. La logique compare l’écart entre « TerminationDate » et « HireDate » à un seuil prédéfini, par exemple 365 jours. Exemples truefalse

Obligatoire Recommandé Facultatif

Hire to Retire, activités du cycle de vie des collaborateurs

Voici les principales étapes et les jalons du processus à enregistrer dans votre journal d’événements pour une découverte précise du processus et son optimisation.

6 Recommandé 9 Facultatif

	Activité	Description
	Départ initié	Représente le début du processus de départ, enregistré lorsqu’une date de fin future est saisie dans le système. Cet événement déclenche les listes de contrôle et les flux de travail de départ.
Pourquoi c’est important Il s'agit d'une étape importante qui lance le processus de départ de l'employé. L'analyse du délai entre cet événement et la fin effective de l'emploi permet d'évaluer l'efficacité et l'exhaustivité des procédures de départ. Où les obtenir Il s’agit généralement de la création d’un enregistrement d’action « Termination » 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 flux de travail de départ dans un module donné. Collecte Capturé lorsqu'une transaction de fin d'emploi avec une date future est soumise. Type d’événement explicit
	Emploi de l'employé terminé	Dernier événement du cycle de vie de l'employé, marquant la fin officielle de la relation de travail. À cette date d'effet de la fin d'emploi, la fiche de l'employé devient inactive dans le système.
Pourquoi c’est important Il s'agit de l'événement de fin de référence du processus, essentiel pour calculer l'ancienneté finale de l'employé et analyser les départs. Il clôt le parcours de l'employé au sein de l'entreprise. Où les obtenir Il s'agit de la date d'effet de l'action finale « Termination » dans l'historique des données d'emploi de l'employé au sein du module HR Core. À cette date, le système fait généralement passer le statut de l'employé d'actif à inactif. Collecte Capturé à partir de la date d'effet de l'action « Termination » dans l'historique d'emploi de l'employé. Type d’événement explicit
	Employé recruté	Marque la création officielle de la fiche de l'employé dans UKG Pro, avec l'attribution formelle d'un Employee ID. Cet événement est généralement enregistré lorsqu'un administrateur RH finalise le recrutement d'un candidat et le fait passer au statut d'employé actif dans le système.
Pourquoi c’est important Il s'agit de l'événement de début de référence pour l'analyse du processus Hire to Retire. Il fournit le point de départ pour mesurer le délai avant la mise en productivité, l'efficacité de l'intégration et l'ancienneté globale de l'employé. Où les obtenir Cet événement est probablement enregistré dans le module HR Core ou Personnel Administration. Il peut être identifié à partir de la date de création de la fiche d'emploi principale de l'employé ou d'un enregistrement d'action « Hire » dans l'historique de ses données d'emploi. Collecte Capturé à partir de la date d'effet de l'action « Hire » dans l'historique d'emploi de l'employé. Type d’événement explicit
	Évaluation de performance réalisée	Représente la fin d'un cycle formel d'évaluation de la performance d'un employé. Cet événement est enregistré lorsque le formulaire d'évaluation est finalisé et envoyé par le manager ou les RH.
Pourquoi c’est important Il s'agit d'une étape récurrente importante du cycle de vie des employés. Le suivi de sa fréquence et du respect des délais aide à évaluer la conformité de la gestion de la performance et son impact sur l'évolution professionnelle. Où les obtenir Se trouve dans le module Performance Management de UKG Pro. Il peut être identifié à partir de la date de fin du formulaire d'évaluation ou d'un changement de statut vers « Completed » pour un cycle d'évaluation. Collecte Capturé à partir de l’horodatage d’achèvement de l’instance du flux de travail d’évaluation des performances. Type d’événement explicit
	Intégration de l'employé terminée	Étape importante indiquant que la liste de contrôle ou le flux de travail d’intégration initial a été mené à bien. Cela signifie généralement que tous les documents requis pour le nouvel employé, les demandes d’accès aux systèmes et les premières tâches administratives sont terminés.
Pourquoi c’est important Marque la fin de la configuration administrative initiale et permet d'analyser la durée totale du cycle d'intégration. Elle indique que l'employé est administrativement prêt à commencer les tâches liées à son poste. Où les obtenir Situé dans le module d’intégration. Cet événement est généralement déduit de l’horodatage d’achèvement du flux de travail d’intégration global ou du moment où la dernière tâche d’intégration obligatoire est marquée comme terminée. Collecte Déduit de l'horodatage de fin de la checklist principale d'intégration de l'employé. Type d’événement inferred
	Promotion approuvée	Indique l'approbation formelle de la promotion d'un employé, qui comprend généralement un changement d'intitulé de poste et souvent de rémunération. Il s'agit d'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 l'évolution professionnelle. Le délai entre l'approbation de la promotion et sa date d'effet peut révéler des goulots d'étranglement administratifs dans le système. Où les obtenir Enregistré comme une action d'emploi spécifique, telle que « Promotion », dans l'historique des données d'emploi de l'employé au sein du module HR Core. L'enregistrement comporte ses propres dates d'approbation et d'effet. Collecte Capturé à partir de la date d'enregistrement d'une action « Promotion » dans l'historique d'emploi de l'employé. Type d’événement explicit
	Changement de poste traité	Représente un changement d'emploi ou de poste qui n'est pas une promotion, comme un transfert latéral ou un changement de service. Cet événement est enregistré lorsque les données d'emploi concernées sont mises à jour dans le système.
Pourquoi c’est important L'analyse des changements de poste fournit des informations sur la mobilité interne, l'affectation des talents et la restructuration de l'organisation. Elle permet de comprendre comment les employés évoluent au sein de l'organisation. Où les 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 telles que « Transfer », « Re-assignment » ou « Position Change », accompagnées de leurs dates d'effet. Collecte Identifié par un code d'action « Transfer » ou similaire dans les données de l'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 rémunération de l'employé, comme ses coordonnées bancaires et ses formulaires fiscaux, ont été saisies et vérifiées. Il s'agit d'une étape essentielle pour garantir que l'employé est payé correctement et dans les délais.
Pourquoi c’est important Cette étape est essentielle pour mesurer la préparation d'un nouvel employé à sa prise de poste. Les retards dans la configuration de la paie peuvent entraîner une insatisfaction de l'employé et des reprises administratives, ce qui en fait un indicateur important de la performance de l'intégration. Où les obtenir Cet événement peut être déduit du module Payroll de UKG Pro. Il peut être déterminé à partir de la date de fin d'une checklist de préparation de la paie ou de la date à laquelle le statut de l'employé passe à « Ready for Payroll ». Collecte Dérivé d'un changement de statut ou de l'horodatage de fin enregistré dans le profil de paie de l'employé. Type d’événement inferred
	Congé d'absence commencé	Marque le début d'un congé d'absence approuvé, pour des raisons médicales ou personnelles par exemple. Cet événement est enregistré lorsque le statut de l'employé passe à un état inactif ou en congé.
Pourquoi c’est important Identifie les périodes d'inactivité dans le cycle de vie d'un employé. Il est essentiel pour calculer précisément l'ancienneté active et comprendre l'impact des congés sur l'évolution professionnelle. Où les obtenir Se trouve dans l'historique des données d'emploi de l'employé au sein du module HR Core. Il correspond à une action telle que « Leave of Absence », avec une date de début d'effet précise. Collecte Capturé à partir de la date d'effet d'une action « Start Leave » dans l'historique d'emploi. Type d’événement explicit
	Départ terminé	Étape indiquant que toutes les tâches obligatoires liées au départ ont été réalisées. Cela comprend notamment la restitution du matériel, le calcul de la paie finale et la révocation des accès aux systèmes.
Pourquoi c’est important Cet événement confirme que toutes les étapes nécessaires ont été suivies pour mettre fin à la relation de travail avec l'employé de manière sécurisée et conforme. Il permet de mesurer la durée du cycle de départ et d'identifier les écarts de conformité. Où les obtenir Cet événement serait déduit de l’horodatage d’achèvement de la liste de contrôle ou du flux de travail de départ global, de manière comparable à l’événement « Employee Onboarded », mais pour le processus de sortie. Collecte Déduit de l'horodatage de fin de la checklist principale de départ de l'employé. Type d’événement inferred
	Entretien de départ réalisé	Cet événement marque la fin de l'entretien de départ avec l'employé qui quitte l'organisation. Il est généralement enregistré comme une tâche terminée dans une checklist de départ.
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 utiles. Il permet de vérifier si cette étape importante est parfois omise dans le processus de départ. Où les obtenir Cet événement se trouve probablement dans le module UKG Pro Onboarding ou HR Help Desk, sous la forme d’une tâche précise dans un flux de travail de départ. Sa capture dépend du marquage manuel de la tâche comme terminée par les ressources humaines. Collecte Enregistré comme une tâche terminée dans la checklist de départ d'un employé. Type d’événement explicit
	Formation attribuée	Enregistre le moment où un cours de formation ou un parcours d'apprentissage précis est attribué à un employé. Cette information est généralement enregistrée dans le module de gestion de la formation du système.
Pourquoi c’est important Cette activité permet de suivre le respect des formations obligatoires et le développement des employés. L'analyse du délai entre l'attribution et la réalisation peut révéler des problèmes d'engagement ou d'efficacité des formations. Où les obtenir Enregistré dans les modules de gestion de la formation ou des talents de UKG Pro. Chaque attribution doit être associée à un enregistrement comprenant une date d'attribution et un Employee ID. Collecte Enregistré lorsqu'un cours ou un programme est attribué au parcours d'apprentissage d'un employé. Type d’événement explicit
	Intégration commencée	Représente le début du processus d’intégration d’un nouvel employé ou du flux de travail correspondant dans UKG Pro. Il s’agit généralement d’un événement déclenché automatiquement ou manuellement, qui attribue une liste de tâches au nouvel employé, à son responsable et aux ressources humaines.
Pourquoi c’est important Le suivi de cette activité permet de mesurer le délai entre la date officielle d'embauche et le début de l'intégration administrative et culturelle. Il constitue le point de départ pour analyser l'efficacité du processus d'intégration et identifier les retards. Où les obtenir Présent dans le module d’intégration de UKG Pro. L’événement peut être déduit de la date de création de la liste de contrôle ou de l’instance du flux de travail d’intégration associée à l’employé. Collecte Déduit de l’horodatage de création du flux de travail d’intégration ou de la liste de tâches de l’employé. Type d’événement inferred
	Manager changé	Cet événement est généré lorsque le champ « Reports To » ou « Manager ID » d'un employé est mis à jour. Il représente une modification de sa ligne hiérarchique directe.
Pourquoi c’est important Les changements de manager peuvent avoir un impact important sur l'engagement et la performance des employés. Le suivi de cet événement permet d'analyser ses effets sur les activités ultérieures, comme les évaluations de performance ou la fidélisation. Où les obtenir Cet événement doit être déduit en suivant dans le temps les changements apportés au champ du manager ou du supérieur hiérarchique dans les données d'emploi de l'employé. Il faut comparer le Manager ID entre deux enregistrements consécutifs pour un même employé. Collecte Déduit de la détection d'un changement dans le champ « Reports To » de l'historique des données d'emploi de l'employé. Type d’événement inferred
	Rémunération modifiée	Cet événement enregistre toute modification du salaire de base, de la structure de bonus ou d'un autre élément de rémunération d'un employé. Il peut faire suite à une promotion, à une augmentation au mérite ou à un ajustement lié au marché.
Pourquoi c’est important Le suivi des changements de rémunération est essentiel pour comprendre l'évolution professionnelle et salariale. Des ajustements fréquents après l'embauche peuvent révéler des erreurs de saisie ou des problèmes liés à la définition du salaire initial. Où les obtenir Se trouve dans l'historique de rémunération de l'employé, au sein du module HR Core ou Payroll. Chaque changement est généralement enregistré avec une date d'effet et un code motif. Collecte Enregistré à partir de la date d'effet d'une nouvelle entrée dans l'historique de rémunération de l'employé. Type d’événement explicit

Recommandé Facultatif

Guides d'extraction

Comment récupérer vos données depuis UKG Pro

Étapes

Prérequis : Vérifiez que Python 3.6 ou une version ultérieure, ainsi que les bibliothèques requests et pandas, sont installés. Vous pouvez les installer avec pip : pip install requests pandas.
Accès à l'API et authentification : Demandez à l'administrateur UKG Pro de créer un compte de service. Vous aurez besoin de l'API Key, du User Name et du Password. Le compte de service doit être autorisé à accéder à tous les endpoints d'API requis, notamment ceux liés aux données du personnel, de la paie, de l'intégration, de la performance et de la formation.
Configurer le script : Ouvrez le script Python fourni dans un éditeur de texte ou un IDE. Repérez la section de configuration située en haut du script et remplacez les valeurs fictives de UKG_BASE_URL, API_KEY, USERNAME, PASSWORD et COMPANY_ID par les identifiants et les informations propres à votre environnement.
Définir la période d'extraction : Dans la section de configuration, définissez les variables START_DATE et END_DATE. Elles déterminent la période pendant laquelle les changements et événements liés aux collaborateurs seront extraits. Il est recommandé de commencer par une période courte, de 3 à 6 mois par exemple, afin de tester le script.
Exécuter le script : Lancez le script depuis la ligne de commande avec python your_script_name.py. Le script s'authentifie, récupère les données depuis les différents endpoints d'API d'UKG Pro pour chaque activité et affiche l'avancement dans la console.
Gérer la limitation du débit de l'API : Le script inclut un appel time.sleep() élémentaire pour respecter les limites de débit de l'API. Si vous rencontrez des erreurs de limitation, HTTP 429, vous devrez peut-être augmenter le délai entre les appels d'API.
Transformer et standardiser les données : Chaque fonction du script récupère les données brutes d'une activité donnée, sélectionne les champs pertinents et les renomme selon le format standard de l'Event Log, notamment EmployeeId, ActivityName et EventTimestamp.
Regrouper les données d'événements : La partie principale du script appelle chaque fonction propre à une activité et ajoute les données obtenues à une liste globale d'événements.
Générer l'Event Log : Après le traitement de toutes les activités, le script regroupe les données dans un DataFrame pandas, les trie par identifiant de collaborateur et par horodatage, puis les enregistre dans un fichier CSV nommé ukg_hire_to_retire_event_log.csv.
Vérifier et importer : Ouvrez le fichier CSV généré pour vérifier que les données sont complètes et correctement formatées. Le fichier peut ensuite être importé dans l'outil de Process Mining.

Configuration

Identifiants d'authentification : Une API Key, un User Name et un Password associés à un compte de service sont nécessaires pour l'authentification auprès de l'API.
URL de base : UKG_BASE_URL correspondant à votre instance UKG Pro, par exemple https://service[##].ultipro.com/api.
Company ID : Le COMPANY_ID unique de votre organisation dans UKG Pro est nécessaire pour de nombreux appels d'API.
Période : Les paramètres START_DATE et END_DATE, au format 'YYYY-MM-DD', définissent la période d'extraction. Pour la première exécution, une période de 3 à 6 mois est recommandée afin de maîtriser le volume de données et de vérifier les résultats.
Versions des endpoints d'API : Le script utilise des versions précises des API REST, par exemple /personnel/v1/. Vérifiez que votre instance UKG Pro prend en charge ces versions.
Dépendances entre modules : L'extraction de certaines activités suppose que votre organisation dispose des licences correspondantes et utilise activement les modules UKG Pro concernés, notamment 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}")

Prêt à commencer ?

Utilisez ce template pour préparer vos données en toute confiance et obtenir des analyses importantes sur vos processus RH. Commencez dès aujourd'hui à optimiser votre parcours Hire to Retire.

Retour au guide d’amélioration Télécharger le modèle

Commencez dès aujourd'hui à optimiser le cycle de vie Hire to Retire de vos collaborateurs !

Réduisez de 30 % la durée de votre cycle Hire to Retire et améliorez l'efficacité de vos équipes RH.

Démarrer l'essai gratuit

Aucune carte bancaire requise, configuration rapide.

Votre template de données Hire to Retire, cycle de vie des collaborateurs

Votre template de données Hire to Retire, cycle de vie des collaborateurs

Hire to Retire, attributs du cycle de vie des collaborateurs

Hire to Retire, activités du cycle de vie des collaborateurs

Guides d'extraction

Extraction par script Python via les API REST d'UKG Pro

Étapes

Configuration

a Exemple de requête python

Prêt à commencer ?

Commencez dès aujourd'hui à optimiser le cycle de vie Hire to Retire de vos collaborateurs !

Nous attachons de l’importance à votre confidentialité