> Amélioration continue des processus > Intégration des employés > BambooHR > Modèle de données

Votre modèle de données d’intégration des employés

BambooHR

Attributs de l’intégration des employés (19) Activités d’intégration des employés (15) Guides d’extraction (2)

Votre modèle de données d’intégration des employés

Ce modèle fournit toutes les indications nécessaires pour recueillir les données utiles à une analyse détaillée de votre processus d’intégration des employés. Il précise les attributs de données essentiels à collecter, les activités importantes à suivre et explique clairement comment extraire efficacement ces données de BambooHR. Utilisez cette ressource pour constituer un journal d’événements fiable et obtenir une vision précise du déroulement de votre intégration.

Attributs recommandés à collecter
Activités clés à suivre pour la découverte du processus
Guide d’extraction étape par étape pour BambooHR

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

Attributs de l’intégration des employés

Voici les champs de données essentiels à inclure dans votre journal d’événements pour permettre une analyse complète de votre processus d’intégration des employés.

5 Obligatoire 6 Recommandé 8 Facultatif

	Nom	Description
	Dossier d’intégration OnboardingCase	Identifiant unique regroupant toutes les activités d’intégration d’un même nouvel employé.
Description L’Onboarding Case sert d’identifiant central pour l’ensemble du processus d’intégration de l’employé. Il relie tous les événements associés, de l’acceptation initiale de l’offre à la réalisation de l’entretien de suivi à 30 jours, au sein d’un parcours unique et cohérent. Dans une analyse de Process Mining, cet Attribut est fondamental pour reconstituer le déroulement de bout en bout du processus pour chaque nouvelle recrue. Il permet de visualiser les cartes de processus, de calculer des KPI au niveau du cas, comme la durée totale du cycle, et d’analyser les différentes variantes du processus. Sans identifiant de cas cohérent, il serait impossible de suivre le parcours d’un même employé à travers les différentes étapes de l’intégration. Pourquoi c’est important Il s’agit de la clé primaire qui relie tous les événements associés et permet d’analyser le parcours d’intégration complet de chaque nouvelle recrue. Où les obtenir Il s’agit d’un identifiant conceptuel, souvent obtenu en combinant l’identifiant de l’employé avec l’instance ou la date d’embauche, car BambooHR ne dispose pas nécessairement d’un « Onboarding Case ID » explicite. Il doit être construit lors de la préparation des données. Exemples ONB-00123ONB-00124ONB-00125
	Horodatage de l’événement EventTimestamp	Date et heure précises auxquelles une activité d’intégration a été achevée ou s’est produite.
Description L’horodatage de l’événement indique le moment exact où une activité donnée a eu lieu. Ces données temporelles sont essentielles pour classer les événements par ordre chronologique et calculer les durées entre les différentes étapes du processus. Cet attribut constitue le fondement de toutes les analyses temporelles en Process Mining. Il sert à calculer les temps de cycle, les temps d’attente et la durée globale du processus. L’analyse des horodatages permet aux organisations d’identifier les étapes les plus longues, de mesurer la performance par rapport aux accords de niveau de service et de repérer les retards qui nuisent à l’expérience des nouvelles recrues. Pourquoi c’est important Cet horodatage fournit l’ordre chronologique des événements et est essentiel pour toutes les analyses de performance et de durée, notamment le calcul des temps de cycle et l’identification des retards. Où les obtenir Extrait de différents champs de date de BambooHR correspondant à l’achèvement des activités, tels que « Offer Acceptance Date », « Background Check Completion Date » ou les journaux système enregistrant les changements de statut. Exemples 2023-10-01T10:00:00Z2023-10-05T14:30:00Z2023-10-15T09:00:00Z
	Nom de l’activité ActivityName	Nom de la tâche ou du jalon précis survenu au cours du processus d’intégration.
Description Cet attribut enregistre le nom de chaque événement ou étape distincte du parcours d’intégration des employés. Il peut s’agir, par exemple, de « Offer Accepted », « Background Check Completed » et « First Day Orientation Completed ». Dans l’analyse, le nom de l’activité sert à construire la carte du processus, qui montre la séquence des événements et le déroulement du travail. Il est essentiel pour identifier les goulots d’étranglement, analyser la fréquence des activités et comprendre les différents parcours, ou variantes, suivis par les nouvelles recrues. En examinant la séquence de ces activités, les analystes peuvent repérer les écarts par rapport au processus standard et les possibilités d’amélioration. Pourquoi c’est important Il définit les étapes du processus, forme l’ossature de la carte du processus et permet d’analyser le flux de travail, les goulots d’étranglement et les variations. Où les obtenir Dérivé des changements de statut, de l’achèvement des tâches ou de champs de date précis dans les listes de contrôle d’intégration ou les flux de travail de recrutement de BambooHR. Exemples Offre acceptéeDossier de formalités envoyéDemande de mise à disposition informatique envoyéeEntretien de suivi à 30 jours terminé
	Dernière mise à jour des données LastDataUpdate	Horodatage indiquant la date de la dernière actualisation des données depuis le système source.
Description Cet attribut enregistre la date et l’heure de l’extraction ou de la mise à jour la plus récente des données. Il permet aux utilisateurs de comprendre clairement leur fraîcheur et leur pertinence. Dans toute analyse, en particulier lorsqu’il s’agit de suivre des processus en cours, il est essentiel de connaître l’actualité des données. Cet horodatage aide les utilisateurs à se fier aux données consultées et à déterminer si elles reflètent l’état actuel des opérations ou une situation antérieure. Il est indispensable aux Dashboards qui suivent les dossiers d’intégration actifs. Pourquoi c’est important Informe les utilisateurs sur l’actualité des données et leur permet de comprendre dans quelle mesure l’analyse du processus est à jour. Où les obtenir Cet horodatage est généré et ajouté au jeu de données lors de l’extraction et du chargement des données. Exemples 2024-05-21T08:00:00Z
	Système source SourceSystem	Indique le système de référence depuis lequel ces données ont été extraites.
Description Cet attribut précise l’origine des données, qui est ici BambooHR. Il contribue à la gouvernance des données et fournit un contexte utile, notamment lorsque des données provenant de plusieurs systèmes sont combinées. Même si cela peut sembler évident, indiquer explicitement le système source est important pour assurer la traçabilité des données et faciliter le dépannage. Dans les environnements analytiques de grande taille, cela permet aux utilisateurs de comprendre le contexte des données et de remonter jusqu’à leur origine en cas de question ou d’incohérence. Pourquoi c’est important Fournit un contexte important sur l’origine des données, indispensable à la gouvernance et à la validation des données, ainsi qu’à l’intégration de données provenant de plusieurs sources. Où les obtenir Il s’agit d’une valeur statique, « BambooHR », ajoutée lors de la transformation des données. Exemples BambooHR
	Horodatage de fin EndTimestamp	Horodatage d’achèvement d’une activité, lorsqu’elle possède une durée mesurable.
Description Alors que StartTime (EventTimestamp) indique le moment où une activité se produit, EndTimestamp indique son achèvement. Cette distinction est particulièrement utile pour les activités qui ne sont pas instantanées, comme « Background Check », qui comporte un état de lancement et un état d’achèvement. L’utilisation d’un horodatage de début et d’un horodatage de fin permet de calculer plus précisément la durée de traitement de chaque activité. Elle aide à distinguer le temps consacré à l’exécution effective d’une tâche du temps d’attente avant le début de l’étape suivante. Ce niveau de détail est essentiel pour réaliser une analyse approfondie des goulots d’étranglement. Pourquoi c’est important Permet de calculer précisément le temps de traitement des activités et de distinguer le temps de travail effectif du temps d’attente. Où les obtenir Dérivé des horodatages d’activités successives. Par exemple, l’EndTimestamp de « Background Check Initiated » correspondrait à l’horodatage de « Background Check Completed ». Exemples 2023-10-02T11:00:00Z2023-10-06T16:45:00Z2023-10-16T10:00:00Z
	Identifiant de l’employé EmployeeId	Identifiant unique attribué à chaque employé dans BambooHR.
Description L’identifiant de l’employé est la clé unique qui identifie un employé donné dans le système RH. Il reste constant pendant toute la durée de sa relation avec l’entreprise. Même si l’Onboarding Case constitue l’identifiant principal du processus, l’identifiant de l’employé est essentiel pour relier les données d’intégration à la fiche de référence de l’employé. Il permet d’enrichir l’analyse avec d’autres attributs, comme l’intitulé du poste ou le service, et de mieux comprendre comment l’expérience d’intégration varie selon les profils d’employés. Pourquoi c’est important Identifie de manière unique la nouvelle recrue, permet d’enrichir les données avec d’autres informations sur l’employé et de suivre l’ensemble de son parcours au-delà de l’intégration. Où les obtenir Disponible comme champ standard dans la fiche de l’employé de BambooHR. Exemples 601856018660187
	Intitulé du poste JobTitle	Fonction ou poste précis de la nouvelle recrue.
Description Cet attribut contient l’intitulé officiel du poste du nouvel employé, par exemple « Software Engineer », « Account Executive » ou « Product Manager ». Il fournit une autre dimension importante pour analyser le processus d’intégration. Les différents postes peuvent nécessiter des modalités d’intégration spécifiques, comme une formation spécialisée ou la mise à disposition d’équipements particuliers. L’analyse par intitulé de poste peut révéler si certaines fonctions connaissent des retards plus importants ou suivent des parcours différents. Elle aide ainsi à adapter et à optimiser l’expérience d’intégration en fonction des besoins propres à chaque poste. Pourquoi c’est important Permet d’analyser le processus d’intégration selon la complexité et les exigences du poste, afin d’adapter l’expérience aux différentes fonctions. Où les obtenir Champ standard associé aux informations professionnelles de l’employé dans BambooHR. Exemples Ingénieur logiciel seniorCoordinateur marketingDirecteur régional des ventes
	Lieu Location	Lieu de travail ou bureau principal de la nouvelle recrue.
Description Cet attribut identifie le bureau ou la zone géographique où le nouvel employé sera affecté. Il peut s’agir d’une ville, d’un immeuble de bureaux ou de la mention « Remote ». L’analyse par lieu est importante pour repérer les différences régionales dans le processus d’intégration. Par exemple, les délais de livraison du matériel peuvent varier sensiblement selon les lieux, ou certains bureaux peuvent appliquer leurs propres procédures d’accueil. Cette analyse aide à standardiser le processus lorsque cela est possible, tout en tenant compte des variations locales nécessaires. Pourquoi c’est important Aide à repérer les variations régionales de la performance du processus, comme les retards de livraison du matériel ou les différences entre les procédures d’accueil locales. Où les obtenir Champ standard du profil de l’employé dans BambooHR, généralement associé aux informations relatives à l’emploi ou au lieu de travail. Exemples Bureau de New YorkLondres, Royaume-UniÀ distance (États-Unis)Siège de San Francisco
	Responsable du recrutement HiringManager	Nom du responsable auquel le nouvel employé est rattaché.
Description Cet attribut identifie le responsable direct de la nouvelle recrue. Le responsable du recrutement joue souvent un rôle essentiel dans le processus d’intégration, notamment pour présenter l’employé à l’équipe et définir ses premiers objectifs. L’analyse de la performance de l’intégration par responsable du recrutement peut mettre en évidence les responsables qui intègrent le mieux les nouveaux membres de leur équipe et ceux qui ont besoin d’un accompagnement ou d’une formation supplémentaires. Elle peut également faire ressortir les bonnes pratiques des responsables les plus performants, afin de les partager dans toute l’organisation et d’améliorer la cohérence ainsi que la qualité de l’expérience des nouvelles recrues. Pourquoi c’est important Permet d’analyser la performance par responsable, d’identifier ceux qui assurent efficacement l’intégration et ceux qui pourraient avoir besoin d’un soutien supplémentaire. Où les obtenir Généralement disponible dans les informations professionnelles de l’employé ou dans les détails de sa structure hiérarchique dans BambooHR. Exemples Jane DoeJohn SmithEmily Jones
	Service Department	Service que rejoint le nouvel employé.
Description Cet attribut précise le service de rattachement, par exemple « Engineering », « Sales » ou « Marketing ». Il constitue une dimension essentielle pour segmenter et comparer la performance du processus. L’analyse du processus d’intégration par service est essentielle pour comprendre les écarts de performance au sein de l’organisation. Elle permet de répondre à des questions telles que : « Quels services présentent les temps de cycle d’intégration les plus longs ? » ou « Les taux de conformité aux formations obligatoires sont-ils plus faibles dans certains services ? » Ces analyses permettent de cibler les mesures à prendre et de partager les bonnes pratiques entre les services. Pourquoi c’est important Permet de comparer l’efficacité de l’intégration, les temps de cycle et les taux de conformité entre les différentes composantes de l’organisation. Où les obtenir Champ standard associé aux informations professionnelles de l’employé dans BambooHR. Exemples IngénierieVentesMarketingRessources humaines
	Date de début StartDate	Premier jour officiel de travail du nouvel employé.
Description La date de début constitue un jalon essentiel du processus d’intégration. Elle distingue les activités préalables à l’embauche, comme les vérifications d’antécédents et les formalités administratives, des activités postérieures à l’embauche, comme l’accueil et la formation. Cette date sert de point de référence dans de nombreuses analyses. Elle permet notamment de calculer le KPI « Time to First Day Readiness », qui mesure si toutes les tâches nécessaires avant l’embauche ont été achevées avant le premier jour de travail. Elle aide également à analyser la ponctualité des activités préalables à l’embauche et leur incidence sur la productivité dès le premier jour. Pourquoi c’est important Sert de jalon essentiel pour distinguer les activités préalables à l’embauche des activités postérieures et mesurer si les nouvelles recrues sont prêtes dès leur premier jour. Où les obtenir Correspond au champ « Hire Date », qui fait partie des informations standard de la fiche d’un employé dans BambooHR. Exemples 2023-11-012023-11-152023-12-01
	Équipe Team	Équipe précise à laquelle la nouvelle recrue est affectée au sein d’un service.
Description Cet attribut fournit un niveau de détail organisationnel plus précis que le service. Il désigne l’équipe immédiate, par exemple « Frontend Developers » ou « Enterprise Sales Team ». L’analyse au niveau du service est utile, mais l’analyse au niveau de l’équipe peut faire apparaître des éléments plus précis. Elle peut révéler des écarts de performance entre des équipes aux fonctions similaires et montrer comment des pratiques propres à chaque équipe, comme les présentations locales ou la formation, influencent l’ensemble du parcours d’intégration. Cette approche est particulièrement utile dans les grands services qui nécessitent une analyse plus détaillée. Pourquoi c’est important Fournit une vue plus détaillée que le service et permet d’analyser les écarts de performance et de processus entre les différentes équipes. Où les obtenir Il peut s’agir d’un champ standard ou personnalisé dans BambooHR, souvent associé à l’affectation organisationnelle de l’employé. Exemples Ingénierie de la plateformeVentes aux entreprises de taille intermédiaireMarketing de contenu
	Indicateur de reprise IsRework	Indicateur signalant qu’une activité constitue la répétition d’une étape déjà réalisée.
Description Cet attribut booléen calculé prend la valeur true lorsqu’une activité, telle que « Paperwork Packet Sent », apparaît plusieurs fois dans un même dossier d’intégration. Il indique qu’une étape du processus a dû être répétée, ce qui révèle généralement une erreur, une information manquante ou une inefficacité. L’identification des reprises constitue une fonctionnalité importante du Process Mining. Cet indicateur permet de filtrer et de quantifier facilement les cas de reprise. Il alimente directement les Dashboards et les KPI consacrés aux reprises, en mettant en évidence les points de friction et les efforts inutiles du processus. La réduction des reprises entraîne des temps de cycle plus courts et une meilleure expérience, tant pour la nouvelle recrue que pour l’équipe RH. Pourquoi c’est important Met en évidence les inefficacités, les erreurs et les efforts inutiles en signalant les activités qui ont dû être répétées. Où les obtenir Il s’agit d’un champ calculé. La logique est implémentée dans l’outil de Process Mining afin de détecter les séquences d’activités répétées au sein d’un dossier. Exemples truefalse
	Nom de la nouvelle recrue NewHireName	Nom complet de l’employé en cours d’intégration.
Description Cet attribut contient le nom du nouvel employé. Il est principalement utilisé à des fins opérationnelles, notamment dans les rapports ou les Dashboards qui doivent identifier des personnes précises. Dans les analyses de Process Mining, les noms sont souvent anonymisés ou remplacés par des identifiants d’employé afin de respecter les réglementations relatives à la protection des données. Toutefois, dans les Dashboards opérationnels utilisés par les équipes RH ou les responsables pour suivre les dossiers actifs, le nom peut fournir un contexte immédiat et facile à comprendre. Pourquoi c’est important Fournit un contexte lisible et compréhensible pour les dossiers individuels, notamment dans les Dashboards opérationnels destinés aux équipes RH et aux responsables. Où les obtenir Champ standard des informations personnelles de l’employé dans BambooHR. Exemples Alice JohnsonRobert WilliamsMaria Garcia
	Pays Country	Pays dans lequel la nouvelle recrue est employée.
Description Cet attribut précise le pays d’emploi. Pour les organisations internationales, il constitue une dimension essentielle de l’analyse. Les processus d’intégration et les réglementations peuvent varier considérablement d’un pays à l’autre. L’analyse du processus par pays aide les organisations à comprendre ces différences, à respecter les législations locales et à repérer les possibilités de standardisation des pratiques entre les régions lorsque cela est pertinent. Elle peut également expliquer les écarts de temps de cycle liés aux jours fériés ou aux procédures administratives propres à chaque pays. Pourquoi c’est important Essentiel aux organisations internationales pour analyser les variations des processus, garantir la conformité locale et gérer les exigences d’intégration propres à chaque région. Où les obtenir Champ standard des informations relatives au lieu de travail ou à l’adresse de l’employé dans BambooHR. Exemples États-UnisRoyaume-UniAllemagneCanada
	Responsable de l’événement EventPerformer	Utilisateur ou système ayant exécuté l’activité d’intégration.
Description Cet attribut identifie la personne, l’équipe ou le système automatisé responsable de l’exécution d’une activité donnée. Par exemple, un spécialiste RH peut effectuer l’activité « Paperwork Packet Sent », tandis que le responsable du recrutement réalise l’activité « Team Introduction ». Ces informations sont très utiles pour l’analyse des ressources et la compréhension de la répartition de la charge de travail. Elles permettent d’identifier les équipes ou les fonctions associées aux activités les plus longues ou aux principaux goulots d’étranglement. Elles permettent également d’analyser les tâches exécutées par certains groupes d’utilisateurs, ce qui peut guider l’affectation des ressources et les stratégies d’automatisation. Pourquoi c’est important Identifie la personne qui réalise chaque tâche, ce qui est essentiel pour analyser la charge de travail, optimiser les ressources et comprendre les comportements propres à chaque utilisateur. Où les obtenir Ces informations peuvent être enregistrées dans les journaux d’audit ou les détails d’achèvement des tâches de BambooHR, souvent associés à l’utilisateur ayant effectué la mise à jour. Exemples Administrateur RHDavid Chen (responsable du recrutement)Automatisation du systèmeAssistance informatique
	Statut d’emploi EmploymentStatus	Statut actuel de la nouvelle recrue dans son parcours professionnel.
Description Cet attribut suit le statut de la nouvelle recrue au fil de sa progression, par exemple de « Offer Accepted » à « Pre-Hire », puis à « Active ». Il fournit une vue d’ensemble de la position de l’employé dans le processus global. En Process Mining, il peut être utilisé comme attribut au niveau du dossier pour filtrer les dossiers d’intégration actifs ou analyser la durée pendant laquelle les dossiers restent dans un statut donné. Il est particulièrement utile pour les Dashboards qui offrent une vue en temps réel de tous les processus d’intégration en cours et aident les équipes RH ainsi que les responsables à suivre leur progression. Pourquoi c’est important Fournit une vue d’ensemble du statut du dossier d’intégration, permettant de filtrer les dossiers actifs et de suivre la progression globale. Où les obtenir Champ standard de la fiche de l’employé dans BambooHR. Exemples ActifInactifSorti des effectifsEn congé
	Temps de cycle de l’intégration OnboardingCycleTime	Durée totale du processus d’intégration pour un dossier donné.
Description Cette mesure calculée évalue le temps de cycle de bout en bout de chaque dossier d’intégration, généralement de « Offer Accepted » à « 30-Day Check-in Completed ». Elle représente le temps total écoulé pour l’ensemble du processus. Il s’agit d’un indicateur clé de performance (KPI) pour évaluer l’efficacité globale du processus. Il est utilisé dans les Dashboards pour suivre la durée moyenne des intégrations, comparer la performance entre les services ou les fonctions et mesurer l’incidence des initiatives d’amélioration des processus. Un temps de cycle plus court est généralement associé à une meilleure expérience pour la nouvelle recrue et à une réduction des coûts administratifs. Pourquoi c’est important Il s’agit d’un KPI essentiel pour mesurer l’efficacité globale du processus et suivre les améliorations au fil du temps. Où les obtenir Calculé en mesurant l’écart entre l’horodatage de la première activité et celui de la dernière activité du dossier. Exemples 35 jours42 jours28 jours

Obligatoire Recommandé Facultatif

Activités d’intégration des employés

Voici les étapes et les jalons essentiels du processus à enregistrer dans votre journal d’événements pour permettre une découverte précise du processus et un suivi des performances.

7 Recommandé 8 Facultatif

	Activité	Description
	Dossier de formalités terminé	Cet événement se produit lorsque la nouvelle recrue a signé tous les documents requis de son dossier d’intégration. BambooHR l’enregistre automatiquement lorsque l’employé a apposé toutes les signatures électroniques requises dans le dossier envoyé.
Pourquoi c’est important La finalisation des formalités est une condition essentielle au premier jour de la nouvelle recrue. L’analyse de cette étape est indispensable pour garantir la Conformité et la préparation au poste, et pour éviter les reprises ainsi que les retards de prise de fonction. Où les obtenir Enregistré à partir de l’horodatage auquel le statut du dossier envoyé passe à « Completed » dans BambooHR. Collecte Un événement distinct est enregistré lorsque la dernière signature électronique requise est apposée dans le dossier de la nouvelle recrue. Type d’événement explicit
	Entretien de suivi à 30 jours terminé	Cette activité correspond à la fin du premier entretien formel entre la nouvelle recrue et son responsable, généralement organisé après environ 30 jours. Elle est enregistrée lorsqu’une tâche « 30-Day Check-in » ou un formulaire d’évaluation est marqué comme terminé dans BambooHR.
Pourquoi c’est important Cette étape est essentielle pour recueillir rapidement des retours, répondre aux difficultés et améliorer la fidélisation des employés. Le suivi de sa réalisation garantit un échange régulier avec les nouvelles recrues pendant une période déterminante. Où les obtenir Enregistré à partir de l’horodatage de fin d’une tâche « 30-Day Check-in » ou d’un formulaire d’évaluation dans BambooHR. Collecte L’événement est enregistré lorsqu’un responsable marque la tâche ou le formulaire de suivi comme « Completed ». Type d’événement explicit
	Formation obligatoire terminée	Cette activité marque la réussite d’une formation obligatoire par le nouvel employé. BambooHR enregistre l’événement lorsque le statut d’une formation attribuée passe à « Completed » dans le module de suivi des formations.
Pourquoi c’est important Il s’agit d’une étape essentielle pour la Conformité. Le suivi de sa réalisation permet de vérifier que l’entreprise respecte les exigences légales et les politiques internes, et que les employés disposent des connaissances nécessaires à leur fonction. Où les obtenir Enregistré à partir de l’horodatage auquel le statut d’un enregistrement de formation passe à « Completed » dans le module Training de BambooHR. Collecte Un événement distinct est enregistré lorsque le champ de statut d’un enregistrement de formation passe à « Completed ». Type d’événement explicit
	Offre acceptée	Cette activité marque le début officiel du processus d’intégration, au moment où un candidat accepte formellement son offre d’emploi. Dans BambooHR, cet événement est généralement enregistré lorsque le statut du candidat dans l’Applicant Tracking System (ATS) passe à « Hired », ce qui déclenche la création de son profil d’employé et de sa checklist d’intégration.
Pourquoi c’est important Il s’agit du point de départ essentiel de chaque cas d’intégration. L’analyse du délai entre cet événement et les suivants permet de mesurer l’efficacité et la rapidité globales du processus préalable à l’embauche. Où les obtenir Déduit de la date à laquelle le statut du candidat passe à « Hired » dans le module ATS de BambooHR ou du renseignement de la date d’embauche dans la fiche de l’employé. Collecte Identifiez l’horodatage auquel le champ « status » du candidat passe à « Hired ». Type d’événement inferred
	Orientation du premier jour terminée	Cette activité marque la fin de la session d’orientation initiale de la nouvelle recrue, consacrée à la culture de l’entreprise, aux politiques internes et aux présentations. Elle est enregistrée lorsqu’une tâche « First Day Orientation » est marquée comme terminée par les RH ou le responsable du recrutement dans la checklist d’intégration de BambooHR.
Pourquoi c’est important Il s’agit d’une étape importante pour l’engagement et l’intégration de l’employé. Veiller à ce qu’elle ait lieu de manière systématique et dans les délais est essentiel pour donner aux nouvelles recrues les meilleures conditions de réussite et leur offrir une expérience positive. Où les obtenir Enregistré à partir de l’horodatage de fin de la tâche « First Day Orientation » dans l’Onboarding Task List. Collecte L’événement est enregistré lorsque la tâche d’orientation passe au statut « Completed ». Type d’événement explicit
	Tâches d’intégration terminées	Cette activité marque la fin de toutes les tâches attribuées dans la checklist d’intégration de la nouvelle recrue. L’événement peut être déduit lorsque le pourcentage de réalisation de la liste des tâches atteint 100 % ou lorsqu’une dernière tâche « Complete Onboarding » est cochée.
Pourquoi c’est important Elle constitue le point final de la partie structurée de l’intégration, organisée autour des tâches. Elle confirme que toutes les étapes administratives et préparatoires ont été exécutées avec succès. Où les obtenir Déduit de l’horodatage de fin de la dernière tâche terminée dans l’Onboarding Task List d’un employé ou du moment où le statut global du processus d’intégration passe à « Complete ». Collecte Identifiez l’horodatage de fin le plus récent parmi toutes les tâches associées à un même cas d’intégration. Type d’événement inferred
	Vérification des antécédents terminée	Cette activité indique que la vérification des antécédents de la nouvelle recrue est terminée et que les résultats sont disponibles. Dans BambooHR, elle est enregistrée lorsque la tâche « Background Check » de la checklist d’intégration passe au statut « Completed ».
Pourquoi c’est important Il s’agit d’une étape importante pour la Conformité. Les retards entre le lancement et la fin de la vérification peuvent constituer un goulot d’étranglement majeur. Leur suivi permet de vérifier que les exigences préalables à l’embauche sont respectées avant la date de début. Où les obtenir Enregistré à partir de l’horodatage de fin de la tâche « Background Check » dans l’Onboarding Task List de la nouvelle recrue. Collecte L’événement est enregistré lorsque le statut de la tâche de vérification des antécédents passe à « Completed ». Type d’événement explicit
	Demande de mise à disposition informatique envoyée	Cette activité marque l’envoi officiel d’une demande au service informatique pour créer les comptes et les accès nécessaires à la nouvelle recrue. Dans BambooHR, elle est généralement enregistrée lorsqu’une tâche prédéfinie « IT Provisioning » est créée et affectée dans la checklist d’intégration.
Pourquoi c’est important La mise à disposition informatique dans les délais est essentielle pour garantir un premier jour productif. Le suivi de cet événement permet de mesurer la réactivité de l’équipe informatique et de diagnostiquer les retards d’accès aux systèmes. Où les obtenir Enregistré à partir de la date et de l’heure de création de la tâche « IT Account Provisioning », ou d’une tâche similaire, dans l’Onboarding Task List de la nouvelle recrue. Collecte L’événement est enregistré lorsque la tâche de mise à disposition informatique est créée dans une checklist d’intégration. Type d’événement explicit
	Dossier de formalités envoyé	Cette activité marque le moment où le dossier de la nouvelle recrue, qui contient notamment les formulaires I-9 et W-4 ainsi que les politiques de l’entreprise, est envoyé à la nouvelle recrue pour examen et signature. BambooHR enregistre cet événement lorsqu’un administrateur RH envoie le dossier au moyen des fonctionnalités de gestion documentaire du système.
Pourquoi c’est important Cette activité lance un flux de travail administratif important. Mesurer le temps écoulé entre ce point et l’achèvement des formalités permet d’évaluer l’efficacité du processus documentaire. Où les obtenir Enregistré à partir de l’horodatage auquel le dossier de la nouvelle recrue est envoyé à un employé pour signature électronique dans BambooHR. Collecte Un événement distinct est enregistré dans le système lorsque l’action « Send Packet » est exécutée. Type d’événement explicit
	Équipement commandé	Cette activité correspond au moment où le matériel nécessaire, comme un ordinateur portable ou un téléphone, est commandé pour la nouvelle recrue. Elle est généralement enregistrée lorsqu’une tâche « Order Equipment » passe au statut « Completed » dans la checklist d’intégration de BambooHR.
Pourquoi c’est important Cette activité constitue une étape importante pour garantir que la nouvelle recrue dispose des outils physiques nécessaires. Les retards à ce stade affectent directement la préparation et la productivité dès le premier jour. Où les obtenir Enregistré à partir de l’horodatage de fin d’une tâche « Order Equipment » dans l’Onboarding Task List de BambooHR. Collecte L’événement est enregistré lorsque le statut de la tâche « Order Equipment » passe à « Completed ». Type d’événement explicit
	Équipement livré	Cette activité indique que l’équipement commandé a été livré physiquement et qu’il est prêt pour la nouvelle recrue. Elle est souvent suivie au moyen d’une tâche distincte « Equipment Delivered » ou « Workspace Setup » marquée comme terminée dans la checklist d’intégration de BambooHR.
Pourquoi c’est important Le suivi du délai entre la commande et la livraison met en évidence les éventuels goulots d’étranglement de la chaîne d’approvisionnement ou de la logistique. Il permet de s’assurer que tous les équipements sont disponibles avant la date de prise de fonction. Où les obtenir Enregistré à partir de l’horodatage de fin d’une tâche « Equipment Delivered » ou « Workspace Setup » dans l’Onboarding Task List. Collecte L’événement est enregistré lorsque le statut de la tâche de livraison ou de configuration passe à « Completed ». Type d’événement explicit
	Formation obligatoire attribuée	Cet événement se produit lorsqu’une formation obligatoire liée à la Conformité ou au poste est attribuée au nouvel employé. Dans BambooHR, il est enregistré dans le module de suivi des formations lorsqu’une nouvelle formation est ajoutée à la fiche de l’employé.
Pourquoi c’est important Il s’agit du point de départ pour mesurer la Conformité des formations. L’analyse du délai entre l’attribution et la réalisation permet de vérifier que les employés respectent rapidement les exigences réglementaires et internes. Où les obtenir Enregistré à partir de la date de création d’un enregistrement de formation attribué à un employé donné dans le module Training de BambooHR. Collecte Un événement distinct est enregistré lorsqu’une nouvelle entrée est créée dans la table de suivi des formations des employés. Type d’événement explicit
	Présentation à l’équipe terminée	Cette activité correspond à la présentation officielle de la nouvelle recrue aux membres de son équipe immédiate. Il s’agit généralement d’une activité informelle, menée par le responsable, qui est enregistrée lorsque la tâche correspondante de la checklist d’intégration dans BambooHR est terminée.
Pourquoi c’est important L’intégration sociale est un élément important d’une intégration réussie. Le suivi de cette activité permet de vérifier que les responsables accomplissent les étapes nécessaires pour accueillir les nouvelles recrues et renforcer la cohésion de l’équipe. Où les obtenir Enregistré à partir de l’horodatage de fin d’une tâche « Team Introduction » dans l’Onboarding Task List, généralement affectée au responsable du recrutement. Collecte L’événement est enregistré lorsque le responsable marque la tâche « Team Introduction » comme « Completed ». Type d’événement explicit
	Profil de l’employé créé	Cette activité correspond à la création officielle de la fiche de la nouvelle recrue dans le SIRH, qui passe ainsi du statut de candidat à celui d’employé. Elle est déduite de la date de création de la fiche de l’employé dans la base de données principale de BambooHR, généralement après l’acceptation de l’offre.
Pourquoi c’est important Cette activité constitue la base de toutes les étapes d’intégration suivantes, comme la mise à disposition informatique et la configuration de la paie. Elle fournit un horodatage clair du moment où l’employé entre officiellement dans le système. Où les obtenir Déduit de l’horodatage de création de la fiche du nouvel employé dans les tables principales de données des employés. Collecte Utilisez l’horodatage de métadonnées « created_at », ou son équivalent, provenant de la fiche principale de l’employé. Type d’événement inferred
	Vérification des antécédents lancée	Cette activité correspond au moment où une vérification des antécédents est demandée pour la nouvelle recrue par l’intermédiaire d’un service intégré. Elle est généralement enregistrée lorsqu’une tâche « Background Check » est créée ou passe au statut « In Progress » dans la liste des tâches d’intégration de la nouvelle recrue dans BambooHR.
Pourquoi c’est important Le suivi du lancement des vérifications des antécédents permet d’identifier les retards du processus de contrôle préalable à l’embauche, qui constitue souvent une étape déterminante pour la Conformité et la rapidité du recrutement. Où les obtenir Enregistré à partir de la date de création ou de début de la tâche « Background Check » dans une Onboarding Task List de BambooHR. Collecte L’événement est enregistré lorsque la tâche de vérification des antécédents est créée ou que son statut passe à « In Progress ». Type d’événement explicit

Recommandé Facultatif

Guides d’extraction

Comment récupérer vos données depuis BambooHR

Étapes

Connectez-vous à BambooHR : accédez à votre instance BambooHR avec un compte utilisateur autorisé à créer et à exécuter des rapports personnalisés.
Accédez aux rapports personnalisés : dans le menu de navigation principal, sélectionnez Reports. Dans la section « Manage Reports », cliquez sur « Add Report ».
Configurez le rapport : donnez-lui un nom explicite, par exemple « Onboarding Process Mining Export ». Ajoutez une brève description si nécessaire.
Sélectionnez les champs du rapport : dans l’onglet « Fields », sélectionnez toutes les colonnes nécessaires au journal d’événements. Vous devez notamment sélectionner les identifiants des employés, les principaux attributs et tous les champs de date correspondant aux activités d’intégration. Sélectionnez notamment les champs suivants :
- Employee #
- First Name, Last Name
- Department, Job Title, Location
- Hiring Manager
- Hire Date (pour « Employee Profile Created »)
- Tous les champs de date personnalisés utilisés pour les étapes clés, comme « Offer Accepted Date ».
- Les dates d’achèvement de toutes les tâches pertinentes d’Onboarding et d’Offboarding. Sélectionnez chaque tâche concernée, par exemple : « Background Check Completed Date », « Paperwork Packet Sent Date », « Paperwork Packet Completed Date », « IT Provisioning Requested Date », etc.
- Les dates du module Training, comme « Mandatory Training Assigned Date » et « Mandatory Training Completed Date ».
Définissez les filtres du rapport : ouvrez l’onglet « Filters » pour définir le périmètre des données. Il est vivement recommandé de filtrer selon « Hire Date » afin de sélectionner les employés d’une période donnée, par exemple les six derniers mois. Le rapport restera ainsi d’une taille raisonnable et les délais d’expiration seront évités.
Enregistrez et générez le rapport : une fois les champs et les filtres configurés, cliquez sur « Save & Run ». Vérifiez les résultats dans l’interface BambooHR afin de vous assurer que les employés et les colonnes de données attendus sont présents.
Exportez les données : cliquez sur le bouton d’export, généralement représenté par une icône de nuage ou de flèche, puis choisissez « Comma Separated Values (.csv) ». Enregistrez le fichier sur votre ordinateur sous un nom explicite, par exemple bamboohr_onboarding_export.csv.
Préparez le script de transformation : copiez l’intégralité du script Python fourni dans la section « query » de ce document et enregistrez-le dans un fichier nommé transform_bamboohr.py, situé dans le même répertoire que votre fichier CSV exporté.
Installez la bibliothèque requise : si pandas n’est pas installé, ouvrez un terminal ou une invite de commandes et exécutez la commande suivante : pip install pandas.
Exécutez la transformation : ouvrez votre terminal ou votre invite de commandes, accédez au répertoire contenant vos fichiers et exécutez le script avec la commande suivante : python transform_bamboohr.py. Le script traitera l’export CSV au format large et générera un fichier nommé event_log.csv, au format long requis pour le Process Mining.
Importez les données dans ProcessMind : le fichier event_log.csv peut maintenant être importé dans l’application ProcessMind.

Configuration

Prérequis : Vous devez disposer du package BambooHR Advantage, qui inclut les fonctionnalités avancées de reporting et d’intégration. Votre rôle utilisateur doit vous autoriser à créer, consulter et exporter des rapports personnalisés contenant des données sur les employés.
Champs du rapport : La réussite de cette méthode repose sur la sélection des bons champs. Le rapport doit être construit dans un format « large », avec une ligne par employé et une colonne de date pour chaque activité d’intégration. Vous devez inclure Employee # comme identifiant du cas, ainsi que toutes les colonnes d’attributs pertinentes, telles que Service, Job Title et Hiring Manager.
Champs et tâches personnalisés : Cette extraction dépend largement de l’utilisation que votre organisation fait de BambooHR. Les activités telles que « Offer Accepted » ou « Equipment Ordered » doivent être enregistrées dans des champs de date personnalisés précis ou sous forme de tâches dans une checklist d’intégration. Veillez à sélectionner les champs correspondant à la date d’achèvement de ces tâches, et pas uniquement leur nom.
Filtres de période : Pour garantir de bonnes performances et conserver des données pertinentes, filtrez toujours le rapport sur « Hire Date ». Une période glissante couvrant généralement les 6 à 12 derniers mois suffit pour analyser le processus sans générer un fichier d’exportation excessivement volumineux.
Planification du rapport : Pour assurer un suivi continu, vous pouvez utiliser la fonctionnalité de BambooHR qui planifie l’exécution du rapport personnalisé et vous l’envoie par e-mail à intervalles réguliers, par exemple chaque semaine. Cette configuration peut automatiser la première partie du processus d’extraction.

a Exemple de requête python

import pandas as pd
import numpy as np
from datetime import datetime

class=class="hl-string">"hl-comment"># --- Configuration ---
class=class="hl-string">"hl-comment"># The input file exported from BambooHR.
BAMBOOHR_EXPORT_FILE = class="hl-string">'bamboohr_onboarding_export.csv'

class=class="hl-string">"hl-comment"># The final output file ready for ProcessMind.
EVENT_LOG_FILE = class="hl-string">'event_log.csv'

class=class="hl-string">"hl-comment"># This dictionary maps the column names from your BambooHR export to the desired Activity Name.
class=class="hl-string">"hl-comment"># You MUST update the keys (the column names) to exactly match the headers in your exported CSV file.
class=class="hl-string">"hl-comment"># For example, if your class="hl-string">'Background Check Completed' task completion date column is named class="hl-string">'Onboarding: Background Check - Completed On', update it below.
ACTIVITY_MAPPING = {
    class="hl-string">'[Offer Accepted Date Custom Field]': class="hl-string">'Offer Accepted',
    class="hl-string">'[Background Check Initiated Task Completion Date]': class="hl-string">'Background Check Initiated',
    class="hl-string">'[Background Check Completed Task Completion Date]': class="hl-string">'Background Check Completed',
    class="hl-string">'[Paperwork Packet Sent Task Completion Date]': class="hl-string">'Paperwork Packet Sent',
    class="hl-string">'[Paperwork Packet Completed Task Completion Date]': class="hl-string">'Paperwork Packet Completed',
    class="hl-string">'Hire Date': class="hl-string">'Employee Profile Created',
    class="hl-string">'[IT Provisioning Requested Task Completion Date]': class="hl-string">'IT Provisioning Requested',
    class="hl-string">'[Equipment Ordered Task Completion Date]': class="hl-string">'Equipment Ordered',
    class="hl-string">'[Equipment Delivered Task Completion Date]': class="hl-string">'Equipment Delivered',
    class="hl-string">'[First Day Orientation Completed Task Completion Date]': class="hl-string">'First Day Orientation Completed',
    class="hl-string">'[Mandatory Training Assigned Date]': class="hl-string">'Mandatory Training Assigned',
    class="hl-string">'[Team Introduction Completed Task Completion Date]': class="hl-string">'Team Introduction Completed',
    class="hl-string">'[Mandatory Training Completed Date]': class="hl-string">'Mandatory Training Completed',
    class="hl-string">'[30-Day Check-in Completed Task Completion Date]': class="hl-string">'30-Day Check-in Completed',
    class="hl-string">'[Onboarding Tasks Completed Date]': class="hl-string">'Onboarding Tasks Completed'
}

class=class="hl-string">"hl-comment"># --- Main Script ---
def transform_bamboohr_export():
    class="hl-string">"""Loads the wide BambooHR report, transforms it into a long event log format, and saves it to a new CSV."""
    print(fclass="hl-string">"Reading BambooHR export from '{BAMBOOHR_EXPORT_FILE}'...")
    try:
        df = pd.read_csv(BAMBOOHR_EXPORT_FILE)
    except FileNotFoundError:
        print(fclass="hl-string">"Error: The file '{BAMBOOHR_EXPORT_FILE}' was not found. Please ensure it is in the same directory as the script.")
        return

    print(class="hl-string">"Identifying attribute and activity columns...")
    class=class="hl-string">"hl-comment"># Use Employee # as the unique case identifier.
    id_vars = [class="hl-string">'Employee class="hl-comment">#']
    
    class=class="hl-string">"hl-comment"># Define recommended attributes to keep for each event.
    class=class="hl-string">"hl-comment"># Update these column names if they are different in your export.
    attribute_vars = [
        class="hl-string">'Department', 
        class="hl-string">'Job Title', 
        class="hl-string">'Location', 
        class="hl-string">'Hiring Manager'
    ]

    class=class="hl-string">"hl-comment"># All columns that exist in the dataframe and are in our mapping are treated as value_vars for melting.
    value_vars = [col for col in ACTIVITY_MAPPING.keys() if col in df.columns]
    
    if not value_vars:
        print(class="hl-string">"Error: None of the specified activity columns in ACTIVITY_MAPPING were found in the CSV.")
        print(class="hl-string">"Please check your column names.")
        return

    class=class="hl-string">"hl-comment"># Ensure all identifier and attribute columns are present.
    all_id_vars = id_vars + attribute_vars
    missing_cols = [col for col in all_id_vars if col not in df.columns]
    if missing_cols:
        print(fclass="hl-string">"Warning: The following columns were not found and will be skipped: {', '.join(missing_cols)}")
        all_id_vars = [col for col in all_id_vars if col in df.columns]

    print(class="hl-string">"Unpivoting data to create event log...")
    class=class="hl-string">"hl-comment"># Unpivot the dataframe from wide to long format.
    event_log_df = df.melt(
        id_vars=all_id_vars,
        value_vars=value_vars,
        var_name=class="hl-string">'ActivityName',
        value_name=class="hl-string">'EventTimestamp'
    )

    class=class="hl-string">"hl-comment"># Drop rows where the event did not occur (timestamp is null).
    event_log_df.dropna(subset=[class="hl-string">'EventTimestamp'], inplace=True)
    
    print(class="hl-string">"Formatting columns for ProcessMind...")
    class=class="hl-string">"hl-comment"># Replace the source column names with the clean activity names.
    event_log_df[class="hl-string">'ActivityName'] = event_log_df[class="hl-string">'ActivityName'].map(ACTIVITY_MAPPING)

    class=class="hl-string">"hl-comment"># Rename columns to match the required schema.
    event_log_df.rename(columns={class="hl-string">'Employee class="hl-comment">#': class="hl-string">'OnboardingCase'}, inplace=True)
    event_log_df[class="hl-string">'EmployeeId'] = event_log_df[class="hl-string">'OnboardingCase']

    class=class="hl-string">"hl-comment"># Add static columns required by the schema.
    event_log_df[class="hl-string">'SourceSystem'] = class="hl-string">'BambooHR'
    event_log_df[class="hl-string">'LastDataUpdate'] = datetime.now().strftime(class="hl-string">'%Y-%m-%d %H:%M:%S')
    event_log_df[class="hl-string">'EndTimestamp'] = event_log_df[class="hl-string">'EventTimestamp'] class=class="hl-string">"hl-comment"># Assuming point-in-time events
    
    class=class="hl-string">"hl-comment"># Ensure timestamp format is consistent.
    event_log_df[class="hl-string">'EventTimestamp'] = pd.to_datetime(event_log_df[class="hl-string">'EventTimestamp']).dt.strftime(class="hl-string">'%Y-%m-%d %H:%M:%S')
    event_log_df[class="hl-string">'EndTimestamp'] = pd.to_datetime(event_log_df[class="hl-string">'EndTimestamp']).dt.strftime(class="hl-string">'%Y-%m-%d %H:%M:%S')

    class=class="hl-string">"hl-comment"># Reorder columns for clarity.
    final_columns = [
        class="hl-string">'OnboardingCase', class="hl-string">'ActivityName', class="hl-string">'EventTimestamp', class="hl-string">'SourceSystem', class="hl-string">'LastDataUpdate',
        class="hl-string">'EmployeeId', class="hl-string">'Department', class="hl-string">'Job Title', class="hl-string">'Location', class="hl-string">'HiringManager', class="hl-string">'EndTimestamp'
    ]
    class=class="hl-string">"hl-comment"># Filter to only include columns that exist.
    final_columns = [col for col in final_columns if col in event_log_df.columns]
    event_log_df = event_log_df[final_columns]

    class=class="hl-string">"hl-comment"># Sort the data.
    event_log_df.sort_values(by=[class="hl-string">'OnboardingCase', class="hl-string">'EventTimestamp'], inplace=True)

    print(fclass="hl-string">"Saving event log to '{EVENT_LOG_FILE}'...")
    event_log_df.to_csv(EVENT_LOG_FILE, index=False)
    print(class="hl-string">"Transformation complete.")

if __name__ == class="hl-string">'__main__':
    transform_bamboohr_export()

Étapes

Prérequis et configuration : vérifiez que Python 3.6 ou une version ultérieure est installé sur votre système. Installez les bibliothèques nécessaires, pandas et requests, en exécutant la commande suivante dans votre terminal : pip install pandas requests.
Générez une clé API BambooHR : connectez-vous à votre compte BambooHR avec des privilèges d’administrateur. Ouvrez l’icône de votre profil en haut à droite, sélectionnez « API Keys » et créez une nouvelle clé API. Donnez-lui un nom explicite, par exemple « ProcessMiningExtraction », et accordez-lui un accès en lecture seule aux données des employés, aux tâches d’intégration et aux dossiers de formation. Copiez la clé générée dans un emplacement sécurisé.
Configurez le script Python : enregistrez le script Python fourni dans un fichier, par exemple extract_onboarding.py. Ouvrez le fichier et remplacez les valeurs fictives de COMPANY_SUBDOMAIN par le sous-domaine propre à votre entreprise, c’est-à-dire la partie de votre URL BambooHR située avant « .bamboohr.com », puis renseignez API_KEY avec la clé générée à l’étape précédente.
Définissez la période d’extraction : modifiez les variables START_DATE et END_DATE dans le script. Ces paramètres définissent la période pendant laquelle les nouvelles recrues seront incluses dans l’extraction. Utilisez le format « YYYY-MM-DD ».
Exécutez le script : lancez le script depuis votre terminal avec la commande suivante : python extract_onboarding.py. Le script se connectera à l’API BambooHR, récupérera les données nécessaires et commencera leur traitement.
Comprenez les appels API : le script commence par appeler le point de terminaison du rapport de l’annuaire des employés afin d’obtenir la liste des employés recrutés pendant la période indiquée. Cette liste sert de base à l’identifiant OnboardingCase.
Récupération itérative des données : pour chaque nouvelle recrue identifiée, le script effectue des appels API supplémentaires afin de récupérer les informations détaillées de son profil, les tâches d’intégration qui lui sont attribuées et ses dossiers de formation. Toutes les données pertinentes du parcours d’intégration sont ainsi collectées.
Transformation et mappage des données : le script transforme les données JSON brutes de l’API en un journal d’événements structuré. Il utilise le dictionnaire prédéfini TASK_TO_ACTIVITY_MAP pour associer les titres des tâches d’intégration dans BambooHR aux noms d’activités standardisés requis pour le Process Mining. Des événements tels que « Offer Accepted » et « Employee Profile Created » sont déduits des dates d’embauche et de création du profil de l’employé.
Vérifiez la sortie de la console : pendant l’exécution, le script affiche des informations de progression dans la console, notamment le nombre de nouvelles recrues trouvées et le nom de chaque employé traité. Surveillez cette sortie afin de repérer les erreurs ou avertissements éventuels.
Générez le fichier de journal d’événements : une fois tous les employés traités, le script regroupe les données dans un DataFrame et les enregistre dans un fichier CSV nommé bamboohr_onboarding_event_log.csv, dans le même répertoire. Ce fichier contient les colonnes requises par ProcessMind.
Préparez l’importation : ouvrez le fichier CSV généré pour en vérifier le contenu. Avant de l’importer dans votre outil de Process Mining, assurez-vous que les colonnes OnboardingCase, ActivityName et EventTimestamp sont correctement renseignées.

Configuration

Autorisations de la clé API : la clé API utilisée pour l’extraction doit disposer au minimum d’autorisations en lecture seule pour les données suivantes : informations personnelles des employés, informations relatives au poste, statut d’emploi, tâches d’intégration et dossiers de formation.
Sous-domaine de l’entreprise : le script a besoin du sous-domaine BambooHR propre à votre entreprise pour construire les URL correctes des points de terminaison API.
Période (START_DATE, END_DATE) : ces variables du script définissent la période d’extraction à partir des dates d’embauche. Il est recommandé de commencer par une période récente de trois à six mois afin de garantir la qualité des données et de maîtriser le volume extrait. Pour une analyse historique complète, vous pouvez élargir cette période, tout en tenant compte des limites de débit de l’API.
Mappage des activités (TASK_TO_ACTIVITY_MAP) : ce dictionnaire du script est essentiel. Il associe les intitulés exacts des tâches d’intégration de votre entreprise dans BambooHR aux noms d’activités standardisés. Vous devez vérifier et personnaliser ce mappage pour l’adapter à la configuration BambooHR propre à votre organisation.
Identifiant du système source : la variable SOURCE_SYSTEM est définie sur « BambooHR » dans le script. Vous pouvez la modifier si vous avez besoin d’un autre identifiant dans votre journal d’événements final.
Considérations liées aux performances : si votre organisation compte des milliers de nouvelles recrues sur la période sélectionnée, le script peut nécessiter un temps d’exécution important en raison des nombreux appels API effectués pour chaque employé. Il est conseillé de l’exécuter en dehors des heures de pointe afin de limiter les effets sur les performances et les risques de dépassement des limites de l’API.

a Exemple de requête python

import requests
import pandas as pd
from datetime import datetime

class=class="hl-string">"hl-comment"># --- Configuration Settings --- #
class=class="hl-string">"hl-comment"># Replace with your companyclass="hl-string">'s subdomain (e.g., 'yourcompany' from yourcompany.bamboohr.com)
COMPANY_SUBDOMAIN = class="hl-string">'[Your Company Subdomain]'
class=class="hl-string">"hl-comment"># Replace with your BambooHR API Key
API_KEY = class="hl-string">'[Your BambooHR API Key]'

class=class="hl-string">"hl-comment"># Define the date range for new hires to extract (based on hire date)
START_DATE = class="hl-string">'2023-01-01'
END_DATE = class="hl-string">'2023-12-31'

SOURCE_SYSTEM = class="hl-string">'BambooHR'

class=class="hl-string">"hl-comment"># --- Critical: Customize this mapping to match your BambooHR task names --- #
TASK_TO_ACTIVITY_MAP = {
    class="hl-string">'Background Check': class="hl-string">'Background Check Completed',
    class="hl-string">'Send New Hire Packet': class="hl-string">'Paperwork Packet Sent',
    class="hl-string">'Complete New Hire Packet': class="hl-string">'Paperwork Packet Completed',
    class="hl-string">'IT Provisioning Request': class="hl-string">'IT Provisioning Requested',
    class="hl-string">'Order Equipment': class="hl-string">'Equipment Ordered',
    class="hl-string">'Equipment Delivered': class="hl-string">'Equipment Delivered',
    class="hl-string">'First Day Orientation': class="hl-string">'First Day Orientation Completed',
    class="hl-string">'Introduce to Team': class="hl-string">'Team Introduction Completed',
    class="hl-string">'30-Day Check-in': class="hl-string">'30-Day Check-in Completed',
    class="hl-string">'Complete Onboarding': class="hl-string">'Onboarding Tasks Completed'
}

class=class="hl-string">"hl-comment"># --- Main Script Logic --- #

def get_new_hires(start_date, end_date):
    class="hl-string">"""Fetches employees hired within the specified date range."""
    url = fclass="hl-string">'https://api.bamboohr.com/api/gateway.php/{COMPANY_SUBDOMAIN}/v1/reports/custom'
    headers = {class="hl-string">'Accept': class="hl-string">'application/json'}
    auth = (API_KEY, class="hl-string">'x')
    
    payload = {
        class="hl-string">'title': class="hl-string">'New Hire Report',
        class="hl-string">'fields': [class="hl-string">'employeeId', class="hl-string">'created', class="hl-string">'hireDate', class="hl-string">'department', class="hl-string">'jobTitle', class="hl-string">'location', class="hl-string">'supervisor'],
        class="hl-string">'filters': {
            class="hl-string">'lastChanged': {
                class="hl-string">'includeNull': class="hl-string">'false'
            },
            class="hl-string">'hireDate': {
                class="hl-string">'operator': class="hl-string">'between',
                class="hl-string">'value': start_date,
                class="hl-string">'value2': end_date
            }
        }
    }
    
    print(fclass="hl-string">"Fetching new hires from {start_date} to {end_date}...")
    response = requests.post(url, auth=auth, headers=headers, json=payload)
    response.raise_for_status()
    data = response.json()
    print(fclass="hl-string">"Found {len(data.get('employees', []))} new hires.")
    return data.get(class="hl-string">'employees', [])

def get_onboarding_tasks(employee_id):
    class="hl-string">"""Fetches onboarding tasks for a specific employee."""
    url = fclass="hl-string">'https://api.bamboohr.com/api/gateway.php/{COMPANY_SUBDOMAIN}/v1/employees/{employee_id}/onboarding/tasks'
    headers = {class="hl-string">'Accept': class="hl-string">'application/json'}
    auth = (API_KEY, class="hl-string">'x')
    response = requests.get(url, auth=auth, headers=headers)
    if response.status_code == 200:
        return response.json().get(class="hl-string">'tasks', [])
    return []

def get_training_records(employee_id):
    class="hl-string">"""Fetches training records for a specific employee."""
    url = fclass="hl-string">'https://api.bamboohr.com/api/gateway.php/{COMPANY_SUBDOMAIN}/v1/employees/{employee_id}/training/'
    headers = {class="hl-string">'Accept': class="hl-string">'application/json'}
    auth = (API_KEY, class="hl-string">'x')
    response = requests.get(url, auth=auth, headers=headers)
    if response.status_code == 200:
        return response.json()
    return []

def main():
    class="hl-string">"""Main function to orchestrate the extraction and transformation."""
    try:
        new_hires = get_new_hires(START_DATE, END_DATE)
    except requests.exceptions.HTTPError as e:
        print(fclass="hl-string">"Error fetching new hires: {e}")
        print(fclass="hl-string">"Response content: {e.response.text}")
        return

    event_log = []
    last_data_update = datetime.utcnow().isoformat() + class="hl-string">'Z'

    for employee in new_hires:
        emp_id = employee[class="hl-string">'employeeId']
        print(fclass="hl-string">"Processing Employee ID: {emp_id}...")

        base_event = {
            class="hl-string">'OnboardingCase': emp_id,
            class="hl-string">'EmployeeId': emp_id,
            class="hl-string">'Department': employee.get(class="hl-string">'department'),
            class="hl-string">'JobTitle': employee.get(class="hl-string">'jobTitle'),
            class="hl-string">'Location': employee.get(class="hl-string">'location'),
            class="hl-string">'HiringManager': employee.get(class="hl-string">'supervisor'),
            class="hl-string">'SourceSystem': SOURCE_SYSTEM,
            class="hl-string">'LastDataUpdate': last_data_update
        }

        class=class="hl-string">"hl-comment"># 1. Offer Accepted (inferred from hireDate)
        if employee.get(class="hl-string">'hireDate'):
            event_log.append({
                **base_event,
                class="hl-string">'ActivityName': class="hl-string">'Offer Accepted',
                class="hl-string">'EventTimestamp': fclass="hl-string">"{employee['hireDate']}T09:00:00Z",
                class="hl-string">'EndTimestamp': fclass="hl-string">"{employee['hireDate']}T09:00:00Z"
            })

        class=class="hl-string">"hl-comment"># 2. Employee Profile Created
        if employee.get(class="hl-string">'created'):
            event_log.append({
                **base_event,
                class="hl-string">'ActivityName': class="hl-string">'Employee Profile Created',
                class="hl-string">'EventTimestamp': employee[class="hl-string">'created'].replace(class="hl-string">' ', class="hl-string">'T'),
                class="hl-string">'EndTimestamp': employee[class="hl-string">'created'].replace(class="hl-string">' ', class="hl-string">'T')
            })
        
        class=class="hl-string">"hl-comment"># 3. Onboarding Task Events
        tasks = get_onboarding_tasks(emp_id)
        task_completion_dates = []
        for task in tasks:
            activity_name = TASK_TO_ACTIVITY_MAP.get(task.get(class="hl-string">'title'))
            if activity_name and task.get(class="hl-string">'completedDate'):
                event_log.append({
                    **base_event,
                    class="hl-string">'ActivityName': activity_name,
                    class="hl-string">'EventTimestamp': fclass="hl-string">"{task['completedDate']}T17:00:00Z",
                    class="hl-string">'EndTimestamp': fclass="hl-string">"{task['completedDate']}T17:00:00Z"
                })
                task_completion_dates.append(task.get(class="hl-string">'completedDate'))

            class=class="hl-string">"hl-comment"># Handle Background Check Initiated (assumed from task creation)
            if task.get(class="hl-string">'title') == class="hl-string">'Background Check' and task.get(class="hl-string">'createdDate'):
                 event_log.append({
                    **base_event,
                    class="hl-string">'ActivityName': class="hl-string">'Background Check Initiated',
                    class="hl-string">'EventTimestamp': fclass="hl-string">"{task['createdDate']}T17:00:00Z",
                    class="hl-string">'EndTimestamp': fclass="hl-string">"{task['createdDate']}T17:00:00Z"
                })

        class=class="hl-string">"hl-comment"># 4. Training Events
        trainings = get_training_records(emp_id)
        for training in trainings:
            if training.get(class="hl-string">'type') in [class="hl-string">'Compliance Training', class="hl-string">'Role-Specific Training', class="hl-string">'Mandatory Training']:
                if training.get(class="hl-string">'assignedDate'):
                    event_log.append({
                        **base_event,
                        class="hl-string">'ActivityName': class="hl-string">'Mandatory Training Assigned',
                        class="hl-string">'EventTimestamp': fclass="hl-string">"{training['assignedDate']}T17:00:00Z",
                        class="hl-string">'EndTimestamp': fclass="hl-string">"{training['assignedDate']}T17:00:00Z"
                    })
                if training.get(class="hl-string">'completed'):
                    event_log.append({
                        **base_event,
                        class="hl-string">'ActivityName': class="hl-string">'Mandatory Training Completed',
                        class="hl-string">'EventTimestamp': fclass="hl-string">"{training['completed']}T17:00:00Z",
                        class="hl-string">'EndTimestamp': fclass="hl-string">"{training['completed']}T17:00:00Z"
                    })

    if not event_log:
        print(class="hl-string">"No events were generated. Please check your date range and API permissions.")
        return

    df = pd.DataFrame(event_log)
    df[class="hl-string">'EventTimestamp'] = pd.to_datetime(df[class="hl-string">'EventTimestamp'])
    df = df.sort_values(by=[class="hl-string">'OnboardingCase', class="hl-string">'EventTimestamp'])
    
    output_filename = class="hl-string">'bamboohr_onboarding_event_log.csv'
    df.to_csv(output_filename, index=False, date_format=class="hl-string">'%Y-%m-%d %H:%M:%S')
    print(fclass="hl-string">"\nExtraction complete. Event log saved to '{output_filename}'.")

if __name__ == class="hl-string">'__main__':
    main()

Prêt à commencer ?

Utilisez ce modèle pour préparer vos données à l’analyse et commencer à optimiser votre processus d’intégration des employés en toute confiance. Commencez dès aujourd’hui à repérer les goulots d’étranglement et à améliorer l’efficacité.

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

Optimisez dès aujourd’hui l’intégration des employés dans BambooHR

Atteignez un taux de conformité de 95 % et éliminez les retards d’intégration.

Démarrer l’essai gratuit

Aucune carte bancaire requise. Commencez dès maintenant à optimiser vos processus.

Votre modèle de données d’intégration des employés

Votre modèle de données d’intégration des employés

Attributs de l’intégration des employés

Activités d’intégration des employés

Guides d’extraction

Export personnalisé depuis les rapports intégrés de BambooHR

Étapes

Configuration

a Exemple de requête python

Extraction par script Python via l’API REST BambooHR

Étapes

Configuration

a Exemple de requête python

Prêt à commencer ?

Optimisez dès aujourd’hui l’intégration des employés dans BambooHR

Votre modèle de données d’intégration des employés

Votre modèle de données d’intégration des employés

Attributs de l’intégration des employés

Activités d’intégration des employés

Guides d’extraction

Export personnalisé depuis les rapports intégrés de BambooHR

Étapes

Configuration

a Exemple de requête python

Extraction par script Python via l’API REST BambooHR

Étapes

Configuration

a Exemple de requête python

Prêt à commencer ?

Optimisez dès aujourd’hui l’intégration des employés dans BambooHR

Nous attachons de l’importance à votre confidentialité