> Mejora continua de procesos > Hire to Retire Ciclo de vida de la persona empleada > UKG Pro > Template de datos

Su plantilla de datos para el ciclo de vida de la persona empleada, de la contratación a la jubilación

UKG Pro

Hire to Retire - Atributos del ciclo de vida de la persona empleada (21) Hire to Retire - Actividades del ciclo de vida de la persona empleada (15) Guías de extracción (1)

Su plantilla de datos para el ciclo de vida de la persona empleada, de la contratación a la jubilación

Esta plantilla ofrece una visión completa de los elementos de datos esenciales para analizar eficazmente su proceso de contratación a jubilación. Detalla los atributos clave que debe recopilar, las actividades principales que debe supervisar y recomendaciones prácticas para extraer estos datos de UKG Pro. Utilice este recurso para agilizar la preparación de sus datos y comenzar su recorrido de Process Mining con confianza.

Atributos recomendados para recopilar
Actividades clave que debe supervisar
Guía para extraer datos de UKG Pro

¿Es nuevo en los registros de eventos? Aprenda a crear un registro de eventos de Process Mining.

Descargar Template

Hire to Retire - Atributos del ciclo de vida de la persona empleada

Estos son los campos de datos recomendados que debe incluir en su registro de eventos para realizar un análisis completo del ciclo de vida de Hire to Retire de la persona empleada y obtener información relevante.

5 Obligatorio 7 Recomendado 9 Opcional

	Nombre	Descripción
	ID del empleado EmployeeId	El identificador único asignado a cada persona empleada, que actúa como el ID de caso principal durante todo su ciclo de vida en la organización.
Descripción El Employee ID actúa como el hilo conductor que conecta todos los eventos relacionados con una persona empleada, desde su solicitud inicial hasta la finalización de su salida de la organización. Este identificador es fundamental para construir una visión completa y de principio a fin del recorrido de cada persona. En el análisis de Process Mining, cada actividad, como «Employee Hired», «Promotion Approved» o «Termination Initiated», se vincula a este ID único. Esto permite analizar las rutas individuales de las personas empleadas, realizar análisis por cohortes basados en sus atributos y calcular con precisión la duración de los ciclos de vida. Por qué es importante Este es el identificador de caso esencial que vincula todos los eventos relacionados con las personas empleadas y permite analizar el proceso Hire to Retire completo de cada persona. Dónde obtenerlo Este es un campo principal de UKG Pro, que normalmente se encuentra en los registros del perfil del empleado o de datos maestros. Consulte la documentación de UKG Pro para conocer el nombre específico de la tabla y del campo, que a menudo aparece como Employee Number o Person ID. Ejemplos 10052198345210047
	Marca de tiempo del evento EventTimestamp	La fecha y hora exactas en que tuvo lugar un evento específico del ciclo de vida.
Descripción Event Timestamp proporciona el contexto cronológico de cada actividad y constituye la base del flujo del proceso. Registra el momento exacto en que un evento como «Offer Accepted» o «Promotion Approved» quedó registrado en el sistema. En el análisis, estas marcas de tiempo se utilizan para calcular las duraciones entre actividades, identificar retrasos y medir los tiempos de ciclo de Subprocesses clave, como la contratación y la incorporación. Las marcas de tiempo precisas son fundamentales para todos los KPI basados en el tiempo y para el análisis del rendimiento. Por qué es importante Este Atributo es esencial para ordenar cronológicamente los eventos y calcular todas las métricas basadas en el tiempo, como los tiempos de ciclo y las duraciones. Dónde obtenerlo Se obtiene de campos de fecha o de marca de tiempo asociados a eventos específicos de UKG Pro, como «HireDate», «TerminationDate» o las marcas de tiempo de cambios de estado en los módulos de Workflow. Ejemplos 2023-01-15T09:00:00Z2023-06-20T14:35:10Z2024-02-01T11:00:00Z
	Nombre de la actividad ActivityName	El nombre del evento o hito específico que tuvo lugar durante el ciclo de vida del empleado, como «Employee Hired» o «Performance Review Conducted».
Descripción Activity Name describe un único paso o Task dentro del proceso Hire to Retire. Estos eventos incluyen una marca de tiempo y se ordenan para crear el flujo del proceso que se visualiza y analiza en Process Mining. El análisis de la secuencia y la frecuencia de estas actividades revela cómo se ejecuta realmente el proceso. Ayuda a identificar las rutas más habituales, las desviaciones respecto al proceso estándar y los cuellos de botella entre actividades clave como «Onboarding Initiated» y «Payroll Setup Completed». Por qué es importante Este Atributo define los pasos del mapa de procesos y permite visualizar y analizar el flujo del ciclo de vida del empleado. Dónde obtenerlo Normalmente se obtiene de registros de eventos, cambios de estado del Workflow o campos de fecha específicos de distintos módulos de UKG Pro, como Recruiting, Onboarding y Performance Management. Por lo general, se necesita una lógica de mapeo para generar nombres de actividad estandarizados. Ejemplos Persona empleada contratadaRevisión del desempeño realizadaTerminación iniciada
	Sistema de origen SourceSystem	Identifica el sistema del que se extrajeron los datos, que en este caso es UKG Pro.
Descripción Este Atributo especifica el origen de los datos del proceso. Aunque en este contexto se trata principalmente de UKG Pro, un proceso Hire to Retire puede incluir datos de otros sistemas, como un Applicant Tracking System (ATS) o un sistema de gestión del aprendizaje (LMS). En el análisis, ayuda a diferenciar las fuentes de datos cuando intervienen varios sistemas y es fundamental para la gobernanza de datos y la resolución de problemas. En una vista de una sola fuente, proporciona un contexto esencial sobre el origen de los datos. Por qué es importante Proporciona un contexto fundamental para la gobernanza de datos, el control de calidad y la trazabilidad, ya que identifica el origen de los datos de eventos. Dónde obtenerlo Normalmente es un valor estático («UKG Pro») que se añade durante el proceso de transformación y extracción de datos. Ejemplos UKG ProUKGPro_CoreHRUKG
	Última actualización de datos LastDataUpdate	La marca de tiempo que indica cuándo se actualizaron o extrajeron por última vez los datos de este evento del sistema de origen.
Descripción Este Atributo proporciona la marca de tiempo de la última extracción de datos de UKG Pro. No indica cuándo tuvo lugar el evento de negocio, sino cuándo se incorporó el registro a la herramienta de Process Mining. Esta información es esencial para conocer la actualidad de los datos analizados. Permite a analistas y usuarios de negocio saber hasta qué punto está actualizado el proceso y ayuda a gestionar las programaciones de actualización de datos y a validar la vigencia de los insights. Por qué es importante Indica la actualidad de los datos, algo esencial para confiar en el análisis y tomar decisiones de negocio oportunas. Dónde obtenerlo Esta marca de tiempo se genera y se añade a cada registro durante el proceso de extracción, transformación y carga de datos (ETL). Ejemplos 2024-03-15T02:00:00Z2024-03-16T02:00:00Z2024-03-17T02:00:00Z
	Departamento EmployeeDepartment	El departamento o la unidad organizativa a la que está asignado el empleado.
Descripción Este Atributo contiene el nombre del departamento asignado al empleado, como «Sales», «Engineering» o «Finance». Es una dimensión organizativa clave para segmentar y comparar el rendimiento del proceso. El análisis por departamento permite comparar la ejecución del proceso entre distintas unidades de negocio. Por ejemplo, puede analizarse si el «Recruitment Cycle Time» es más largo en los departamentos técnicos o si el «Performance Review Adherence» varía significativamente entre Sales y Operations, lo que proporciona insights específicos para mejorar. Por qué es importante Permite realizar análisis comparativos avanzados al filtrar y segmentar el proceso según la estructura organizativa, revelando variaciones entre departamentos. Dónde obtenerlo Es un campo estándar del registro del puesto o cargo del empleado en el módulo Core HR de UKG Pro. Ejemplos IngenieríaVentasRecursos Humanos
	Estado laboral EmploymentStatus	El estado laboral actual o histórico del empleado, como «Active», «Terminated» o «On Leave».
Descripción Este Atributo indica el estado oficial del empleado dentro de la empresa en un momento determinado. Es una dimensión crítica para comprender el estado general de la plantilla y filtrar el análisis a poblaciones específicas de empleados. El análisis de los cambios en el estado laboral ayuda a modelar correctamente el proceso, por ejemplo, diferenciando entre una ausencia temporal y una terminación permanente. Es fundamental para calcular las tasas de rotación y comprender los resultados de las distintas rutas del ciclo de vida. Por qué es importante Proporciona un contexto esencial sobre la situación del empleado y permite analizar con precisión la rotación y segmentar la plantilla. Dónde obtenerlo Es un campo principal del registro maestro del empleado en el módulo Core HR de UKG Pro. Ejemplos ActivoDesvinculadaAusencia laboral
	Fecha de contratación HireDate	La fecha oficial de inicio de la relación laboral del empleado con la organización.
Descripción Hire Date marca el inicio de la permanencia del empleado. Es un campo de fecha fundamental que sirve como referencia para numerosos cálculos y análisis temporales relacionados con el ciclo de vida del empleado. Este Atributo se utiliza para calcular la antigüedad del empleado, un dato esencial para analizar «Early Employee Churn Rate». También facilita el análisis por cohortes, ya que permite comparar los patrones del ciclo de vida de empleados contratados en distintos periodos. Por qué es importante Sirve como referencia para calcular la antigüedad del empleado y es esencial para el análisis por cohortes y los KPI de rotación. Dónde obtenerlo Es un campo estándar y obligatorio del registro principal del empleado en el módulo Core HR de UKG Pro. Ejemplos 2022-08-152023-01-202021-05-10
	ID de la solicitud de empleo JobRequisitionId	El identificador único de la solicitud de empleo que inició el proceso de contratación.
Descripción Job Requisition ID es la referencia única de una vacante concreta. Vincula todas las actividades iniciales de contratación, desde la creación y aprobación hasta la búsqueda de candidatos y el envío de ofertas. Este ID es esencial para analizar el KPI «Recruitment Cycle Time», ya que marca el inicio real del proceso de contratación. Permite seguir todo el embudo de una vacante y analizar métricas como «Inactive Job Requisition Rate» mediante la identificación de solicitudes que no avanzan. Por qué es importante Proporciona un punto de inicio claro para el proceso de contratación y permite medir con precisión los tiempos del ciclo de contratación y la eficacia de las solicitudes. Dónde obtenerlo Se encuentra en el módulo Recruiting de UKG Pro o en el Applicant Tracking System (ATS) conectado. Ejemplos REQ-2023-015REQ-2024-112REQ-2023-504
	Nombre del gerente ManagerName	El nombre del gerente directo o supervisor del empleado.
Descripción Este Atributo identifica al gerente directo del empleado. El gerente desempeña un papel fundamental en muchos eventos del ciclo de vida, como las evaluaciones de desempeño, las promociones y las asignaciones de formación. El análisis por gerente ayuda a comprender las variaciones en la ejecución a nivel de equipo y la eficacia de los gerentes. Por ejemplo, el Dashboard «Manager Transition Impact Analysis» utiliza este Atributo para observar cómo afecta un cambio de gerente a las actividades posteriores. También es clave para el KPI «Time to Managerial Re-engagement». Por qué es importante Permite analizar el rendimiento del proceso a nivel de equipo y ayuda a evaluar el impacto de los gerentes en los eventos del ciclo de vida del empleado. Dónde obtenerlo Esta información forma parte de los datos de la estructura jerárquica del empleado en el módulo Core HR de UKG Pro. Ejemplos John SmithMaria GarciaChen Wei
	Puesto JobTitle	El nombre oficial del puesto del empleado, como «Software Engineer» o «Sales Manager».
Descripción Job Title describe la función o el puesto del empleado dentro de la organización. Este Atributo es una dimensión clave para analizar cómo varían los procesos según las funciones y los niveles de antigüedad. En el análisis, Job Title puede utilizarse para comparar los tiempos de incorporación de distintos puestos, evaluar la velocidad de las promociones o identificar si determinados puestos presentan tasas más altas de rotación temprana. Esto ayuda a adaptar los procesos de RR. HH. y los programas de apoyo a las necesidades específicas de cada grupo de empleados. Por qué es importante Permite analizar el proceso según la función para comprender cómo varían los procesos del ciclo de vida entre distintas funciones y niveles de antigüedad. Dónde obtenerlo Es un campo estándar asociado al puesto o registro laboral del empleado en el módulo Core HR de UKG Pro. Ejemplos Ingeniero de software IIGerente sénior de productoSocio de negocio de Recursos Humanos
	Usuario que ejecutó la acción ActioningUser	El nombre o ID del usuario, normalmente un representante de RR. HH. o un gerente, que realizó la actividad en UKG Pro.
Descripción Este Atributo identifica a la persona responsable de ejecutar un paso específico del proceso, como el reclutador que envió una oferta o el gerente que aprobó una promoción. Vincula las actividades del proceso con las personas que las realizan. En el análisis, este Atributo resulta muy valioso para comprender la distribución de la carga de trabajo, identificar necesidades de formación y analizar el rendimiento por usuario. Por ejemplo, puede ayudar a determinar si los errores de entrada de datos posteriores a «Payroll Setup Completed» se concentran en determinados usuarios, lo que respalda el KPI «Post-Onboarding Data Rework Rate». Por qué es importante Vincula las actividades del proceso con usuarios específicos y permite analizar la carga de trabajo, comparar el rendimiento e investigar reprocesos o errores. Dónde obtenerlo Normalmente se encuentra en los registros de auditoría o en los campos «Last Modified By» de los módulos de UKG Pro. El nombre exacto del campo varía según el módulo. Ejemplos j.does.smithhr_admin
	¿Rotación temprana? IsEarlyChurn	Una marca booleana que indica si la terminación del empleado tuvo lugar dentro de un periodo inicial de permanencia predefinido, como 90 o 180 días.
Descripción Este Atributo calculado identifica a los empleados que abandonan la organización poco después de ser contratados. La empresa suele definir el umbral de «temprana», por ejemplo, dentro del primer año. Esta marca simplifica el análisis necesario para el Dashboard «Early Tenure Churn Insights» y el KPI «Early Employee Churn Rate». Permite filtrar y segmentar rápidamente este grupo de gran interés y analizar sus características y patrones del ciclo de vida, lo que ayuda a identificar problemas en la contratación o la incorporación. Por qué es importante Respalda directamente el análisis de la rotación temprana al identificar casos de riesgo y ayudar a determinar las causas fundamentales de las salidas prematuras de empleados. Dónde obtenerlo Este Atributo se calcula durante la preparación de datos. La lógica compara la diferencia entre «TerminationDate» y «HireDate» con un umbral predefinido, como 365 días. Ejemplos truefalse
	Evaluación de desempeño PerformanceRating	La calificación asignada a un empleado durante un ciclo de evaluación del desempeño.
Descripción Performance Rating es el resultado de la actividad «Performance Review Conducted». Normalmente se expresa en una escala, como 1-5, o mediante etiquetas descriptivas, como «Exceeds Expectations». Cuantifica la evaluación del desempeño del empleado. Este Atributo es valioso para relacionar los eventos del proceso con los resultados de desempeño. Por ejemplo, el análisis puede explorar si los empleados con mejor desempeño reciben promociones más rápido o si existe una relación entre las calificaciones de desempeño y la rotación de empleados. Es fundamental para el Dashboard «Performance Review Cycle Compliance». Por qué es importante Relaciona los eventos del proceso con los resultados de desempeño y permite analizar la eficacia de la gestión del talento y su impacto en la retención. Dónde obtenerlo Se encuentra en el módulo Performance Management de UKG Pro y está vinculado a ciclos de evaluación específicos. Ejemplos Supera las expectativasCumple las expectativasNecesita mejorar5
	Fecha de terminación TerminationDate	La fecha oficial de finalización de la relación laboral del empleado.
Descripción Termination Date marca el final de la permanencia del empleado. Es el punto final del ciclo de vida del empleado dentro de la organización. Este Atributo es necesario para calcular la antigüedad total del empleado y constituye un componente clave del análisis de rotación. El tiempo transcurrido entre Hire Date y Termination Date sirve de base para el Dashboard «Early Tenure Churn Insights» y los KPI relacionados. Por qué es importante Define el final del ciclo de vida del empleado, permite calcular la antigüedad total y respalda todos los análisis relacionados con la rotación. Dónde obtenerlo Es un campo estándar del registro principal del empleado en UKG Pro que se completa cuando finaliza el proceso de terminación. Ejemplos 2023-11-302024-02-152022-12-31
	Hora de finalización del evento EventEndTime	La marca de tiempo que indica la finalización de una actividad con una duración medible.
Descripción En las actividades que no son instantáneas, Event End Time registra cuándo se completó la actividad. Se diferencia de Event Timestamp (StartTime), que marca el inicio. Contar con una hora de inicio y otra de finalización permite calcular con precisión el tiempo de procesamiento de actividades individuales, como «Background Check» u «Onboarding Task». Esto facilita un análisis más detallado de dónde se emplea el tiempo dentro del proceso. Por qué es importante Permite calcular con precisión los tiempos de procesamiento de actividades individuales y ayuda a identificar los pasos que consumen más tiempo en el proceso. Dónde obtenerlo Se obtiene de los campos de fecha de finalización de UKG Pro. A menudo es necesario asociar un evento de inicio con el evento de finalización correspondiente de los datos de origen. Ejemplos 2023-01-15T17:30:00Z2023-06-21T10:00:00Z2024-02-01T11:05:00Z
	Motivo de terminación TerminationReason	El motivo documentado de la salida del empleado, como «Voluntary - Resignation» o «Involuntary - Performance».
Descripción Este Atributo registra el motivo por el que terminó la relación laboral del empleado. Normalmente, los motivos se clasifican como voluntarios o involuntarios, con subcategorías más específicas. Es un Atributo crítico para analizar la retención y la rotación. Al segmentar a los empleados que han salido según el motivo de su salida, las organizaciones pueden obtener insights profundos sobre las causas fundamentales de la rotación. Por ejemplo, analizar «Early Employee Churn Rate» por motivo de terminación permite distinguir entre decisiones de contratación inadecuadas y ofertas más competitivas. Por qué es importante Proporciona información crítica sobre los factores que impulsan la rotación de empleados y permite diseñar estrategias de retención específicas. Dónde obtenerlo Normalmente, este campo se registra durante el proceso de terminación o salida en el módulo Core HR de UKG Pro. Ejemplos Voluntaria: otra oportunidadInvoluntaria: desempeñoJubilación
	Motivo del cambio de función RoleChangeReason	El motivo de un cambio en la función del empleado, como «Promotion», «Lateral Transfer» o «Reorganization».
Descripción Este Atributo proporciona contexto sobre los eventos de movilidad interna. Explica por qué cambió la función o el puesto de un empleado dentro de la organización. Es esencial para el Dashboard y el KPI «Internal Mobility Cycle Time», ya que permite diferenciar entre promociones y otros tipos de traslado. Analizar el proceso por motivo puede revelar si los procesos de promoción son más lentos que los movimientos laterales y ayudar a agilizar las trayectorias de desarrollo profesional. Por qué es importante Explica el contexto de los movimientos internos y permite analizar con mayor precisión los procesos de movilidad interna, como las promociones frente a los traslados laterales. Dónde obtenerlo Normalmente, esta información se registra como parte de la transacción de cambio de puesto o traslado en el módulo Core HR de UKG Pro. Ejemplos AscensoTraslado lateralReorganización
	Nivel salarial SalaryGrade	El nivel o banda salarial asociado al puesto del empleado.
Descripción Salary Grade representa el nivel de compensación de un puesto concreto. Es un Atributo clave para analizar las actividades y tendencias relacionadas con la compensación. Este Atributo es importante para análisis como los eventos «Compensation Changed» y puede utilizarse para seguir el KPI «Post-Onboarding Data Rework Rate» si se observan correcciones frecuentes de los niveles salariales. También permite segmentar el proceso para comprobar si los tiempos de ciclo de las promociones o las tasas de rotación varían según el nivel de compensación. Por qué es importante Proporciona contexto para las actividades relacionadas con la compensación y permite segmentar el proceso por nivel salarial. Dónde obtenerlo Está disponible en el perfil de compensación o laboral del empleado dentro del módulo Core HR de UKG Pro. Ejemplos IC3M2D1
	Nombre de la formación TrainingName	El nombre o título del curso de formación asignado al empleado.
Descripción Este Atributo identifica una formación o un módulo de aprendizaje específico asignado a un empleado. Puede tratarse desde formación obligatoria sobre cumplimiento hasta el desarrollo de competencias específicas para un puesto. Es un Atributo clave para el Dashboard «Training Assignment & Completion» y el KPI «Training Completion Rate». Permite seguir el progreso y la eficacia de programas de formación concretos y analizar los tiempos de finalización de distintos cursos. Por qué es importante Permite seguir y analizar programas de formación específicos y ayuda a medir el cumplimiento y la eficacia del desarrollo profesional. Dónde obtenerlo Se obtiene del módulo Learning de UKG Pro o de un Learning Management System (LMS) conectado. Ejemplos Código de conducta 2024Habilidades avanzadas de gestiónConcienciación sobre ciberseguridad
	Ubicación Location	La ubicación geográfica o la oficina donde trabaja el empleado.
Descripción Este Atributo especifica la ubicación de trabajo principal del empleado, que puede ser una ciudad, un país o un edificio de oficinas concreto. Es una dimensión clave para el análisis geográfico de los procesos de RR. HH. El análisis del rendimiento del proceso por ubicación puede revelar diferencias regionales en la eficiencia de la contratación, las prácticas de incorporación o las tasas de rotación. Por ejemplo, puede comparar el «Recruitment Cycle Time» entre las oficinas de «New York» y «London» para identificar buenas prácticas o cuellos de botella locales. Por qué es importante Permite segmentar geográficamente el proceso y revela variaciones regionales en el rendimiento y el cumplimiento. Dónde obtenerlo Esta información forma parte de los datos laborales o personales del empleado en el módulo Core HR de UKG Pro. Ejemplos Nueva York, NYLondres, Reino UnidoRemoto

Obligatorio Recomendado Opcional

Hire to Retire - Actividades del ciclo de vida de la persona empleada

Estos son los pasos clave y los hitos del proceso que debe capturar en su registro de eventos para lograr un descubrimiento preciso y optimizar el proceso.

6 Recomendado 9 Opcional

	Actividad	Descripción
	Persona empleada contratada	Marca la creación oficial del registro de la persona empleada en UKG Pro, donde se asigna formalmente un Employee ID. Este evento suele registrarse cuando una persona administradora de RR. HH. finaliza el proceso de contratación de una candidatura y la incorpora al sistema como persona empleada activa.
Por qué es importante Este es el evento de inicio definitivo para el análisis del proceso Hire to Retire. Proporciona la base para medir el tiempo hasta la productividad, la eficiencia de la incorporación y la permanencia total de la persona empleada. Dónde obtenerlo Es probable que este evento se registre en el módulo HR Core o Personnel Administration. Puede identificarse mediante la fecha de creación del registro laboral principal de la persona empleada o mediante un registro de acción específico «Hire» en su historial de datos laborales. Recopilar Se captura a partir de la fecha efectiva de la acción «Hire» en el historial laboral de la persona empleada. Tipo de evento explicit
	Persona empleada desvinculada	El evento final del ciclo de vida de la persona empleada, que representa el fin oficial de la relación laboral. Es el momento en que el registro de la persona pasa a estar inactivo en el sistema, a partir de la fecha efectiva de terminación.
Por qué es importante Es el evento final definitivo del proceso, fundamental para calcular la permanencia total de la persona empleada y analizar la rotación. Cierra el ciclo de su recorrido en la organización. Dónde obtenerlo Es la fecha efectiva de la acción final «Termination» en el historial de datos laborales de la persona empleada dentro del módulo HR Core. Normalmente, el sistema cambia ese día el estado de la persona empleada de activa a inactiva. Recopilar Se captura a partir de la fecha efectiva de la acción «Termination» en el historial laboral de la persona empleada. Tipo de evento explicit
	Persona empleada incorporada	Un hito clave que indica la finalización correcta de la lista de comprobación o el Workflow inicial de incorporación. Normalmente significa que se han completado toda la documentación necesaria para la nueva incorporación, las solicitudes de acceso a los sistemas y las tareas administrativas iniciales.
Por qué es importante Marca el final de la configuración administrativa inicial y permite analizar la duración total del ciclo de incorporación. Señala el momento en que la persona empleada está preparada administrativamente para comenzar sus funciones específicas. Dónde obtenerlo Se encuentra en el módulo Onboarding. Normalmente se infiere a partir de la marca de tiempo de finalización del Workflow general de incorporación o del momento en que se marca como completada la última tarea obligatoria. Recopilar Se infiere a partir de la marca de tiempo de finalización de la lista de comprobación principal de incorporación de la persona empleada. Tipo de evento inferred
	Promoción aprobada	Indica la aprobación formal de la promoción de una persona empleada, que normalmente incluye un cambio de puesto y, a menudo, de remuneración. Es un evento diferenciado que precede a la fecha efectiva del cambio.
Por qué es importante Esta actividad es clave para analizar la movilidad interna y la progresión profesional. El tiempo entre la aprobación de la promoción y su fecha efectiva puede revelar cuellos de botella administrativos en el sistema. Dónde obtenerlo Se registra como una acción laboral específica, como «Promotion», en el historial de datos laborales de la persona empleada dentro del módulo HR Core. El registro tendrá sus propias fechas de aprobación y efectividad. Recopilar Se captura a partir de la fecha de registro de una acción «Promotion» en el historial laboral de la persona empleada. Tipo de evento explicit
	Revisión del desempeño realizada	Representa la finalización de un ciclo formal de revisión del desempeño de una persona empleada. Este evento se registra cuando la persona responsable o RR. HH. finaliza y envía el formulario de revisión.
Por qué es importante Es un hito recurrente fundamental en el ciclo de vida de las personas empleadas. Hacer un seguimiento de su frecuencia y puntualidad ayuda a evaluar el cumplimiento de la gestión del desempeño y su impacto en la progresión profesional. Dónde obtenerlo Se encuentra en el módulo Performance Management de UKG Pro. Puede identificarse mediante la fecha de finalización del formulario de revisión del desempeño o mediante un cambio de estado a «Completed» en un ciclo de revisión. Recopilar Se captura a partir de la marca de tiempo de finalización de la instancia del Workflow de revisión del desempeño. Tipo de evento explicit
	Terminación iniciada	Representa el inicio del proceso de salida de la organización y se registra cuando se introduce en el sistema una fecha futura de terminación. Este evento activa las listas de comprobación y los Workflows de salida.
Por qué es importante Es un hito fundamental que inicia el proceso de salida de la persona empleada. Analizar el tiempo entre este evento y la terminación final ayuda a evaluar la eficiencia y la integridad de los procedimientos de salida. Dónde obtenerlo Normalmente corresponde a la creación de un registro de acción «Termination» en los datos laborales de la persona empleada, con una fecha efectiva futura. También puede ser el inicio de un Workflow de salida en un módulo específico. Recopilar Se captura cuando se envía una transacción de terminación con una fecha futura. Tipo de evento explicit
	Cambio de puesto procesado	Representa un cambio en el puesto o la función de la persona empleada que no constituye una promoción, como un traslado lateral o un cambio de departamento. Se registra cuando se actualizan los datos laborales correspondientes en el sistema.
Por qué es importante Analizar los cambios de puesto proporciona información sobre la movilidad interna, la asignación del talento y la reestructuración organizativa. Ayuda a identificar cómo se desplazan las personas empleadas dentro de la organización. Dónde obtenerlo Se captura a partir del historial de datos laborales de la persona empleada en el módulo HR Core. Puede identificarse mediante acciones laborales como «Transfer», «Re-assignment» o «Position Change», junto con sus fechas efectivas. Recopilar Se identifica mediante un código de acción «Transfer» o similar en los datos del historial laboral de la persona empleada. Tipo de evento explicit
	Configuración de nómina completada	Indica que se ha introducido y verificado toda la información necesaria para procesar el pago de la persona empleada, como los datos bancarios y los formularios fiscales. Es un paso fundamental para garantizar que la persona empleada reciba su salario correctamente y a tiempo.
Por qué es importante Este hito es esencial para medir la preparación de las nuevas incorporaciones. Los retrasos en la configuración de la nómina pueden provocar insatisfacción y retrabajo administrativo, por lo que constituye un indicador clave del rendimiento de la incorporación. Dónde obtenerlo Este evento puede inferirse a partir del módulo Payroll de UKG Pro. Puede derivarse de la fecha de finalización de una lista de comprobación de preparación de nómina o de la fecha en que el estado de la persona empleada cambia a «Ready for Payroll». Recopilar Se deriva de un cambio de estado o de la marca de tiempo de finalización del perfil de nómina de la persona empleada. Tipo de evento inferred
	Entrevista de salida realizada	Este evento marca la finalización de la entrevista de salida con la persona empleada que deja la organización. Normalmente se registra como una tarea completada en una lista de comprobación de salida.
Por qué es importante Hacer un seguimiento de la finalización de las entrevistas de salida es importante para garantizar el cumplimiento de RR. HH. y recopilar comentarios valiosos. Ayuda a identificar si este paso fundamental se omite en el proceso de salida. Dónde obtenerlo Es probable que este evento se encuentre en el módulo Onboarding o HR Help Desk de UKG Pro, como una tarea específica dentro de un Workflow de salida. Su registro depende de que RR. HH. marque manualmente la tarea como completada. Recopilar Se registra como una tarea completada dentro de la lista de comprobación de salida de una persona empleada. Tipo de evento explicit
	Formación asignada	Registra el momento en que se asigna a una persona empleada un curso de formación o un plan de aprendizaje específico. Normalmente se registra en el módulo de gestión del aprendizaje del sistema.
Por qué es importante Esta actividad ayuda a realizar un seguimiento del cumplimiento de la formación obligatoria y a supervisar el desarrollo de las personas empleadas. Analizar el tiempo entre la asignación y la finalización puede revelar problemas de participación o de eficacia de la formación. Dónde obtenerlo Se registra en los módulos de gestión del aprendizaje o de gestión del talento de UKG Pro. Cada asignación debe contar con un registro correspondiente que incluya la fecha de asignación y el Employee ID. Recopilar Se registra cuando se asigna un curso o plan de estudios al plan de aprendizaje de una persona empleada. Tipo de evento explicit
	Incorporación iniciada	Representa el inicio del proceso o Workflow de incorporación de una nueva persona empleada en UKG Pro. Normalmente es un evento activado de forma automática o manual que asigna una lista de tareas a la nueva persona empleada, a su responsable y a RR. HH.
Por qué es importante El seguimiento de esta actividad ayuda a medir el tiempo transcurrido entre la fecha oficial de contratación y el inicio de la integración administrativa y cultural. Es el punto de partida para analizar la eficiencia del proceso de incorporación e identificar retrasos. Dónde obtenerlo Se encuentra en el módulo Onboarding de UKG Pro. El evento puede inferirse a partir de la fecha de creación de la lista de comprobación de incorporación o de la instancia de Workflow asociada a la persona empleada. Recopilar Se infiere a partir de la marca de tiempo de creación del Workflow de incorporación o de la lista de tareas de la persona empleada. Tipo de evento inferred
	Inicio de una ausencia	Marca el inicio de una ausencia aprobada de una persona empleada, por motivos médicos o personales, por ejemplo. Se registra cuando el estado de la persona empleada cambia a inactiva o en situación de ausencia.
Por qué es importante Identifica los periodos de inactividad en el ciclo de vida de una persona empleada. Es fundamental para calcular con precisión la permanencia activa y comprender el impacto de las ausencias en la progresión profesional. Dónde obtenerlo Se encuentra en el historial de datos laborales de la persona empleada, dentro del módulo HR Core. Corresponde a una acción laboral como «Leave of Absence», con una fecha efectiva de inicio específica. Recopilar Se captura a partir de la fecha efectiva de una acción «Start Leave» en el historial laboral. Tipo de evento explicit
	Remuneración modificada	Este evento registra cualquier cambio en el salario base, la estructura de bonificaciones u otros componentes de la remuneración de una persona empleada. Puede formar parte de una promoción, un aumento por méritos o un ajuste de mercado.
Por qué es importante El seguimiento de los cambios en la remuneración es fundamental para comprender la progresión profesional y salarial. Los ajustes frecuentes después de la contratación podrían indicar errores de introducción de datos o problemas en la fijación del salario inicial. Dónde obtenerlo Se encuentra en la tabla del historial de remuneración de la persona empleada, dentro del módulo HR Core o Payroll. Cada cambio suele registrarse con una fecha efectiva y un código de motivo. Recopilar Se registra a partir de la fecha efectiva de una nueva entrada en el historial de remuneración de la persona empleada. Tipo de evento explicit
	Responsable cambiado	Este evento se genera cuando se actualiza el campo «Reports To» o «Manager ID» de una persona empleada. Representa un cambio en su línea jerárquica directa.
Por qué es importante Los cambios de responsable pueden afectar considerablemente al compromiso y al desempeño de las personas empleadas. El seguimiento de este evento permite analizar su efecto en actividades posteriores, como las revisiones del desempeño o la retención. Dónde obtenerlo Este evento debe inferirse mediante el seguimiento de los cambios en el campo del responsable o supervisor en los datos laborales de la persona empleada a lo largo del tiempo. Es necesario comparar el Manager ID entre registros consecutivos de la misma persona empleada. Recopilar Se infiere al detectar un cambio en el campo «Reports To» del historial de datos laborales de la persona empleada. Tipo de evento inferred
	Salida de la organización completada	Un hito que indica que se han completado todas las tareas obligatorias de salida. Incluye actividades como la devolución de activos, los cálculos finales de nómina y la revocación de accesos a los sistemas.
Por qué es importante Este evento confirma que se han realizado todos los pasos necesarios para finalizar la relación laboral de forma segura y conforme a los requisitos de cumplimiento. Ayuda a medir la duración del ciclo de salida e identificar brechas de cumplimiento. Dónde obtenerlo Se inferiría a partir de la marca de tiempo de finalización de la lista de comprobación o del Workflow general de salida, de forma similar al evento «Employee Onboarded», pero aplicado al proceso de salida. Recopilar Se infiere a partir de la marca de tiempo de finalización de la lista de comprobación principal de salida de la persona empleada. Tipo de evento inferred

Recomendado Opcional

Guías de extracción

Cómo obtener sus datos de UKG Pro

Pasos

Requisitos previos: Asegúrese de tener Python 3.6 o una versión posterior, además de las bibliotecas requests y pandas instaladas. Puede instalarlas con pip: pip install requests pandas.
Acceso y autenticación de la API: Póngase en contacto con la persona administradora de UKG Pro para crear una cuenta de servicio. Necesitará la API Key, User Name y Password. La cuenta de servicio debe tener permisos para acceder a todos los endpoints de API necesarios, incluidos los datos de personal, nómina, onboarding, desempeño y aprendizaje.
Configure el script: Abra el script de Python proporcionado en un editor de texto o IDE. Localice la sección de configuración al principio del script y sustituya los valores de marcador de posición de UKG_BASE_URL, API_KEY, USERNAME, PASSWORD y COMPANY_ID por sus credenciales y los datos específicos de su entorno.
Defina el intervalo de extracción: En la sección de configuración, defina las variables START_DATE y END_DATE. Estas determinan el período del que se extraerán los cambios y eventos de las personas empleadas. Se recomienda comenzar con un intervalo menor, como 3-6 meses, para probar el script.
Ejecute el script: Ejecute el script desde la línea de comandos con python your_script_name.py. El script se autenticará, obtendrá datos de varios endpoints de la API de UKG Pro para cada actividad y mostrará el progreso en la consola.
Gestione la limitación de solicitudes de la API: El script incluye una pausa básica mediante time.sleep() para respetar los límites de frecuencia de la API. Si encuentra errores de limitación, HTTP 429, puede que deba aumentar la duración de la pausa entre llamadas a la API.
Transforme y estandarice los datos: Cada función del script está diseñada para obtener datos sin procesar de una actividad específica, seleccionar los campos relevantes y cambiarles el nombre para adaptarlos al formato estándar del Registro de eventos, como EmployeeId, ActivityName y EventTimestamp.
Combine los datos de eventos: La parte principal del script llama a cada función específica de actividad y añade los datos resultantes a una única lista maestra de eventos.
Genere el Registro de eventos: Después de procesar todas las actividades, el script consolida los datos en un DataFrame de pandas, los ordena por ID de persona empleada y marca de tiempo, y los guarda en un archivo CSV denominado ukg_hire_to_retire_event_log.csv.
Revise y cargue el archivo: Abra el CSV generado para comprobar que los datos estén completos y tengan el formato correcto. El archivo ya está listo para cargarse en la herramienta de Process Mining.

Configuración

Credenciales de autenticación: Para autenticar la API se necesitan una API Key, User Name y Password de una cuenta de servicio.
URL base: La UKG_BASE_URL de su instancia de UKG Pro, por ejemplo, https://service[##].ultipro.com/api.
Company ID: El COMPANY_ID único de su organización dentro de UKG Pro es necesario para muchas llamadas a la API.
Intervalo de fechas: Los parámetros START_DATE y END_DATE, en formato «YYYY-MM-DD», controlan el período de extracción. Para la ejecución inicial, se recomienda un período de 3-6 meses para gestionar el volumen de datos y verificar los resultados.
Versiones de los endpoints de API: El script utiliza versiones específicas de las API REST, por ejemplo, /personnel/v1/. Asegúrese de que su instancia de UKG Pro admita estas versiones.
Dependencias de módulos: La extracción de determinadas actividades requiere que su organización tenga licencia y utilice activamente los módulos correspondientes de UKG Pro, como Onboarding, Learning y Performance Management. Si un módulo no está en uso, no se extraerá la actividad correspondiente.

a Consulta de ejemplo 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}")

¿Listo para comenzar?

Utilice esta plantilla para preparar sus datos con confianza y obtener conclusiones clave sobre sus procesos de RR. HH. Comience hoy mismo a optimizar su recorrido de contratación a jubilación.

Volver a la guía de mejora Descargar Template

¡Comience hoy a optimizar el ciclo de vida de sus empleados de Hire to Retire!

Reduzca un 30 % el tiempo de ciclo de contratación a jubilación y aumente la eficiencia de RR. HH.

Iniciar la prueba gratuita

No necesita tarjeta de crédito y la configuración es rápida.

Su plantilla de datos para el ciclo de vida de la persona empleada, de la contratación a la jubilación

Su plantilla de datos para el ciclo de vida de la persona empleada, de la contratación a la jubilación

Hire to Retire - Atributos del ciclo de vida de la persona empleada

Hire to Retire - Actividades del ciclo de vida de la persona empleada

Guías de extracción

Extracción mediante scripts de Python a través de las API REST de UKG Pro

Pasos

Configuración

a Consulta de ejemplo python

¿Listo para comenzar?

¡Comience hoy a optimizar el ciclo de vida de sus empleados de Hire to Retire!

Valoramos su privacidad