> Melhoria contínua de processos > Ciclo de vida do funcionário, da contratação ao desligamento > UKG Pro > Template de dados

Seu Template de dados do ciclo de vida do colaborador, da contratação ao desligamento

UKG Pro

← Voltar ao guia de melhoria

Atributos do ciclo de vida do colaborador, da contratação ao desligamento(21) Atividades do ciclo de vida do colaborador, da contratação ao desligamento(15) Guias de extração(1)

Seu Template de dados do ciclo de vida do colaborador, da contratação ao desligamento

Este Template apresenta uma visão completa dos dados essenciais para analisar com eficiência o processo de contratação ao desligamento. Ele descreve os principais atributos a coletar, as atividades importantes a acompanhar e orientações práticas para extrair esses dados do UKG Pro. Use este material para simplificar a preparação dos dados e começar sua jornada de Process Mining com tranquilidade.

Atributos recomendados para coleta
Principais atividades a acompanhar
Orientações para extração no UKG Pro

Novidade em Event Logs? Saiba como criar um Event Log para Process Mining.

Baixar Template

Atributos do ciclo de vida do colaborador, da contratação ao desligamento

Estes são os campos de dados recomendados para incluir no Event Log e obter análises e insights completos sobre o ciclo de vida do colaborador, da contratação ao desligamento.

5 Obrigatório 7 Recomendado 9 Opcional

	Nome	Descrição
	Data e hora do evento EventTimestamp	Data e hora exatas em que um evento específico do ciclo de vida ocorreu.
Descrição A data e hora do evento fornecem o contexto cronológico de cada atividade e formam a base do fluxo do processo. Elas registram o momento exato em que um evento, como 'Offer Accepted' ou 'Promotion Approved', foi registrado no sistema. Na análise, esses dados são usados para calcular a duração entre atividades, identificar atrasos e medir os tempos de ciclo de subprocessos importantes, como recrutamento e integração. Datas e horas precisas são essenciais para todos os KPIs baseados em tempo e para a análise de performance. Por que isso importa Esse atributo é essencial para ordenar os eventos cronologicamente e calcular todas as métricas baseadas em tempo, como tempos de ciclo e durações. Onde encontrar Obtido de campos de data ou data e hora associados a eventos específicos no UKG Pro, como 'HireDate', 'TerminationDate' ou datas e horas de mudanças de status nos módulos de fluxo de trabalho. Exemplos 2023-01-15T09:00:00Z2023-06-20T14:35:10Z2024-02-01T11:00:00Z
	ID do funcionário EmployeeId	Identificador exclusivo atribuído a cada funcionário, usado como ID do caso principal durante todo o ciclo de vida dele na organização.
Descrição O ID do funcionário conecta todos os eventos relacionados a ele, desde a candidatura inicial até o desligamento. Esse identificador é essencial para criar uma visão completa, de ponta a ponta, da trajetória de cada pessoa. Na análise de Process Mining, todas as atividades, como 'Employee Hired', 'Promotion Approved' ou 'Termination Initiated', são vinculadas a esse ID exclusivo. Isso permite analisar a trajetória de cada funcionário, comparar grupos com base nos atributos dos funcionários e calcular com precisão a duração de cada ciclo de vida. Por que isso importa Esse é o identificador essencial do caso que conecta todos os eventos relacionados ao funcionário e permite analisar o processo completo, da contratação ao desligamento, para cada pessoa. Onde encontrar Esse é um campo central do UKG Pro, geralmente encontrado nos registros do perfil do funcionário ou nos dados principais. Consulte a documentação do UKG Pro para identificar a tabela e o nome do campo específicos, que costuma ser chamado de Employee Number ou Person ID. Exemplos 10052198345210047
	Nome da atividade ActivityName	Nome do evento ou marco específico ocorrido no ciclo de vida do funcionário, como 'Employee Hired' ou 'Performance Review Conducted'.
Descrição O nome da atividade descreve uma etapa ou tarefa do processo de contratação ao desligamento. Os eventos recebem uma data e hora e são ordenados para formar o fluxo do processo, que é visualizado e analisado no Process Mining. Analisar a sequência e a frequência dessas atividades revela como o processo realmente acontece. Isso ajuda a identificar caminhos comuns, desvios do processo padrão e gargalos entre atividades importantes, como 'Onboarding Initiated' e 'Payroll Setup Completed'. Por que isso importa Esse atributo define as etapas do mapa de processos e permite visualizar e analisar o fluxo do ciclo de vida do funcionário. Onde encontrar Em geral, é obtido de Event Logs, mudanças de status do fluxo de trabalho ou campos de data específicos em vários módulos do UKG Pro, como Recruiting, Onboarding e Performance Management. Normalmente, é preciso definir uma lógica de mapeamento para gerar nomes padronizados para as atividades. Exemplos Funcionário contratadoAvaliação de performance realizadaDesligamento iniciado
	Sistema de origem SourceSystem	Identifica o sistema de onde os dados foram extraídos, que neste caso é o UKG Pro.
Descrição Esse atributo indica a origem dos dados do processo. Neste caso, a principal fonte é o UKG Pro, mas um processo de contratação ao desligamento pode envolver dados de outros sistemas, como um sistema de rastreamento de candidatos (ATS) ou um sistema de gestão de aprendizagem (LMS). Na análise, ele ajuda a diferenciar as fontes quando há vários sistemas envolvidos e é essencial para a governança de dados e a solução de problemas. Em uma visão de uma única fonte, fornece contexto importante sobre a origem dos dados. Por que isso importa Fornece contexto essencial para a governança de dados, a garantia da qualidade e a rastreabilidade, identificando a origem dos dados dos eventos. Onde encontrar Normalmente, é um valor estático ('UKG Pro') adicionado durante a extração e transformação dos dados. Exemplos UKG ProUKGPro_CoreHRUKG
	Última atualização dos dados LastDataUpdate	Data e hora que indicam quando os dados deste evento foram atualizados ou extraídos pela última vez do sistema de origem.
Descrição Esse atributo informa a data e hora da última extração de dados do UKG Pro. Não indica quando o evento de negócio ocorreu, mas quando o registro foi carregado na ferramenta de Process Mining. Essa informação é essencial para entender o nível de atualização dos dados analisados. Ela permite que analistas e usuários de negócio saibam o quanto a visão do processo está atualizada, além de ajudar a gerenciar as atualizações dos dados e verificar a atualidade dos insights. Por que isso importa Indica o nível de atualização dos dados, essencial para confiar na análise e tomar decisões de negócio no momento certo. Onde encontrar Essa data e hora é gerada e adicionada 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
	Cargo JobTitle	O cargo oficial do funcionário, como 'Engenheiro de software' ou 'Gerente de vendas'.
Descrição O cargo descreve a função ou posição do funcionário na organização. Esse atributo é uma dimensão importante para analisar como os processos variam entre diferentes funções e níveis de senioridade. Na análise, o cargo pode ser usado para comparar o tempo de integração de pessoas em diferentes funções, avaliar a velocidade das promoções ou identificar se determinados cargos apresentam taxas mais altas de rotatividade precoce. Isso ajuda a adaptar os processos de RH e os programas de apoio às necessidades específicas de cada grupo de funcionários. Por que isso importa Permite analisar os processos do ciclo de vida por função e nível de senioridade. Onde encontrar Este é um campo padrão associado à posição ou ao registro profissional do funcionário no módulo Core HR do UKG Pro. Exemplos Engenheiro de software IIGerente sênior de produtoParceiro de negócios de RH
	Data de contratação HireDate	Data oficial de início do vínculo empregatício do funcionário com a organização.
Descrição A data de contratação marca o início do vínculo do funcionário com a organização. É um campo de data fundamental, usado como referência em diversos cálculos e análises temporais relacionados ao ciclo de vida do funcionário. Esse atributo é usado para calcular o tempo de permanência do funcionário, essencial para analisar a 'Taxa de rotatividade precoce de funcionários'. Também permite fazer análises por coorte e comparar os padrões do ciclo de vida de funcionários contratados em diferentes períodos. Por que isso importa Serve de referência para calcular o tempo de permanência dos funcionários e é essencial para análises por coorte e KPIs de rotatividade. Onde encontrar Este é um campo padrão e obrigatório no registro principal do funcionário no módulo Core HR do UKG Pro. Exemplos 2022-08-152023-01-202021-05-10
	Departamento EmployeeDepartment	Departamento ou unidade organizacional à qual o funcionário está vinculado.
Descrição Esse atributo contém o nome do departamento ao qual o funcionário está vinculado, como 'Vendas', 'Engenharia' ou 'Finanças'. É uma dimensão organizacional importante para segmentar e comparar a performance do processo. A análise por departamento permite comparar a execução do processo entre diferentes unidades de negócio. Por exemplo, você pode verificar se o 'Tempo de ciclo do recrutamento' é maior nos departamentos técnicos ou se a 'Conformidade com as avaliações de performance' varia significativamente entre Vendas e Operações, gerando insights direcionados para melhorias. Por que isso importa Permite fazer análises comparativas detalhadas, filtrando e segmentando o processo pela estrutura organizacional para revelar diferenças entre departamentos. Onde encontrar Esse é um campo padrão no registro de cargo ou função do funcionário, no módulo Core HR do UKG Pro. Exemplos EngenhariaVendasRecursos Humanos
	ID da requisição de vaga JobRequisitionId	Identificador exclusivo da requisição de vaga que deu início ao processo de contratação.
Descrição O ID da requisição de vaga é a referência exclusiva de uma vaga específica. Ele conecta todas as atividades iniciais de recrutamento, da criação e aprovação da vaga à busca por candidatos e ao envio de ofertas. Esse ID é essencial para analisar o KPI 'Tempo de ciclo do recrutamento', pois marca o início real do processo de contratação. Ele permite acompanhar todo o funil de uma vaga e analisar métricas como a 'Taxa de requisições de vaga inativas', identificando as requisições que não avançam. Por que isso importa Define um ponto de partida claro para o processo de recrutamento e permite medir com precisão o tempo de contratação e a efetividade das requisições de vaga. Onde encontrar Encontrado no módulo Recruiting do UKG Pro ou no sistema de rastreamento de candidatos (ATS) conectado. Exemplos REQ-2023-015REQ-2024-112REQ-2023-504
	Nome do gerente ManagerName	Nome do gerente direto ou supervisor do funcionário.
Descrição Este atributo identifica o gerente direto do funcionário. O gerente tem um papel importante em vários eventos do ciclo de vida, incluindo avaliações de desempenho, promoções e atribuições de treinamento. A análise por gerente ajuda a entender as diferenças na execução das atividades das equipes e a eficácia dos gerentes. Por exemplo, o Dashboard 'Análise do impacto da transição de gerente' usa esse atributo para mostrar como uma mudança de gerente afeta as atividades seguintes. Ele também é essencial para o KPI 'Tempo até o novo engajamento gerencial'. Por que isso importa Permite analisar a performance do processo por equipe e ajuda a avaliar o impacto dos gerentes nos eventos do ciclo de vida dos funcionários. Onde encontrar Essas informações fazem parte dos dados da estrutura hierárquica do funcionário no módulo Core HR do UKG Pro. Exemplos João SilvaMaria GarciaChen Wei
	Status do vínculo empregatício EmploymentStatus	Status atual ou histórico do vínculo empregatício do funcionário, como 'Ativo', 'Desligado' ou 'Afastado'.
Descrição Esse atributo indica o status oficial do funcionário na empresa em determinado momento. É uma dimensão importante para entender a situação geral da força de trabalho e filtrar a análise por grupos específicos de funcionários. Analisar as mudanças no status do vínculo empregatício ajuda a modelar o processo corretamente, distinguindo, por exemplo, um afastamento temporário de um desligamento definitivo. Esse atributo é fundamental para calcular as taxas de rotatividade e entender os resultados de diferentes trajetórias no ciclo de vida do funcionário. Por que isso importa Fornece contexto essencial sobre a situação do funcionário e permite analisar a rotatividade com precisão e segmentar a força de trabalho. Onde encontrar Esse é um campo central do registro principal do funcionário no módulo Core HR do UKG Pro. Exemplos AtivoDesligadoAfastamento
	Usuário responsável pela ação ActioningUser	Nome ou ID do usuário, geralmente um representante de RH ou gestor, que realizou 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 fez uma oferta ou o gestor que aprovou uma promoção. Ele vincula as atividades do processo às pessoas que as realizaram. Na análise, esse atributo é valioso para entender a distribuição da carga de trabalho, identificar necessidades de treinamento e analisar a performance por usuário. Por exemplo, ele pode ajudar a identificar se os erros de entrada de dados após 'Payroll Setup Completed' se concentram em usuários específicos, contribuindo para a métrica 'Taxa de retrabalho de dados após a integração'. Por que isso importa Vincula as atividades do processo a usuários específicos e permite analisar a carga de trabalho, comparar a performance e investigar retrabalho ou erros. Onde encontrar Geralmente encontrado nos logs de auditoria ou nos campos 'Last Modified By' dos módulos do UKG Pro. O nome exato do campo varia conforme o módulo. Exemplos j.does.smithhr_admin
	Avaliação de desempenho PerformanceRating	Nota atribuída ao funcionário durante um ciclo de avaliação de desempenho.
Descrição A avaliação de desempenho é o resultado da atividade 'Avaliação de desempenho realizada'. Ela costuma usar uma escala, como de 1 a 5, ou classificações descritivas, como 'Supera as expectativas'. Esse atributo quantifica a avaliação de desempenho do funcionário. Ele é útil para relacionar eventos do processo aos resultados de desempenho. Por exemplo, a análise pode mostrar se funcionários com alto desempenho são promovidos mais rapidamente ou se há relação entre as avaliações de desempenho e a rotatividade. Esse atributo é central para o Dashboard 'Conformidade do ciclo de avaliação de desempenho'. Por que isso importa Relaciona os eventos do processo aos resultados de desempenho, permitindo analisar a eficácia da gestão de talentos e seu impacto na retenção. Onde encontrar Disponível no módulo Performance Management do UKG Pro e vinculado a ciclos de avaliação específicos. Exemplos Supera as expectativasAtende às expectativasPrecisa melhorar5
	Data de desligamento TerminationDate	Data oficial de encerramento do vínculo empregatício do funcionário.
Descrição A data de desligamento marca o fim do vínculo do funcionário com a organização e encerra seu ciclo de vida na empresa. Este atributo é necessário para calcular o tempo total de permanência do funcionário e é um componente importante da análise de rotatividade. O intervalo entre a data de contratação e a data de desligamento serve de base para o Dashboard 'Insights sobre rotatividade no início do vínculo' e os KPIs relacionados. Por que isso importa Define o fim do ciclo de vida do funcionário, permitindo calcular o tempo total de permanência e apoiar todas as análises relacionadas à rotatividade. Onde encontrar Este é um campo padrão no registro principal do funcionário no UKG Pro, preenchido quando o processo de desligamento é concluído. Exemplos 2023-11-302024-02-152022-12-31
	É rotatividade precoce IsEarlyChurn	Indicador booleano que informa se o funcionário foi desligado dentro de um período inicial predefinido, como 90 ou 180 dias.
Descrição Este atributo calculado identifica funcionários que deixam a organização pouco tempo depois de serem contratados. A empresa costuma definir o limite para considerar a saída precoce, por exemplo, dentro do primeiro ano. Esse indicador simplifica a análise necessária para o Dashboard 'Insights sobre rotatividade no início do vínculo' e o KPI 'Taxa de rotatividade precoce de funcionários'. Ele permite filtrar e segmentar rapidamente esse grupo de interesse e analisar suas características e padrões do ciclo de vida, ajudando a identificar problemas no recrutamento ou na integração. Por que isso importa Apoia diretamente a análise da rotatividade precoce ao sinalizar casos de risco e ajudar a identificar as causas raiz das saídas prematuras de funcionários. Onde encontrar Este atributo é calculado durante a preparação dos dados. A lógica compara a diferença entre 'TerminationDate' e 'HireDate' com um limite predefinido, como 365 dias. Exemplos truefalse
	Faixa salarial SalaryGrade	Faixa ou nível de remuneração associado à função do funcionário.
Descrição A faixa salarial representa o nível de remuneração de um cargo específico. É um atributo importante para analisar atividades e tendências relacionadas à remuneração. Esse atributo é útil em análises de eventos como 'Remuneração alterada' e pode ser usado para acompanhar o KPI 'Taxa de retrabalho de dados após a integração' quando há correções frequentes nas faixas salariais. Ele também permite segmentar o processo para verificar se o tempo de ciclo das promoções ou as taxas de rotatividade variam conforme o nível de remuneração. Por que isso importa Dá contexto às atividades relacionadas à remuneração e permite segmentar o processo por faixa salarial. Onde encontrar Disponível no perfil de remuneração ou profissional do funcionário no módulo Core HR do UKG Pro. Exemplos IC3M2D1
	Hora de término do evento EventEndTime	Data e hora que indicam a conclusão de uma atividade com duração mensurável.
Descrição Em atividades que não são instantâneas, a hora de término do evento registra quando a atividade foi concluída. Ela se diferencia do timestamp do evento (StartTime), que marca o início. Com os horários de início e término, é possível calcular com precisão o tempo de processamento de atividades específicas, como 'Verificação de antecedentes' ou 'Tarefa de integração'. Isso permite analisar com mais detalhes onde o tempo é gasto no processo. Por que isso importa Permite calcular com precisão o tempo de processamento de cada atividade e identificar as etapas que mais consomem tempo no processo. Onde encontrar Obtido dos campos de data de conclusão no UKG Pro. Muitas vezes, é necessário combinar um evento de início com o evento de conclusão correspondente nos dados de origem. Exemplos 2023-01-15T17:30:00Z2023-06-21T10:00:00Z2024-02-01T11:05:00Z
	Localização Location	Localização geográfica ou escritório onde o funcionário trabalha.
Descrição Este atributo indica o principal local de trabalho do funcionário, que pode ser uma cidade, um país ou um escritório específico. É uma dimensão importante para a análise geográfica dos processos de RH. Analisar a performance do processo por localização pode revelar diferenças regionais na eficiência das contratações, nas práticas de integração ou nas taxas de rotatividade. Por exemplo, você pode comparar o 'Tempo de ciclo de recrutamento' entre os escritórios de 'Nova York' e 'Londres' para identificar boas práticas ou gargalos locais. Por que isso importa Permite segmentar o processo por localização geográfica e identificar variações regionais de performance e Conformidade. Onde encontrar Essas informações fazem parte dos dados profissionais ou pessoais do funcionário no módulo Core HR do UKG Pro. Exemplos Nova York, NYLondres, Reino UnidoRemoto
	Motivo da mudança de função RoleChangeReason	Motivo da mudança de função de um funcionário, como 'Promoção', 'Transferência lateral' ou 'Reorganização'.
Descrição Este atributo dá contexto aos eventos de mobilidade interna. Ele explica por que a função ou posição de um funcionário mudou dentro da organização. É essencial para o Dashboard e o KPI 'Tempo de ciclo de mobilidade interna', pois permite diferenciar promoções de outros tipos de transferência. Analisar o processo por motivo pode revelar se as promoções demoram mais do que as movimentações laterais e ajudar a simplificar os caminhos de desenvolvimento de carreira. Por que isso importa Explica o contexto das movimentações internas e permite analisar com mais precisão processos de mobilidade, como promoções e transferências laterais. Onde encontrar Essas informações costumam ser registradas na 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 de um funcionário, como 'Voluntário - Pedido de demissão' ou 'Involuntário - Desempenho'.
Descrição Este atributo registra o motivo do encerramento do vínculo empregatício de um funcionário. Os motivos costumam ser classificados como voluntários ou involuntários, com subcategorias mais específicas. Este é um atributo essencial para analisar retenção e rotatividade. Ao segmentar os funcionários desligados pelo motivo da saída, as organizações podem identificar as causas raiz da rotatividade. Por exemplo, analisar a 'Taxa de rotatividade precoce de funcionários' por motivo de desligamento ajuda a diferenciar problemas nas contratações de ofertas mais competitivas. Por que isso importa Ajuda a identificar os fatores que levam à rotatividade de funcionários e a definir estratégias de retenção direcionadas. Onde encontrar Este campo costuma ser preenchido durante o processo de desligamento no módulo Core HR do UKG Pro. Exemplos Voluntário - Outra oportunidadeInvoluntário - DesempenhoAposentadoria
	Nome do treinamento TrainingName	Nome ou título do curso de treinamento atribuído ao funcionário.
Descrição Este atributo identifica um treinamento ou módulo de aprendizagem específico atribuído a um funcionário. Pode ser um treinamento obrigatório de Conformidade ou o desenvolvimento de habilidades específicas para uma função. É um atributo importante para o Dashboard 'Atribuição e conclusão de treinamentos' e o KPI 'Taxa de conclusão de treinamentos'. Ele permite acompanhar o progresso e a eficácia de programas de treinamento específicos e analisar o tempo de conclusão de diferentes cursos. Por que isso importa Permite acompanhar e analisar programas de treinamento específicos, ajudando a medir a Conformidade e a eficácia do desenvolvimento profissional. Onde encontrar Obtido do módulo Learning do UKG Pro ou de um sistema de gestão de aprendizagem (LMS) conectado. Exemplos Código de conduta 2024Habilidades avançadas de gestãoConscientização sobre cibersegurança

Obrigatório Recomendado Opcional

Atividades do ciclo de vida do colaborador, da contratação ao desligamento

Estas são as principais etapas e marcos do processo a registrar no Event Log para descobrir e otimizar o processo com precisão.

6 Recomendado 9 Opcional

	Atividade	Descrição
	Avaliação de performance realizada	Representa a conclusão de um ciclo formal de avaliação de performance de um funcionário. O evento é registrado quando o gestor ou a equipe de RH finaliza e envia o formulário de avaliação.
Por que isso importa Esse é um marco recorrente importante no ciclo de vida do funcionário. Acompanhar sua frequência e pontualidade ajuda a avaliar a Conformidade da gestão de performance e seu impacto na progressão da carreira. Onde encontrar Encontrado no módulo Performance Management do UKG Pro. Pode ser identificado pela data de conclusão do formulário de avaliação de performance ou pela mudança do status do ciclo para 'Completed'. Coleta Obtido da data e hora de conclusão da instância do fluxo de trabalho de avaliação de performance. Tipo de evento explicit
	Desligamento iniciado	Marca o início do processo de desligamento, registrado quando uma data futura de desligamento é inserida no sistema. Esse evento aciona listas de tarefas e fluxos de trabalho de desligamento.
Por que isso importa Esse é um marco importante que dá início ao processo de saída do funcionário. Analisar o tempo entre esse evento e o desligamento final ajuda a avaliar a eficiência e a conclusão dos procedimentos de desligamento. Onde encontrar Em geral, corresponde à criação de um registro de ação 'Termination' nos dados de cargo do funcionário, com uma data futura de vigência. Também pode marcar o início de um fluxo de trabalho de desligamento em um módulo específico. Coleta Registrado quando uma transação de desligamento com data futura é enviada. Tipo de evento explicit
	Funcionário contratado	Marca a criação oficial do registro do funcionário no UKG Pro, quando um ID do funcionário é atribuído formalmente. Em geral, esse evento é registrado quando um administrador de RH conclui a contratação de um candidato, que passa a ser um funcionário ativo no sistema.
Por que isso importa Este é o evento de início definitivo para a análise do processo de contratação ao desligamento. Ele serve de referência para medir o tempo até a produtividade, a eficiência da integração e o tempo total de permanência do funcionário na empresa. Onde encontrar Esse evento provavelmente fica registrado no módulo HR Core ou Personnel Administration. Ele pode ser identificado pela data de criação do registro principal de vínculo empregatício do funcionário ou por um registro específico da ação 'Hire' no histórico de dados do cargo. Coleta Obtido da data efetiva da ação 'Hire' na tabela do histórico de cargos do funcionário. Tipo de evento explicit
	Funcionário desligado	Evento final do ciclo de vida do funcionário, que representa o encerramento oficial do vínculo empregatício. Nessa data, o registro do funcionário fica inativo no sistema, conforme a data de vigência do desligamento.
Por que isso importa Esse é o evento final definitivo do processo, essencial para calcular o tempo total de permanência do funcionário e analisar a rotatividade. Ele encerra o ciclo do funcionário na empresa. Onde encontrar Essa é a data de vigência da ação final 'Termination' no histórico de dados de cargo do funcionário, no módulo HR Core. Em geral, nessa data o sistema muda o status do funcionário de ativo para inativo. Coleta Obtido da data de vigência da ação 'Termination' no histórico de cargos do funcionário. Tipo de evento explicit
	Integração do funcionário concluída	Marco importante que indica a conclusão bem-sucedida da lista de tarefas ou do fluxo de trabalho inicial de integração. Em geral, isso significa que toda a documentação necessária para a contratação, as solicitações de acesso aos sistemas e as tarefas administrativas iniciais foram concluídas.
Por que isso importa Marca o fim da configuração administrativa inicial e permite analisar o tempo total do ciclo de integração. Indica que o funcionário está administrativamente pronto para começar as atividades específicas do cargo. Onde encontrar Localizado no módulo Onboarding. Em geral, esse evento é inferido a partir da data e hora de conclusão do fluxo de trabalho geral de integração ou do momento em que a última tarefa obrigatória é marcada como concluída. Coleta Inferido a partir da data e hora de conclusão da lista principal de tarefas de integração do funcionário. Tipo de evento inferred
	Promoção aprovada	Indica a aprovação formal da promoção de um funcionário, que geralmente inclui uma mudança de cargo e, muitas vezes, de remuneração. É um evento distinto, que ocorre antes da data em que a mudança entra em vigor.
Por que isso importa Essa atividade é importante para analisar a mobilidade interna e a progressão na carreira. O tempo entre a aprovação da promoção e a data em que ela entra em vigor pode revelar gargalos administrativos no sistema. Onde encontrar Registrado como uma ação específica de cargo, como 'Promotion', no histórico de dados do cargo do funcionário, no módulo HR Core. O registro terá datas próprias de aprovação e vigência. Coleta Obtido da data de registro de uma ação 'Promotion' no histórico de cargos do funcionário. Tipo de evento explicit
	Afastamento iniciado	Marca o início de um afastamento aprovado do funcionário, por motivos médicos ou pessoais, por exemplo. O evento é registrado quando o status do funcionário muda para inativo ou afastado.
Por que isso importa Identifica períodos de inatividade no ciclo de vida do funcionário. É essencial para calcular corretamente o tempo de permanência ativa e entender o impacto do afastamento na progressão da carreira. Onde encontrar Encontrado no histórico de dados de cargo do funcionário, no módulo HR Core. Corresponde a uma ação como 'Leave of Absence', com uma data de início de vigência específica. Coleta Obtido da data de vigência de uma ação 'Start Leave' no histórico de cargos. 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 funcionário, como dados bancários e formulários fiscais, foram inseridas e verificadas. Essa etapa é essencial para garantir que o funcionário receba o pagamento correto e no prazo.
Por que isso importa Esse marco é fundamental para medir se o novo funcionário está pronto para começar. Atrasos na configuração da folha de pagamento podem causar insatisfação e retrabalho administrativo, por isso essa é uma métrica importante do processo de integração. Onde encontrar Esse evento pode ser inferido a partir do módulo Payroll do UKG Pro. Ele pode ser identificado pela data de conclusão de uma lista de verificação de preparação da folha de pagamento ou pela data em que o status do funcionário muda para 'Ready for Payroll'. Coleta Obtido de uma mudança de status ou da data e hora de conclusão no perfil de folha de pagamento do funcionário. Tipo de evento inferred
	Desligamento concluído	Marco que indica a conclusão de todas as tarefas obrigatórias de desligamento. Isso inclui atividades como a devolução de equipamentos, os cálculos finais da folha de pagamento e a revogação do acesso aos sistemas.
Por que isso importa Esse evento confirma que todas as etapas necessárias para encerrar o vínculo com o funcionário com segurança e em conformidade foram realizadas. Ele ajuda a medir o tempo do ciclo de desligamento e a identificar lacunas de Conformidade. Onde encontrar Esse evento seria inferido a partir da data e hora de conclusão da lista de tarefas ou do fluxo de trabalho geral de desligamento, de forma semelhante ao evento 'Employee Onboarded', mas referente à saída. Coleta Inferido a partir da data e hora de conclusão da lista principal de tarefas de desligamento do funcionário. Tipo de evento inferred
	Entrevista de desligamento realizada	Esse evento marca a conclusão da entrevista de desligamento com o funcionário que está saindo. Em geral, é registrado como uma tarefa concluída na lista de tarefas de desligamento.
Por que isso importa Acompanhar a conclusão das entrevistas de desligamento é importante para garantir a Conformidade de RH e coletar feedback valioso. Isso ajuda a identificar se essa etapa essencial está sendo ignorada no processo de desligamento. Onde encontrar Esse evento provavelmente aparece no módulo Onboarding ou HR Help Desk do UKG Pro como uma tarefa específica em um fluxo de trabalho de desligamento. O registro depende de alguém da equipe de RH marcar manualmente a tarefa como concluída. Coleta Registrado como uma tarefa concluída na lista de tarefas de desligamento do funcionário. Tipo de evento explicit
	Gestor alterado	Esse evento é gerado quando o campo 'Reports To' ou 'Manager ID' de um funcionário é atualizado. Ele representa uma mudança na linha de reporte direto do funcionário.
Por que isso importa Mudanças de gestor podem afetar significativamente o engajamento e a performance dos funcionários. Acompanhar esse evento permite analisar seus efeitos em atividades posteriores, como avaliações de performance ou retenção. Onde encontrar Esse evento precisa ser inferido pelo acompanhamento das mudanças no campo de gestor ou supervisor nos dados de cargo do funcionário ao longo do tempo. Para isso, é necessário comparar o ID do gestor entre registros consecutivos do mesmo funcionário. Coleta Inferido pela detecção de uma mudança no campo 'Reports To' no histórico de dados de cargo do funcionário. Tipo de evento inferred
	Integração iniciada	Marca o início do processo ou fluxo de trabalho de integração de novos funcionários no UKG Pro. Em geral, esse evento é acionado automaticamente ou manualmente e atribui uma lista de tarefas ao novo funcionário, ao gestor e à equipe de RH.
Por que isso importa Acompanhar essa atividade ajuda a medir o tempo entre a data oficial da contratação e o início da integração administrativa e cultural. É o ponto de partida para analisar a eficiência do processo de integração e identificar atrasos. Onde encontrar Encontrado no módulo Onboarding do UKG Pro. O evento pode ser identificado pela data de criação da lista de tarefas ou da instância do fluxo de trabalho de integração associada ao funcionário. Coleta Inferido a partir da data e hora de criação do fluxo de trabalho de integração ou da lista de tarefas do funcionário. Tipo de evento inferred
	Mudança de cargo processada	Representa uma mudança de cargo ou função que não é uma promoção, como uma transferência lateral ou mudança de departamento. O evento é registrado quando os dados de cargo correspondentes são atualizados no sistema.
Por que isso importa Analisar as mudanças de cargo gera insights sobre mobilidade interna, alocação de talentos e reestruturação organizacional. Isso ajuda a entender como os funcionários se movimentam pela organização. Onde encontrar Obtido do histórico de dados de cargo do funcionário no módulo HR Core. Pode ser identificado por ações como 'Transfer', 'Re-assignment' ou 'Position Change', junto com as respectivas datas de vigência. Coleta Identificado por um código de ação 'Transfer' ou semelhante nos dados do histórico de cargos do funcionário. Tipo de evento explicit
	Remuneração alterada	Esse evento registra qualquer alteração no salário-base, na estrutura de bônus ou em outros componentes da remuneração do funcionário. Pode fazer parte de uma promoção, de um aumento por mérito ou de um ajuste de mercado.
Por que isso importa Acompanhar as mudanças na remuneração é essencial para entender a progressão na carreira e no salário. Ajustes frequentes após a contratação podem indicar erros de entrada de dados ou problemas na definição do salário inicial. Onde encontrar Encontrado na tabela do histórico de remuneração do funcionário, no módulo HR Core ou Payroll. Em geral, cada alteração é registrada com uma data de vigência e um código de motivo. Coleta Registrado a partir da data de vigência de uma nova entrada no histórico de remuneração do funcionário. Tipo de evento explicit
	Treinamento atribuído	Registra o momento em que um curso específico ou plano de aprendizagem é atribuído a um funcionário. Normalmente, essa informação é registrada no módulo de gestão de aprendizagem do sistema.
Por que isso importa Essa atividade ajuda a acompanhar a Conformidade com os treinamentos obrigatórios e o desenvolvimento dos funcionários. Analisar o tempo entre a atribuição e a conclusão pode revelar problemas de engajamento ou de eficácia do treinamento. Onde encontrar Registrado nos módulos de gestão de aprendizagem ou de talentos do UKG Pro. Cada atribuição deve ter um registro correspondente com a data da atribuição e o ID do funcionário. Coleta Registrado quando um curso ou currículo é atribuído ao plano de aprendizagem de um funcionário. Tipo de evento explicit

Recomendado Opcional

Guias de extração

Como obter seus dados do UKG Pro

Etapas

Pré-requisitos: Verifique se você tem o Python 3.6 ou superior e as bibliotecas requests e pandas instaladas. Você pode instalá-las com pip: pip install requests pandas.
Acesso à API e autenticação: Peça ao administrador do UKG Pro para criar uma conta de serviço. Você precisará da API Key, do User Name e da Password. A conta de serviço deve ter permissão para acessar todos os endpoints necessários da API, incluindo dados de pessoal, folha de pagamento, integração, desempenho e aprendizagem.
Configure o script: Abra o script Python fornecido em um editor de texto ou IDE. Localize a seção de configuração no início do script e substitua os valores de exemplo de UKG_BASE_URL, API_KEY, USERNAME, PASSWORD e COMPANY_ID pelas credenciais e informações do seu ambiente.
Defina o período de extração: Na seção de configuração, defina as variáveis START_DATE e END_DATE. Elas determinam o período de extração das alterações e dos eventos dos colaboradores. Para testar o script, recomendamos começar com um intervalo menor, como 3 a 6 meses.
Execute o script: Execute o script pela linha de comando usando python your_script_name.py. O script fará a autenticação, buscará dados nos vários endpoints da API do UKG Pro para cada atividade e mostrará o andamento no console.
Gerencie os limites da API: O script inclui uma pausa básica com time.sleep() para respeitar os limites de chamadas da API. Se ocorrerem erros de limitação (HTTP 429), talvez seja necessário aumentar o intervalo 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 seguir o formato padrão do Event Log (EmployeeId, ActivityName, EventTimestamp etc.).
Combine os dados dos eventos: A parte principal do script chama a função de cada atividade e acrescenta os dados resultantes a uma única lista geral de eventos.
Gere o Event Log: Depois de processar todas as atividades, o script reúne os dados em um DataFrame do pandas, ordena as linhas por ID do colaborador e data e hora e salva o resultado em um arquivo CSV chamado ukg_hire_to_retire_event_log.csv.
Revise e carregue o arquivo: Abra o CSV gerado para confirmar que os dados estão completos e formatados corretamente. O arquivo estará pronto para ser carregado na ferramenta de Process Mining.

Configuração

Credenciais de autenticação: Para autenticar na API, são necessários a API Key, o User Name e a Password de uma conta de serviço.
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 para muitas chamadas da API.
Período: Os parâmetros START_DATE e END_DATE (no formato 'YYYY-MM-DD') definem o intervalo de extração. Na primeira execução, recomendamos um período de 3 a 6 meses para controlar o volume de dados e verificar os resultados.
Versões dos endpoints da API: O script usa versões específicas das APIs REST (por exemplo, /personnel/v1/). Confirme se sua instância do UKG Pro oferece suporte a essas versões.
Dependências de módulos: A extração de algumas atividades exige que sua organização tenha licenças dos módulos correspondentes do UKG Pro e os utilize, como Onboarding, Learning e Performance Management. Se um módulo não estiver em uso, a atividade correspondente não será extraída.

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

Pronto para começar?

Use este Template para preparar seus dados com segurança e descobrir insights importantes sobre seus processos de RH. Comece hoje a otimizar a jornada da contratação ao desligamento.

Voltar ao guia de melhoria

Baixar Template

Comece hoje a otimizar o ciclo de vida do colaborador, da contratação ao desligamento!

Reduza em 30% o tempo de ciclo da contratação ao desligamento e aumente a eficiência de RH.

Começar o teste grátis

Não é necessário cartão de crédito. Configuração rápida.

Seu Template de dados do ciclo de vida do colaborador, da contratação ao desligamento

Seu Template de dados do ciclo de vida do colaborador, da contratação ao desligamento

Atributos do ciclo de vida do colaborador, da contratação ao desligamento

Atividades do ciclo de vida do colaborador, da contratação ao desligamento

Guias de extração

Extração com script Python pelas APIs REST do UKG Pro

Etapas

Configuração

Consulta de exemplo python

Pronto para começar?

Comece hoje a otimizar o ciclo de vida do colaborador, da contratação ao desligamento!