> Mejora Continua de Procesos > Contratación a Jubilación Ciclo de Vida del Empleado > UKG Pro > Plantilla de Datos

Plantilla de Datos: De la Contratación al Retiro - Ciclo de Vida del Empleado

UKG Pro

Atributos del Ciclo de Vida del Empleado de Contratación a Jubilación (22) Actividades del Ciclo de Vida del Empleado de Contratación a Jubilación (15) Guías de Extracción (1)

Su Plantilla de Datos del Ciclo de Vida del Empleado (Contratación a Retiro)

Esta plantilla ofrece una visión general de los elementos de datos esenciales para analizar eficazmente su proceso De contratación a retiro. Detalla los atributos clave que debe recopilar, las actividades que seguir y recomendaciones prácticas para extraer estos datos de UKG Pro. Úsela para agilizar la preparación de datos y asegurar un inicio fluido en su iniciativa de Process Mining.

Atributos recomendados para recopilar
Actividades clave para el seguimiento
Guía de Extracción para UKG Pro

¿Nuevo en registros de eventos? Aprenda cómo crear un registro de eventos para Process Mining.

Descargar Plantilla

Atributos del Ciclo de Vida del Empleado de Contratación a Jubilación

Estos son los campos de datos recomendados para incluir en su registro de eventos para un análisis e insights exhaustivos del Ciclo de Vida del Empleado (Hire to Retire).

5 Requerido 7 Recomendado 10 Opcional

	Nombre	Descripción
	ID de Empleado EmployeeId	El identificador único asignado a cada empleado, que sirve como ID de caso principal para todo su ciclo de vida dentro de la organización.
Descripción El ID de Empleado actúa como el hilo conductor central que conecta todos los eventos relacionados con un empleado, desde su solicitud inicial hasta su desvinculación final. Este identificador es crucial para construir una vista de proceso de extremo a extremo completa del viaje de un individuo. En el análisis de process mining, cada actividad, como 'Empleado Contratado', 'Promoción Aprobada' o 'Terminación Iniciada', se vincula a este ID único. Esto permite el análisis de rutas individuales de los empleados, el análisis de cohortes basado en los atributos del empleado y el cálculo preciso de las duraciones del ciclo de vida. Por qué es importante Este es el identificador de caso esencial que vincula todos los eventos relacionados con el empleado, lo que permite analizar de principio a fin el proceso De contratación a retiro para cada empleado. Dónde obtener Este es un campo esencial en UKG Pro, normalmente ubicado en el perfil del empleado o en los registros maestros. Consulte la documentación de UKG Pro para el nombre exacto de tabla y campo, que suele etiquetarse como Employee Number o Person ID. Ejemplos 10052198345210047
	Timestamp del Evento EventTimestamp	La fecha y hora precisas en que ocurrió un evento específico del ciclo de vida.
Descripción El Timestamp del Evento proporciona el contexto cronológico para cada actividad, formando la columna vertebral del flujo del proceso. Registra el momento exacto en que un evento como 'Oferta Aceptada' o 'Promoción Aprobada' fue registrado en el sistema. En el análisis, estos timestamps se utilizan para calcular duraciones entre actividades, identificar retrasos y medir tiempos de ciclo para subprocesos clave como la contratación y la incorporación. Los timestamps precisos son críticos para todos los KPIs basados en el tiempo y el análisis de rendimiento. Por qué es importante Este atributo es esencial para ordenar los eventos cronológicamente y calcular todas las métricas basadas en el tiempo, como los tiempos de ciclo y las duraciones. Dónde obtener Obtenido de campos de fecha o timestamp asociados con eventos específicos en UKG Pro, como 'HireDate', 'TerminationDate' o timestamps de cambio de estado en módulos de flujo de trabajo. 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 ocurrió en el ciclo de vida del empleado, como 'Empleado Contratado' o 'Revisión de Desempeño Realizada'.
Descripción El Nombre de Actividad describe un paso o tarea única dentro del proceso de Contratación al Retiro. Estos eventos tienen un timestamp y se ordenan para construir el flujo del proceso que se visualiza y analiza en el process mining. Analizar la secuencia y frecuencia de estas actividades revela la ejecución real del proceso. Ayuda a identificar rutas comunes, desviaciones del proceso estándar y cuellos de botella entre actividades clave como 'Incorporación Iniciada' y 'Configuración de Nómina Completada'. Por qué es importante Este atributo define los pasos en el mapa de procesos, permitiendo la visualización y el análisis del flujo del ciclo de vida del empleado. Dónde obtener Normalmente se deriva de registros de eventos, cambios de estado en el workflow o campos de fecha específicos dentro de varios módulos de UKG Pro (p. ej., Recruiting, Onboarding, Performance Management). Suele requerirse una lógica de mapeo para generar nombres de actividades estandarizados. Ejemplos Empleado ContratadoRevisión de Desempeño RealizadaTerminación Iniciada
	Source System 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. Si bien en este contexto es principalmente UKG Pro, un proceso de Contratación a Retiro (Hire to Retire) podría involucrar datos de otros sistemas como un Sistema de Seguimiento de Candidatos (ATS) o un sistema de gestión de aprendizaje (LMS).\n\nEn el análisis, ayuda a diferenciar las fuentes de datos si hay múltiples sistemas involucrados y es crucial para la gobernanza de datos y la resolución de problemas. Para una vista de fuente única, proporciona un contexto esencial sobre el origen de los datos. Por qué es importante Proporciona contexto crucial para la gobernanza de datos, la garantía de calidad y la trazabilidad al identificar el origen de los datos del evento. Dónde obtener Suele ser un valor estático ('UKG Pro') añadido durante el proceso de transformación y extracción de datos. Ejemplos UKG ProUKGPro_CoreHRUKG
	Última actualización de datos LastDataUpdate	El timestamp que indica cuándo los datos de este evento fueron actualizados o extraídos por última vez del sistema de origen.
Descripción Este atributo proporciona la timestamp de la última extracción de datos de UKG Pro. No es el tiempo en que ocurrió el evento de negocio, sino cuando el registro fue introducido en la herramienta de process mining.\n\nEsta información es vital para comprender la frescura de los datos que se analizan. Permite a los analistas y usuarios de negocio saber cuán actual es la vista del proceso y ayuda a gestionar los programas de actualización de datos y a validar la actualidad de los insights. Por qué es importante Indica la actualidad de los datos, lo cual es esencial para confiar en el análisis y tomar decisiones comerciales oportunas. Dónde obtener Este timestamp se genera y se añade a cada registro durante el proceso de extracción, transformación y carga (ETL). Ejemplos 2024-03-15T02:00:00Z2024-03-16T02:00:00Z2024-03-17T02:00:00Z
	Cargo JobTitle	El título de puesto oficial del empleado, como 'Ingeniero de Software' o 'Gerente de Ventas'.
Descripción El Título del Puesto describe el rol o puesto del empleado dentro de la organización. Este atributo es una dimensión clave para analizar cómo los procesos difieren entre varios roles y niveles de antigüedad. En el análisis, el Título del Puesto se puede utilizar para comparar los tiempos de incorporación para diferentes roles, evaluar las velocidades de promoción o identificar si ciertos títulos de puesto tienen tasas más altas de rotación temprana. Esto ayuda a adaptar los procesos de RR. HH. y los programas de soporte a las necesidades específicas de diferentes grupos de empleados. Por qué es importante Permite hacer análisis por rol para entender cómo varían los procesos del ciclo de vida entre funciones y niveles de senioridad. Dónde obtener Este es un campo estándar asociado al puesto o cargo del empleado en el módulo Core HR de UKG Pro. Ejemplos Ingeniero de Software IIGerente de Producto SéniorHR Business Partner
	Departamento EmployeeDepartment	El departamento o unidad organizacional al que está asignado el empleado.
Descripción Este atributo contiene el nombre del departamento asignado al empleado, como 'Ventas', 'Ingeniería' o 'Finanzas'. Es una dimensión organizacional clave para segmentar y comparar el rendimiento del proceso.\n\nEl análisis por departamento permite comparar la ejecución de procesos en diferentes unidades de negocio. Por ejemplo, se puede analizar si el 'tiempo de ciclo de reclutamiento' ('Recruitment Cycle Time') es más largo para los departamentos técnicos o si la 'adherencia a las revisiones de desempeño' ('Performance Review Adherence') varía significativamente entre Ventas y Operaciones, proporcionando insights específicos para la mejora. Por qué es importante Permite un potente análisis comparativo al permitirle filtrar y segmentar el proceso basado en la estructura organizacional, revelando variaciones departamentales. Dónde obtener Este es un campo estándar en el registro de puesto o cargo del empleado dentro del módulo Core HR de UKG Pro. Ejemplos IngenieríaVentasRecursos Humanos
	Estado de Empleo EmploymentStatus	El estado laboral actual o histórico del empleado, como 'Activo', 'Terminado' o 'De Permiso'.
Descripción Este atributo indica el estado oficial del empleado dentro de la empresa en un momento dado. Es una dimensión crítica para comprender el estado general de la fuerza laboral y para filtrar el análisis a poblaciones de empleados específicas.\n\nAnalizar los cambios en el estado de empleo ayuda a modelar correctamente el proceso, por ejemplo, distinguiendo entre una licencia temporal y una terminación permanente. Es fundamental para calcular las tasas de rotación (churn rates) y comprender los resultados de diferentes trayectorias del ciclo de vida. Por qué es importante Proporciona contexto esencial sobre la situación de un empleado, lo que permite un análisis preciso de la rotación y la segmentación de la fuerza laboral. Dónde obtener Este es un campo clave en el registro maestro del empleado en el módulo Core HR de UKG Pro. Ejemplos ActivoFinalizadoAusencia Laboral
	Fecha de Contratación HireDate	La fecha de inicio oficial del empleo de un empleado con la organización.
Descripción La Fecha de Contratación marca el inicio de la antigüedad del empleado. Es un campo de fecha fundamental que sirve como línea base para muchos cálculos y análisis basados en el tiempo relacionados con el ciclo de vida del empleado. Este atributo se utiliza para calcular la antigüedad del empleado, lo cual es crucial para analizar la 'Tasa de Rotación Temprana de Empleados'. También ayuda en el análisis de cohortes, permitiendo la comparación de patrones de ciclo de vida para empleados contratados en diferentes períodos. Por qué es importante Sirve como línea de base para calcular la antigüedad del empleado y es esencial para el análisis de cohortes y los KPIs de tasa de rotación. Dónde obtener Este es un campo estándar y obligatorio en el registro principal del empleado en el módulo Core HR de UKG Pro. Ejemplos 2022-08-152023-01-202021-05-10
	ID de Solicitud de Puesto JobRequisitionId	El identificador único para la solicitud de puesto que inició el proceso de contratación.
Descripción El ID de Solicitud de Puesto es la referencia única para una vacante específica. Vincula todas las actividades de reclutamiento de etapa temprana, 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 de 'Tiempo de Ciclo de Reclutamiento', ya que marca el verdadero inicio del proceso de contratación. Permite rastrear todo el embudo para una sola vacante y analizar métricas como la 'Tasa de Solicitudes de Puesto Inactivas' al identificar solicitudes que no progresan. Por qué es importante Proporciona un punto de partida claro para el proceso de reclutamiento, permitiendo una medición precisa de los tiempos de ciclo de contratación y la eficacia de la solicitud. Dónde obtener Se encuentra dentro del módulo de Recruiting de UKG Pro o el Applicant Tracking System (ATS) conectado. Ejemplos REQ-2023-015REQ-2024-112REQ-2023-504
	Nombre del Gerente ManagerName	El nombre del gerente o supervisor directo del empleado.
Descripción Este atributo identifica al gerente directo del empleado. El gerente juega un papel crucial en muchos eventos del ciclo de vida, incluyendo revisiones de desempeño, ascensos y asignaciones de capacitación.\n\nAnalizar por gerente ayuda a comprender las variaciones en la ejecución a nivel de equipo y la efectividad del gerente. El dashboard de 'Análisis de Impacto de la Transición de Gerente' ('Manager Transition Impact Analysis'), por ejemplo, se basa en este atributo para ver cómo un cambio de gerente afecta las actividades posteriores. También es clave para el KPI de 'Tiempo de Reincorporación Gerencial' ('Time to Managerial Re-engagement'). Por qué es importante Permite el análisis del rendimiento de 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 obtener 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
	Usuario que ejecuta 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 extendió una oferta o el gerente que aprobó un ascenso. Vincula las actividades del proceso con los actores humanos.\n\nEn el análisis, este atributo es invaluable para comprender la distribución de la carga de trabajo, identificar necesidades de capacitación y analizar el rendimiento de usuarios específicos. Por ejemplo, puede ayudar a determinar si los errores de entrada de datos después de 'Configuración de Nómina Completada' ('Payroll Setup Completed') se concentran en usuarios específicos, lo que respalda el KPI de 'Tasa de Retrabajo de Datos Post-Incorporación' ('Post-Onboarding Data Rework Rate'). Por qué es importante Vincula las actividades del proceso a usuarios específicos, permitiendo el análisis de carga de trabajo, comparaciones de rendimiento e investigación de retrabajos o errores. Dónde obtener Suele encontrarse en los registros de auditoría o en campos "Last Modified By" dentro de los módulos de UKG Pro. El nombre exacto del campo varía según el módulo. Ejemplos j.does.smithhr_admin
	Calificación de Desempeño PerformanceRating	La calificación asignada a un empleado durante un ciclo de revisión de desempeño.
Descripción La Calificación de Desempeño es el resultado de una actividad de 'Revisión de Desempeño Realizada', típicamente en una escala (p. ej., 1-5) o usando etiquetas descriptivas (p. ej., 'Supera las Expectativas'). Cuantifica la evaluación de desempeño de un empleado. Este atributo es valioso para correlacionar eventos del proceso con resultados de desempeño. Por ejemplo, el análisis puede explorar si los empleados de alto rendimiento son promovidos más rápido, o si existe un vínculo entre las calificaciones de desempeño y la rotación de empleados. Es fundamental para el dashboard de 'Cumplimiento del Ciclo de Revisión de Desempeño'. Por qué es importante Conecta eventos de proceso con resultados de rendimiento, permitiendo el análisis de la efectividad de la gestión del talento y su impacto en la retención. Dónde obtener Se encuentra dentro del módulo de Performance Management de UKG Pro, vinculado a ciclos de revisión específicos. Ejemplos Supera las ExpectativasCumple las ExpectativasNecesita Mejorar5
	Es Rotación Temprana IsEarlyChurn	Indicador booleano que indica si la terminación de la persona empleada ocurrió dentro de un período inicial predefinido, por ejemplo, 90 o 180 días.
Descripción Este atributo calculado marca a los empleados que abandonan la organización poco después de ser contratados. El umbral para 'temprano' suele ser definido por el negocio, por ejemplo, dentro del primer año.\n\nEste indicador simplifica el análisis requerido para el dashboard de 'Insights de Rotación Temprana' ('Early Tenure Churn Insights') y el KPI de 'Tasa de Rotación Temprana de Empleados' ('Early Employee Churn Rate'). Permite un filtrado y segmentación rápidos para aislar a este grupo de alto interés y analizar sus características y patrones de ciclo de vida, ayudando a identificar problemas en la contratación o incorporación. Por qué es importante Apoya directamente el análisis de rotación temprana marcando casos en riesgo, ayudando a identificar las causas raíz de las salidas prematuras de empleados. Dónde obtener Este atributo se calcula durante la preparación de datos. La lógica compara la diferencia entre la 'TerminationDate' y 'HireDate' con un umbral predefinido (por ejemplo, 365 días). Ejemplos truefalse
	Fecha de terminación TerminationDate	La fecha de finalización oficial del empleo de un empleado.
Descripción La Fecha de Terminación marca la conclusión de la antigüedad 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 final de un empleado y es un componente clave del análisis de rotación. El tiempo entre la Fecha de Contratación y la Fecha de Terminación proporciona la base para el dashboard de 'Perspectivas de Rotación Temprana por Antigüedad' y los KPIs relacionados. Por qué es importante Define el fin del ciclo de vida del empleado, permitiendo el cálculo de la antigüedad total y apoyando todo análisis relacionado con la rotación. Dónde obtener Este es un campo estándar en el registro principal del empleado en UKG Pro, que se completa al finalizar el proceso de baja. Ejemplos 2023-11-302024-02-152022-12-31
	Grado salarial SalaryGrade	El grado o banda salarial asociado al puesto del empleado.
Descripción El Grado salarial representa el nivel de compensación para un puesto particular. Es un atributo clave para analizar las actividades y tendencias relacionadas con la compensación. Este atributo es importante para análisis de eventos como 'Compensación cambiada' y puede usarse para rastrear el KPI de 'Tasa de reelaboración de datos post-incorporación' si se observan correcciones frecuentes en los grados salariales. También permite la segmentación para ver si los tiempos de ciclo de promoción o las tasas de rotación difieren según el nivel de compensación. Por qué es importante Proporciona contexto para las actividades relacionadas con la compensación y permite la segmentación del proceso por nivel salarial. Dónde obtener Disponible en la ficha de compensación o en el perfil del puesto de la persona empleada dentro del módulo Core HR de UKG Pro. Ejemplos IC3M2D1
	Hora Fin del Evento EventEndTime	El timestamp que marca la finalización de una actividad que tiene una duración medible.
Descripción Para las actividades que no son instantáneas, la Hora de Finalización del Evento registra cuándo se completó la actividad. Esto contrasta con la Marca de Tiempo del Evento (Hora de Inicio), que indica el comienzo. Contar con una hora de inicio y fin permite el cálculo preciso del tiempo de procesamiento de actividades individuales, como 'Verificación de Antecedentes' o 'Tarea de Incorporación'. Esto facilita un análisis más granular de cómo se utiliza el tiempo dentro del proceso. Por qué es importante Permite el cálculo de tiempos de procesamiento precisos para actividades individuales, ayudando a identificar los pasos que consumen más tiempo en el proceso. Dónde obtener Obtenido de campos de fecha de finalización en UKG Pro. Esto a menudo requiere emparejar un evento de inicio con un 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 de un empleado, como 'Voluntaria - Renuncia' o 'Involuntaria - Desempeño'.
Descripción Este atributo captura la razón por la cual se rescindió el empleo de un empleado. Las razones suelen clasificarse como voluntarias o involuntarias, con subcategorías más específicas.\n\nEste es un atributo crítico para el análisis de retención y rotación (churn). Al segmentar a los empleados cesados por su motivo de salida, las organizaciones pueden obtener insights profundos sobre las causas raíz de la rotación de personal. Por ejemplo, analizar la 'Tasa de Rotación Temprana de Empleados' ('Early Employee Churn Rate') por motivo de terminación puede distinguir entre malas decisiones de contratación y ofertas competitivas. Por qué es importante Proporciona una visión crítica sobre los impulsores de la rotación de empleados, lo que permite estrategias de retención orientadas. Dónde obtener Este campo suele registrarse durante el proceso de terminación u offboarding dentro del módulo Core HR de UKG Pro. Ejemplos Voluntario - Otra OportunidadInvoluntario - DesempeñoJubilación
	Motivo del cambio de rol RoleChangeReason	El motivo de un cambio en el rol de un empleado, como 'Promoción', 'Traslado Lateral' o 'Reorganización'.
Descripción Este atributo proporciona contexto para los eventos de movilidad interna. Explica por qué se cambió el rol o la posición de un empleado dentro de la organización.\n\nEsto es esencial para el dashboard y KPI de 'Tiempo de Ciclo de Movilidad Interna' ('Internal Mobility Cycle Time'), ya que permite diferenciar entre ascensos y otros tipos de traslados. Analizar el proceso por motivo puede revelar si los procesos de ascenso son más lentos que los movimientos laterales, ayudando a optimizar las trayectorias de desarrollo profesional. Por qué es importante Explica el contexto detrás de los movimientos internos, permitiendo un análisis más matizado de los procesos de movilidad interna como promociones frente a transferencias laterales. Dónde obtener Esta información suele capturarse como parte de la transacción de cambio de puesto o traslado en el módulo Core HR de UKG Pro. Ejemplos PromociónTransferencia LateralReorganización
	Nombre de Capacitación TrainingName	El nombre o título del curso de capacitación asignado al empleado.
Descripción Este atributo identifica un módulo de formación o aprendizaje específico que se le ha asignado a un empleado. Esto podría abarcar desde una capacitación obligatoria de cumplimiento hasta el desarrollo de habilidades específicas del puesto.\n\nEste es un atributo clave para el dashboard de 'Asignación y Finalización de Capacitación' ('Training Assignment & Completion') y el KPI de 'Tasa de Finalización de Capacitación' ('Training Completion Rate'). Permite seguir el progreso y la efectividad de programas de capacitación específicos y analizar los tiempos de finalización en diferentes cursos. Por qué es importante Permite el seguimiento y análisis de programas de capacitación específicos, ayudando a medir el cumplimiento y la efectividad del desarrollo. Dónde obtener Obtenido del módulo de Aprendizaje de UKG Pro o de un Sistema de Gestión del Aprendizaje (LMS) conectado. Ejemplos Código de Conducta 2024Habilidades avanzadas de gestiónConcienciación sobre Ciberseguridad
	Tiempo de Procesamiento ProcessingTime	La duración calculada de una sola actividad, desde su inicio hasta su finalización.
Descripción Tiempo de procesamiento mide el tiempo dedicado a una tarea específica, calculado como la diferencia entre la Hora de finalización del evento y el timestamp del evento (Hora de inicio). Representa el 'tiempo de servicio' para una actividad. Esta métrica es crucial para identificar qué actividades específicas consumen más tiempo en el proceso. Por ejemplo, puede destacar que la actividad 'Verificación de antecedentes iniciada' toma, en promedio, cinco días para completarse, lo que la convierte en un claro objetivo de optimización. Por qué es importante Cuantifica la duración de tareas individuales, permitiendo la optimización dirigida de las actividades que más tiempo consumen en el proceso. Dónde obtener Este atributo se calcula durante la preparación de datos restando el Event Timestamp del Event End Time. Ejemplos 28800086400604800
	Ubicación Location	La ubicación geográfica u oficina donde se encuentra el empleado.
Descripción Este atributo especifica la ubicación de trabajo principal del empleado, que podría ser una ciudad, un país o un edificio de oficina específico. Es una dimensión clave para el análisis geográfico de los procesos de RR.HH.\n\nAnalizar el rendimiento del proceso por ubicación puede revelar diferencias regionales en la eficiencia de contratación, las prácticas de incorporación o las tasas de rotación. Por ejemplo, podría comparar el 'Tiempo de Ciclo de Reclutamiento' ('Recruitment Cycle Time') entre las oficinas de 'Nueva York' y 'Londres' para identificar las mejores prácticas o cuellos de botella localizados. Por qué es importante Permite la segmentación geográfica del proceso, revelando variaciones regionales en el rendimiento y el cumplimiento. Dónde obtener 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

Requerido Recomendado Opcional

Actividades del Ciclo de Vida del Empleado de Contratación a Jubilación

Estos son los pasos y hitos clave del proceso que debe capturar en su registro de eventos para un descubrimiento y optimización de procesos precisos.

6 Recomendado 9 Opcional

	Actividad	Descripción
	Empleado Contratado	Marca la creación oficial del registro del empleado en UKG Pro, donde se asigna formalmente un ID de empleado. Este evento se captura generalmente cuando un administrador de RRHH finaliza el proceso de contratación de un candidato, transicionándolo a un empleado activo dentro del sistema.
Por qué es importante Este es el evento de inicio definitivo para el análisis del proceso De contratación a retiro. Proporciona la base para medir el tiempo hasta la productividad, la eficiencia del onboarding y la antigüedad total en la empresa. Dónde obtener Este evento probablemente se registra en el módulo de HR Core o Administración de Personal. Se puede identificar por la fecha de creación del registro de empleo principal del empleado o un registro de acción específico de 'Contratación' ('Hire') en el historial de datos de empleo del empleado. Capturar Se captura a partir de la fecha de vigencia de la acción 'Hire' en la tabla de historial del puesto de la persona empleada. Tipo de evento explicit
	Empleado Incorporado	Un hito clave que indica la finalización correcta de la lista de verificación o del workflow inicial de onboarding. Suele significar que ya se completó toda la documentación de ingreso, las solicitudes de acceso a sistemas y las tareas administrativas iniciales.
Por qué es importante Marca el final de la configuración administrativa inicial, permitiendo el análisis del tiempo de ciclo total del onboarding. Significa el punto en el que el empleado está administrativamente listo para comenzar sus funciones específicas del puesto. Dónde obtener Ubicado en el módulo de Onboarding. Se suele inferir de la marca de tiempo de finalización del workflow general de onboarding o cuando la última tarea obligatoria de onboarding se marca como completada. Capturar Se infiere a partir de la marca de tiempo de finalización de la lista de verificación maestra de incorporación para el empleado. Tipo de evento inferred
	Empleado Terminado	El evento final en el ciclo de vida del empleado, que representa el fin oficial del empleo. Es cuando el registro del empleado se vuelve inactivo en el sistema a partir de la fecha efectiva de terminación.
Por qué es importante Este es el evento de cierre definitivo del proceso, crucial para calcular la antigüedad final del empleado y analizar la rotación. Cierra el ciclo del recorrido del empleado en la empresa. Dónde obtener Esta es la fecha de vigencia de la acción final 'Termination' en el historial de datos laborales del empleado dentro del módulo Core HR. En esa fecha, el sistema suele cambiar el estado del empleado de activo a inactivo. Capturar Se captura a partir de la fecha de vigencia de la acción 'Termination' en el historial del puesto de la persona empleada. Tipo de evento explicit
	Promoción aprobada	Indica la aprobación formal del ascenso de un empleado, lo que generalmente incluye un cambio en el cargo y, a menudo, en la compensación. Este es un evento distinto que precede a la fecha de efectividad 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 un ascenso y su fecha efectiva puede revelar cuellos de botella administrativos en el sistema. Dónde obtener Registrado como una acción laboral específica, como 'Promoción', en el historial de datos laborales del empleado dentro del módulo HR Core. El registro tendrá sus propias fechas de aprobación y efectividad. Capturar Se captura a partir de la fecha de registro de una acción 'Promotion' en el historial del puesto. Tipo de evento explicit
	Revisión de Desempeño Realizada	Representa la finalización de un ciclo formal de evaluación de desempeño para un empleado. Este evento se registra cuando el formulario de revisión es finalizado y enviado por el gerente o RRHH.
Por qué es importante Este es un hito recurrente clave en el ciclo de vida del empleado. Controlar su frecuencia y puntualidad ayuda a evaluar el cumplimiento de la gestión del desempeño y su impacto en el desarrollo profesional. Dónde obtener Se encuentra en el módulo de Performance Management de UKG Pro. Puede identificarse por la fecha de finalización del formulario de revisión de desempeño o un cambio de estado a 'Completado' para un ciclo de revisión. Capturar Se captura a partir de la marca de tiempo de finalización de la instancia del workflow de evaluación de desempeño. Tipo de evento explicit
	Terminación Iniciada	Representa el inicio del proceso de desvinculación, el cual se registra cuando se introduce una fecha de finalización futura en el sistema. Este evento activa listas de verificación y flujos de trabajo de desvinculación.
Por qué es importante Este es un hito crítico que inicia el proceso de salida del empleado. Analizar el tiempo entre este evento y la baja definitiva ayuda a evaluar la eficiencia y la integridad de los procedimientos de offboarding. Dónde obtener Normalmente es la creación de un registro de acción 'Termination' en los datos laborales del empleado, con una fecha de vigencia futura. También puede ser el inicio de un workflow de offboarding en un módulo específico. Capturar Se captura cuando se envía una transacción de terminación con fecha futura. Tipo de evento explicit
	Cambio de rol procesado	Representa un cambio en el puesto o posición del empleado que no es una promoción, como un traslado lateral o un cambio de departamento. Esto se registra cuando los datos de puesto relevantes se actualizan en el sistema.
Por qué es importante Analizar los cambios de rol aporta visibilidad sobre la movilidad interna, la asignación de talento y las reestructuraciones. Ayuda a entender cómo se mueven las personas dentro de la organización. Dónde obtener Se obtiene del historial de datos del puesto en el módulo Core HR. Puede identificarse por acciones como 'Transfer', 'Re-assignment' o 'Position Change', junto con sus fechas de vigencia. Capturar Identificado por un código de acción como 'Transferencia' o similar en el historial de datos laborales del empleado. Tipo de evento explicit
	Capacitación Asignada	Registra el momento en que se asigna un curso de formación o un plan de aprendizaje específico a una persona empleada. Normalmente se registra en el módulo de gestión del aprendizaje del sistema.
Por qué es importante Esta actividad ayuda a rastrear el cumplimiento de capacitaciones obligatorias y monitorea el desarrollo de los empleados. Analizar el tiempo entre la asignación y la finalización puede resaltar problemas de compromiso o la efectividad de la capacitación. Dónde obtener Registrado en los módulos de gestión del aprendizaje o gestión del talento de UKG Pro. Cada asignación debe tener un registro correspondiente con una fecha de asignación y un ID de empleado. Capturar Registrado cuando un curso o plan de estudios se asigna al plan de aprendizaje de un empleado. Tipo de evento explicit
	Compensación Cambiada	Este evento captura cualquier cambio en el salario base de un empleado, la estructura de bonificaciones u otros componentes de compensación. Puede ser parte de un ascenso, un aumento por mérito o un ajuste de mercado.
Por qué es importante Hacer seguimiento de los cambios de compensación es vital para entender la evolución profesional y salarial. Ajustes frecuentes tras la contratación pueden indicar errores de registro o problemas con la definición salarial inicial. Dónde obtener Se encuentra en la tabla de historial de compensaciones del empleado dentro del módulo de HR Core o Payroll. Cada cambio se registra típicamente con una fecha de efectividad y un código de motivo. Capturar Registrado a partir de la fecha de efectividad de una nueva entrada en el registro del historial de compensación del empleado. Tipo de evento explicit
	Configuración de Nómina Completada	Indica que toda la información necesaria para procesar el pago del empleado, como los detalles bancarios y los formularios de impuestos, ha sido ingresada y verificada. Este es un paso crítico para asegurar que el empleado reciba su pago correcta y puntualmente.
Por qué es importante Este hito es clave para medir la preparación de las nuevas incorporaciones. Los retrasos en el alta de nómina pueden provocar insatisfacción y retrabajo administrativo, por lo que es un indicador clave del onboarding. Dónde obtener Este evento puede inferirse del módulo de Nómina de UKG Pro. Puede derivarse de la fecha de finalización de una lista de verificación de preparación de nómina ('payroll readiness checklist') o de la fecha en que el estado del empleado cambia a 'Listo para Nómina' ('Ready for Payroll'). Capturar Derivado de un cambio de estado o timestamp de finalización en el perfil de nómina del empleado. Tipo de evento inferred
	Desvinculación Completada	Un hito que indica que todas las tareas obligatorias de offboarding se han completado. Incluye actividades como devolución de activos, cálculo de la nómina final y revocación de accesos a sistemas.
Por qué es importante Este evento confirma que se han tomado todos los pasos necesarios para separar al empleado de manera segura y conforme al cumplimiento. Ayuda a medir el tiempo de ciclo de desvinculación y a identificar brechas de cumplimiento. Dónde obtener Se infiere a partir del timestamp de finalización de la checklist o del workflow general de offboarding, similar al evento 'Employee Onboarded' pero aplicado al proceso de salida. Capturar Se infiere a partir de la marca de tiempo de finalización de la lista de verificación maestra de desvinculación para el empleado. Tipo de evento inferred
	Entrevista de Salida Realizada	Este evento marca la finalización de la entrevista de salida con el empleado que se marcha. Se suele registrar como una tarea completada en una lista de verificación de desvinculación ('offboarding checklist').
Por qué es importante Registrar la finalización de las entrevistas de salida es importante para asegurar el cumplimiento de RR. HH. y obtener feedback valioso. Ayuda a detectar si este paso crucial se está omitiendo en el offboarding. Dónde obtener Este evento probablemente se encuentre en el módulo de Onboarding o HR Help Desk de UKG Pro como una tarea específica dentro de un workflow de offboarding. Su captura depende de que RR. HH. marque manualmente la tarea como completada. Capturar Registrado como una tarea completada dentro de la lista de verificación de desvinculación de un empleado. Tipo de evento explicit
	Gerente Cambiado	Este evento se genera cuando se actualiza el campo 'Reporta a' ('Reports To') o 'ID de Gerente' ('Manager ID') para un empleado. Representa un cambio en la línea de reporte directo del empleado.
Por qué es importante Los cambios de gerente pueden afectar significativamente el compromiso y el rendimiento de los empleados. El seguimiento de este evento permite analizar su efecto en actividades posteriores como las evaluaciones de desempeño o la retención. Dónde obtener Este evento debe inferirse mediante el seguimiento de los cambios en el campo de gerente o supervisor en los datos de empleo del empleado a lo largo del tiempo. Requiere comparar el ID de gerente entre registros consecutivos para el mismo empleado. Capturar Se infiere al detectar un cambio en el campo 'Reporta a' en el historial de datos laborales del empleado. Tipo de evento inferred
	Inicio de Ausencia Laboral	Marca el inicio de una ausencia laboral aprobada para un empleado, como por razones médicas o personales. Esto se registra cuando el estado del empleado cambia a inactivo, en estado de licencia.
Por qué es importante Identifica los períodos de inactividad en el ciclo de vida de un empleado. Es crucial para calcular con precisión la antigüedad activa y comprender el impacto de las licencias en la progresión profesional. Dónde obtener Se encuentra en el historial de datos laborales del empleado dentro del módulo de HR Core. Esto corresponde a una acción laboral como 'Licencia por Ausencia' con una fecha de inicio efectiva específica. Capturar Se captura a partir de la fecha de vigencia de una acción 'Start Leave' en el historial del puesto. Tipo de evento explicit
	Onboarding Iniciado	Representa el inicio del proceso de incorporación de nuevos empleados o flujo de trabajo dentro de UKG Pro. Este es típicamente un evento automatizado o activado manualmente que asigna una lista de verificación de tareas al nuevo empleado, a su gerente y a RRHH.
Por qué es importante Registrar esta actividad ayuda a medir el tiempo 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 onboarding e identificar retrasos. Dónde obtener Se encuentra en el módulo de Onboarding de UKG Pro. El evento puede inferirse de la fecha de creación de la lista de verificación de incorporación o de la instancia de workflow asociada al empleado. Capturar Se infiere a partir de la marca de tiempo de creación del workflow de incorporación o lista de tareas del empleado. 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+ y las bibliotecas requests y pandas instaladas. Puede instalarlas con pip: pip install requests pandas.
Acceso a la API y autenticación: Póngase en contacto con su administrador o administradora de UKG Pro para crear una Service Account. Necesitará el API Key, User Name y Password. La Service Account debe tener permisos para acceder a todos los endpoints necesarios de la API, incluidos personal, nómina, onboarding, desempeño y aprendizaje.
Configurar el script: Abra el script de Python en un editor de texto o IDE. Busque la sección de configuración al inicio del script y reemplace los valores de ejemplo de UKG_BASE_URL, API_KEY, USERNAME, PASSWORD y COMPANY_ID por sus credenciales y detalles de entorno.
Definir el rango de fechas de extracción: En la sección de configuración, defina las variables START_DATE y END_DATE. Esto determina la ventana de tiempo de la que se extraerán cambios y eventos de personas empleadas. Se recomienda empezar con un rango pequeño, como 3–6 meses, para probar el script.
Ejecutar el script: Ejecútelo 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.
Gestionar la limitación de la API: El script incluye un time.sleep() básico para respetar los límites de la API. Si recibe errores por limitación (HTTP 429), quizá deba aumentar el tiempo de espera entre llamadas a la API.
Transformar y estandarizar los datos: Cada función del script está diseñada para obtener datos en bruto de una actividad específica, seleccionar los campos relevantes y renombrarlos al formato estándar de registro de eventos (EmployeeId, ActivityName, EventTimestamp, etc.).
Combinar los datos de eventos: La parte principal del script llama a cada función específica por actividad y agrega los resultados en una única lista maestra de eventos.
Generar el registro de eventos: Tras procesar todas las actividades, el script consolida los datos en un DataFrame de pandas, los ordena por ID de empleado y marca de tiempo, y los guarda como un archivo CSV llamado ukg_hire_to_retire_event_log.csv.
Revisar y cargar: Abra el archivo CSV generado para verificar que los datos estén completos y con el formato correcto. Este archivo ya está listo para cargarlo en la herramienta de Process Mining.

Configuración

Credenciales de Autenticación: Para la autenticación de la API, se requieren las credenciales de una cuenta de servicio: una Clave de API, un Nombre de Usuario y una Contraseña.
URL Base: La UKG_BASE_URL de su instancia de UKG Pro (por ejemplo, https://service[##].ultipro.com/api).
ID de Compañía: El COMPANY_ID único de su organización dentro de UKG Pro es necesario para muchas llamadas a la API.
Rango de Fechas: Los parámetros START_DATE y END_DATE (en formato 'YYYY-MM-DD') controlan la ventana de extracción. Para la ejecución inicial, se recomienda un período de 3 a 6 meses para gestionar el volumen de datos y verificar los resultados.
Versiones del Endpoint de la API: El script utiliza versiones específicas de las API REST (por ejemplo, /personnel/v1/). Asegúrese de que su instancia de UKG Pro sea compatible con estas versiones.
Dependencias de Módulo: La extracción de ciertas actividades requiere que su organización haya licenciado y esté utilizando activamente los módulos correspondientes de UKG Pro, como Onboarding, Learning y Performance Management. Si un módulo no está en uso, la actividad correspondiente no se extraerá.

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}")