> Melhoria Contínua de Processos > Da contratação à aposentadoria ciclo de vida do colaborador > UKG Pro > Modelo de Dados

Template de Dados: Da contratação à aposentadoria - Ciclo de Vida do Colaborador

UKG Pro

← Voltar ao Guia de Melhoria

Da contratação à aposentadoria - atributos do ciclo de vida do colaborador (22) Da contratação à aposentadoria - atividades do ciclo de vida do colaborador (15) Guias de Extração (1)

Seu Template de dados do ciclo de vida do colaborador (Hire to Retire)

Este template traz uma visão geral abrangente dos elementos de dados essenciais para analisar com eficiência o seu processo de Admissão a Desligamento. Ele descreve os atributos cruciais a coletar, as atividades-chave a acompanhar e orientações práticas para extrair esses dados do UKG Pro. Use este recurso para agilizar a preparação dos dados e começar sua jornada de Process Mining com o pé direito.

Atributos recomendados para coletar
Atividades-chave a monitorizar
Orientações de extração para o UKG Pro

É novo em event logs? Saiba como criar um event log para Process Mining.

Baixar Modelo

Da contratação à aposentadoria - atributos do ciclo de vida do colaborador

Estes são os campos de dados recomendados para incluir no seu Event Log e viabilizar uma análise completa do ciclo de vida do colaborador, do recrutamento à aposentadoria (Hire to Retire), com insights acionáveis.

5 Obrigatório 7 Recomendado 10 Opcional

	Nome	Descrição
	Event Timestamp EventTimestamp	A data e a hora exatas em que um evento específico do ciclo de vida ocorreu.
Descrição O timestamp do evento fornece o contexto cronológico de cada atividade e é a espinha dorsal do fluxo do processo. Ele registra o momento exato em que um evento como 'Oferta Aceita' ou 'Promoção Aprovada' foi registrado no sistema. Na análise, esses timestamps são usados para calcular as durações entre atividades, identificar atrasos e medir tempos de ciclo de subprocessos críticos como recrutamento e onboarding. Timestamps precisos são fundamentais para todos os KPIs baseados em tempo e para a análise de performance. Por que é importante Este atributo é essencial para ordenar os eventos em ordem cronológica e calcular todas as métricas de tempo, como tempos de ciclo e durações. Onde obter Obtido de campos de data ou timestamp associados a eventos específicos no UKG Pro, como 'HireDate', 'TerminationDate' ou timestamps de mudança de status nos módulos de workflow. Exemplos 2023-01-15T09:00:00Z2023-06-20T14:35:10Z2024-02-01T11:00:00Z
	ID do Funcionário EmployeeId	O identificador único atribuído a cada colaborador, que funciona como o case ID principal de todo o seu ciclo de vida na organização.
Descrição O ID do colaborador funciona como o fio condutor que conecta todos os eventos relacionados a ele, desde a candidatura inicial até o offboarding final. Esse identificador é essencial para montar uma visão ponta a ponta da jornada de cada pessoa. Na análise de Process Mining, toda atividade — como 'Colaborador Admitido', 'Promoção Aprovada' ou 'Desligamento Iniciado' — é vinculada a esse ID único. Isso permite analisar jornadas individuais, fazer análises por coortes com base em atributos dos colaboradores e calcular com precisão as durações ao longo do ciclo de vida. Por que é importante Este é o identificador essencial do caso que conecta todos os eventos relacionados ao colaborador, tornando possível analisar, de ponta a ponta, o processo de Hire to Retire de cada indivíduo. Onde obter Este é um campo central no UKG Pro, normalmente presente no perfil do colaborador ou nos registros de dados mestres. Consulte a documentação do UKG Pro para a tabela e o nome do campo específicos, frequentemente rotulados como Employee Number ou Person ID. Exemplos 10052198345210047
	Nome da Atividade ActivityName	O nome do evento ou marco ocorrido no ciclo de vida do colaborador, como 'Colaborador Admitido' ou 'Avaliação de Desempenho Realizada'.
Descrição O nome da atividade descreve um passo ou tarefa específica no processo de contratação à aposentadoria. Esses eventos são registrados com timestamp e ordenados para formar o fluxo do processo que é visualizado e analisado em Process Mining. Ao analisar a sequência e a frequência dessas atividades, você vê como o processo acontece de fato. Isso ajuda a identificar caminhos recorrentes, desvios do fluxo padrão e gargalos entre atividades-chave, como 'Onboarding Iniciado' e 'Configuração da Folha de Pagamento Concluída'. Por que é importante Esse atributo define as etapas no mapa do processo, permitindo visualizar e analisar o fluxo do ciclo de vida do colaborador. Onde obter Geralmente é derivado de Event Logs, mudanças de status de workflow ou campos de data específicos em vários módulos do UKG Pro (por exemplo, Recruiting, Onboarding, Performance Management). Normalmente é necessário aplicar uma lógica de mapeamento para gerar nomes padronizados de atividades. Exemplos Colaborador contratadoRevisão de performance realizadaDesligamento Iniciado
	Sistema de Origem SourceSystem	Identifica o sistema de onde os dados foram extraídos — neste caso, o UKG Pro.
Descrição Este atributo especifica a origem dos dados do processo. Embora, neste contexto, seja principalmente o UKG Pro, um processo de Hire to Retire pode envolver dados de outros sistemas, como um Applicant Tracking System (ATS) ou um Learning Management System (LMS). Na análise, ajuda a diferenciar as fontes quando vários sistemas estão envolvidos e é crucial para governança de dados e resolução de problemas. Em uma visão de fonte única, fornece o contexto essencial sobre a origem dos dados. Por que é importante Oferece contexto essencial para governança de dados, garantia de qualidade e rastreabilidade ao identificar a origem dos eventos. Onde obter Normalmente é um valor estático ('UKG Pro') adicionado durante o processo de transformação e extração de dados. Exemplos UKG ProUKGPro_CoreHRUKG
	Última Atualização de Dados LastDataUpdate	O timestamp que indica quando os dados deste evento foram atualizados ou extraídos do sistema de origem pela última vez.
Descrição Este atributo informa o timestamp da última extração de dados do UKG Pro. Não é o momento em que o evento de negócio ocorreu, e sim quando o registro foi trazido para a ferramenta de Process Mining. Essa informação é vital para entender a atualidade dos dados analisados. Permite que analistas e usuários de negócio saibam quão recente é a visão do processo e ajuda a gerenciar cronogramas de atualização e a validar o quão recentes são os insights. Por que é importante Indica a atualidade dos dados, essencial para confiar na análise e tomar decisões no tempo certo. Onde obter Esse timestamp é gerado e anexado a cada registro durante o processo de extração, transformação e carregamento (ETL) dos dados. Exemplos 2024-03-15T02:00:00Z2024-03-16T02:00:00Z2024-03-17T02:00:00Z
	Data de admissão HireDate	A data oficial de início do vínculo do colaborador com a organização.
Descrição A Data de Admissão marca o início do tempo de casa do colaborador. É um campo de data fundamental que serve de base para vários cálculos e análises relacionadas ao ciclo de vida do colaborador. Esse atributo é usado para calcular o tempo de casa, essencial para analisar a 'Taxa de Rotatividade Precoce'. Também apoia análises por coorte, permitindo comparar padrões de ciclo de vida de colaboradores admitidos em períodos diferentes. Por que é importante Serve de base para calcular o tempo de casa do colaborador e é essencial para análises de coorte e KPIs de rotatividade. Onde obter Este é um campo padrão e obrigatório no registro principal do colaborador no módulo Core HR do UKG Pro. Exemplos 2022-08-152023-01-202021-05-10
	Departamento EmployeeDepartment	O departamento ou a unidade organizacional à qual o colaborador está lotado.
Descrição Esse atributo contém o nome do departamento ao qual o colaborador está alocado, como 'Sales', 'Engineering' ou 'Finance'. É uma dimensão organizacional chave para segmentar e comparar a performance de processos. Análises por departamento permitem comparar a execução do processo entre diferentes unidades de negócio. Por exemplo, é possível verificar se o 'Tempo de ciclo de recrutamento' é maior em áreas técnicas ou se a 'Aderência às avaliações de desempenho' varia significativamente entre Vendas e Operações, gerando insights direcionados para melhoria. Por que é importante Permite uma análise comparativa robusta ao filtrar e segmentar o processo pela estrutura organizacional, evidenciando variações entre áreas. Onde obter Este é um campo padrão no registro de cargo ou posição do colaborador dentro do módulo Core HR do UKG Pro. Exemplos EngenhariaVendasRecursos Humanos
	ID da requisição de vaga JobRequisitionId	O identificador único da requisição de vaga que iniciou o processo de contratação.
Descrição O Job Requisition ID é a referência única de uma vaga específica. Ele conecta todas as atividades iniciais do recrutamento, da criação e aprovação à busca de candidatos e envio de propostas. Esse ID é essencial para analisar o KPI de 'Tempo de Ciclo de Recrutamento', pois marca o início real do processo de contratação. Permite acompanhar todo o funil de uma vaga e avaliar métricas como a 'Taxa de Requisições de Vaga Inativas', identificando aquelas que não avançam. Por que é importante Fornece um ponto de partida claro para o recrutamento, permitindo medir com precisão o tempo de ciclo de contratação e a eficácia das requisições. Onde obter Localizado no módulo Recruiting do UKG Pro ou no Applicant Tracking System (ATS) conectado. Exemplos REQ-2023-015REQ-2024-112REQ-2023-504
	Nome do gestor ManagerName	O nome do gestor direto ou supervisor do colaborador.
Descrição Esse atributo identifica o gestor direto do colaborador. O gestor é peça central em vários eventos do ciclo de vida, incluindo avaliações de desempenho, promoções e atribuição de treinamentos. Análises por gestor ajudam a entender variações na execução em nível de time e a efetividade de liderança. O dashboard 'Análise do Impacto de Transição de Gestor', por exemplo, usa esse atributo para ver como a troca de gestor afeta atividades subsequentes. Também é chave para o KPI 'Tempo até o reengajamento do gestor'. Por que é importante Permite analisar o desempenho do processo no nível da equipe e avaliar o impacto dos gestores nos eventos do ciclo de vida do colaborador. Onde obter Esta informação faz parte dos dados de estrutura de reporte do colaborador no módulo Core HR do UKG Pro. Exemplos John SmithMaria GarciaChen Wei
	Status do vínculo empregatício EmploymentStatus	A situação atual ou histórica do vínculo do colaborador, como 'Ativo', 'Desligado' ou 'Em licença'.
Descrição Este atributo indica a situação oficial do colaborador na empresa em determinado momento. É uma dimensão essencial para entender o estado geral da força de trabalho e para filtrar as análises por populações específicas de colaboradores. Analisar mudanças no status de emprego ajuda a modelar o processo corretamente — por exemplo, distinguindo uma licença temporária de um desligamento definitivo. É fundamental para calcular taxas de rotatividade e entender os desfechos de diferentes trajetórias no ciclo de vida. Por que é importante Fornece contexto essencial sobre a situação do colaborador, possibilitando análise precisa de rotatividade e segmentação da força de trabalho. Onde obter Este é um campo central no registro mestre do colaborador no módulo Core HR do UKG Pro. Exemplos AtivoEncerradoAfastamento
	Título do cargo JobTitle	O título oficial do cargo do colaborador, como 'Engenheiro de Software' ou 'Gerente de Vendas'.
Descrição O Cargo descreve o papel ou a posição do colaborador na organização. Esse atributo é uma dimensão-chave para entender como os processos variam entre funções e níveis de senioridade. Nas análises, o Cargo pode ser usado para comparar tempos de onboarding entre funções, avaliar o tempo até promoções e identificar se certos cargos têm maior taxa de rotatividade precoce. Isso ajuda a ajustar processos de RH e programas de suporte às necessidades de cada grupo. Por que é importante Permite análises por cargo para entender como os processos do ciclo de vida variam entre funções e níveis de senioridade. Onde obter Este é um campo padrão associado ao registro de posição ou cargo do colaborador no módulo Core HR do UKG Pro. Exemplos Engenheiro de Software IIGerente de Produto SêniorBusiness Partner de RH
	Usuário que realizou a ação ActioningUser	O nome ou ID do usuário — normalmente alguém de RH ou um gestor — que executou a atividade no UKG Pro.
Descrição Esse atributo identifica a pessoa responsável por executar uma etapa específica do processo, como o recrutador que enviou a oferta ou o gestor que aprovou uma promoção. Ele conecta as atividades do processo aos atores humanos. Nas análises, esse atributo é valioso para entender a distribuição de carga de trabalho, identificar necessidades de treinamento e avaliar a performance por usuário. Por exemplo, pode indicar se erros de digitação após 'Payroll Setup Completed' se concentram em usuários específicos, apoiando o KPI 'Taxa de retrabalho de dados pós-onboarding'. Por que é importante Associa as atividades do processo a usuários específicos, permitindo analisar a carga de trabalho, comparar performance e investigar retrabalho e erros. Onde obter Geralmente encontrado em registros de auditoria ou nos campos 'Last Modified By' nos módulos do UKG Pro. O nome exato do campo varia conforme o módulo. Exemplos j.does.smithhr_admin
	Avaliação de performance PerformanceRating	A nota atribuída ao colaborador durante um ciclo de avaliação de desempenho.
Descrição A Nota de Desempenho é o resultado da atividade 'Avaliação de Desempenho Realizada', normalmente em uma escala (por exemplo, 1–5) ou com rótulos descritivos (por exemplo, 'Supera as expectativas'). Ela quantifica a avaliação de performance do colaborador. Esse atributo é valioso para correlacionar eventos do processo com resultados de performance. Por exemplo, é possível analisar se quem tem alta performance é promovido mais rápido ou se existe relação entre notas de desempenho e rotatividade. É um elemento central do dashboard 'Conformidade do Ciclo de Avaliação de Desempenho'. Por que é importante Conecta eventos do processo a resultados de performance, permitindo analisar a efetividade da gestão de talentos e seu impacto na retenção. Onde obter Localizado no módulo de Performance Management do UKG Pro, vinculado a ciclos de avaliação específicos. Exemplos Acima das expectativasAtende às expectativasPrecisa melhorar5
	Data de desligamento TerminationDate	A data oficial de término do vínculo do colaborador.
Descrição A Data de Desligamento marca a conclusão do tempo de casa do colaborador. É o ponto final do ciclo de vida do colaborador na organização. Esse atributo é necessário para calcular o tempo de casa total e é um componente-chave da análise de rotatividade. O intervalo entre a Data de Admissão e a Data de Desligamento serve de base para o dashboard 'Insights de Rotatividade no Início do Tempo de Casa' e KPIs relacionados. Por que é importante Define o fim do ciclo de vida do colaborador, permitindo calcular o tempo total de casa e dando suporte a todas as análises de rotatividade. Onde obter Este é um campo padrão no registro principal do colaborador no UKG Pro, preenchido quando o processo de rescisão é concluído. Exemplos 2023-11-302024-02-152022-12-31
	É rotatividade precoce IsEarlyChurn	Indicador booleano que sinaliza se o desligamento ocorreu dentro de um período inicial predefinido (por exemplo, 90 ou 180 dias).
Descrição Este atributo calculado sinaliza colaboradores que deixam a organização pouco tempo após a contratação. O limite para 'inicial' é normalmente definido pelo negócio, por exemplo, dentro do primeiro ano. Esse indicador simplifica a análise necessária para o dashboard 'Early Tenure Churn Insights' e o KPI 'Early Employee Churn Rate'. Ele permite filtrar e segmentar rapidamente para isolar esse grupo de alto interesse e analisar suas características e padrões de ciclo de vida, ajudando a identificar problemas em recrutamento ou onboarding. Por que é importante Apoia diretamente a análise de desligamento precoce ao sinalizar casos em risco, ajudando a identificar as causas raiz das saídas antecipadas. Onde obter Durante a preparação dos dados, este atributo é calculado. A lógica compara a diferença entre 'TerminationDate' e 'HireDate' com um limite predefinido (por exemplo, 365 dias). Exemplos verdadeirofalse
	Event End Time EventEndTime	O timestamp que marca a conclusão de uma atividade com duração mensurável.
Descrição Para atividades que não são instantâneas, o horário de término do evento registra quando a atividade foi concluída. Isso contrasta com o carimbo de data e hora do evento (StartTime), que marca o início. Ter início e fim permite calcular com precisão o tempo de processamento de atividades individuais, como 'Verificação de antecedentes' ou 'Tarefa de integração'. Isso viabiliza uma análise mais granular de onde o tempo é gasto no processo. Por que é importante Permite calcular tempos de processamento precisos por atividade, ajudando a identificar as etapas que mais consomem tempo no processo. Onde obter Obtido a partir dos campos de data de conclusão no UKG Pro. Muitas vezes é necessário vincular um evento de início ao evento de conclusão correspondente nos dados de origem. Exemplos 2023-01-15T17:30:00Z2023-06-21T10:00:00Z2024-02-01T11:05:00Z
	Faixa salarial SalaryGrade	O nível ou a faixa de remuneração associados ao cargo do colaborador.
Descrição Faixa salarial representa o nível de remuneração de um determinado cargo. É um atributo-chave para analisar atividades e tendências relacionadas à compensação. Esse atributo é importante em análises de eventos como 'Remuneração alterada' e pode ser usado para acompanhar o KPI 'Taxa de retrabalho de dados pós-onboarding' quando houver correções frequentes de faixas salariais. Também permite segmentar para verificar se o tempo de ciclo de promoções ou as taxas de rotatividade variam por nível de remuneração. Por que é importante Fornece contexto para atividades relacionadas à remuneração e permite segmentar o processo por nível de remuneração. Onde obter Disponível no perfil de remuneração ou de cargo do colaborador no módulo Core HR do UKG Pro. Exemplos IC3M2D1
	Localização Location	A localidade ou o escritório onde o colaborador trabalha.
Descrição Este atributo indica o local principal de trabalho do colaborador, que pode ser uma cidade, país ou um edifício específico. É uma dimensão-chave para a análise geográfica de processos de RH. Analisar o desempenho do processo por local pode revelar diferenças regionais na eficiência de contratação, nas práticas de onboarding ou nas taxas de rotatividade. Por exemplo, você pode comparar o 'Recruitment Cycle Time' entre os escritórios de 'New York' e 'London' para identificar boas práticas ou gargalos locais. Por que é importante Permite segmentar o processo por região, revelando variações de performance e conformidade. Onde obter Esta informação faz parte dos dados de cargo ou pessoais do colaborador no módulo Core HR do UKG Pro. Exemplos Nova York, NYLondres, Reino UnidoRemoto
	Motivo da mudança de cargo RoleChangeReason	O motivo da mudança de função do colaborador, como 'Promoção', 'Movimentação Lateral' ou 'Reorganização'.
Descrição Este atributo fornece contexto para eventos de mobilidade interna. Explica por que o cargo ou a posição de um colaborador foi alterado na organização. É essencial para o dashboard e o KPI de 'Internal Mobility Cycle Time', pois permite diferenciar promoções de outros tipos de movimentação. Analisar o processo por motivo pode revelar se promoções são mais lentas do que transferências laterais, ajudando a agilizar as trajetórias de carreira. Por que é importante Explica o contexto das movimentações internas, permitindo uma análise mais rica de processos de mobilidade como promoções versus transferências laterais. Onde obter Esta informação normalmente é capturada como parte da transação de mudança de cargo ou transferência no módulo Core HR do UKG Pro. Exemplos PromoçãoTransferência lateralReorganização
	Motivo do Desligamento TerminationReason	O motivo registrado para a saída do colaborador, como 'Voluntário - Pedido de demissão' ou 'Involuntário - Desempenho'.
Descrição Esse atributo registra o motivo do término do vínculo empregatício de um colaborador. Os motivos normalmente são categorizados como voluntários ou involuntários, com subcategorias mais específicas. É um atributo crítico para análises de retenção e rotatividade. Ao segmentar desligamentos pelo motivo de saída, a organização identifica as causas raiz da rotatividade. Por exemplo, analisar a 'Taxa de rotatividade precoce' por motivo de desligamento ajuda a diferenciar contratações malsucedidas de propostas mais competitivas. Por que é importante Oferece um insight essencial sobre os fatores da rotatividade, permitindo estratégias de retenção mais precisas. Onde obter Este campo normalmente é registrado durante o processo de rescisão ou de desligamento no módulo Core HR do UKG Pro. Exemplos Voluntário - Outra oportunidadeInvoluntário - DesempenhoAposentadoria
	Nome do treinamento TrainingName	O nome ou título do curso atribuído ao colaborador.
Descrição Esse atributo identifica um treinamento ou módulo de aprendizagem específico atribuído ao colaborador — desde treinamentos obrigatórios de conformidade até desenvolvimento de habilidades por função. É um atributo-chave para o dashboard 'Atribuição e Conclusão de Treinamentos' e para o KPI 'Taxa de conclusão de treinamento'. Ele permite acompanhar o progresso e a efetividade de programas específicos e analisar tempos de conclusão entre cursos. Por que é importante Permite acompanhar e analisar programas de treinamento específicos, ajudando a medir conformidade e efetividade dos programas de desenvolvimento. Onde obter Obtido no módulo Learning do UKG Pro ou em um Learning Management System (LMS) conectado. Exemplos Código de Conduta 2024Habilidades Avançadas de GestãoConscientização em Cibersegurança
	Tempo de Processamento ProcessingTime	A duração calculada de uma única atividade, do início ao fim.
Descrição Processing Time mede o tempo gasto em uma tarefa específica, calculado como a diferença entre o Event End Time e o Event Timestamp (StartTime). Representa o 'service time' de uma atividade. Esse indicador é crucial para identificar quais atividades consomem mais tempo no processo. Por exemplo, pode mostrar que a atividade 'Background Check Initiated' leva, em média, cinco dias para ser concluída, tornando-se um alvo claro para otimização. Por que é importante Quantifica a duração de tarefas individuais, permitindo otimizar de forma direcionada as atividades mais demoradas do processo. Onde obter Durante a preparação dos dados, este atributo é calculado subtraindo o 'Event Timestamp' do 'Event End Time'. Exemplos 28800086400604800

Obrigatório Recomendado Opcional

Da contratação à aposentadoria - atividades do ciclo de vida do colaborador

Estes são os principais passos e marcos do processo que devem ser capturados no seu Event Log para descobrir e otimizar o processo com mais precisão.

6 Recomendado 9 Opcional

	Atividade	Descrição
	Colaborador contratado	Marca a criação oficial do registro do colaborador no UKG Pro, quando um Employee ID é formalmente atribuído. Esse evento geralmente é capturado quando o RH finaliza a contratação do candidato, transformando-o em colaborador ativo no sistema.
Por que é importante Este é o evento inicial definitivo para a análise do processo de Hire to Retire. Ele fornece a base para medir o tempo até atingir produtividade, a eficiência do onboarding e o tempo de casa geral do colaborador. Onde obter Este evento provavelmente é registrado no módulo HR Core ou Personnel Administration. Pode ser identificado pela data de criação do registro principal de emprego do colaborador ou por um registro específico de ação 'Hire' no histórico de dados de cargo do colaborador. Captura Capturado a partir da data de vigência da ação 'Hire' na tabela de histórico de emprego do colaborador. Tipo de evento explicit
	Colaborador desligado	O evento final do ciclo de vida do colaborador, que representa o término oficial do vínculo. É quando o registro do colaborador fica inativo no sistema a partir da data efetiva de desligamento.
Por que é importante Este é o evento final definitivo do processo, crucial para calcular o tempo de casa total do colaborador e analisar a rotatividade. Ele fecha o ciclo da jornada do colaborador na empresa. Onde obter Esta é a data de vigência da ação final de 'Termination' no histórico de dados de cargo do colaborador dentro do módulo HR Core. O sistema normalmente altera o status do colaborador de ativo para inativo nessa data. Captura Capturado a partir da data de vigência da ação 'Termination' no histórico de emprego do colaborador. Tipo de evento explicit
	Desligamento Iniciado	Representa o início do processo de offboarding, registrado quando uma data futura de desligamento é lançada no sistema. Esse evento dispara checklists e workflows de offboarding.
Por que é importante Este é um marco crítico que inicia o processo de desligamento do colaborador. Analisar o tempo entre este evento e a rescisão final ajuda a avaliar a eficiência e a completude dos procedimentos de desligamento. Onde obter Geralmente, isso envolve a criação de um registro de ação 'Termination' nos dados de emprego do colaborador, com data efetiva futura. Também pode ser o início de um workflow de offboarding em um módulo específico. Captura Capturado quando uma transação de desligamento com data futura é enviada. Tipo de evento explicit
	Onboarding do colaborador concluído	Um marco importante que indica a conclusão bem-sucedida do checklist ou workflow inicial de onboarding. Normalmente significa que toda a papelada obrigatória do novo contratado, as solicitações de acesso a sistemas e as tarefas administrativas iniciais foram concluídas.
Por que é importante Marca o fim da configuração administrativa inicial, permitindo analisar o tempo total de onboarding. Indica que o colaborador está administrativamente pronto para iniciar as atividades específicas do cargo. Onde obter Localizado no módulo de Onboarding. Normalmente é inferido pela data e hora de conclusão do Workflow de onboarding como um todo ou quando a última tarefa obrigatória de onboarding é marcada como concluída. Captura Inferido a partir do carimbo de data e hora de conclusão do checklist principal de onboarding do colaborador. Tipo de evento inferred
	Promoção aprovada	Indica a aprovação formal da promoção de um colaborador, normalmente com mudança de cargo e, muitas vezes, de remuneração. É um evento distinto que antecede a data efetiva da mudança.
Por que é importante Essa atividade é essencial para analisar mobilidade interna e evolução de carreira. O tempo entre a aprovação da promoção e sua data de vigência pode evidenciar gargalos administrativos no sistema. Onde obter Registrado como uma ação específica de cargo, como 'Promoção', no histórico de dados do colaborador no módulo HR Core. O registro terá suas próprias datas de aprovação e de vigência. Captura Capturado a partir da data de registro de uma ação 'Promotion' no histórico de emprego do colaborador. Tipo de evento explicit
	Revisão de performance realizada	Representa a conclusão de um ciclo formal de avaliação de desempenho de um colaborador. O evento é registrado quando o formulário de avaliação é finalizado e enviado pelo gestor ou pelo RH.
Por que é importante Este é um marco recorrente e crítico no ciclo de vida do colaborador. Acompanhar sua frequência e pontualidade ajuda a avaliar a conformidade da gestão de desempenho e seu impacto na progressão de carreira. Onde obter Localizado no módulo de Performance Management do UKG Pro. Pode ser identificado pela data de conclusão do formulário de avaliação de desempenho ou por uma mudança de status para 'Completed' no ciclo de avaliação. Captura Capturado a partir do timestamp de conclusão da instância do Workflow de avaliação de desempenho. Tipo de evento explicit
	Configuração da folha de pagamento concluída	Indica que todas as informações necessárias para processar o pagamento do colaborador, como dados bancários e formulários fiscais, foram inseridas e validadas. Etapa crítica para garantir pagamento correto e no prazo.
Por que é importante Esse marco é crucial para medir a prontidão do novo contratado. Atrasos na configuração da folha de pagamento podem gerar insatisfação e retrabalho administrativo, tornando-o um indicador-chave de desempenho do onboarding. Onde obter Este evento pode ser inferido a partir do módulo Payroll do UKG Pro. Pode ser derivado da data de conclusão de um checklist de prontidão da folha de pagamento ou da data em que o status do colaborador muda para 'Ready for Payroll'. Captura Derivado de uma mudança de status ou do carimbo de data e hora de conclusão no perfil de folha de pagamento do colaborador. Tipo de evento inferred
	Entrevista de desligamento realizada	Este evento marca a conclusão da entrevista de desligamento com o colaborador que está saindo. Normalmente é registrado como uma tarefa concluída em um checklist de desligamento.
Por que é importante Acompanhar a realização das entrevistas de desligamento é importante para garantir a conformidade em RH e coletar feedback valioso. Ajuda a identificar se essa etapa crucial está sendo ignorada no offboarding. Onde obter Este evento provavelmente aparece nos módulos Onboarding ou HR Help Desk do UKG Pro como uma tarefa específica dentro de um workflow de desligamento. A captura depende de o RH marcar manualmente a tarefa como concluída. Captura Registrado como uma tarefa concluída na checklist de offboarding do colaborador. Tipo de evento explicit
	Início do afastamento	Marca o início do afastamento aprovado do colaborador, por motivos médicos ou pessoais. É registrado quando o status do colaborador muda para inativo, em afastamento.
Por que é importante Identifica períodos de inatividade no ciclo de vida do colaborador. Essencial para calcular com precisão o tempo ativo e entender o impacto das licenças na progressão de carreira. Onde obter Localizado no histórico de dados de cargo do colaborador dentro do módulo HR Core. Corresponde a uma ação como 'Leave of Absence', com uma data de início efetiva. Captura Capturado a partir da data de vigência de uma ação 'Start Leave' no histórico de emprego. Tipo de evento explicit
	Mudança de cargo processada	Representa uma mudança no cargo ou na função do colaborador que não é promoção, como uma transferência lateral ou movimentação entre departamentos. O evento é registrado quando os dados de cargo correspondentes são atualizados no sistema.
Por que é importante Analisar mudanças de cargo traz insights sobre mobilidade interna, alocação de talentos e reestruturações. Ajuda a entender como as pessoas se movimentam na organização. Onde obter Capturado no histórico de dados de emprego do colaborador no módulo Core HR. Pode ser identificado por ações como 'Transfer', 'Re-assignment' ou 'Position Change', junto com suas datas de vigência. Captura Identificado por um código de ação 'Transfer' ou semelhante no histórico de cargos do colaborador. Tipo de evento explicit
	Mudança de gestor	Este evento é gerado quando os campos 'Reports To' ou 'Manager ID' de um colaborador são atualizados. Ele representa uma mudança na linha de subordinação direta do colaborador.
Por que é importante Mudanças de gestor podem impactar significativamente o engajamento e a performance. Acompanhar esse evento permite analisar os efeitos em atividades posteriores, como avaliações de performance e retenção. Onde obter Este evento deve ser inferido acompanhando, ao longo do tempo, as alterações no campo de gestor ou supervisor nos dados de cargo do colaborador. Requer comparar o Manager ID entre registros consecutivos do mesmo colaborador. Captura Inferido ao detectar uma mudança no campo 'Reports To' no histórico de dados do cargo do colaborador. Tipo de evento inferred
	Offboarding concluído	Um marco que indica que todas as tarefas obrigatórias de offboarding foram concluídas. Isso inclui devolução de ativos, cálculo da folha final e revogação de acessos aos sistemas.
Por que é importante Este evento confirma que todas as etapas necessárias foram concluídas para realizar o desligamento do colaborador com segurança e em conformidade. Ajuda a medir o tempo de ciclo do desligamento e a identificar lacunas de conformidade. Onde obter Isso seria inferido a partir do timestamp de conclusão do checklist ou do workflow geral de offboarding, semelhante ao evento 'Employee Onboarded', mas relativo ao processo de saída. Captura Inferido a partir do carimbo de data e hora de conclusão do checklist principal de offboarding do colaborador. Tipo de evento inferred
	Onboarding iniciado	Representa o início do processo ou workflow de onboarding de um novo colaborador no UKG Pro. Geralmente é um evento automático ou acionado manualmente que atribui um checklist de tarefas ao novo colaborador, ao seu gestor e ao RH.
Por que é importante Monitorar essa atividade ajuda a medir o tempo entre a data oficial de contratação e o início da integração administrativa e cultural. É o ponto de partida para analisar a eficiência do onboarding e identificar atrasos. Onde obter Localizado no módulo de Onboarding do UKG Pro. O evento pode ser inferido pela data de criação do checklist de integração ou da instância do workflow associada ao colaborador. Captura Inferido a partir do carimbo de data e hora de criação do workflow de onboarding ou da lista de tarefas do colaborador. Tipo de evento inferred
	Remuneração alterada	Este evento registra qualquer alteração no salário base, na estrutura de bônus ou em outros componentes de remuneração. Pode fazer parte de uma promoção, de um aumento por mérito ou de um ajuste de mercado.
Por que é importante Acompanhar mudanças na remuneração é essencial para entender a evolução de carreira e salarial. Ajustes frequentes após a admissão podem indicar erros de lançamento ou problemas na definição inicial do salário. Onde obter Localizado na tabela de histórico de remuneração do colaborador no HR Core ou no módulo de Payroll. Cada alteração costuma trazer uma data de vigência e um código de motivo. Captura Registrado a partir da data efetiva de uma nova entrada no histórico de remuneração do colaborador. Tipo de evento explicit
	Treinamento atribuído	Registra o momento em que um curso de treinamento ou plano de aprendizagem é atribuído a um colaborador. Geralmente isso é registrado no módulo de gestão de aprendizagem (LMS) do sistema.
Por que é importante Essa atividade ajuda a acompanhar a conformidade com treinamentos obrigatórios e a monitorar o desenvolvimento dos colaboradores. Analisar o tempo entre a atribuição e a conclusão pode revelar questões de engajamento ou a efetividade do treinamento. Onde obter Registrado nos módulos de gestão de aprendizagem ou gestão de talentos do UKG Pro. Cada atribuição deve ter um registro correspondente com data de atribuição e ID do colaborador. Captura Registrado ao adicionar um curso ou uma trilha ao plano de aprendizado do colaborador. Tipo de evento explicit

Recomendado Opcional

Guias de Extração

Como extrair seus dados do UKG Pro

Etapas

Pré-requisitos: Certifique-se de ter o Python 3.6+ e as bibliotecas requests e pandas instaladas. Se precisar, instale com pip: pip install requests pandas.
Acesso à API e autenticação: Fale com o administrador do UKG Pro para criar um Service Account. Você vai precisar de API Key, User Name e Password. O Service Account deve ter permissão para acessar todos os endpoints necessários da API, incluindo dados de pessoal, folha de pagamento, onboarding, performance e treinamento.
Configure o script: Abra o script Python no seu editor de texto ou IDE. Encontre a seção de configuração no topo do arquivo e substitua os valores de exemplo de UKG_BASE_URL, API_KEY, USERNAME, PASSWORD e COMPANY_ID pelas suas credenciais e detalhes do ambiente.
Defina o período de extração: Na seção de configuração, ajuste as variáveis START_DATE e END_DATE. Elas determinam a janela de tempo da qual serão extraídas as mudanças e os eventos dos colaboradores. Recomenda-se começar com um intervalo menor, como 3–6 meses, para testar o script.
Execute o script: Execute o script no terminal com python your_script_name.py. Ele vai autenticar, buscar dados em vários endpoints da API do UKG Pro para cada atividade e mostrar o progresso no console.
Trate o limite de taxa da API: O script inclui um time.sleep() básico para respeitar os limites da API. Se ocorrerem erros HTTP 429, aumente a duração da espera entre as chamadas.
Transforme e padronize os dados: Cada função do script busca dados brutos de uma atividade específica, seleciona os campos relevantes e os renomeia para o formato padrão de Event Log (EmployeeId, ActivityName, EventTimestamp, etc.).
Combine os eventos: A parte principal do script chama cada função por atividade e agrega os resultados em uma única lista mestre de eventos.
Gere o Event Log: Depois de processar todas as atividades, o script consolida os dados em um DataFrame do pandas, ordena por ID do colaborador e timestamp e salva como um arquivo CSV ukg_hire_to_retire_event_log.csv.
Revisão e upload: Abra o CSV gerado para conferir se os dados estão completos e corretos. Esse arquivo já está pronto para upload na ferramenta de Process Mining.

Configuração

Credenciais de autenticação: É necessária uma conta de serviço com API Key, User Name e Password para autenticação na API.
URL base: A UKG_BASE_URL da sua instância do UKG Pro (por exemplo, https://service[##].ultipro.com/api).
ID da empresa: O COMPANY_ID exclusivo da sua organização no UKG Pro é necessário em muitas chamadas de API.
Período: Os parâmetros START_DATE e END_DATE (no formato 'YYYY-MM-DD') definem a janela de extração. Na primeira execução, recomenda-se um período de 3 a 6 meses para controlar o volume de dados e validar os resultados.
Versões dos endpoints da API: O script usa versões específicas das APIs REST (por exemplo, /personnel/v1/). Verifique se a sua instância do UKG Pro é compatível com essas versões.
Dependências de módulos: A extração de determinadas atividades exige que sua organização tenha licença e use ativamente os módulos correspondentes do UKG Pro, como Onboarding, Learning e Performance Management. Se um módulo não estiver em uso, a atividade correspondente não será extraída.

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