> Amélioration continue des processus > Cycle de vie des employés, de l’embauche à la retraite > UKG Pro > Modèle de données

Votre modèle de données pour le parcours des collaborateurs, de leur arrivée à leur départ

UKG Pro

← Retour au guide d’amélioration

Attributs du parcours des collaborateurs, de leur arrivée à leur départ(21) Activités du parcours des collaborateurs, de leur arrivée à leur départ(15) Guides d’extraction(1)

Votre modèle de données pour le parcours des collaborateurs, de leur arrivée à leur départ

Ce modèle présente les éléments de données essentiels à l’analyse de votre processus, du recrutement au départ des collaborateurs. Il précise les attributs à recueillir, les activités à suivre et les méthodes pratiques pour extraire ces données d’UKG Pro. Utilisez cette ressource pour préparer vos données et démarrer votre analyse de processus dans de bonnes conditions.

Attributs recommandés à recueillir
Activités clés à suivre
Guide d’extraction des données d’UKG Pro

Vous découvrez les journaux d’événements ? Découvrez comment créer un journal d’événements pour le Process Mining.

Télécharger le modèle

Attributs du parcours des collaborateurs, de leur arrivée à leur départ

Voici les champs de données recommandés à inclure dans votre journal d’événements pour analyser en détail le parcours des collaborateurs, de leur arrivée à leur départ.

5 Obligatoire 7 Recommandé 9 Facultatif

	Nom	Description
	Horodatage de l’événement EventTimestamp	Date et heure précises auxquelles un événement du cycle de vie s’est produit.
Description L’horodatage de l’événement situe chaque activité dans le temps et constitue la base du flux du processus. Il indique le moment exact où un événement, comme « Offer Accepted » ou « Promotion Approved », a été enregistré dans le système. Lors de l’analyse, ces horodatages servent à calculer les délais 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 exacts sont indispensables au calcul des indicateurs clés de performance liés au temps et à l’analyse des performances. Pourquoi est-ce important ? Cet attribut est indispensable pour ordonner les événements chronologiquement et calculer toutes les métriques temporelles, notamment les temps de cycle et les durées. Où trouver ces données Provient des champs de date ou d’horodatage associés à des événements précis dans UKG Pro, comme « 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é. Il sert d’identifiant de cas principal pour l’ensemble de son parcours au sein de l’organisation.
Description L’identifiant de l’employé relie tous les événements qui le concernent, de sa candidature initiale à la fin du processus de départ. Il est essentiel pour reconstituer le parcours complet de chaque personne, de bout en bout. Dans une analyse par Process Mining, chaque activité, comme « Employee Hired », « Promotion Approved » ou « Termination Initiated », est associée à cet identifiant unique. Cela permet d’analyser les parcours individuels, de comparer des cohortes selon les attributs des employés et de calculer précisément la durée de chaque cycle de vie. Pourquoi est-ce important ? Cet identifiant de cas essentiel relie tous les événements concernant un employé et permet d’analyser, pour chaque personne, le processus complet allant de l’embauche au départ. Où trouver ces données Champ central de UKG Pro, généralement présent dans les profils 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 désigné par « 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 de cet événement depuis le système source.
Description Cet attribut indique la date et l’heure 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 connaître l’actualité des données analysées. Elle permet aux analystes et aux utilisateurs métier de savoir si la vue du processus est à jour, de gérer les calendriers d’actualisation des données et de vérifier la récence des analyses. Pourquoi est-ce important ? Indique si les données sont à jour, ce qui est essentiel pour se fier à l’analyse et prendre des décisions métier en temps utile. Où trouver ces données 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 de l’étape précise survenue dans le 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 du processus allant de l’embauche au départ. Les événements sont horodatés et ordonnés pour reconstituer le flux du processus, qui est ensuite visualisé et analysé par Process Mining. L’analyse de l’ordre et de la fréquence des activités révèle le déroulement réel du processus. Elle permet de repérer les parcours courants, les écarts par rapport au processus standard et les goulots d’étranglement entre des activités clés comme « Onboarding Initiated » et « Payroll Setup Completed ». Pourquoi est-ce important ? Cet attribut définit les étapes de la cartographie du processus et permet de visualiser et d’analyser le parcours de l’employé. Où trouver ces données Cet attribut 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 le recrutement, l’intégration ou la gestion des performances. Une logique d’association est généralement nécessaire pour produire des noms d’activité normalisés. Exemples Employé embauchéÉvaluation des performances réaliséeDépart initié
	Système source SourceSystem	Indique le système d’où proviennent les données extraites, en l’occurrence UKG Pro.
Description Cet attribut précise l’origine des données de processus. Dans ce contexte, il s’agit principalement de UKG Pro, mais un processus allant de l’embauche au départ peut aussi faire intervenir d’autres systèmes, comme un système de suivi des candidatures (ATS) ou un système de gestion de la formation (LMS). Lors de l’analyse, il permet de distinguer les sources de données lorsque plusieurs systèmes sont concernés et facilite la gouvernance des données et le diagnostic des problèmes. Dans une vue reposant sur une seule source, il précise l’origine des données. Pourquoi est-ce important ? Précise l’origine des données d’événement, un élément important pour la gouvernance des données, l’assurance qualité et la traçabilité. Où trouver ces données 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 d’emploi de la personne au sein de l’organisation.
Description La date d’embauche marque le début de la période d’emploi. Ce champ de date fondamental sert de référence à de nombreux calculs et analyses temporels liés au cycle de vie de l’employé. Cet attribut permet de calculer l’ancienneté, indispensable à l’analyse du « Taux de départ précoce des employés ». Il sert également à l’analyse par cohorte, qui compare les parcours des employés recrutés à différentes périodes. Pourquoi est-ce important ? Sert de référence pour calculer l’ancienneté et est essentiel à l’analyse par cohorte ainsi qu’aux indicateurs clés de performance liés aux départs. Où trouver ces données Ce champ standard obligatoire figure dans le dossier 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 poste JobRequisitionId	Identifiant unique de la demande de poste à l’origine du processus de recrutement.
Description L’identifiant de la demande de poste est la référence unique d’un poste à pourvoir. Il relie toutes les activités des premières étapes 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 l’indicateur « temps de cycle du recrutement », car il marque le véritable début du processus. Il permet de suivre l’ensemble du parcours de recrutement pour un poste donné et d’analyser des métriques comme le « taux de demandes de poste inactives », en repérant celles qui n’avancent pas. Pourquoi est-ce important ? Fournit un point de départ précis pour le processus de recrutement et permet de mesurer correctement les temps de cycle d’embauche et l’efficacité des demandes de poste. Où trouver ces données Dans le module de recrutement de UKG Pro ou dans le système de suivi des candidatures (ATS) connecté. Exemples REQ-2023-015REQ-2024-112REQ-2023-504
	Intitulé du poste JobTitle	Intitulé officiel du poste de l’employé, par exemple « Ingénieur logiciel » ou « Responsable commercial ».
Description L’intitulé du poste décrit le rôle ou la fonction de l’employé au sein de l’organisation. Cet attribut est une dimension importante pour analyser les différences entre les processus selon les fonctions et les niveaux d’ancienneté. L’analyse de cet attribut permet de comparer les délais d’intégration selon les fonctions, d’évaluer la rapidité des promotions ou de repérer les intitulés de poste associés à un taux élevé de départs précoces. Ces résultats aident à adapter les processus RH et les programmes d’accompagnement aux besoins des différents groupes d’employés. Pourquoi est-ce important ? Permet d’analyser les processus du cycle de vie selon les fonctions et les niveaux d’ancienneté. Où trouver ces données Ce champ standard est associé au poste ou au dossier d’emploi de l’employé dans le module Core HR de UKG Pro. Exemples Ingénieur logiciel IIChef de 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 l’attribution des formations. L’analyse par responsable permet de comprendre les différences d’exécution entre les équipes et d’évaluer l’efficacité managériale. Par exemple, le Dashboard « Analyse de l’impact d’un changement de responsable » s’appuie sur cet attribut pour mesurer les effets d’un changement de responsable sur les activités suivantes. Il est également essentiel pour l’indicateur clé de performance « Délai avant la reprise du suivi managérial ». Pourquoi est-ce important ? Permet d’analyser la performance des processus à l’échelle des équipes et d’évaluer l’influence des responsables sur les événements du cycle de vie des employés. Où trouver ces données Ces informations figurent dans les données de rattachement 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 « Ventes », « Ingénierie » ou « Finance ». Il s’agit d’un axe organisationnel important pour segmenter et comparer les performances du processus. L’analyse par service permet de comparer le déroulement du processus entre différentes unités opérationnelles. Vous pouvez, par exemple, vérifier si le « temps de cycle du recrutement » est plus long dans les services techniques ou si le « respect des délais d’évaluation des performances » varie fortement entre les ventes et les opérations. Ces comparaisons permettent de cibler les améliorations. Pourquoi est-ce important ? Permet de filtrer et de segmenter le processus selon la structure organisationnelle afin de comparer les résultats et de repérer les différences entre services. Où trouver ces données Champ standard de l’enregistrement d’emploi ou de poste de l’employé dans le module Core HR de UKG Pro. Exemples IngénierieVentesRessources humaines
	Statut d’emploi EmploymentStatus	Statut d’emploi actuel ou passé de l’employé, par exemple « Actif », « Fin d’emploi » ou « En congé ».
Description Cet attribut indique le statut officiel de l’employé dans l’entreprise à un moment donné. Il permet de comprendre la situation globale des effectifs et de limiter l’analyse à des populations précises. L’analyse des changements de statut d’emploi permet de modéliser correctement le processus, par exemple en distinguant un congé temporaire d’une fin d’emploi définitive. Cet attribut est indispensable pour calculer les taux de départ et comprendre les résultats des différents parcours du cycle de vie. Pourquoi est-ce important ? Précise la situation de l’employé et permet d’analyser correctement les départs et de segmenter les effectifs. Où trouver ces données Champ central de l’enregistrement de référence de l’employé dans le module Core HR de UKG Pro. Exemples ActifFin d’emploiCongé
	Utilisateur à l’origine de l’action ActioningUser	Nom ou identifiant de l’utilisateur, généralement un représentant des RH ou un responsable, qui a effectué l’activité dans UKG Pro.
Description Cet attribut identifie la personne responsable d’une étape précise du processus, par exemple le recruteur qui a transmis une offre ou le responsable qui a approuvé une promotion. Il relie les activités du processus aux personnes qui les réalisent. Lors de l’analyse, cet attribut est très utile pour comprendre la répartition de la charge de travail, repérer les besoins de formation et comparer les performances des utilisateurs. Il peut, par exemple, aider à déterminer si les erreurs de saisie après l’étape « Payroll Setup Completed » sont concentrées chez certains utilisateurs, ce qui contribue au calcul de l’indicateur « Taux de reprises des données après l’intégration ». Pourquoi est-ce important ? Relie les activités du processus à des utilisateurs précis et permet d’analyser la charge de travail, de comparer les performances et d’examiner les reprises ou les erreurs. Où trouver ces données Généralement présent dans les journaux 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 d’emploi de l’employé.
Description La date de fin d’emploi marque la fin de la période d’emploi et du parcours de l’employé au sein de l’organisation. Cet attribut est nécessaire pour calculer l’ancienneté totale et constitue un élément clé de l’analyse des départs. La période entre la date d’embauche et la date de fin d’emploi sert de base au Dashboard « Analyse des départs en début de carrière » et aux indicateurs clés de performance associés. Pourquoi est-ce important ? Marque la fin du parcours de l’employé, permet de calculer son ancienneté totale et contribue à toutes les analyses liées aux départs. Où trouver ces données Ce champ standard du dossier principal de l’employé dans UKG Pro est renseigné à la fin de la procédure de départ. Exemples 2023-11-302024-02-152022-12-31
	Départ précoce IsEarlyChurn	Indicateur booléen précisant si l’employé a quitté l’organisation avant la fin d’une période d’ancienneté 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. L’entreprise définit généralement le seuil correspondant à un départ précoce, par exemple au cours de la première année. Cet indicateur simplifie l’analyse du Dashboard « Analyse des départs en début de carrière » et de l’indicateur clé de performance « Taux de départ précoce des employés ». Il permet de filtrer et de segmenter rapidement ce groupe afin d’étudier ses caractéristiques et ses parcours, et de repérer d’éventuels problèmes de recrutement ou d’intégration. Pourquoi est-ce important ? Contribue directement à l’analyse des départs précoces en signalant les cas à risque et en aidant à en déterminer les causes. Où trouver ces données 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
	Échelon salarial SalaryGrade	Échelon ou fourchette de rémunération associé au poste de l’employé.
Description L’échelon salarial indique le niveau de rémunération associé à un poste. Cet attribut est important pour analyser les activités et les tendances liées à la rémunération. Il est utile, par exemple, pour analyser les événements « Modification de la rémunération » et suivre l’indicateur clé de performance « Taux de reprise des données après l’intégration » si les échelons salariaux font l’objet de corrections fréquentes. Il permet aussi de comparer les temps de cycle des promotions et les taux de départ selon le niveau de rémunération. Pourquoi est-ce important ? Apporte un contexte aux activités liées à la rémunération et permet de segmenter le processus selon le niveau de salaire. Où trouver ces données Disponible dans le profil de rémunération ou le profil professionnel de l’employé, dans le module Core HR de UKG Pro. Exemples IC3M2D1
	Évaluation de performance PerformanceRating	Évaluation attribuée à un employé lors d’un cycle d’évaluation de performance.
Description L’évaluation de performance est le résultat de l’activité « Évaluation de performance réalisée ». Elle est généralement exprimée sur une échelle (par exemple, de 1 à 5) ou à l’aide de libellés descriptifs (par exemple, « Dépasse les attentes »). Elle quantifie l’appréciation de la performance d’un employé. Cet attribut permet de mettre en relation les événements du processus et les résultats de performance. L’analyse peut, par exemple, déterminer si les employés les plus performants sont promus plus rapidement ou s’il existe un lien entre les évaluations de performance et les départs. Il est au cœur du Dashboard « Conformité du cycle d’évaluation de performance ». Pourquoi est-ce important ? Relie les événements du processus aux résultats de performance afin d’analyser l’efficacité de la gestion des talents et son effet sur la fidélisation. Où trouver ces données Disponible dans le module Performance Management de UKG Pro et associé à des cycles d’évaluation précis. Exemples Dépasse les attentesRépond aux attentesDoit s’améliorer5
	Heure de fin de l’événement EventEndTime	Horodatage indiquant 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 quand l’activité s’est achevée. Elle se distingue de l’horodatage de l’événement (StartTime), qui marque le début. La présence des heures de début et de fin permet de calculer précisément la durée de traitement de chaque activité, comme « Vérification des antécédents » ou « Tâche d’intégration ». Vous pouvez ainsi analyser plus finement le temps consacré à chaque étape du processus. Pourquoi est-ce important ? Permet de calculer précisément la durée de traitement de chaque activité et de repérer les étapes les plus longues du processus. Où trouver ces données Provient des champs de date d’achèvement de UKG Pro. Il faut souvent 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ù travaille l’employé.
Description Cet attribut indique le lieu de travail principal de l’employé, qui peut correspondre à une ville, un pays ou un bâtiment précis. Il constitue une dimension importante pour l’analyse géographique des processus RH. L’analyse de la performance des processus par lieu peut révéler des différences régionales dans l’efficacité du recrutement, les pratiques d’intégration ou les taux de départ. Vous pouvez, par exemple, comparer le « Temps de cycle du recrutement » des bureaux de « New York » et de « Londres » afin de repérer les bonnes pratiques ou les goulots d’étranglement locaux. Pourquoi est-ce important ? Permet de segmenter le processus par zone géographique et de mettre en évidence les différences régionales de performance et de conformité. Où trouver ces données Ces informations figurent dans les 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 de départ documenté de l’employé, par exemple « Départ volontaire : démission » ou « Départ involontaire : performance ».
Description Cet attribut indique le motif de fin d’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 est essentiel pour analyser la fidélisation et les départs. En répartissant les employés ayant quitté l’organisation selon leur motif de départ, celle-ci peut mieux comprendre les causes profondes de l’attrition. Par exemple, l’analyse du « Taux de départ précoce des employés » par motif permet de distinguer les erreurs de recrutement des offres concurrentes. Pourquoi est-ce important ? Aide à comprendre les causes des départs et à définir des stratégies de fidélisation ciblées. Où trouver ces données Ce champ est généralement renseigné lors de la procédure de départ dans le module Core HR de UKG Pro. Exemples Départ volontaire : autre opportunitéDépart involontaire : performanceDépart à la retraite
	Motif du changement de fonction RoleChangeReason	Motif du changement de fonction d’un employé, par exemple « Promotion », « Mutation latérale » ou « Réorganisation ».
Description Cet attribut apporte un contexte aux événements de mobilité interne. Il indique pourquoi la fonction ou le poste d’un employé a changé au sein de l’organisation. Il est essentiel au Dashboard et à l’indicateur clé de performance « Temps de cycle de la mobilité interne », car il permet de distinguer les promotions des autres types de mutation. L’analyse des processus par motif peut révéler si les promotions prennent plus de temps que les mutations latérales et aider à améliorer les parcours d’évolution professionnelle. Pourquoi est-ce important ? Précise le contexte des mobilités internes et permet d’analyser plus finement les processus, notamment en distinguant les promotions des mutations latérales. Où trouver ces données Ces informations sont généralement enregistrées lors d’une modification de poste ou d’une mutation dans le module Core HR de UKG Pro. Exemples PromotionMutation latéraleRéorganisation
	Nom de la formation TrainingName	Nom ou intitulé de la formation attribuée à l’employé.
Description Cet attribut désigne 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 à une fonction. Il est essentiel au Dashboard « Attribution et suivi des formations » et à l’indicateur clé de performance « Taux d’achèvement des formations ». 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 des différents cours. Pourquoi est-ce important ? Permet de suivre et d’analyser des programmes de formation précis afin d’évaluer la conformité et l’efficacité du développement des compétences. Où trouver ces données Provient du module Learning de 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é

Obligatoire Recommandé Facultatif

Activités du parcours des collaborateurs, de leur arrivée à leur départ

Voici les principales étapes et les jalons à consigner dans votre journal d’événements pour découvrir et optimiser vos processus avec précision.

6 Recommandé 9 Facultatif

	Activité	Description
	Départ initié	Marque le début du processus de départ et est enregistré lorsqu’une date de fin d’emploi future est saisie dans le système. Cet événement déclenche les listes de contrôle et les flux de travail liés au départ.
Pourquoi est-ce important ? Cette étape importante marque le début du 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ù trouver ces données 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. Cela peut également correspondre au début d’un flux de travail de départ dans un module dédié. Données à recueillir Enregistré lorsqu’une transaction de fin d’emploi assortie d’une date future est soumise. Type d’événement explicit
	Employé embauché	Marque la création officielle du dossier de l’employé dans UKG Pro et l’attribution formelle d’un identifiant d’employé. Cet événement est généralement enregistré lorsqu’un administrateur RH finalise le recrutement d’un candidat et que celui-ci devient un employé actif dans le système.
Pourquoi est-ce important ? Il s’agit de l’événement de début de référence pour l’analyse du processus d’embauche au départ. Il sert de point de départ pour mesurer le délai avant la pleine productivité, l’efficacité de l’intégration et l’ancienneté globale des employés. Où trouver ces données Cet événement est probablement enregistré dans le module HR Core ou Administration du personnel. Il peut être repéré à partir de la date de création du dossier d’emploi principal de l’employé ou d’un enregistrement d’action « Hire » dans l’historique de ses données d’emploi. Données à recueillir À partir de la date d’effet de l’action « Hire » dans la table de l’historique d’emploi de l’employé. Type d’événement explicit
	Évaluation des performances réalisée	Marque la fin d’un cycle formel d’évaluation des performances d’un employé. Cet événement est enregistré lorsque le responsable ou les RH finalisent et soumettent le formulaire d’évaluation.
Pourquoi est-ce 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 permet d’évaluer la conformité de la gestion des performances et son effet sur l’évolution de carrière. Où trouver ces données Dans le module de gestion des performances de UKG Pro. L’événement peut être repéré à partir de la date d’achèvement du formulaire d’évaluation ou du passage du statut du cycle d’évaluation à « Completed ». Données à recueillir À partir de l’horodatage d’achèvement de l’instance du flux de travail d’évaluation des performances. Type d’événement explicit
	Fin d’emploi de l’employé	Dernier événement du cycle de vie de l’employé, il marque la fin officielle de son emploi. À la date d’effet de la fin d’emploi, le dossier de l’employé devient inactif dans le système.
Pourquoi est-ce 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ù trouver ces données 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. Données à recueillir À partir de la date d’effet de l’action « Termination » dans l’historique d’emploi de l’employé. Type d’événement explicit
	Intégration de l’employé terminée	Étape clé marquant la fin du processus ou de la liste de contrôle initiale d’intégration. Cela signifie généralement que tous les documents requis pour la nouvelle recrue, les demandes d’accès aux systèmes et les premières tâches administratives sont terminés.
Pourquoi est-ce important ? Marque la fin de la configuration administrative initiale et permet d’analyser le temps de cycle total de l’intégration. À ce stade, l’employé est prêt, sur le plan administratif, à commencer les tâches propres à son poste. Où trouver ces données 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 obligatoire est marquée comme terminée. Données à recueillir Déduit de l’horodatage d’achèvement de la liste de contrôle principale d’intégration de l’employé. Type d’événement inferred
	Promotion approuvée	Indique l’approbation officielle de la promotion d’un employé, qui s’accompagne généralement d’un changement de titre de poste et souvent de rémunération. Cet événement distinct précède la date d’effet du changement.
Pourquoi est-ce important ? Cette activité est essentielle pour analyser la mobilité interne et l’évolution de carrière. Le délai entre l’approbation de la promotion et sa date d’effet peut révéler des goulots d’étranglement administratifs. Où trouver ces données Enregistrée comme une action d’emploi précise, par exemple « 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. Données à recueillir À 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é	Correspond à un changement de poste ou de fonction qui ne constitue pas une promotion, par exemple une mutation latérale ou un changement de service. L’événement est enregistré lorsque les données d’emploi concernées sont mises à jour dans le système.
Pourquoi est-ce important ? L’analyse des changements de poste renseigne sur la mobilité interne, l’affectation des talents et les réorganisations. Elle permet de comprendre comment les employés évoluent au sein de l’organisation. Où trouver ces données À partir de l’historique des données d’emploi de l’employé dans le module HR Core. L’événement peut être repéré grâce à des actions telles que « Transfer », « Re-assignment » ou « Position Change », ainsi qu’à leurs dates d’effet. Données à recueillir Repéré grâce au code d’action « Transfer » ou à un code similaire dans l’historique d’emploi de l’employé. Type d’événement explicit
	Changement de responsable	Cet événement est généré lorsque le champ « Reports To » ou « Manager ID » d’un employé est mis à jour. Il correspond à un changement de supérieur hiérarchique direct.
Pourquoi est-ce important ? Un changement de responsable peut avoir un effet important sur l’engagement et les performances d’un employé. Le suivi de cet événement permet d’en analyser les effets sur les activités ultérieures, comme les évaluations de performance ou la fidélisation. Où trouver ces données Cet événement doit être déduit du suivi des changements du champ responsable ou supérieur hiérarchique dans les données d’emploi de l’employé au fil du temps. Il faut comparer l’identifiant du responsable entre deux enregistrements consécutifs du même employé. Données à recueillir 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
	Configuration de la paie terminée	Indique que toutes les informations nécessaires au traitement de la paie de l’employé, comme ses coordonnées bancaires et ses formulaires fiscaux, ont été saisies et vérifiées. Cette étape est essentielle pour garantir que l’employé est payé correctement et dans les délais.
Pourquoi est-ce important ? Cette étape est importante pour évaluer si une nouvelle recrue est prête à commencer. Un retard dans la configuration de la paie peut mécontenter l’employé et entraîner des reprises administratives. C’est donc un indicateur clé du processus d’intégration. Où trouver ces données Cet événement peut être déduit du module de paie de UKG Pro. Il peut correspondre à la date d’achèvement d’une liste de contrôle de préparation de la paie ou à la date à laquelle le statut de l’employé passe à « Ready for Payroll ». Données à recueillir Déduit d’un changement de statut ou de l’horodatage d’achèvement du profil de paie de l’employé. Type d’événement inferred
	Début d’un congé	Marque le début d’un congé approuvé, par exemple pour des raisons médicales ou personnelles. L’événement est enregistré lorsque le statut de l’employé passe à un état inactif ou en congé.
Pourquoi est-ce important ? Permet de repérer les périodes d’inactivité dans le cycle de vie d’un employé. Cet événement est essentiel pour calculer précisément l’ancienneté active et comprendre l’effet des congés sur l’évolution de carrière. Où trouver ces données Dans l’historique des données d’emploi de l’employé, au sein du module HR Core. Il correspond à une action d’emploi telle que « Leave of Absence », assortie d’une date de début d’effet précise. Données à recueillir À partir de la date d’effet d’une action « Start Leave » dans l’historique d’emploi. Type d’événement explicit
	Début de l’intégration	Marque le début du processus ou du flux de travail d’intégration d’une nouvelle recrue dans UKG Pro. Cet événement est généralement déclenché automatiquement ou manuellement et attribue une liste de tâches au nouvel employé, à son responsable et aux RH.
Pourquoi est-ce 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. C’est le point de départ pour analyser l’efficacité du processus d’intégration et repérer les retards. Où trouver ces données 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 de flux de travail associée à l’employé. Données à recueillir Déduit de l’horodatage de création du flux de travail ou de la liste de tâches d’intégration de l’employé. Type d’événement inferred
	Départ de l’employé terminé	Étape marquant la fin de toutes les tâches obligatoires liées au départ. Celles-ci comprennent notamment la restitution du matériel, le calcul de la paie finale et la révocation des accès aux systèmes.
Pourquoi est-ce important ? Cet événement confirme que toutes les étapes nécessaires ont été suivies pour mettre fin à l’emploi de manière sécurisée et conforme. Il permet de mesurer le temps de cycle du processus de départ et de repérer les lacunes en matière de conformité. Où trouver ces données Cet événement peut être déduit de l’horodatage d’achèvement de la liste de contrôle ou du flux de travail global de départ, comme pour l’événement « Employee Onboarded », mais pour le processus de départ. Données à recueillir Déduit de l’horodatage d’achèvement de la liste de contrôle 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 avec l’employé sur le départ. Il est généralement enregistré comme une tâche terminée dans une liste de contrôle de départ.
Pourquoi est-ce important ? Le suivi des entretiens de départ est important pour garantir la conformité RH et recueillir des retours utiles. Il permet de repérer si cette étape importante est omise dans le processus de départ. Où trouver ces données Cet événement se trouve probablement dans le module d’intégration ou HR Help Desk de UKG Pro, sous la forme d’une tâche précise dans un flux de travail de départ. Il n’est enregistré que si les RH marquent manuellement la tâche comme terminée. Données à recueillir Enregistré comme une tâche terminée dans la liste de contrôle de départ de l’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 consignée dans le module de gestion de la formation du système.
Pourquoi est-ce 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 fin de la formation peut révéler des problèmes d’engagement ou d’efficacité. Où trouver ces données Enregistrée dans les modules de gestion de la formation ou des talents de UKG Pro. Chaque attribution doit être associée à un enregistrement indiquant la date d’attribution et l’identifiant de l’employé. Données à recueillir Enregistrée lorsqu’un cours ou un programme est ajouté au plan d’apprentissage d’un employé. Type d’événement explicit
	Rémunération modifiée	Cet événement enregistre toute modification du salaire de base, de la structure des primes ou d’autres éléments de rémunération d’un employé. Il peut s’agir d’une promotion, d’une augmentation au mérite ou d’un ajustement au marché.
Pourquoi est-ce important ? Le suivi des changements de rémunération est essentiel pour comprendre l’évolution de carrière et de salaire. Des ajustements fréquents après l’embauche peuvent signaler des erreurs de saisie ou des problèmes lors de la détermination du salaire initial. Où trouver ces données Dans la table de l’historique de rémunération de l’employé, au sein du module HR Core ou de paie. Chaque changement est généralement enregistré avec une date d’effet et un code de motif. Données à recueillir À 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 extraire vos données d’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 à votre administrateur UKG Pro de créer un compte de service. Vous aurez besoin de la clé API, du nom d’utilisateur et du mot de passe. Ce compte doit disposer des autorisations nécessaires pour accéder à tous les points de terminaison API requis, notamment ceux concernant le personnel, la paie, l’intégration, les performances et la formation.
Configurez le script : Ouvrez le script Python fourni dans un éditeur de texte ou un IDE. Dans la section de configuration en haut du script, remplacez les valeurs fictives de UKG_BASE_URL, API_KEY, USERNAME, PASSWORD et COMPANY_ID par vos identifiants et les informations propres à votre environnement.
Définissez la plage de dates d’extraction : Dans la section de configuration, renseignez les variables START_DATE et END_DATE. Elles déterminent la période couverte par l’extraction des changements et événements concernant les collaborateurs. Pour tester le script, il est recommandé de commencer par une période plus courte, de 3 à 6 mois par exemple.
Exécutez le script : Lancez le script depuis la ligne de commande avec python your_script_name.py. Il s’authentifiera, récupérera les données auprès des différents points de terminaison API d’UKG Pro pour chaque activité et affichera sa progression dans la console.
Gérez les limites de débit de l’API : Le script inclut un appel simple à time.sleep() pour respecter les limites de débit de l’API. Si vous rencontrez des erreurs de limitation (HTTP 429), augmentez éventuellement le délai entre les appels API.
Transformez et normalisez les données : Chaque fonction du script récupère les données brutes d’une activité précise, sélectionne les champs pertinents et les renomme selon le format standard du journal d’événements (EmployeeId, ActivityName, EventTimestamp, etc.).
Regroupez les données d’événements : La partie principale du script appelle chaque fonction associée à une activité et ajoute les données obtenues à une liste unique d’événements.
Générez le journal d’événements : Une fois toutes les activités traitées, le script regroupe les données dans un DataFrame pandas, les trie par identifiant de collaborateur et horodatage, puis les enregistre dans un fichier CSV nommé ukg_hire_to_retire_event_log.csv.
Vérifiez et importez le fichier : Ouvrez le fichier CSV généré pour vérifier que les données sont complètes et correctement formatées. Vous pouvez ensuite l’importer dans l’outil de Process Mining.

Configuration

Identifiants d’authentification : Une clé API, un nom d’utilisateur et un mot de passe associés à un compte de service 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).
Identifiant de l’entreprise : Le COMPANY_ID unique de votre organisation dans UKG Pro est nécessaire pour de nombreux appels API.
Plage de dates : 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 points de terminaison 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 aux modules : L’extraction de certaines activités nécessite que votre organisation ait souscrit aux modules UKG Pro correspondants et les utilise activement, notamment Onboarding, Learning et Performance Management. Si un module n’est pas utilisé, l’activité correspondante ne sera pas extraite.

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 modèle pour préparer vos données en toute confiance et mieux comprendre vos processus RH. Commencez dès aujourd’hui à optimiser le parcours des collaborateurs, de leur arrivée à leur départ.

Retour au guide d’amélioration

Télécharger le modèle

Optimisez dès aujourd’hui le parcours des collaborateurs, de leur arrivée à leur départ !

Réduisez de 30 % le temps de cycle du parcours des collaborateurs et améliorez l’efficacité des RH.

Démarrez l’essai gratuit

Aucune carte bancaire requise. Configuration rapide.

Votre modèle de données pour le parcours des collaborateurs, de leur arrivée à leur départ

Votre modèle de données pour le parcours des collaborateurs, de leur arrivée à leur départ

Attributs du parcours des collaborateurs, de leur arrivée à leur départ

Activités du parcours des collaborateurs, de leur arrivée à leur départ

Guides d’extraction

Extraction avec un script Python via les API REST d’UKG Pro

Étapes

Configuration

Exemple de requête python

Prêt à commencer ?

Optimisez dès aujourd’hui le parcours des collaborateurs, de leur arrivée à leur départ !

Prêt à commencer ?

Optimisez dès aujourd’hui le parcours des collaborateurs, de leur arrivée à leur départ !