> Miglioramento continuo dei processi > Dall’assunzione al pensionamento: ciclo di vita dei dipendenti > UKG Pro > Template dei dati

Il Suo template dei dati per il ciclo di vita dei dipendenti, dall’assunzione alla cessazione del rapporto di lavoro

UKG Pro

← Torna alla guida al miglioramento

Attributi del ciclo di vita dei dipendenti, dall’assunzione alla cessazione del rapporto di lavoro(21) Attività del ciclo di vita dei dipendenti, dall’assunzione alla cessazione del rapporto di lavoro(15) Guide all’estrazione(1)

Il Suo template dei dati per il ciclo di vita dei dipendenti, dall’assunzione alla cessazione del rapporto di lavoro

Questo template offre una panoramica completa degli elementi di dati essenziali per analizzare efficacemente il processo dall’assunzione alla cessazione del rapporto di lavoro. Indica gli attributi fondamentali da raccogliere, le attività principali da monitorare e fornisce indicazioni pratiche su come 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 dei dati da UKG Pro

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

Scarica il template

Attributi del ciclo di vita dei dipendenti, dall’assunzione alla cessazione del rapporto di lavoro

Questi sono i campi dati consigliati da includere nell’Event Log per analizzare in modo completo il ciclo di vita dei dipendenti, dall’assunzione alla cessazione del rapporto di lavoro, e ricavarne informazioni utili.

5 Obbligatorio 7 Consigliato 9 Facoltativo

	Nome	Descrizione
	Data e ora dell’evento EventTimestamp	La data e l’ora esatte in cui si è verificato uno specifico evento del ciclo di vita.
Descrizione La data e ora dell’evento forniscono il contesto cronologico di ogni attività e costituiscono la base del flusso del processo. Registrano il momento esatto in cui un evento, come «Offerta accettata» o «Promozione approvata», è stato inserito nel sistema. Nell’analisi, queste date e ore servono a calcolare la durata tra le attività, individuare i ritardi e misurare i tempi di ciclo di sottoprocessi fondamentali, come la selezione e l’inserimento. La precisione delle date e ore è essenziale per tutti gli indicatori basati sul tempo e per l’analisi delle prestazioni. Perché è importante Questo attributo è essenziale per ordinare gli eventi cronologicamente e calcolare tutte le metriche basate sul tempo, come i tempi di ciclo e le durate. Dove reperirli Ricavato dai campi data o data e ora associati a eventi specifici in UKG Pro, come «HireDate», «TerminationDate» o le date e ore delle modifiche di stato nei moduli dei flussi di lavoro. Esempi 2023-01-15T09:00:00Z2023-06-20T14:35:10Z2024-02-01T11:00:00Z
	ID del dipendente EmployeeId	Identificativo univoco assegnato a ogni dipendente, utilizzato come ID del caso principale per l’intero ciclo di vita nell’organizzazione.
Descrizione L’ID del dipendente è il riferimento centrale che collega tutti gli eventi che lo riguardano, dalla candidatura iniziale fino alla procedura di uscita. Questo identificativo è essenziale per ricostruire il percorso completo del singolo dipendente, dall’inizio alla fine. Nell’analisi di Process Mining, ogni attività, come «Dipendente assunto», «Promozione approvata» o «Procedura di cessazione avviata», è collegata a questo ID univoco. Ciò consente di analizzare i percorsi dei singoli dipendenti, confrontare gruppi in base agli attributi dei dipendenti e calcolare con precisione la durata delle diverse fasi del ciclo di vita. Perché è importante È l’identificativo essenziale del caso che collega tutti gli eventi relativi al dipendente e consente di analizzare per ogni persona l’intero processo, dall’assunzione all’uscita. Dove reperirli È un campo fondamentale di UKG Pro, che si trova in genere nei dati anagrafici o nel profilo del dipendente. Per conoscere la tabella e il nome del campo specifici, consulti la documentazione di UKG Pro: il campo è spesso denominato Employee Number o Person ID. Esempi 10052198345210047
	Nome dell’attività ActivityName	Nome dello specifico evento o della tappa che si è verificata nel ciclo di vita del dipendente, ad esempio «Dipendente assunto» o «Valutazione delle prestazioni svolta».
Descrizione Il nome dell’attività descrive un singolo passaggio o una singola attività del processo di gestione del ciclo di vita dei dipendenti, dall’assunzione all’uscita. Gli eventi vengono registrati con data e ora e ordinati per ricostruire il flusso del processo, che viene poi visualizzato e analizzato con il Process Mining. Analizzare la sequenza e la frequenza delle attività permette di capire come si svolge realmente il processo. Aiuta a individuare i percorsi più comuni, gli scostamenti dal processo standard e i colli di bottiglia tra attività fondamentali, come «Inserimento avviato» e «Configurazione delle retribuzioni completata». Perché è importante Questo attributo definisce i passaggi della mappa del processo e consente di visualizzare e analizzare il flusso del ciclo di vita del dipendente. Dove reperirli In genere, si ricava dagli Event Log, dalle modifiche di stato dei flussi di lavoro o da specifici campi data nei diversi moduli di UKG Pro, ad esempio Recruiting, Onboarding e Performance Management. Di solito, è necessario definire una logica di mappatura per generare nomi standardizzati delle attività. Esempi Dipendente assuntoValutazione delle prestazioni svoltaProcedura di cessazione avviata
	Sistema di origine SourceSystem	Identifica il sistema da cui sono stati estratti i dati, in questo caso UKG Pro.
Descrizione Questo attributo specifica l’origine dei dati del processo. In questo caso si tratta principalmente di UKG Pro, ma un processo di gestione del ciclo di vita dei dipendenti, dall’assunzione all’uscita, può includere dati provenienti da altri sistemi, come un sistema di tracciamento delle candidature (ATS) o un sistema di gestione dell’apprendimento (LMS). Nell’analisi, aiuta a distinguere le fonti dei dati quando sono coinvolti più sistemi ed è essenziale per la governance dei dati e la risoluzione dei problemi. Se si utilizza un’unica fonte, fornisce un contesto importante 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 reperirli In genere, è un valore statico («UKG Pro») aggiunto durante l’estrazione e la trasformazione dei dati. Esempi UKG ProUKGPro_CoreHRUKG
	Ultimo aggiornamento dei dati LastDataUpdate	Data e ora che indicano quando i dati di questo evento sono stati aggiornati o estratti per l’ultima volta dal sistema di origine.
Descrizione Questo attributo indica la data e ora dell’ultima estrazione dei dati da UKG Pro. Non corrisponde al momento in cui si è verificato l’evento aziendale, ma a quando la registrazione è stata importata nello strumento di Process Mining. Questa informazione è fondamentale per capire quanto siano aggiornati i dati analizzati. Consente ad analisti e utenti aziendali di sapere quanto è attuale la rappresentazione del processo e aiuta a gestire gli aggiornamenti dei dati e a verificare la data delle indicazioni ottenute. Perché è importante Indica quanto sono aggiornati i dati, un aspetto essenziale per poter fare affidamento sull’analisi e prendere decisioni aziendali tempestive. Dove reperirli Questa data e ora viene generata e aggiunta a ogni registrazione 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 presso l’organizzazione.
Descrizione La data di assunzione segna l’inizio del rapporto di lavoro del dipendente. È un campo data fondamentale, utilizzato come base per numerosi calcoli e analisi temporali relativi al ciclo di vita del dipendente. Questo attributo serve a calcolare l’anzianità di servizio, un dato essenziale per analizzare il «Tasso di abbandono dei dipendenti nei primi mesi». È utile anche per l’analisi per coorti, che consente di confrontare i modelli del ciclo di vita dei dipendenti assunti in periodi diversi. Perché è importante Costituisce la base per calcolare l’anzianità di servizio ed è essenziale per l’analisi per coorti e per i KPI sul tasso di abbandono. Dove reperirli È un campo standard obbligatorio nella scheda principale del dipendente nel modulo Core HR di UKG Pro. Esempi 2022-08-152023-01-202021-05-10
	ID della richiesta di assunzione JobRequisitionId	Identificativo univoco della richiesta di assunzione che ha dato avvio al processo di selezione.
Descrizione L’ID della richiesta di assunzione è il riferimento univoco a una specifica posizione aperta. Collega tutte le attività iniziali di selezione, dalla creazione e approvazione della richiesta alla ricerca dei candidati e alla presentazione delle offerte. Questo ID è essenziale per analizzare l’indicatore «Tempo di ciclo della selezione», perché segna l’effettivo inizio del processo di assunzione. Consente di monitorare l’intero percorso di selezione per una singola posizione e di analizzare metriche come il «Tasso di richieste di assunzione inattive», individuando quelle che non avanzano. Perché è importante Fornisce un punto di partenza chiaro per il processo di selezione e consente di misurare con precisione i tempi di assunzione e l’efficacia delle richieste. Dove reperirli Si trova nel modulo Recruiting di UKG Pro o nel sistema di tracciamento delle candidature (ATS) collegato. Esempi REQ-2023-015REQ-2024-112REQ-2023-504
	Nome del responsabile ManagerName	Il nome del responsabile diretto o del supervisore del dipendente.
Descrizione Questo attributo identifica il responsabile diretto del dipendente. Il responsabile svolge un ruolo fondamentale in molti eventi del ciclo di vita, tra cui le valutazioni delle prestazioni, le promozioni e l’assegnazione della formazione. L’analisi per responsabile aiuta a comprendere le differenze nell’esecuzione del lavoro a livello di team e l’efficacia dei responsabili. Ad esempio, la Dashboard «Analisi dell’impatto del cambio di responsabile» utilizza questo attributo per valutare come un cambio di responsabile influisca sulle attività successive. È inoltre essenziale per il KPI «Tempo per il nuovo coinvolgimento del responsabile». Perché è importante Consente di analizzare le prestazioni dei processi a livello di team e aiuta a valutare l’impatto dei responsabili sugli eventi del ciclo di vita dei dipendenti. Dove reperirli Queste informazioni fanno parte dei dati sulla struttura gerarchica del dipendente nel modulo Core HR di UKG Pro. Esempi John SmithMaria GarciaChen Wei
	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 «Vendite», «Ingegneria» o «Finanza». È una dimensione organizzativa fondamentale per segmentare e confrontare le prestazioni dei processi. L’analisi per reparto consente di confrontare lo svolgimento dei processi tra diverse unità aziendali. Ad esempio, permette di verificare se il «Tempo di ciclo della selezione» è più lungo nei reparti tecnici o se il «Rispetto delle scadenze delle valutazioni delle prestazioni» varia sensibilmente tra Vendite e Operations, fornendo indicazioni mirate per il miglioramento. Perché è importante Consente confronti approfonditi filtrando e segmentando il processo in base alla struttura organizzativa, così da far emergere le differenze tra i reparti. Dove reperirli È un campo standard nella registrazione del ruolo o della posizione del dipendente nel modulo Core HR di UKG Pro. Esempi IngegneriaVenditeRisorse umane
	Stato del rapporto di lavoro EmploymentStatus	Stato attuale o storico del rapporto di lavoro del dipendente, ad esempio «Attivo», «Cessato» o «In congedo».
Descrizione Questo attributo indica lo stato ufficiale del dipendente nell’organizzazione in un determinato momento. È una dimensione fondamentale per comprendere la situazione complessiva del personale e filtrare l’analisi in base a specifiche categorie di dipendenti. Analizzare le variazioni dello stato del rapporto di lavoro aiuta a rappresentare correttamente il processo, distinguendo, ad esempio, un congedo temporaneo da una cessazione definitiva. È inoltre essenziale per calcolare il turnover e comprendere gli esiti dei diversi percorsi nel ciclo di vita del dipendente. Perché è importante Fornisce il contesto essenziale sulla situazione lavorativa del dipendente e consente di analizzare con precisione il turnover e segmentare il personale. Dove reperirli È un campo fondamentale nella scheda principale del dipendente nel modulo Core HR di UKG Pro. Esempi AttivoRapporto di lavoro cessatoCongedo
	Titolo professionale JobTitle	La denominazione ufficiale della posizione del dipendente, ad esempio «Ingegnere software» o «Responsabile vendite».
Descrizione La denominazione della posizione descrive il ruolo o l’incarico del dipendente all’interno dell’organizzazione. Questo attributo è una dimensione fondamentale per analizzare le differenze tra i processi in base ai ruoli e ai livelli di anzianità. In fase di analisi, la denominazione della posizione consente di confrontare i tempi di inserimento per ruoli diversi, valutare la rapidità delle promozioni o individuare le posizioni associate a un tasso più elevato di abbandono nei primi mesi. Queste informazioni aiutano ad adattare i processi HR e i programmi di supporto alle esigenze dei diversi gruppi di dipendenti. Perché è importante Consente di analizzare i processi del ciclo di vita in base ai ruoli e ai livelli di anzianità, per capire come variano a seconda delle mansioni. Dove reperirli È un campo standard associato alla posizione o alla scheda lavorativa del dipendente nel modulo Core HR di UKG Pro. Esempi Ingegnere software IIResponsabile senior di prodottoReferente HR per le unità aziendali
	Utente che ha eseguito l’azione ActioningUser	Nome o ID dell’utente, in genere un rappresentante delle risorse umane o un responsabile, che ha svolto l’attività in UKG Pro.
Descrizione Questo attributo identifica la persona responsabile di una specifica fase del processo, ad esempio il selezionatore che ha presentato un’offerta o il responsabile che ha approvato una promozione. Collega le attività del processo alle persone che le hanno svolte. Nell’analisi, è prezioso per comprendere la distribuzione del carico di lavoro, individuare esigenze formative e analizzare le prestazioni dei singoli utenti. Ad esempio, può aiutare a capire se gli errori di inserimento dei dati dopo «Configurazione delle retribuzioni completata» si concentrano su utenti specifici, fornendo elementi utili per l’indicatore «Tasso di correzione dei dati dopo l’inserimento». Perché è importante Collega le attività del processo a utenti specifici e consente di analizzare il carico di lavoro, confrontare le prestazioni e indagare sulle correzioni o sugli errori. Dove reperirli In genere, si trova nei registri di controllo o nei campi «Ultima modifica effettuata da» dei moduli di UKG Pro. Il nome esatto del campo varia a seconda del modulo. Esempi j.does.smithhr_admin
	Abbandono nei primi mesi IsEarlyChurn	Un indicatore booleano che segnala se il rapporto di lavoro è cessato entro un periodo iniziale di servizio prestabilito, ad esempio 90 o 180 giorni.
Descrizione Questo attributo calcolato segnala i dipendenti che lasciano l’organizzazione poco dopo l’assunzione. La soglia che definisce il periodo iniziale viene in genere stabilita dall’azienda, ad esempio entro il primo anno. L’indicatore semplifica le analisi necessarie per la Dashboard «Analisi dell’abbandono nei primi anni di servizio» e per il KPI «Tasso di abbandono dei dipendenti nei primi mesi». Consente di filtrare e segmentare rapidamente i dati per isolare questo gruppo di particolare interesse e analizzarne le caratteristiche e i modelli del ciclo di vita, aiutando a individuare eventuali problemi nel reclutamento o nell’inserimento. Perché è importante Supporta direttamente l’analisi dell’abbandono nei primi mesi, segnalando i casi a rischio e aiutando a individuarne le cause profonde. Dove reperirli Questo attributo viene calcolato durante la preparazione dei dati. La logica confronta la differenza tra «TerminationDate» e «HireDate» con una soglia prestabilita, ad esempio 365 giorni. Esempi truefalse
	Data di cessazione TerminationDate	La data ufficiale di fine del rapporto di lavoro del dipendente.
Descrizione La data di cessazione segna la fine del rapporto di lavoro e conclude il ciclo di vita del dipendente all’interno dell’organizzazione. Questo attributo è necessario per calcolare l’anzianità di servizio complessiva ed è un elemento fondamentale per l’analisi del ricambio del personale. Il periodo compreso tra la data di assunzione e quella di cessazione costituisce la base della Dashboard «Analisi dell’abbandono nei primi anni di servizio» e dei KPI correlati. Perché è importante Definisce la fine del ciclo di vita del dipendente, consentendo di calcolare l’anzianità di servizio complessiva e supportando tutte le analisi relative all’abbandono. Dove reperirli È un campo standard nella scheda principale del dipendente in UKG Pro, compilato al completamento della procedura di cessazione. Esempi 2023-11-302024-02-152022-12-31
	Fascia retributiva SalaryGrade	La fascia o il livello retributivo associato al ruolo del dipendente.
Descrizione La fascia retributiva rappresenta il livello di retribuzione previsto per una determinata posizione. È un attributo fondamentale per analizzare le attività e le tendenze relative alla retribuzione. Questo attributo è utile per analisi come gli eventi «Retribuzione modificata» e può servire a monitorare il KPI «Tasso di rielaborazione dei dati dopo l’inserimento» quando si osservano frequenti correzioni delle fasce retributive. Consente inoltre di segmentare i dati per verificare se i tempi di promozione o i tassi di ricambio variano in base al livello retributivo. Perché è importante Fornisce un contesto per le attività relative alla retribuzione e consente di segmentare il processo in base al livello retributivo. Dove reperirli Disponibile nel profilo retributivo o lavorativo del dipendente nel modulo Core HR di UKG Pro. Esempi IC3M2D1
	Motivo del cambio di ruolo RoleChangeReason	Il motivo del cambio di ruolo del dipendente, ad esempio «Promozione», «Trasferimento laterale» o «Riorganizzazione».
Descrizione Questo attributo fornisce il contesto degli eventi di mobilità interna e spiega perché il ruolo o la posizione del dipendente è cambiato all’interno dell’organizzazione. È essenziale per la Dashboard e il KPI «Tempo di ciclo della mobilità interna», perché permette di distinguere le promozioni dagli altri tipi di trasferimento. Analizzare il processo in base al motivo può rivelare se le promozioni richiedono più tempo dei trasferimenti laterali e aiutare a rendere più efficienti i percorsi di sviluppo professionale. Perché è importante Spiega il contesto dei trasferimenti interni e consente un’analisi più approfondita dei processi di mobilità, ad esempio distinguendo le promozioni dai trasferimenti laterali. Dove reperirli Queste informazioni vengono in genere registrate nella transazione di cambio di 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 «Volontaria - Dimissioni» o «Involontaria - Prestazioni».
Descrizione Questo attributo registra il motivo per cui è cessato il rapporto di lavoro di un dipendente. In genere, i motivi sono classificati come volontari o involontari e suddivisi in categorie più specifiche. È un attributo fondamentale per le analisi della fidelizzazione e del ricambio del personale. Suddividendo i dipendenti che hanno lasciato l’organizzazione in base al motivo, è possibile ottenere indicazioni approfondite sulle cause profonde dell’abbandono. Ad esempio, analizzare il «Tasso di abbandono dei dipendenti nei primi mesi» per motivo di cessazione permette di distinguere tra scelte di assunzione poco efficaci e offerte più competitive. Perché è importante Fornisce indicazioni fondamentali sui fattori che determinano il ricambio del personale e consente di definire strategie mirate di fidelizzazione. Dove reperirli Questo campo viene in genere registrato durante la procedura di cessazione o di uscita dal servizio nel modulo Core HR di UKG Pro. Esempi Volontaria - Nuova opportunitàInvolontaria - PrestazioniPensionamento
	Nome del corso di 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 al dipendente. Può trattarsi di una formazione obbligatoria sulla conformità o di un corso per sviluppare competenze specifiche del ruolo. È un attributo fondamentale per la Dashboard «Assegnazione e completamento della formazione» e per il KPI «Tasso di completamento della formazione». Consente di monitorare i progressi e l’efficacia dei singoli programmi formativi e di analizzare i tempi di completamento dei diversi corsi. Perché è importante Consente di monitorare e analizzare specifici programmi di formazione, aiutando a misurare la conformità e l’efficacia dello sviluppo professionale. Dove reperirli Proviene dal modulo UKG Pro Learning o da un sistema di gestione dell’apprendimento (LMS) collegato. Esempi Codice di condotta 2024Competenze avanzate di gestioneConsapevolezza della sicurezza informatica
	Ora di fine dell’evento EventEndTime	L’indicazione temporale che segna il completamento di un’attività con una durata misurabile.
Descrizione Per le attività che non si svolgono istantaneamente, l’ora di fine dell’evento registra il momento in cui l’attività è stata completata. Si distingue dall’indicazione temporale dell’evento (StartTime), che ne segna l’inizio. La disponibilità dell’ora di inizio e di fine consente di calcolare con precisione il tempo di elaborazione delle singole attività, come «Verifica dei precedenti» o «Attività di inserimento». In questo modo è possibile analizzare più nel dettaglio come viene impiegato il tempo nelle diverse fasi del processo. Perché è importante Consente di calcolare con precisione i tempi di elaborazione delle singole attività e di individuare le fasi del processo che richiedono più tempo. Dove reperirli Proviene dai campi relativi alla data di completamento in UKG Pro. Spesso è necessario abbinare un evento di inizio al corrispondente evento di completamento nei dati di origine. Esempi 2023-01-15T17:30:00Z2023-06-21T10:00:00Z2024-02-01T11:05:00Z
	Sede Location	La località geografica o la sede in cui lavora il dipendente.
Descrizione Questo attributo indica 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 dei processi per sede può far emergere differenze regionali nell’efficienza delle assunzioni, nelle pratiche di inserimento o nei tassi di ricambio del personale. Ad esempio, è possibile confrontare il «Tempo di ciclo del reclutamento» tra le sedi di New York e Londra per individuare le pratiche più efficaci o i colli di bottiglia locali. Perché è importante Consente di segmentare geograficamente il processo, mettendo in luce le differenze regionali nelle prestazioni e nella conformità. Dove reperirli Queste informazioni fanno parte dei dati lavorativi 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 al dipendente durante un ciclo di valutazione delle prestazioni.
Descrizione La valutazione delle prestazioni è l’esito dell’attività «Valutazione delle prestazioni completata»; in genere viene espressa su una scala, ad esempio da 1 a 5, oppure con giudizi descrittivi, come «Supera le aspettative». Quantifica la valutazione delle prestazioni del dipendente. Questo attributo è utile per mettere in relazione gli eventi di processo con i risultati delle prestazioni. Ad esempio, l’analisi può verificare se i dipendenti con prestazioni elevate vengono promossi più rapidamente o se esiste un legame tra le valutazioni e il ricambio del personale. È un elemento centrale della Dashboard «Conformità del ciclo di valutazione delle prestazioni». Perché è importante Collega gli eventi di processo ai risultati delle prestazioni e consente di analizzare l’efficacia della gestione dei talenti e il suo impatto sulla fidelizzazione. Dove reperirli Disponibile nel modulo Performance Management di UKG Pro e collegata a specifici cicli di valutazione. Esempi Supera le aspettativeSoddisfa le aspettativeDa migliorare5

Obbligatorio Consigliato Facoltativo

Attività del ciclo di vita dei dipendenti, dall’assunzione alla cessazione del rapporto di lavoro

Questi sono i passaggi e le tappe fondamentali del processo da registrare nell’Event Log per individuare e ottimizzare i processi con precisione.

6 Consigliato 9 Facoltativo

	Attività	Descrizione
	Dipendente assunto	Indica la creazione ufficiale della scheda del dipendente in UKG Pro, con l’assegnazione formale di un ID dipendente. L’evento viene in genere registrato quando un amministratore HR conclude la procedura di assunzione del candidato, che diventa così un dipendente attivo nel sistema.
Perché è importante È l’evento di inizio di riferimento per l’analisi del processo di gestione del ciclo di vita dei dipendenti, dall’assunzione all’uscita. Costituisce la base di riferimento per misurare il tempo necessario per raggiungere la produttività, l’efficienza dell’inserimento e l’anzianità complessiva del dipendente. Dove reperirli L’evento è probabilmente registrato nel modulo HR Core o Amministrazione del personale. Può essere individuato tramite la data di creazione della scheda principale del rapporto di lavoro oppure tramite una specifica registrazione dell’azione «Assunzione» nella cronologia dei dati lavorativi del dipendente. Acquisizione Rilevato dalla data di decorrenza dell’azione «Assunzione» nella tabella della cronologia lavorativa del dipendente. Tipo di evento explicit
	Inserimento del dipendente completato	Tappa fondamentale che indica il completamento della lista di controllo o del flusso di lavoro iniziale per l’inserimento. In genere, significa che sono stati completati tutti i documenti richiesti al nuovo assunto, le richieste di accesso ai sistemi e le attività amministrative iniziali.
Perché è importante Segna la fine della configurazione amministrativa iniziale e consente di calcolare il tempo complessivo del ciclo di inserimento. Indica che il dipendente è pronto, dal punto di vista amministrativo, a iniziare le attività specifiche del proprio ruolo. Dove reperirli Si trova nel modulo Onboarding. In genere, l’evento viene dedotto dalla data e ora di completamento del flusso di lavoro complessivo o dal momento in cui l’ultima attività obbligatoria di inserimento viene contrassegnata come completata. Acquisizione Dedotto dalla data e ora di completamento della lista di controllo principale per l’inserimento del dipendente. Tipo di evento inferred
	Procedura di cessazione avviata	Indica l’avvio della procedura di uscita, registrato quando nel sistema viene inserita una data futura di cessazione del rapporto di lavoro. Questo evento attiva le liste di controllo e i flussi di lavoro per la procedura di uscita.
Perché è importante È una tappa fondamentale che dà inizio alla procedura di uscita del dipendente. Analizzare il tempo che intercorre tra questo evento e la cessazione definitiva aiuta a valutare l’efficienza e la completezza delle procedure di uscita. Dove reperirli In genere, corrisponde alla creazione di una registrazione dell’azione «Cessazione» nei dati lavorativi del dipendente, con una data di decorrenza futura. Può anche coincidere con l’avvio di un flusso di lavoro per la procedura di uscita in un modulo specifico. Acquisizione Rilevato quando viene inviata una transazione di cessazione con data futura. Tipo di evento explicit
	Promozione approvata	Indica l’approvazione formale della promozione di un dipendente, che comporta in genere un cambiamento del titolo professionale e spesso della retribuzione. È un evento distinto, che precede la data di decorrenza della modifica.
Perché è importante Questa attività è importante per analizzare la mobilità interna e l’avanzamento di carriera. Il tempo che intercorre tra l’approvazione della promozione e la sua decorrenza può far emergere colli di bottiglia amministrativi. Dove reperirli Registrato come azione specifica sui dati lavorativi, ad esempio «Promozione», nella cronologia del dipendente all’interno del modulo HR Core. La registrazione include le date di approvazione e di decorrenza. Acquisizione Rilevato dalla data di registrazione di un’azione «Promozione» nella cronologia lavorativa del dipendente. Tipo di evento explicit
	Rapporto di lavoro cessato	L’evento finale del ciclo di vita del dipendente, che rappresenta la conclusione ufficiale del rapporto di lavoro. In questa data, corrispondente alla decorrenza della cessazione, la scheda del dipendente diventa inattiva nel sistema.
Perché è importante È l’evento finale di riferimento per il processo, essenziale per calcolare l’anzianità definitiva del dipendente e analizzare il turnover. Conclude il percorso del dipendente nell’organizzazione. Dove reperirli Corrisponde alla data di decorrenza dell’azione finale «Cessazione» 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 Rilevato dalla data di decorrenza dell’azione «Cessazione» nella cronologia lavorativa del dipendente. Tipo di evento explicit
	Valutazione delle prestazioni svolta	Indica il completamento di un ciclo formale di valutazione delle prestazioni del dipendente. L’evento viene registrato quando il responsabile o le risorse umane finalizzano e inviano il modulo di valutazione.
Perché è importante È una tappa ricorrente fondamentale nel ciclo di vita del dipendente. Monitorarne la frequenza e il rispetto delle scadenze aiuta a valutare la conformità delle pratiche di gestione delle prestazioni e il loro impatto sull’avanzamento di carriera. Dove reperirli Si trova nel modulo Performance Management di UKG Pro. Può essere individuato tramite la data di completamento del modulo di valutazione o tramite il passaggio dello stato del ciclo di valutazione a «Completato». Acquisizione Rilevato dalla data e ora di completamento dell’istanza del flusso di lavoro di valutazione delle prestazioni. Tipo di evento explicit
	Cambio di ruolo elaborato	Indica un cambiamento nel ruolo o nella posizione del dipendente che non costituisce una promozione, come un trasferimento laterale o un passaggio a un altro reparto. L’evento viene registrato quando i dati lavorativi pertinenti vengono aggiornati nel sistema.
Perché è importante L’analisi dei cambi di ruolo offre indicazioni sulla mobilità interna, sull’assegnazione dei talenti e sulla riorganizzazione aziendale. Aiuta a capire come si spostano i dipendenti all’interno dell’organizzazione. Dove reperirli Rilevato dalla cronologia dei dati lavorativi del dipendente nel modulo HR Core. Può essere individuato tramite azioni come «Trasferimento», «Riassegnazione» o «Cambio di posizione» e le relative date di decorrenza. Acquisizione Individuato tramite un codice azione «Trasferimento» o simile nella cronologia lavorativa del dipendente. 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 nella lista di controllo per la procedura di uscita.
Perché è importante Monitorare il completamento dei colloqui di uscita è importante per garantire la conformità delle procedure HR e raccogliere riscontri utili. Aiuta a individuare se questo passaggio fondamentale viene omesso durante la procedura di uscita. Dove reperirli L’evento si trova probabilmente nel modulo Onboarding o HR Help Desk di UKG Pro, come attività specifica all’interno di un flusso di lavoro per la procedura di uscita. La registrazione dipende dal fatto che le risorse umane contrassegnino manualmente l’attività come completata. Acquisizione Registrato come attività completata nella lista di controllo per la procedura di uscita del dipendente. Tipo di evento explicit
	Configurazione delle retribuzioni 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. È un passaggio fondamentale per garantire che il dipendente riceva la retribuzione corretta e nei tempi previsti.
Perché è importante Questa tappa è essenziale per valutare se il nuovo assunto è pronto. I ritardi nella configurazione delle retribuzioni possono causare insoddisfazione e ulteriori attività amministrative, perciò rappresentano un indicatore importante dell’efficienza dell’inserimento. Dove reperirli L’evento può essere dedotto dal modulo Payroll di UKG Pro. Può essere ricavato dalla data di completamento della lista di controllo per la preparazione delle retribuzioni o dalla data in cui lo stato del dipendente passa a «Pronto per le retribuzioni». Acquisizione Ricavato da una modifica dello stato o dalla data e ora di completamento nel profilo retributivo del dipendente. Tipo di evento inferred
	Congedo iniziato	Segna l’inizio di un congedo approvato del dipendente, ad esempio per motivi di salute o personali. Viene registrato quando lo stato del dipendente passa a inattivo o in congedo.
Perché è importante Individua i periodi di inattività nel ciclo di vita del dipendente. È essenziale per calcolare correttamente l’anzianità effettiva e comprendere l’impatto dei congedi sull’avanzamento di carriera. Dove reperirli Si trova nella cronologia dei dati lavorativi del dipendente nel modulo HR Core. Corrisponde a un’azione lavorativa come «Congedo», con una data di inizio specifica. Acquisizione Rilevato dalla data di decorrenza dell’azione «Inizio congedo» nella cronologia lavorativa. Tipo di evento explicit
	Formazione assegnata	Registra il momento in cui a un dipendente viene assegnato uno specifico corso di formazione o piano di apprendimento. Di solito, l’assegnazione viene registrata nel modulo di gestione dell’apprendimento del sistema.
Perché è importante Questa attività consente di monitorare il rispetto degli obblighi formativi e lo sviluppo dei dipendenti. Analizzare il tempo che intercorre tra l’assegnazione e il completamento può far emergere problemi di partecipazione o indicare quanto sia efficace la formazione. Dove reperirli Registrato nei moduli di gestione dell’apprendimento o dei talenti di UKG Pro. Ogni assegnazione dovrebbe avere una registrazione con la data di assegnazione e l’ID del dipendente. Acquisizione Registrato quando un corso o un programma viene assegnato al piano di apprendimento del dipendente. Tipo di evento explicit
	Inserimento avviato	Indica l’avvio del processo o del flusso di lavoro di inserimento del nuovo assunto in UKG Pro. In genere, l’evento viene attivato automaticamente o manualmente e assegna una lista di attività al nuovo dipendente, al suo responsabile e alle risorse umane.
Perché è importante Il monitoraggio di questa attività consente di misurare il tempo che intercorre tra la data ufficiale di assunzione e l’avvio dell’integrazione amministrativa e culturale. È il punto di partenza per analizzare l’efficienza del processo di inserimento e individuare eventuali ritardi. Dove reperirli Si trova nel modulo Onboarding di UKG Pro. L’evento può essere dedotto dalla data di creazione della lista di controllo o dell’istanza del flusso di lavoro associata al dipendente. Acquisizione Dedotto dalla data e ora di creazione del flusso di lavoro o della lista di attività di inserimento del dipendente. Tipo di evento inferred
	Procedura di uscita completata	Tappa che indica il completamento di tutte le attività obbligatorie della procedura di uscita, tra cui la restituzione dei beni aziendali, il calcolo della retribuzione finale e la revoca degli accessi ai sistemi.
Perché è importante Questo evento conferma che sono state completate tutte le attività necessarie per concludere il rapporto di lavoro in modo sicuro e conforme. Aiuta a misurare il tempo del ciclo di uscita e a individuare eventuali lacune di conformità. Dove reperirli L’evento può essere dedotto dalla data e ora di completamento della lista di controllo o del flusso di lavoro complessivo per la procedura di uscita, analogamente all’evento «Inserimento del dipendente completato», ma riferito alla fase di uscita. Acquisizione Dedotto dalla data e ora di completamento della lista di controllo principale per la procedura di uscita del dipendente. Tipo di evento inferred
	Responsabile modificato	L’evento viene generato quando si aggiorna il campo «Riporta a» o «ID responsabile» del dipendente. Indica un cambiamento nella linea di riporto diretto.
Perché è importante I cambi di responsabile possono incidere in modo significativo sul coinvolgimento e sulle prestazioni dei dipendenti. Monitorare questo evento consente di analizzarne gli effetti sulle attività successive, come le valutazioni delle prestazioni o la permanenza in azienda. Dove reperirli L’evento deve essere dedotto monitorando nel tempo le modifiche al campo del responsabile o del supervisore nei dati lavorativi del dipendente. A tal fine, occorre confrontare l’ID del responsabile tra registrazioni consecutive dello stesso dipendente. Acquisizione Dedotto rilevando una modifica del campo «Riporta a» nella cronologia dei dati lavorativi del dipendente. Tipo di evento inferred
	Retribuzione modificata	Questo evento registra qualsiasi modifica alla retribuzione base, ai bonus o ad altre componenti retributive del dipendente. Può derivare da una promozione, da un aumento per merito o da un adeguamento al mercato.
Perché è importante Monitorare le modifiche retributive è essenziale per comprendere l’evoluzione della carriera e dello stipendio. Modifiche frequenti dopo l’assunzione possono indicare errori di inserimento dei dati o problemi nella definizione dello stipendio iniziale. Dove reperirli Si trova nella tabella della cronologia retributiva del dipendente, nel modulo HR Core o Payroll. In genere, ogni modifica è registrata con una data di decorrenza e un codice che ne indica il motivo. Acquisizione Registrato a partire dalla data di decorrenza di una nuova voce nella cronologia retributiva del dipendente. Tipo di evento explicit

Consigliato Facoltativo

Guide all’estrazione

Come ottenere i dati da UKG Pro

Passaggi

Prerequisiti: verifichi di avere Python 3.6 o versione successiva e le librerie requests e pandas installate. Può installarle con pip: pip install requests pandas.
Accesso e autenticazione API: contatti l’amministratore di UKG Pro per creare un account di servizio. Le serviranno API Key, User Name e Password. L’account di servizio deve disporre delle autorizzazioni per accedere a tutti gli endpoint API necessari, inclusi quelli relativi a dati del personale, retribuzioni, onboarding, valutazioni e formazione.
Configuri lo script: apra lo script Python fornito in un editor di testo o in un ambiente di sviluppo integrato (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 proprio 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 cambiamenti ed eventi relativi ai dipendenti. Per verificare lo script, si consiglia di iniziare con un intervallo più breve, ad esempio da 3 a 6 mesi.
Esegua lo script: avvii lo script dalla riga di comando con 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à l’avanzamento nella console.
Gestisca i limiti delle API: lo script include una funzione time.sleep() di base per rispettare i limiti di frequenza delle API. Se si verificano errori di limitazione delle richieste (HTTP 429), potrebbe essere necessario aumentare l’intervallo di attesa 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 (EmployeeId, ActivityName, EventTimestamp e così via).
Combini i dati degli eventi: la parte principale dello script richiama la funzione specifica per ciascuna attività e aggiunge i dati risultanti a un unico elenco generale di eventi.
Generi l’Event Log: dopo aver elaborato tutte le attività, lo script riunisce i dati in un DataFrame pandas, li ordina per ID dipendente e data e ora, quindi li salva in un file CSV denominato ukg_hire_to_retire_event_log.csv.
Verifichi e carichi il file: apra il file CSV generato per verificare che i dati siano completi e formattati correttamente. Il file è pronto per essere caricato nello strumento di Process Mining.

Configurazione

Credenziali di autenticazione: per l’autenticazione API sono necessari l’API Key, lo User Name e la Password di un account di servizio.
URL di base: UKG_BASE_URL dell’istanza UKG Pro (ad esempio https://service[##].ultipro.com/api).
ID azienda: per molte chiamate API è necessario il valore univoco COMPANY_ID assegnato all’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 da 3 a 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 l’istanza UKG Pro supporti queste versioni.
Dipendenze dai moduli: per estrarre alcune attività, l’organizzazione deve avere una licenza per i moduli UKG Pro corrispondenti e utilizzarli attivamente, ad esempio Onboarding, Learning e Performance Management. Se un modulo non è in uso, l’attività corrispondente non verrà estratta.

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 dati con sicurezza e ottenere informazioni utili sui processi delle risorse umane. Inizi oggi a ottimizzare il percorso dei dipendenti, dall’assunzione alla cessazione del rapporto di lavoro.

Torna alla guida al miglioramento

Scarica il template

Inizi oggi a ottimizzare il ciclo di vita dei dipendenti, dall’assunzione alla cessazione del rapporto di lavoro.

Riduca del 30% il tempo di ciclo del processo dall’assunzione alla cessazione del rapporto di lavoro e migliori l’efficienza delle risorse umane.

Inizi la prova gratuita

Non è richiesta la carta di credito. La configurazione è rapida.

Il Suo template dei dati per il ciclo di vita dei dipendenti, dall’assunzione alla cessazione del rapporto di lavoro

Il Suo template dei dati per il ciclo di vita dei dipendenti, dall’assunzione alla cessazione del rapporto di lavoro

Attributi del ciclo di vita dei dipendenti, dall’assunzione alla cessazione del rapporto di lavoro

Attività del ciclo di vita dei dipendenti, dall’assunzione alla cessazione del rapporto di lavoro

Guide all’estrazione

Estrazione tramite script Python e API REST di UKG Pro

Passaggi

Configurazione

Query di esempio python

È pronto a iniziare?

Inizi oggi a ottimizzare il ciclo di vita dei dipendenti, dall’assunzione alla cessazione del rapporto di lavoro.