> Miglioramento continuo dei processi > Hire to Retire Ciclo di vita del dipendente > UKG Pro > Template dei dati

Il Suo Template dei dati per Hire to Retire - Ciclo di vita dei dipendenti

UKG Pro

Hire to Retire - Attributi del ciclo di vita del dipendente (21) Hire to Retire - Attività del ciclo di vita del dipendente (15) Guide all'estrazione (1)

Il Suo Template dei dati per Hire to Retire - Ciclo di vita dei dipendenti

Questo Template offre una panoramica completa degli elementi di dati essenziali necessari per analizzare efficacemente il processo Hire to Retire. Illustra gli attributi fondamentali da raccogliere, le attività principali da monitorare e indicazioni pratiche per estrarre questi dati da UKG Pro. Utilizzi questa risorsa per semplificare la preparazione dei dati e avviare senza difficoltà il percorso di Process Mining.

Attributi consigliati da raccogliere
Attività principali da monitorare
Indicazioni per l'estrazione da UKG Pro

Non conosce ancora gli Event Log? Scopra come creare un Event Log per il Process Mining.

Scarica il Template

Hire to Retire - Attributi del ciclo di vita del dipendente

Questi sono i campi dati consigliati da includere nell’Event Log per un’analisi completa e approfondimenti sul ciclo di vita del dipendente Hire to Retire.

5 Obbligatorio 7 Consigliato 9 Facoltativo

	Nome	Descrizione
	ID dipendente EmployeeId	L’identificativo univoco assegnato a ciascun dipendente, che funge da ID principale del caso per l’intero ciclo di vita all’interno dell’organizzazione.
Descrizione L’Employee ID costituisce il filo conduttore centrale che collega tutti gli eventi relativi a un dipendente, dalla candidatura iniziale fino alla conclusione del rapporto di lavoro. Questo identificativo è fondamentale per costruire una visione completa end-to-end del percorso individuale. Nell’analisi di Process Mining, ogni attività, come «Employee Hired», «Promotion Approved» o «Termination Initiated», è collegata a questo ID univoco. Ciò consente di analizzare i percorsi dei singoli dipendenti, effettuare analisi per coorte basate sugli attributi dei dipendenti e calcolare con precisione la durata dei cicli di vita. Perché è importante Questo è l’identificativo essenziale del caso che collega tutti gli eventi relativi ai dipendenti, rendendo possibile analizzare il processo Hire to Retire end-to-end per ogni singola persona. Dove reperirlo Questo è un campo fondamentale di UKG Pro, generalmente presente nei record del profilo del dipendente o nei record dei dati anagrafici principali. Consulti la documentazione di UKG Pro per individuare la tabella e il nome specifico del campo, spesso indicato come Employee Number o Person ID. Esempi 10052198345210047
	Timestamp dell'evento EventTimestamp	La data e l'ora precise in cui si è verificato uno specifico evento del ciclo di vita.
Descrizione Il Timestamp dell'evento fornisce il contesto cronologico di ogni attività e costituisce la base del flusso del processo. Registra il momento esatto in cui un evento come «Offer Accepted» o «Promotion Approved» è stato registrato nel sistema. Nell'analisi, questi timestamp vengono utilizzati per calcolare la durata tra le attività, identificare i ritardi e misurare i tempi di ciclo di subprocess chiave come recruiting e onboarding. Timestamp accurati sono fondamentali per tutti i KPI basati sul tempo e per l'analisi delle prestazioni. Perché è importante Questo Attributo è essenziale per ordinare cronologicamente gli eventi e calcolare tutte le metriche basate sul tempo, come i tempi di ciclo e le durate. Dove reperirlo Proviene dai campi data o timestamp associati a eventi specifici in UKG Pro, come «HireDate», «TerminationDate» o i timestamp delle variazioni di stato nei moduli Workflow. Esempi 2023-01-15T09:00:00Z2023-06-20T14:35:10Z2024-02-01T11:00:00Z
	Nome dell'attività ActivityName	Il nome dell'evento o della milestone specifica che si è verificata nel ciclo di vita del dipendente, ad esempio «Employee Hired» o «Performance Review Conducted».
Descrizione Il Nome dell'attività descrive un singolo passaggio o Task all'interno del processo Hire to Retire. Questi eventi sono associati a un timestamp e ordinati per creare il flusso del processo, visualizzato e analizzato mediante il Process Mining. L'analisi della sequenza e della frequenza di queste attività rivela l'effettiva esecuzione del processo. Consente di identificare i percorsi più comuni, le deviazioni dal processo standard e i colli di bottiglia tra attività chiave come «Onboarding Initiated» e «Payroll Setup Completed». Perché è importante Questo Attributo definisce i passaggi nella mappa del processo, consentendo di visualizzare e analizzare il flusso del ciclo di vita del dipendente. Dove reperirlo Generalmente deriva dagli Event Log, dalle variazioni dello stato del Workflow o da specifici campi data presenti nei diversi moduli di UKG Pro, ad esempio Recruiting, Onboarding e Performance Management. Di norma è necessaria una logica di mappatura per generare nomi standardizzati delle attività. Esempi Dipendente assuntoValutazione delle performance svoltaConclusione del rapporto di lavoro avviata
	Sistema di origine SourceSystem	Identifica il sistema dal quale sono stati estratti i dati, che in questo caso è UKG Pro.
Descrizione Questo Attributo specifica l'origine dei dati di processo. Sebbene in questo contesto si tratti principalmente di UKG Pro, un processo Hire to Retire può includere dati provenienti da altri sistemi, come un Applicant Tracking System (ATS) o un sistema di gestione dell'apprendimento (LMS). Nell'analisi, consente di distinguere le fonti dei dati quando sono coinvolti più sistemi ed è fondamentale per la governance dei dati e la risoluzione dei problemi. In una vista basata su un'unica fonte, fornisce il contesto essenziale sull'origine dei dati. Perché è importante Fornisce un contesto essenziale per la governance dei dati, il controllo della qualità e la tracciabilità, identificando l'origine dei dati degli eventi. Dove reperirlo Generalmente è un valore statico («UKG Pro») aggiunto durante il processo di trasformazione ed estrazione dei dati. Esempi UKG ProUKGPro_CoreHRUKG
	Ultimo aggiornamento dei dati LastDataUpdate	Il timestamp che indica quando i dati relativi a questo evento sono stati aggiornati o estratti per l'ultima volta dal sistema di origine.
Descrizione Questo Attributo fornisce il timestamp dell'ultima estrazione dei dati da UKG Pro. Non indica il momento in cui si è verificato l'evento aziendale, bensì quando il record è stato acquisito nello strumento di Process Mining. Questa informazione è fondamentale per comprendere l'aggiornamento dei dati analizzati. Consente ad analisti e utenti aziendali di sapere quanto è attuale la vista del processo, oltre a supportare la gestione delle pianificazioni di aggiornamento dei dati e la verifica della recenza degli insight. Perché è importante Indica l'aggiornamento dei dati, un elemento essenziale per considerare affidabile l'analisi e prendere decisioni aziendali tempestive. Dove reperirlo Questo timestamp viene generato e aggiunto a ogni record durante il processo di estrazione, trasformazione e caricamento dei dati (ETL). Esempi 2024-03-15T02:00:00Z2024-03-16T02:00:00Z2024-03-17T02:00:00Z
	Data di assunzione HireDate	La data ufficiale di inizio del rapporto di lavoro del dipendente con l'organizzazione.
Descrizione La Hire Date segna l'inizio dell'anzianità del dipendente. È un campo data fondamentale che costituisce la base per numerosi calcoli e analisi temporali relativi al ciclo di vita del dipendente. Questo Attributo viene utilizzato per calcolare l'anzianità aziendale, fondamentale per analizzare l'«Early Employee Churn Rate». Supporta inoltre l'analisi per coorti, consentendo di confrontare i modelli del ciclo di vita dei dipendenti assunti in periodi diversi. Perché è importante Costituisce la base per calcolare l'anzianità aziendale ed è essenziale per l'analisi per coorti e per i KPI relativi al tasso di turnover. Dove reperirlo È un campo standard obbligatorio del record principale del dipendente nel modulo Core HR di UKG Pro. Esempi 2022-08-152023-01-202021-05-10
	ID della richiesta di assunzione JobRequisitionId	L'identificativo univoco della richiesta di assunzione che ha avviato il processo di recruiting.
Descrizione Il Job Requisition ID è il riferimento univoco a una specifica posizione aperta. Collega tutte le attività iniziali di recruiting, dalla creazione e approvazione fino alla ricerca dei candidati e alla presentazione delle offerte. Questo ID è essenziale per analizzare il KPI «Recruitment Cycle Time», poiché identifica l'effettivo inizio del processo di assunzione. Consente di monitorare l'intero funnel relativo a una singola posizione aperta e di analizzare metriche come «Inactive Job Requisition Rate», identificando le richieste che non avanzano. Perché è importante Fornisce un punto di partenza chiaro per il processo di recruiting, consentendo di misurare con precisione i tempi del ciclo di assunzione e l'efficacia delle richieste. Dove reperirlo Si trova nel modulo Recruiting di UKG Pro o nell'Applicant Tracking System (ATS) collegato. Esempi REQ-2023-015REQ-2024-112REQ-2023-504
	Nome del manager ManagerName	Il nome del manager diretto o del supervisore del dipendente.
Descrizione Questo Attributo identifica il manager diretto del dipendente. Il manager svolge un ruolo fondamentale in numerosi eventi del ciclo di vita, tra cui valutazioni delle prestazioni, promozioni e assegnazioni formative. L'analisi per manager aiuta a comprendere le differenze nell'esecuzione a livello di team e l'efficacia dei manager. Ad esempio, la Dashboard «Manager Transition Impact Analysis» utilizza questo Attributo per valutare in che modo un cambio di manager influisce sulle attività successive. È inoltre fondamentale per il KPI «Time to Managerial Re-engagement». Perché è importante Consente di analizzare le prestazioni del processo a livello di team e aiuta a valutare l'impatto dei manager sugli eventi del ciclo di vita dei dipendenti. Dove reperirlo Questa informazione fa parte dei dati relativi alla struttura gerarchica del dipendente nel modulo Core HR di UKG Pro. Esempi John SmithMaria GarciaChen Wei
	Qualifica professionale JobTitle	La qualifica professionale ufficiale del dipendente, ad esempio «Software Engineer» o «Sales Manager».
Descrizione La Job Title descrive il ruolo o la posizione del dipendente all'interno dell'organizzazione. Questo Attributo è una dimensione fondamentale per analizzare le differenze dei processi tra ruoli e livelli di seniority diversi. Nell'analisi, la Job Title può essere utilizzata per confrontare i tempi di onboarding di ruoli diversi, valutare la velocità delle promozioni o identificare le qualifiche professionali associate a tassi più elevati di turnover iniziale. Ciò consente di adattare i processi HR e i programmi di supporto alle esigenze specifiche dei diversi gruppi di dipendenti. Perché è importante Consente un'analisi basata sul ruolo per comprendere come i processi del ciclo di vita variano tra funzioni professionali e livelli di seniority diversi. Dove reperirlo È un campo standard associato al record della posizione o del ruolo del dipendente nel modulo Core HR di UKG Pro. Esempi Ingegnere software di livello IIProduct Manager seniorHR Business Partner
	Reparto EmployeeDepartment	Il reparto o l'unità organizzativa a cui è assegnato il dipendente.
Descrizione Questo Attributo contiene il nome del reparto assegnato al dipendente, ad esempio «Sales», «Engineering» o «Finance». È una dimensione organizzativa fondamentale per segmentare e confrontare le prestazioni del processo. L'analisi per reparto consente di confrontare l'esecuzione del processo tra diverse unità aziendali. È possibile, ad esempio, verificare se il «Recruitment Cycle Time» è più lungo nei reparti tecnici o se il «Performance Review Adherence» varia significativamente tra Sales e Operations, ottenendo insight mirati per il miglioramento. Perché è importante Consente un'analisi comparativa approfondita, permettendoLe di filtrare e segmentare il processo in base alla struttura organizzativa e di evidenziare le differenze tra reparti. Dove reperirlo È un campo standard del record relativo al ruolo o alla posizione del dipendente nel modulo Core HR di UKG Pro. Esempi IngegneriaVenditeRisorse umane
	Stato occupazionale EmploymentStatus	Lo stato occupazionale attuale o storico del dipendente, ad esempio «Active», «Terminated» o «On Leave».
Descrizione Questo Attributo indica lo stato ufficiale del dipendente all'interno dell'azienda in un determinato momento. È una dimensione fondamentale per comprendere lo stato complessivo della forza lavoro e filtrare l'analisi su specifiche popolazioni di dipendenti. L'analisi delle variazioni dello stato occupazionale aiuta a modellare correttamente il processo, distinguendo, ad esempio, tra un'assenza temporanea e una cessazione definitiva. È fondamentale per calcolare i tassi di turnover e comprendere gli esiti dei diversi percorsi del ciclo di vita. Perché è importante Fornisce il contesto essenziale sulla posizione del dipendente, consentendo un'analisi accurata del turnover e la segmentazione della forza lavoro. Dove reperirlo È un campo fondamentale del record anagrafico principale del dipendente nel modulo Core HR di UKG Pro. Esempi AttivoCessatoCongedo
	Utente che esegue l'azione ActioningUser	Il nome o l'ID dell'utente, generalmente un rappresentante HR o un manager, che ha eseguito l'attività in UKG Pro.
Descrizione Questo Attributo identifica la persona responsabile dell'esecuzione di uno specifico passaggio del processo, ad esempio il recruiter che ha presentato un'offerta o il manager che ha approvato una promozione. Collega le attività del processo agli attori umani. Nell'analisi, questo Attributo è prezioso per comprendere la distribuzione del carico di lavoro, identificare le esigenze formative e analizzare le prestazioni dei singoli utenti. Può, ad esempio, aiutare a individuare se gli errori di inserimento dati successivi a «Payroll Setup Completed» sono concentrati su determinati utenti, fornendo supporto al KPI «Post-Onboarding Data Rework Rate». Perché è importante Collega le attività del processo a utenti specifici, consentendo di analizzare il carico di lavoro, confrontare le prestazioni e indagare rilavorazioni o errori. Dove reperirlo Generalmente si trova nei log della cronologia di audit o nei campi «Last Modified By» dei moduli di UKG Pro. Il nome esatto del campo varia a seconda del modulo. Esempi j.does.smithhr_admin
	Data di cessazione TerminationDate	La data ufficiale di conclusione del rapporto di lavoro del dipendente.
Descrizione La Termination Date segna la conclusione dell'anzianità del dipendente. Rappresenta il punto finale del ciclo di vita del dipendente all'interno dell'organizzazione. Questo Attributo è necessario per calcolare l'anzianità complessiva del dipendente ed è un componente fondamentale dell'analisi del turnover. Il periodo compreso tra Hire Date e Termination Date costituisce la base della Dashboard «Early Tenure Churn Insights» e dei KPI correlati. Perché è importante Definisce la fine del ciclo di vita del dipendente, consentendo di calcolare l'anzianità complessiva e supportando tutte le analisi relative all'attrition. Dove reperirlo È un campo standard del record principale del dipendente in UKG Pro, valorizzato al completamento del processo di cessazione. Esempi 2023-11-302024-02-152022-12-31
	È turnover iniziale IsEarlyChurn	Un flag booleano che indica se la cessazione del rapporto di lavoro è avvenuta entro un periodo iniziale predefinito, ad esempio 90 o 180 giorni.
Descrizione Questo Attributo calcolato identifica i dipendenti che lasciano l'organizzazione poco dopo l'assunzione. La soglia che definisce il periodo «iniziale» viene generalmente stabilita dall'azienda, ad esempio entro il primo anno. Questo flag semplifica l'analisi necessaria per la Dashboard «Early Tenure Churn Insights» e per il KPI «Early Employee Churn Rate». Consente di filtrare e segmentare rapidamente questo gruppo di particolare interesse e di analizzarne caratteristiche e percorsi del ciclo di vita, contribuendo a individuare problemi nel recruiting o nell'onboarding. Perché è importante Supporta direttamente l'analisi del turnover iniziale, segnalando i casi a rischio e aiutando a identificare le cause alla radice delle uscite premature dei dipendenti. Dove reperirlo Questo Attributo viene calcolato durante la preparazione dei dati. La logica confronta la differenza tra «TerminationDate» e «HireDate» con una soglia predefinita, ad esempio 365 giorni. Esempi truefalse
	Fascia retributiva SalaryGrade	La fascia o il livello retributivo associato al ruolo del dipendente.
Descrizione La Salary Grade rappresenta il livello retributivo di una determinata posizione. È un Attributo fondamentale per analizzare le attività e le tendenze relative alla retribuzione. Questo Attributo è importante per analisi come gli eventi «Compensation Changed» e può essere utilizzato per monitorare il KPI «Post-Onboarding Data Rework Rate» qualora si osservino correzioni frequenti delle fasce retributive. Consente inoltre di segmentare il processo per verificare se i tempi del ciclo di promozione o i tassi di turnover variano in base al livello retributivo. Perché è importante Fornisce il contesto per le attività relative alla retribuzione e consente di segmentare il processo in base al livello retributivo. Dove reperirlo È disponibile nel profilo retributivo o professionale del dipendente, nel modulo Core HR di UKG Pro. Esempi IC3M2D1
	Motivo del cambio di ruolo RoleChangeReason	Il motivo del cambiamento di ruolo del dipendente, ad esempio «Promotion», «Lateral Transfer» o «Reorganization».
Descrizione Questo Attributo fornisce il contesto per gli eventi di mobilità interna. Spiega perché il ruolo o la posizione del dipendente è cambiato all'interno dell'organizzazione. È essenziale per la Dashboard e il KPI «Internal Mobility Cycle Time», poiché consente di distinguere tra promozioni e altri tipi di trasferimento. L'analisi del processo per motivo può evidenziare se i processi di promozione sono più lenti dei trasferimenti laterali, contribuendo a semplificare i percorsi di sviluppo professionale. Perché è importante Spiega il contesto dei movimenti interni e consente un'analisi più approfondita dei processi di mobilità interna, come le promozioni rispetto ai trasferimenti laterali. Dove reperirlo Questa informazione viene generalmente acquisita nell'ambito della transazione di cambio ruolo o trasferimento nel modulo Core HR di UKG Pro. Esempi PromozioneTrasferimento lateraleRiorganizzazione
	Motivo della cessazione TerminationReason	Il motivo documentato della cessazione del rapporto di lavoro, ad esempio «Voluntary - Resignation» o «Involuntary - Performance».
Descrizione Questo Attributo registra il motivo per cui il rapporto di lavoro del dipendente è stato cessato. I motivi sono generalmente classificati come volontari o involontari, con ulteriori sottocategorie specifiche. È un Attributo fondamentale per l'analisi della retention e del turnover. Segmentando i dipendenti cessati in base al motivo dell'uscita, le organizzazioni possono ottenere insight approfonditi sulle cause alla radice dell'attrition. Ad esempio, l'analisi dell'«Early Employee Churn Rate» per motivo della cessazione può distinguere tra decisioni di assunzione inadeguate e offerte della concorrenza. Perché è importante Fornisce insight fondamentali sui fattori che determinano il turnover dei dipendenti, consentendo di definire strategie di retention mirate. Dove reperirlo Generalmente viene registrato durante il processo di cessazione o offboarding nel modulo Core HR di UKG Pro. Esempi Volontario, un'altra opportunitàInvolontario - PrestazioniPensionamento
	Nome della formazione TrainingName	Il nome o il titolo del corso di formazione assegnato al dipendente.
Descrizione Questo Attributo identifica uno specifico corso di formazione o modulo di apprendimento assegnato a un dipendente. Può trattarsi di una formazione obbligatoria sulla conformità o dello sviluppo di competenze specifiche per il ruolo. È un Attributo fondamentale per la Dashboard «Training Assignment & Completion» e per il KPI «Training Completion Rate». Consente di monitorare l'avanzamento e l'efficacia di specifici programmi formativi e di analizzare i tempi di completamento dei diversi corsi. Perché è importante Consente di monitorare e analizzare specifici programmi formativi, aiutando a misurare la conformità e l'efficacia dello sviluppo professionale. Dove reperirlo Proviene dal modulo Learning di UKG Pro o da un Learning Management System (LMS) collegato. Esempi Codice di condotta 2024Competenze avanzate di gestioneConsapevolezza della sicurezza informatica
	Ora di fine dell'evento EventEndTime	Il timestamp che indica il completamento di un'attività con una durata misurabile.
Descrizione Per le attività non istantanee, l'ora di fine dell'evento registra il momento in cui l'attività è stata completata. Si contrappone al Timestamp dell'evento (StartTime), che indica l'inizio. La disponibilità sia dell'ora di inizio sia di quella di fine consente di calcolare con precisione il tempo di elaborazione delle singole attività, come «Background Check» o «Onboarding Task». Ciò supporta un'analisi più granulare dei punti del processo in cui viene impiegato il tempo. Perché è importante Consente di calcolare con precisione i tempi di elaborazione delle singole attività e aiuta a individuare i passaggi del processo che richiedono più tempo. Dove reperirlo Proviene dai campi relativi alla data di completamento in UKG Pro. Spesso è necessario associare un evento di inizio al corrispondente evento di completamento presente nei dati di origine. Esempi 2023-01-15T17:30:00Z2023-06-21T10:00:00Z2024-02-01T11:05:00Z
	Sede Location	La sede geografica o l'ufficio presso cui opera il dipendente.
Descrizione Questo Attributo specifica la sede di lavoro principale del dipendente, che può essere una città, un Paese o uno specifico edificio. È una dimensione fondamentale per l'analisi geografica dei processi HR. L'analisi delle prestazioni del processo per sede può evidenziare differenze regionali nell'efficienza delle assunzioni, nelle pratiche di onboarding o nei tassi di turnover. È possibile, ad esempio, confrontare il «Recruitment Cycle Time» tra gli uffici di «New York» e «London» per identificare best practice o colli di bottiglia locali. Perché è importante Consente di segmentare geograficamente il processo, evidenziando le variazioni regionali nelle prestazioni e nella conformità. Dove reperirlo Questa informazione fa parte dei dati professionali o personali del dipendente nel modulo Core HR di UKG Pro. Esempi New York, NYLondra, Regno UnitoDa remoto
	Valutazione delle prestazioni PerformanceRating	La valutazione assegnata a un dipendente durante un ciclo di valutazione delle prestazioni.
Descrizione La Performance Rating è l'esito dell'attività «Performance Review Conducted», generalmente espresso su una scala, ad esempio da 1 a 5, oppure mediante etichette descrittive, come «Exceeds Expectations». Quantifica la valutazione delle prestazioni del dipendente. Questo Attributo è utile per correlare gli eventi del processo agli esiti delle prestazioni. L'analisi può, ad esempio, verificare se i dipendenti con prestazioni elevate vengono promossi più rapidamente o se esiste un legame tra le valutazioni delle prestazioni e il turnover. È centrale per la Dashboard «Performance Review Cycle Compliance». Perché è importante Collega gli eventi del processo agli esiti delle prestazioni, consentendo di analizzare l'efficacia della gestione dei talenti e il relativo impatto sulla retention. Dove reperirlo Si trova nel modulo Performance Management di UKG Pro, collegato a specifici cicli di valutazione. Esempi Supera le aspettativeSoddisfa le aspettativeNecessita di miglioramento5

Obbligatorio Consigliato Facoltativo

Hire to Retire - Attività del ciclo di vita del dipendente

Questi sono i principali passaggi e traguardi del processo da acquisire nell’Event Log per una corretta individuazione del processo e l’ottimizzazione.

6 Consigliato 9 Facoltativo

	Attività	Descrizione
	Conclusione del rapporto di lavoro avviata	Rappresenta l’avvio del processo di uscita, registrato quando nel sistema viene inserita una futura data di cessazione. Questo evento attiva checklist e Workflow per la conclusione del rapporto di lavoro.
Perché è importante Si tratta di una milestone fondamentale che dà inizio al processo di uscita del dipendente. Analizzare il tempo tra questo evento e la cessazione definitiva aiuta a valutare l’efficienza e la completezza delle procedure di uscita. Dove reperirlo In genere corrisponde alla creazione di un record dell’azione «Termination» nei dati lavorativi del dipendente, con una futura data di decorrenza. Può anche coincidere con l’avvio di un Workflow di uscita in un modulo specifico. Acquisizione Acquisito quando viene inviata una transazione di cessazione con data futura. Tipo di evento explicit
	Dipendente assunto	Indica la creazione ufficiale del record del dipendente in UKG Pro, con l’assegnazione formale di un Employee ID. Questo evento viene generalmente registrato quando un amministratore HR completa il processo di assunzione di un candidato, trasformandolo in un dipendente attivo nel sistema.
Perché è importante Questo è l’evento iniziale definitivo per l’analisi del processo Hire to Retire. Fornisce il punto di riferimento per misurare il tempo necessario a raggiungere la produttività, l’efficienza dell’onboarding e la durata complessiva della permanenza del dipendente. Dove reperirlo L’evento viene probabilmente registrato nel modulo HR Core o Personnel Administration. Può essere identificato dalla data di creazione del record principale di impiego del dipendente o da uno specifico record dell’azione «Hire» nella cronologia dei dati lavorativi. Acquisizione Acquisito dalla data di decorrenza dell’azione «Hire» nella tabella della cronologia lavorativa del dipendente. Tipo di evento explicit
	Dipendente cessato	L’evento finale del ciclo di vita del dipendente, che rappresenta la conclusione ufficiale del rapporto di lavoro. Si verifica quando il record del dipendente diventa inattivo nel sistema, a partire dalla data di decorrenza della cessazione.
Perché è importante Questo è l’evento finale definitivo del processo, fondamentale per calcolare l’anzianità complessiva del dipendente e analizzare il turnover. Chiude il percorso del dipendente all’interno dell’azienda. Dove reperirlo Corrisponde alla data di decorrenza dell’azione finale «Termination» nella cronologia dei dati lavorativi del dipendente, all’interno del modulo HR Core. In genere, in questa data il sistema modifica lo stato del dipendente da attivo a inattivo. Acquisizione Acquisito dalla data di decorrenza dell’azione «Termination» nella cronologia lavorativa del dipendente. Tipo di evento explicit
	Onboarding del dipendente completato	Una milestone fondamentale che indica il completamento con successo della checklist o del Workflow iniziale di onboarding. In genere significa che tutti i documenti richiesti al nuovo assunto, le richieste di accesso ai sistemi e le attività amministrative iniziali sono stati completati.
Perché è importante Segna la conclusione della configurazione amministrativa iniziale e consente di analizzare la durata complessiva del ciclo di onboarding. Indica il momento in cui il dipendente è pronto, dal punto di vista amministrativo, a iniziare le attività specifiche del ruolo. Dove reperirlo Si trova nel modulo Onboarding. In genere viene dedotto dal timestamp di completamento del Workflow complessivo di onboarding o dal momento in cui l’ultima attività obbligatoria di onboarding viene contrassegnata come completata. Acquisizione Dedotto dal timestamp di completamento della checklist principale di onboarding del dipendente. Tipo di evento inferred
	Promozione approvata	Indica l’approvazione formale della promozione di un dipendente, che generalmente comprende una modifica del titolo professionale e spesso della retribuzione. Si tratta di un evento distinto, precedente alla data di decorrenza della modifica.
Perché è importante Questa attività è fondamentale per analizzare la mobilità interna e la progressione professionale. Il tempo tra l’approvazione della promozione e la sua data di decorrenza può evidenziare colli di bottiglia amministrativi nel sistema. Dove reperirlo Registrato come specifica azione lavorativa, ad esempio «Promotion», nella cronologia dei dati lavorativi del dipendente all’interno del modulo HR Core. Il record avrà date proprie di approvazione e decorrenza. Acquisizione Acquisito dalla data di registrazione di un’azione «Promotion» nella cronologia lavorativa del dipendente. Tipo di evento explicit
	Valutazione delle performance svolta	Rappresenta il completamento di un ciclo formale di valutazione delle performance di un dipendente. L’evento viene registrato quando il modulo di valutazione viene finalizzato e inviato dal manager o dalle risorse umane.
Perché è importante Si tratta di una milestone ricorrente fondamentale nel ciclo di vita del dipendente. Monitorarne frequenza e puntualità aiuta a valutare la conformità della gestione delle performance e il suo impatto sulla progressione professionale. Dove reperirlo Si trova nel modulo Performance Management di UKG Pro. Può essere identificato dalla data di completamento del modulo di valutazione delle performance o da una modifica dello stato del ciclo di valutazione a «Completed». Acquisizione Acquisito dal timestamp di completamento dell’istanza del Workflow di valutazione delle performance. Tipo di evento explicit
	Colloquio di uscita svolto	Questo evento segna il completamento del colloquio di uscita con il dipendente in partenza. In genere viene registrato come attività completata in una checklist di uscita.
Perché è importante Monitorare il completamento dei colloqui di uscita è importante per garantire la conformità HR e raccogliere feedback preziosi. Aiuta a individuare se questo passaggio fondamentale viene saltato nel processo di uscita. Dove reperirlo L’evento si troverebbe probabilmente nel modulo Onboarding o HR Help Desk di UKG Pro, come attività specifica all’interno di un Workflow di uscita. La sua registrazione dipende dal fatto che le risorse umane contrassegnino manualmente l’attività come completata. Acquisizione Registrato come attività completata nella checklist di uscita del dipendente. Tipo di evento explicit
	Configurazione delle paghe completata	Indica che tutte le informazioni necessarie per elaborare la retribuzione del dipendente, come le coordinate bancarie e i moduli fiscali, sono state inserite e verificate. Si tratta di un passaggio fondamentale per garantire che il dipendente venga pagato correttamente e puntualmente.
Perché è importante Questa milestone è fondamentale per misurare la preparazione dei nuovi assunti. I ritardi nella configurazione delle paghe possono causare insoddisfazione nei dipendenti e rilavorazioni amministrative, rendendo questo passaggio un KPI importante dell’onboarding. Dove reperirlo L’evento può essere dedotto dal modulo Payroll di UKG Pro. Può derivare dalla data di completamento di una checklist di preparazione delle paghe o dalla data in cui lo stato del dipendente passa a «Ready for Payroll». Acquisizione Derivato da una modifica dello stato o dal timestamp di completamento nel profilo Payroll del dipendente. Tipo di evento inferred
	Congedo iniziato	Segna l’inizio di un congedo approvato del dipendente, ad esempio per motivi medici o personali. Viene registrato quando lo stato del dipendente passa a inattivo o in congedo.
Perché è importante Identifica i periodi di inattività nel ciclo di vita del dipendente. È fondamentale per calcolare con precisione l’anzianità attiva e comprendere l’impatto del congedo sulla progressione professionale. Dove reperirlo Si trova nella cronologia dei dati lavorativi del dipendente, all’interno del modulo HR Core. Corrisponde a un’azione lavorativa come «Leave of Absence», con una specifica data di inizio effettiva. Acquisizione Acquisito dalla data di decorrenza di un’azione «Start Leave» nella cronologia lavorativa. Tipo di evento explicit
	Formazione assegnata	Registra il momento in cui uno specifico corso di formazione o piano di apprendimento viene assegnato a un dipendente. Di norma viene registrato nel modulo di gestione dell’apprendimento del sistema.
Perché è importante Questa attività aiuta a monitorare la conformità alla formazione obbligatoria e lo sviluppo dei dipendenti. Analizzare il tempo tra assegnazione e completamento può evidenziare problemi di partecipazione o di efficacia della formazione. Dove reperirlo Registrato nei moduli di gestione dell’apprendimento o dei talenti di UKG Pro. Ogni assegnazione dovrebbe avere un record corrispondente con data di assegnazione ed Employee ID. Acquisizione Registrato quando un corso o un curriculum viene assegnato al piano di apprendimento di un dipendente. Tipo di evento explicit
	Manager cambiato	Questo evento viene generato quando il campo «Reports To» o «Manager ID» di un dipendente viene aggiornato. Rappresenta una modifica della linea gerarchica diretta del dipendente.
Perché è importante I cambi di manager possono incidere significativamente sul coinvolgimento e sulle performance dei dipendenti. Monitorare questo evento consente di analizzarne l’effetto su attività successive, come le valutazioni delle performance o la retention. Dove reperirlo Questo evento deve essere dedotto monitorando nel tempo le modifiche al campo del manager o del supervisore nei dati lavorativi del dipendente. È necessario confrontare il Manager ID tra record consecutivi dello stesso dipendente. Acquisizione Dedotto rilevando una modifica nel campo «Reports To» della cronologia dei dati lavorativi del dipendente. Tipo di evento inferred
	Onboarding avviato	Rappresenta l’avvio del processo o Workflow di onboarding del nuovo assunto in UKG Pro. Si tratta generalmente di un evento attivato automaticamente o manualmente, che assegna una checklist di attività al nuovo dipendente, al manager e alle risorse umane.
Perché è importante Il monitoraggio di questa attività aiuta a misurare il tempo che intercorre tra la data ufficiale di assunzione e l’avvio dell’integrazione amministrativa e culturale. Costituisce il punto di partenza per analizzare l’efficienza del processo di onboarding e individuare i ritardi. Dove reperirlo Si trova nel modulo Onboarding di UKG Pro. L’evento può essere dedotto dalla data di creazione della checklist di onboarding o dell’istanza di Workflow associata al dipendente. Acquisizione Dedotto dal timestamp di creazione del Workflow di onboarding o dell’elenco di attività del dipendente. Tipo di evento inferred
	Processo di cambio ruolo elaborato	Rappresenta una modifica al lavoro o alla posizione del dipendente che non costituisce una promozione, come un trasferimento laterale o il passaggio a un altro reparto. Viene registrato quando i dati lavorativi pertinenti vengono aggiornati nel sistema.
Perché è importante Analizzare i cambi di ruolo offre insight sulla mobilità interna, sull’impiego dei talenti e sulla riorganizzazione aziendale. Aiuta a comprendere come i dipendenti si spostano all’interno dell’organizzazione. Dove reperirlo Acquisito dalla cronologia dei dati lavorativi del dipendente nel modulo HR Core. Può essere identificato da azioni lavorative come «Transfer», «Re-assignment» o «Position Change», insieme alle relative date di decorrenza. Acquisizione Identificato da un codice azione «Transfer» o simile nei dati della cronologia lavorativa del dipendente. Tipo di evento explicit
	Processo di uscita completato	Una milestone che indica il completamento di tutte le attività obbligatorie di uscita. Comprende attività come la restituzione dei beni aziendali, i calcoli finali delle paghe e la revoca degli accessi ai sistemi.
Perché è importante Questo evento conferma che sono stati completati tutti i passaggi necessari per concludere il rapporto con il dipendente in modo sicuro e conforme. Aiuta a misurare la durata del ciclo di uscita e a individuare le lacune di conformità. Dove reperirlo Viene dedotto dal timestamp di completamento della checklist o del Workflow complessivo di uscita, in modo analogo all’evento «Employee Onboarded», ma per il processo di uscita. Acquisizione Dedotto dal timestamp di completamento della checklist principale di uscita del dipendente. Tipo di evento inferred
	Retribuzione modificata	Questo evento registra qualsiasi modifica allo stipendio base, alla struttura dei bonus o ad altri componenti della retribuzione del dipendente. Può essere associato a una promozione, a un aumento meritocratico o a un adeguamento di mercato.
Perché è importante Monitorare le modifiche retributive è fondamentale per comprendere la progressione professionale ed economica. Adeguamenti frequenti dopo l’assunzione potrebbero indicare errori di inserimento dei dati o problemi nella definizione dello stipendio iniziale. Dove reperirlo Si trova nella tabella della cronologia retributiva del dipendente, all’interno del modulo HR Core o Payroll. Ogni modifica viene generalmente registrata con una data di decorrenza e un codice causale. Acquisizione Registrato a partire dalla data di decorrenza di una nuova voce nel record della cronologia retributiva del dipendente. Tipo di evento explicit

Consigliato Facoltativo

Guide all'estrazione

Come ottenere i Suoi dati da UKG Pro

Passaggi

Prerequisiti: verifichi di disporre di Python 3.6 o versione successiva e che siano installate le librerie requests e pandas. Può installarle con pip: pip install requests pandas.
Accesso e autenticazione API: contatti l'amministratore di UKG Pro per creare un Service Account. Le serviranno API Key, User Name e Password. Il Service Account deve disporre delle autorizzazioni per accedere a tutti gli endpoint API richiesti, inclusi i dati relativi a personale, payroll, onboarding, performance e learning.
Configuri lo script: apra lo script Python fornito in un editor di testo o in un IDE. Individui la sezione di configurazione all'inizio dello script e sostituisca i valori segnaposto di UKG_BASE_URL, API_KEY, USERNAME, PASSWORD e COMPANY_ID con le credenziali e i dati del Suo ambiente.
Imposti l'intervallo di date per l'estrazione: nella sezione di configurazione definisca le variabili START_DATE e END_DATE. Queste determinano il periodo per il quale verranno estratti modifiche ed eventi relativi ai dipendenti. Per testare lo script, si consiglia di iniziare con un intervallo più breve, ad esempio 3-6 mesi.
Esegua lo script: esegua lo script dalla riga di comando utilizzando python your_script_name.py. Lo script eseguirà l'autenticazione, recupererà i dati dai diversi endpoint API di UKG Pro per ciascuna attività e mostrerà gli aggiornamenti sull'avanzamento nella console.
Gestisca il throttling delle API: lo script include una pausa di base time.sleep() per rispettare i limiti di frequenza delle API. Se riscontra errori di throttling, HTTP 429, potrebbe dover aumentare la durata della pausa tra le chiamate API.
Trasformi e standardizzi i dati: ogni funzione dello script è progettata per recuperare i dati grezzi di una specifica attività, selezionare i campi pertinenti e rinominarli secondo il formato standard dell'Event Log, ad esempio EmployeeId, ActivityName ed EventTimestamp.
Combini i dati degli eventi: la parte principale dello script richiama ciascuna funzione specifica per attività e aggiunge i dati risultanti a un unico elenco principale di eventi.
Generi l'Event Log: dopo aver elaborato tutte le attività, lo script consolida i dati in un DataFrame pandas, li ordina per ID dipendente e timestamp e li salva in un file CSV denominato ukg_hire_to_retire_event_log.csv.
Verifichi e carichi il file: apra il CSV generato per verificare che i dati siano completi e formattati correttamente. Il file è ora pronto per essere caricato nello strumento di Process Mining.

Configurazione

Credenziali di autenticazione: per l'autenticazione API sono necessari una API Key, uno User Name e una Password associati a un Service Account.
URL di base: UKG_BASE_URL dell'istanza UKG Pro, ad esempio https://service[##].ultipro.com/api.
Company ID: per molte chiamate API è necessario il COMPANY_ID univoco della Sua organizzazione in UKG Pro.
Intervallo di date: i parametri START_DATE e END_DATE, nel formato 'YYYY-MM-DD', definiscono il periodo di estrazione. Per la prima esecuzione, si consiglia un intervallo di 3-6 mesi, così da gestire il volume dei dati e verificare i risultati.
Versioni degli endpoint API: lo script utilizza versioni specifiche delle API REST, ad esempio /personnel/v1/. Verifichi che la Sua istanza UKG Pro supporti tali versioni.
Dipendenze dai moduli: l'estrazione di alcune attività richiede che la Sua organizzazione disponga delle licenze e utilizzi attivamente i moduli UKG Pro corrispondenti, come Onboarding, Learning e Performance Management. Se un modulo non è in uso, l'attività corrispondente non verrà estratta.

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

Pronto a iniziare?

Utilizzi questo Template per preparare i Suoi dati con sicurezza e ottenere informazioni essenziali sui processi HR. Inizi oggi stesso a ottimizzare il percorso Hire to Retire.

Torna alla guida al miglioramento Scarica il Template

Inizi oggi a ottimizzare il ciclo di vita dei dipendenti Hire to Retire!

Riduca del 30% il tempo di ciclo Hire to Retire e aumenti l'efficienza HR.

Inizi la prova gratuita

Non è richiesta alcuna carta di credito, configurazione rapida.

Il Suo Template dei dati per Hire to Retire - Ciclo di vita dei dipendenti

Il Suo Template dei dati per Hire to Retire - Ciclo di vita dei dipendenti

Hire to Retire - Attributi del ciclo di vita del dipendente

Hire to Retire - Attività del ciclo di vita del dipendente

Guide all'estrazione

Estrazione tramite script Python dalle API REST di UKG Pro

Passaggi

Configurazione

a Query di esempio python

Pronto a iniziare?

Inizi oggi a ottimizzare il ciclo di vita dei dipendenti Hire to Retire!

La Sua privacy è importante