> Ciągłe doskonalenie procesów > Proces od zatrudnienia do odejścia pracownika > UKG Pro > Szablon danych

Szablon danych dla procesu od zatrudnienia do odejścia pracownika

UKG Pro

← Wróć do przewodnika ulepszania procesów

Atrybuty procesu od zatrudnienia do odejścia pracownika(21) Działania w procesie od zatrudnienia do odejścia pracownika(15) Instrukcje pobierania danych(1)

Szablon danych dla procesu od zatrudnienia do odejścia pracownika

Ten szablon przedstawia dane potrzebne do skutecznej analizy procesu od zatrudnienia do odejścia pracownika. Zawiera listę atrybutów do zebrania, działań do śledzenia oraz praktyczne wskazówki dotyczące pobierania danych z UKG Pro. Ułatwia przygotowanie danych i rozpoczęcie analizy process mining.

Zalecane atrybuty do zebrania
Najważniejsze działania do śledzenia
Wskazówki dotyczące pobierania danych z UKG Pro

Pierwszy raz spotykają się Państwo z dziennikiem zdarzeń? Dowiedz się jak utworzyć dziennik zdarzeń na potrzeby process mining.

Pobierz szablon

Atrybuty procesu od zatrudnienia do odejścia pracownika

Poniżej przedstawiono zalecane pola danych, które warto uwzględnić w event logu, aby analizować proces od zatrudnienia do odejścia pracownika i uzyskać pełny obraz jego przebiegu.

5 Wymagane 7 Zalecane 9 Opcjonalne

	Nazwa	Opis
	Identyfikator pracownika EmployeeId	Unikalny identyfikator przypisany każdemu pracownikowi. Służy jako główny identyfikator case dla całego cyklu zatrudnienia danej osoby w organizacji.
Opis Employee ID łączy wszystkie zdarzenia dotyczące pracownika, od pierwszego zgłoszenia kandydatury po zakończenie procedury odejścia. Ten identyfikator jest niezbędny do odtworzenia pełnego przebiegu procesu dotyczącego danej osoby. W analizie process mining każda czynność, na przykład „Pracownik zatrudniony”, „Zatwierdzenie awansu” lub „Rozpoczęcie procedury rozwiązania stosunku pracy”, jest powiązana z tym unikalnym identyfikatorem. Umożliwia to analizę ścieżek poszczególnych pracowników, porównywanie grup według cech pracowników i dokładne obliczanie czasu trwania poszczególnych etapów cyklu zatrudnienia. Dlaczego to ważne To podstawowy identyfikator case, który łączy wszystkie zdarzenia dotyczące pracownika i umożliwia analizę całego procesu od zatrudnienia do odejścia dla każdej osoby. Skąd pobrać To podstawowe pole w UKG Pro, zazwyczaj dostępne w profilu pracownika lub rekordach danych podstawowych. Nazwę konkretnej tabeli i pola, często oznaczanego jako Employee Number lub Person ID, można sprawdzić w dokumentacji UKG Pro. Przykłady 10052198345210047
	Znacznik czasu zdarzenia EventTimestamp	Dokładna data i godzina wystąpienia konkretnego zdarzenia w cyklu życia pracownika.
Opis Znacznik czasu zdarzenia określa chronologię każdej czynności i stanowi podstawę do odtworzenia przebiegu procesu. Zapisuje dokładny moment zarejestrowania w systemie zdarzenia, takiego jak „Przyjęcie oferty” lub „Zatwierdzenie awansu”. W analizie znaczniki czasu służą do obliczania odstępów między czynnościami, wykrywania opóźnień i mierzenia czasu trwania ważnych podprocesów, takich jak rekrutacja i wdrożenie. Dokładne znaczniki czasu są niezbędne do obliczania wskaźników KPI opartych na czasie i analizy wyników. Dlaczego to ważne Ten atrybut jest niezbędny do chronologicznego uporządkowania zdarzeń i obliczania wszystkich wskaźników opartych na czasie, takich jak czas trwania cyklu i poszczególnych etapów. Skąd pobrać Pobierany z pól daty lub znacznika czasu przypisanych do konkretnych zdarzeń w UKG Pro, takich jak „HireDate”, „TerminationDate” lub znaczniki czasu zmian statusu w modułach workflow. Przykłady 2023-01-15T09:00:00Z2023-06-20T14:35:10Z2024-02-01T11:00:00Z
	Data ostatniej aktualizacji danych LastDataUpdate	Znacznik czasu wskazujący, kiedy dane dotyczące tego zdarzenia zostały ostatnio odświeżone lub wyodrębnione z systemu źródłowego.
Opis Ten atrybut wskazuje czas ostatniego wyodrębnienia danych z UKG Pro. Nie jest to czas wystąpienia zdarzenia biznesowego, lecz moment pobrania rekordu do narzędzia process mining. Informacja ta pozwala ocenić aktualność analizowanych danych. Analitycy i użytkownicy biznesowi mogą sprawdzić, jak aktualny jest obraz procesu. Ułatwia też zarządzanie harmonogramem odświeżania danych i weryfikację aktualności wniosków. Dlaczego to ważne Wskazuje aktualność danych, co pomaga ocenić wiarygodność analizy i podejmować decyzje biznesowe we właściwym czasie. Skąd pobrać Ten znacznik czasu jest generowany i dodawany do każdego rekordu podczas procesu wyodrębniania, przekształcania i ładowania danych (ETL). Przykłady 2024-03-15T02:00:00Z2024-03-16T02:00:00Z2024-03-17T02:00:00Z
	Nazwa czynności ActivityName	Nazwa konkretnego zdarzenia lub kamienia milowego w cyklu życia pracownika, na przykład „Pracownik zatrudniony” lub „Przeprowadzenie oceny okresowej”.
Opis Nazwa czynności opisuje pojedynczy krok lub zadanie w procesie od zatrudnienia do odejścia pracownika. Zdarzenia otrzymują znaczniki czasu i są porządkowane, aby utworzyć przebieg procesu, który można wizualizować i analizować za pomocą process mining. Analiza kolejności i częstotliwości czynności pokazuje, jak proces przebiega w praktyce. Pomaga wykrywać typowe ścieżki, odstępstwa od standardowego przebiegu i wąskie gardła między ważnymi czynnościami, takimi jak „Rozpoczęcie wdrożenia pracownika” i „Konfiguracja listy płac zakończona”. Dlaczego to ważne Ten atrybut określa kroki na mapie procesu i umożliwia wizualizację oraz analizę przebiegu cyklu życia pracownika. Skąd pobrać Zazwyczaj jest ustalana na podstawie dzienników zdarzeń, zmian statusu workflow lub konkretnych pól daty w różnych modułach UKG Pro, na przykład Recruiting, Onboarding i Performance Management. Do utworzenia ujednoliconych nazw czynności zwykle potrzebne są reguły mapowania. Przykłady Pracownik zatrudnionyPrzeprowadzenie oceny okresowejRozpoczęcie procedury rozwiązania stosunku pracy
	System źródłowy SourceSystem	Wskazuje system, z którego wyodrębniono dane, w tym przypadku UKG Pro.
Opis Ten atrybut wskazuje źródło danych o procesie. W tym przypadku jest nim przede wszystkim UKG Pro, ale proces od zatrudnienia do odejścia pracownika może obejmować również dane z innych systemów, takich jak system śledzenia kandydatów (ATS) lub system zarządzania nauką (LMS). W analizie atrybut pomaga rozróżnić źródła danych, jeśli wykorzystywanych jest kilka systemów. Jest też niezbędny do zarządzania danymi i rozwiązywania problemów. W widoku opartym na jednym źródle dostarcza ważnych informacji o pochodzeniu danych. Dlaczego to ważne Wskazanie źródła danych o zdarzeniach dostarcza ważnych informacji potrzebnych do zarządzania danymi, kontroli jakości i śledzenia ich pochodzenia. Skąd pobrać Zazwyczaj jest to stała wartość („UKG Pro”) dodawana podczas wyodrębniania i przekształcania danych. Przykłady UKG ProUKGPro_CoreHRUKG
	Data zatrudnienia HireDate	Oficjalna data rozpoczęcia pracy w organizacji.
Opis Data zatrudnienia wyznacza początek stażu pracownika. To podstawowe pole daty, które stanowi punkt odniesienia dla wielu obliczeń i analiz związanych z cyklem zatrudnienia. Na podstawie tego atrybutu oblicza się staż pracy, potrzebny między innymi do analizy wskaźnika wczesnych odejść pracowników. Ułatwia on również analizę kohortową, czyli porównywanie przebiegu cyklu zatrudnienia osób przyjętych w różnych okresach. Dlaczego to ważne Stanowi punkt odniesienia przy obliczaniu stażu pracy i jest niezbędna do analizy kohortowej oraz KPI dotyczących rotacji. Skąd pobrać Standardowe, wymagane pole w głównym rekordzie pracownika w module Core HR systemu UKG Pro. Przykłady 2022-08-152023-01-202021-05-10
	Dział EmployeeDepartment	Dział lub jednostka organizacyjna, do której przypisano pracownika.
Opis Ten atrybut zawiera nazwę działu przypisanego pracownikowi, na przykład „Sprzedaż”, „Inżynieria” lub „Finanse”. Jest ważnym wymiarem organizacyjnym, który pozwala dzielić proces na segmenty i porównywać jego wyniki. Analiza według działu umożliwia porównanie przebiegu procesu w różnych jednostkach biznesowych. Można na przykład sprawdzić, czy „Czas rekrutacji” jest dłuższy w działach technicznych albo czy „Terminowość ocen okresowych” znacznie różni się między działami sprzedaży i operacji. Takie porównania pomagają wskazać obszary wymagające usprawnień. Dlaczego to ważne Umożliwia porównywanie wyników procesu według struktury organizacyjnej i wykrywanie różnic między działami. Skąd pobrać To standardowe pole w rekordzie zatrudnienia lub stanowiska pracownika w module Core HR systemu UKG Pro. Przykłady InżynieriaSprzedażZasoby ludzkie
	Identyfikator zapotrzebowania na stanowisko JobRequisitionId	Unikalny identyfikator zapotrzebowania na stanowisko, od którego rozpoczął się proces rekrutacji.
Opis Identyfikator zapotrzebowania na stanowisko to unikalny numer konkretnego wakatu. Łączy wszystkie początkowe czynności rekrutacyjne, od utworzenia i zatwierdzenia zapotrzebowania po wyszukiwanie kandydatów i składanie ofert. Ten identyfikator jest niezbędny do analizy wskaźnika KPI „Czas rekrutacji”, ponieważ wskazuje faktyczny początek procesu zatrudnienia. Pozwala śledzić cały lejek rekrutacyjny dla jednego wakatu i analizować wskaźniki, takie jak „Odsetek nieaktywnych zapotrzebowań na stanowisko”, wykrywając zapotrzebowania, które nie przechodzą do kolejnych etapów. Dlaczego to ważne Wyznacza czytelny początek procesu rekrutacji, co pozwala dokładnie mierzyć czas zatrudnienia i skuteczność zapotrzebowań na stanowisko. Skąd pobrać Można go znaleźć w module Recruiting systemu UKG Pro lub w połączonym systemie śledzenia kandydatów (ATS). Przykłady REQ-2023-015REQ-2024-112REQ-2023-504
	Imię i nazwisko przełożonego ManagerName	Imię i nazwisko bezpośredniego przełożonego pracownika.
Opis Ten atrybut wskazuje bezpośredniego przełożonego pracownika. Przełożony uczestniczy w wielu zdarzeniach związanych z cyklem zatrudnienia, takich jak oceny okresowe, awanse i przydzielanie szkoleń. Analiza danych według przełożonego pozwala porównać sposób realizacji procesów w zespołach i ocenić skuteczność menedżerów. Na przykład dashboard „Analiza wpływu zmiany przełożonego” wykorzystuje ten atrybut, aby sprawdzić, jak zmiana przełożonego wpływa na kolejne działania. Atrybut jest też potrzebny do obliczania KPI „Czas do ponownego zaangażowania menedżera”. Dlaczego to ważne Umożliwia analizę wyników procesu na poziomie zespołu i ocenę wpływu przełożonych na zdarzenia związane z cyklem zatrudnienia pracownika. Skąd pobrać Informacja ta należy do danych o strukturze podległości pracownika w module Core HR systemu UKG Pro. Przykłady Jan KowalskiMaria GarciaChen Wei
	Nazwa stanowiska JobTitle	Oficjalna nazwa stanowiska pracownika, np. „inżynier oprogramowania” lub „kierownik sprzedaży”.
Opis Nazwa stanowiska określa rolę lub pozycję pracownika w organizacji. To ważny wymiar analizy różnic w przebiegu procesów między stanowiskami i poziomami doświadczenia. Dzięki temu atrybutowi można porównywać czas wdrożenia pracowników na różnych stanowiskach, analizować tempo awansów lub sprawdzać, czy osoby na określonych stanowiskach częściej odchodzą wkrótce po zatrudnieniu. Wyniki pomagają dostosować procesy HR i programy wsparcia do potrzeb poszczególnych grup pracowników. Dlaczego to ważne Umożliwia analizę procesów w podziale na stanowiska i poziomy doświadczenia. Skąd pobrać Standardowe pole dotyczące stanowiska lub danych o zatrudnieniu pracownika w module Core HR systemu UKG Pro. Przykłady Inżynier oprogramowania IIStarszy menedżer produktuPartner biznesowy HR
	Status zatrudnienia EmploymentStatus	Bieżący lub historyczny status zatrudnienia pracownika, na przykład „Aktywny”, „Zwolniony” lub „Na urlopie”.
Opis Ten atrybut wskazuje oficjalny status pracownika w firmie w danym momencie. Jest ważnym wymiarem, który pomaga określić ogólny stan zatrudnienia i filtrować analizę według wybranych grup pracowników. Analiza zmian statusu zatrudnienia pomaga prawidłowo odwzorować proces, na przykład odróżnić tymczasowy urlop od trwałego zakończenia zatrudnienia. Jest też niezbędna do obliczania wskaźników odejść i analizy wyników różnych ścieżek cyklu zatrudnienia. Dlaczego to ważne Dostarcza ważnych informacji o statusie pracownika, umożliwiając dokładną analizę odejść i podział pracowników na grupy. Skąd pobrać To podstawowe pole w głównym rekordzie pracownika w module Core HR systemu UKG Pro. Przykłady AktywnyZakończenie zatrudnieniaUrlop
	Użytkownik wykonujący czynność ActioningUser	Nazwa lub identyfikator użytkownika, zazwyczaj pracownika HR lub przełożonego, który wykonał daną czynność w UKG Pro.
Opis Ten atrybut wskazuje osobę odpowiedzialną za wykonanie konkretnego kroku procesu, na przykład rekrutera, który złożył ofertę, lub przełożonego, który zatwierdził awans. Łączy czynności w procesie z osobami, które je wykonują. W analizie pomaga zrozumieć rozkład obciążenia pracą, określić potrzeby szkoleniowe i porównać wyniki poszczególnych użytkowników. Można na przykład sprawdzić, czy błędy we wprowadzaniu danych po czynności „Konfiguracja listy płac zakończona” dotyczą konkretnych użytkowników. Ułatwia to analizę wskaźnika KPI „Odsetek poprawek danych po wdrożeniu”. Dlaczego to ważne Łączy czynności w procesie z konkretnymi użytkownikami, umożliwiając analizę obciążenia pracą, porównywanie wyników oraz badanie poprawek i błędów. Skąd pobrać Zazwyczaj można go znaleźć w dziennikach audytowych lub polach „Last Modified By” w modułach UKG Pro. Dokładna nazwa pola zależy od modułu. Przykłady j.does.smithhr_admin
	Czas zakończenia zdarzenia EventEndTime	Znacznik czasu wskazujący zakończenie działania o mierzalnym czasie trwania.
Opis W przypadku działań, które nie odbywają się natychmiast, czas zakończenia zdarzenia wskazuje, kiedy działanie zostało ukończone. Różni się od znacznika czasu zdarzenia (StartTime), który oznacza jego początek. Dostęp do czasu rozpoczęcia i zakończenia pozwala dokładnie obliczyć czas realizacji poszczególnych działań, takich jak „Weryfikacja przeszłości” lub „Zadanie wdrożeniowe”. Dzięki temu można szczegółowo sprawdzić, na których etapach procesu upływa najwięcej czasu. Dlaczego to ważne Umożliwia dokładne obliczenie czasu realizacji poszczególnych działań i wskazanie najbardziej czasochłonnych etapów procesu. Skąd pobrać Pochodzi z pól daty zakończenia w UKG Pro. Często wymaga połączenia zdarzenia rozpoczęcia z odpowiadającym mu zdarzeniem zakończenia w danych źródłowych. Przykłady 2023-01-15T17:30:00Z2023-06-21T10:00:00Z2024-02-01T11:05:00Z
	Czy wczesne odejście IsEarlyChurn	Wartość logiczna wskazująca, czy pracownik odszedł w określonym początkowym okresie zatrudnienia, na przykład w ciągu 90 lub 180 dni.
Opis Ten obliczany atrybut oznacza pracowników, którzy odchodzą z organizacji wkrótce po zatrudnieniu. Organizacja określa, jaki okres uznaje za początkowy, na przykład pierwszy rok pracy. Atrybut ułatwia analizę na potrzeby dashboardu „Analiza wczesnych odejść” i KPI „Wskaźnik wczesnych odejść pracowników”. Pozwala szybko filtrować i wyodrębniać tę grupę, a następnie analizować jej cechy i przebieg cyklu zatrudnienia. Może to pomóc w wykryciu problemów z rekrutacją lub wdrożeniem. Dlaczego to ważne Wspiera analizę wczesnych odejść, wskazując przypadki wymagające uwagi i pomagając ustalić przyczyny przedwczesnego odejścia pracowników. Skąd pobrać Atrybut jest obliczany podczas przygotowania danych. Reguła porównuje różnicę między polami „TerminationDate” i „HireDate” z ustalonym progiem, na przykład 365 dni. Przykłady truefalse
	Data rozwiązania stosunku pracy TerminationDate	Oficjalna data zakończenia zatrudnienia pracownika.
Opis Data rozwiązania stosunku pracy oznacza koniec stażu pracownika i jego cyklu zatrudnienia w organizacji. Atrybut jest potrzebny do obliczenia całkowitego stażu pracy i stanowi ważny element analizy odejść. Różnica między datą zatrudnienia a datą rozwiązania stosunku pracy jest podstawą dashboardu „Analiza wczesnych odejść” i powiązanych z nim KPI. Dlaczego to ważne Wyznacza koniec cyklu zatrudnienia pracownika, umożliwia obliczenie całkowitego stażu pracy i wspiera analizy odejść. Skąd pobrać Standardowe pole w głównym rekordzie pracownika w UKG Pro, uzupełniane po zakończeniu procesu rozwiązania stosunku pracy. Przykłady 2023-11-302024-02-152022-12-31
	Grupa zaszeregowania płacowego SalaryGrade	Grupa lub przedział wynagrodzenia przypisany do stanowiska pracownika.
Opis Grupa zaszeregowania płacowego określa poziom wynagrodzenia przypisany do danego stanowiska. Atrybut ten służy do analizy działań i trendów związanych z wynagrodzeniami. Jest przydatny między innymi przy analizie zdarzeń „Zmiana wynagrodzenia”. Jeśli często koryguje się grupę zaszeregowania, można też śledzić KPI „Wskaźnik ponownego wprowadzania danych po wdrożeniu”. Atrybut pozwala ponadto sprawdzić, czy czas awansu lub poziom rotacji różni się w zależności od poziomu wynagrodzenia. Dlaczego to ważne Dostarcza kontekstu do analizy działań związanych z wynagrodzeniami i umożliwia podział procesu według poziomu płac. Skąd pobrać Dostępna w profilu wynagrodzenia lub stanowiska pracownika w module Core HR systemu UKG Pro. Przykłady IC3M2D1
	Lokalizacja Location	Miejsce pracy pracownika, na przykład miasto, kraj lub biuro.
Opis Ten atrybut określa główne miejsce pracy pracownika, na przykład miasto, kraj lub konkretny budynek biurowy. Umożliwia analizę procesów HR w podziale na lokalizacje. Porównanie wyników procesu między lokalizacjami może ujawnić różnice regionalne w skuteczności rekrutacji, przebiegu wdrożenia lub poziomie rotacji. Na przykład można porównać czas rekrutacji w biurach w Nowym Jorku i Londynie, aby znaleźć dobre praktyki lub lokalne wąskie gardła. Dlaczego to ważne Umożliwia analizę procesu według lokalizacji i pokazuje regionalne różnice w wynikach oraz zgodności. Skąd pobrać Informacja ta należy do danych o stanowisku lub danych osobowych pracownika w module Core HR systemu UKG Pro. Przykłady Nowy Jork, NYLondyn, Wielka BrytaniaPraca zdalna
	Nazwa szkolenia TrainingName	Nazwa lub tytuł szkolenia przypisanego pracownikowi.
Opis Ten atrybut wskazuje konkretne szkolenie lub moduł edukacyjny przypisany pracownikowi. Może to być zarówno obowiązkowe szkolenie z zakresu zgodności, jak i rozwój umiejętności potrzebnych na danym stanowisku. Atrybut jest podstawą dashboardu „Przypisywanie i ukończenie szkoleń” oraz KPI „Wskaźnik ukończenia szkoleń”. Pozwala śledzić postępy i skuteczność poszczególnych programów szkoleniowych oraz porównywać czas ukończenia różnych kursów. Dlaczego to ważne Umożliwia śledzenie i analizę poszczególnych programów szkoleniowych oraz ocenę zgodności i skuteczności rozwoju pracowników. Skąd pobrać Dane pochodzą z modułu UKG Pro Learning lub połączonego systemu zarządzania nauczaniem (LMS). Przykłady Kodeks postępowania 2024Zaawansowane umiejętności menedżerskieŚwiadomość cyberbezpieczeństwa
	Ocena wyników pracy PerformanceRating	Ocena przyznana pracownikowi podczas cyklu oceny okresowej.
Opis Ocena wyników pracy jest rezultatem działania „Przeprowadzono ocenę okresową”. Może być wyrażona na skali, np. od 1 do 5, albo za pomocą opisów, takich jak „Przekracza oczekiwania”. Określa wynik oceny pracy pracownika. Atrybut pozwala powiązać zdarzenia w procesie z wynikami pracy. Można na przykład sprawdzić, czy osoby osiągające wysokie wyniki awansują szybciej albo czy ocena pracy wiąże się z odejściem z organizacji. Atrybut jest podstawą dashboardu „Zgodność z cyklem ocen okresowych”. Dlaczego to ważne Łączy zdarzenia w procesie z wynikami pracy, umożliwiając analizę skuteczności zarządzania talentami i jego wpływu na retencję pracowników. Skąd pobrać Dostępna w module Performance Management systemu UKG Pro i powiązana z konkretnymi cyklami ocen. Przykłady Przekracza oczekiwaniaSpełnia oczekiwaniaWymaga poprawy5
	Powód rozwiązania stosunku pracy TerminationReason	Zapisany powód odejścia pracownika, np. „dobrowolne odejście z własnej inicjatywy” lub „zwolnienie z powodu wyników pracy”.
Opis Ten atrybut określa powód zakończenia zatrudnienia pracownika. Powody są zwykle podzielone na dobrowolne i niedobrowolne, a każda z tych kategorii może mieć bardziej szczegółowe podkategorie. Atrybut jest istotny przy analizie retencji i odejść pracowników. Podział osób, które odeszły, według przyczyny pozwala lepiej zrozumieć źródła rotacji. Na przykład analiza wskaźnika wczesnych odejść według powodu rozwiązania stosunku pracy pomaga odróżnić nietrafione decyzje rekrutacyjne od odejść do konkurencji. Dlaczego to ważne Pomaga ustalić przyczyny rotacji pracowników i dobrać działania, które ograniczą odejścia. Skąd pobrać To pole jest zwykle uzupełniane podczas procesu rozwiązania stosunku pracy lub offboardingu w module Core HR systemu UKG Pro. Przykłady Dobrowolne odejście, inna ofertaZwolnienie z powodu wyników pracyPrzejście na emeryturę
	Powód zmiany stanowiska RoleChangeReason	Powód zmiany roli pracownika, na przykład awans, przeniesienie na równorzędne stanowisko lub reorganizacja.
Opis Ten atrybut wyjaśnia kontekst zmian stanowiska w ramach mobilności wewnętrznej. Określa, dlaczego zmieniono rolę lub stanowisko pracownika w organizacji. Jest potrzebny do dashboardu i KPI „Czas trwania procesu mobilności wewnętrznej”, ponieważ pozwala odróżnić awanse od innych rodzajów przeniesień. Analiza według powodu zmiany może ujawnić, czy awanse trwają dłużej niż przeniesienia na równorzędne stanowiska, i pomóc usprawnić ścieżki rozwoju zawodowego. Dlaczego to ważne Wyjaśnia przyczyny zmian stanowiska i pozwala dokładniej analizować mobilność wewnętrzną, na przykład porównywać awanse z przeniesieniami na równorzędne stanowiska. Skąd pobrać Informacja ta jest zwykle zapisywana przy zmianie stanowiska lub przeniesieniu w module Core HR systemu UKG Pro. Przykłady AwansPrzeniesienie na równorzędne stanowiskoReorganizacja

Wymagane Zalecane Opcjonalne

Działania w procesie od zatrudnienia do odejścia pracownika

Poniżej przedstawiono etapy i kamienie milowe procesu, które warto zapisać w event logu, aby dokładnie odtworzyć i usprawnić jego przebieg.

6 Zalecane 9 Opcjonalne

	Działanie	Opis
	Pracownik zatrudniony	Oznacza oficjalne utworzenie rekordu pracownika w UKG Pro i przypisanie mu identyfikatora Employee ID. Zdarzenie jest zazwyczaj rejestrowane, gdy administrator HR finalizuje zatrudnienie kandydata, który staje się aktywnym pracownikiem w systemie.
Dlaczego to ważne To zdarzenie wyznacza początek analizy procesu od zatrudnienia do odejścia pracownika. Stanowi punkt odniesienia przy pomiarze czasu do osiągnięcia produktywności, efektywności wdrożenia i całkowitego stażu pracy. Skąd pobrać Zdarzenie jest prawdopodobnie rejestrowane w module HR Core lub Personnel Administration. Można je rozpoznać po dacie utworzenia głównego rekordu zatrudnienia pracownika albo po osobnym wpisie „Hire” w historii danych o zatrudnieniu. Rejestrowanie Pobierane z daty wejścia w życie działania „Hire” w tabeli historii zatrudnienia pracownika. Typ zdarzenia explicit
	Przeprowadzenie oceny okresowej	Oznacza zakończenie formalnego cyklu oceny okresowej pracownika. Zdarzenie jest rejestrowane po sfinalizowaniu i przesłaniu formularza oceny przez przełożonego lub dział HR.
Dlaczego to ważne To ważny, powtarzający się kamień milowy w cyklu życia pracownika. Śledzenie częstotliwości i terminowości ocen pomaga sprawdzić zgodność procesu zarządzania wynikami z wymaganiami oraz jego wpływ na rozwój kariery. Skąd pobrać Zdarzenie można znaleźć w module Performance Management w UKG Pro. Można je rozpoznać po dacie zakończenia formularza oceny okresowej lub zmianie statusu cyklu oceny na „Completed”. Rejestrowanie Pobierane ze znacznika czasu zakończenia instancji workflow oceny okresowej. Typ zdarzenia explicit
	Rozpoczęcie procedury rozwiązania stosunku pracy	Oznacza rozpoczęcie procesu odejścia pracownika. Zdarzenie jest rejestrowane po wprowadzeniu do systemu przyszłej daty rozwiązania stosunku pracy. Uruchamia listy kontrolne i workflow związane z odejściem.
Dlaczego to ważne To ważny kamień milowy rozpoczynający proces odejścia pracownika. Analiza czasu od tego zdarzenia do ostatecznego zakończenia zatrudnienia pomaga ocenić sprawność i kompletność procedur związanych z odejściem. Skąd pobrać Zazwyczaj jest to utworzenie rekordu działania „Termination” w danych o zatrudnieniu pracownika, z przyszłą datą wejścia w życie. Może to być również rozpoczęcie workflow związanego z odejściem w odpowiednim module. Rejestrowanie Rejestrowane po przesłaniu transakcji rozwiązania stosunku pracy z przyszłą datą. Typ zdarzenia explicit
	Wdrożenie pracownika zakończone	Kamień milowy oznaczający pomyślne zakończenie początkowej listy kontrolnej lub workflow wdrożenia. Zazwyczaj oznacza to, że wypełniono wszystkie wymagane dokumenty nowego pracownika, złożono wnioski o dostęp do systemów i wykonano początkowe zadania administracyjne.
Dlaczego to ważne Oznacza koniec początkowej konfiguracji administracyjnej i pozwala analizować całkowity czas wdrożenia. Wskazuje moment, w którym pracownik jest administracyjnie gotowy do wykonywania obowiązków na swoim stanowisku. Skąd pobrać Zdarzenie znajduje się w module Onboarding. Zazwyczaj można je ustalić na podstawie znacznika czasu zakończenia całego workflow wdrożenia lub oznaczenia ostatniego obowiązkowego zadania jako ukończonego. Rejestrowanie Ustalane na podstawie znacznika czasu zakończenia głównej listy kontrolnej wdrożenia pracownika. Typ zdarzenia inferred
	Zakończenie zatrudnienia pracownika	Ostatnie zdarzenie w cyklu życia pracownika, oznaczające oficjalny koniec zatrudnienia. W tym dniu, zgodnie z datą wejścia rozwiązania stosunku pracy w życie, rekord pracownika staje się nieaktywny w systemie.
Dlaczego to ważne To ostateczne zdarzenie kończące proces. Jest niezbędne do obliczenia całkowitego stażu pracy i analizy odejść pracowników. Zamyka historię zatrudnienia danej osoby w firmie. Skąd pobrać Jest to data wejścia w życie końcowego działania „Termination” w historii danych o zatrudnieniu pracownika w module HR Core. W tym dniu system zazwyczaj zmienia status pracownika z aktywnego na nieaktywny. Rejestrowanie Pobierane z daty wejścia w życie działania „Termination” w historii zatrudnienia pracownika. Typ zdarzenia explicit
	Zatwierdzenie awansu	Oznacza formalne zatwierdzenie awansu pracownika, który zazwyczaj wiąże się ze zmianą nazwy stanowiska, a często także wynagrodzenia. Jest to osobne zdarzenie poprzedzające datę wejścia zmiany w życie.
Dlaczego to ważne Ta czynność pomaga analizować mobilność wewnętrzną i rozwój kariery. Czas między zatwierdzeniem awansu a datą jego wejścia w życie może ujawnić wąskie gardła administracyjne. Skąd pobrać Zdarzenie jest rejestrowane jako osobna czynność dotycząca zatrudnienia, na przykład „Promotion”, w historii danych o zatrudnieniu pracownika w module HR Core. Rekord zawiera osobne daty zatwierdzenia i wejścia zmiany w życie. Rejestrowanie Pobierane z daty rejestracji działania „Promotion” w historii zatrudnienia pracownika. Typ zdarzenia explicit
	Konfiguracja listy płac zakończona	Oznacza, że wprowadzono i zweryfikowano wszystkie informacje potrzebne do naliczania wynagrodzenia pracownika, takie jak dane bankowe i formularze podatkowe. Ten etap pozwala zapewnić prawidłową i terminową wypłatę.
Dlaczego to ważne Ten kamień milowy pomaga ocenić gotowość nowego pracownika do pracy. Opóźnienia w konfiguracji listy płac mogą prowadzić do niezadowolenia pracownika i dodatkowych poprawek administracyjnych, dlatego jest to ważny wskaźnik efektywności wdrożenia. Skąd pobrać Zdarzenie można ustalić na podstawie danych z modułu Payroll w UKG Pro. Może to być data zakończenia listy kontrolnej gotowości do naliczania wynagrodzeń albo data zmiany statusu pracownika na „Ready for Payroll”. Rejestrowanie Ustalane na podstawie zmiany statusu lub znacznika czasu zakończenia w profilu płacowym pracownika. Typ zdarzenia inferred
	Przeprowadzenie rozmowy końcowej	Zdarzenie oznacza zakończenie rozmowy końcowej z odchodzącym pracownikiem. Zazwyczaj jest rejestrowane jako ukończone zadanie na liście kontrolnej związanej z odejściem.
Dlaczego to ważne Śledzenie rozmów końcowych pomaga zapewnić zgodność procedur HR z wymaganiami i zebrać cenne informacje zwrotne. Pozwala sprawdzić, czy ten ważny etap nie jest pomijany w procesie odejścia. Skąd pobrać Zdarzenie można znaleźć w module Onboarding lub HR Help Desk w UKG Pro jako osobne zadanie w workflow związanym z odejściem. Jego rejestracja zależy od ręcznego oznaczenia zadania jako ukończonego przez pracownika HR. Rejestrowanie Rejestrowane jako ukończone zadanie na liście kontrolnej odejścia pracownika. Typ zdarzenia explicit
	Przypisanie szkolenia	Rejestruje moment przypisania pracownikowi konkretnego kursu lub planu szkoleniowego. Zazwyczaj zapisuje się go w module zarządzania nauką.
Dlaczego to ważne Ta czynność pomaga monitorować zgodność z wymogami dotyczącymi obowiązkowych szkoleń i śledzić rozwój pracowników. Analiza czasu od przypisania do ukończenia szkolenia może ujawnić problemy z zaangażowaniem lub skutecznością szkolenia. Skąd pobrać Zdarzenie jest rejestrowane w modułach zarządzania nauką lub talentami w UKG Pro. Każde przypisanie powinno mieć odpowiadający mu rekord z datą przypisania i identyfikatorem pracownika. Rejestrowanie Rejestrowane po przypisaniu kursu lub programu do planu nauki pracownika. Typ zdarzenia explicit
	Rozpoczęcie urlopu	Oznacza początek zatwierdzonego urlopu pracownika, na przykład zdrowotnego lub osobistego. Zdarzenie jest rejestrowane po zmianie statusu pracownika na nieaktywny lub przebywający na urlopie.
Dlaczego to ważne Pozwala wskazać okresy nieaktywności w cyklu życia pracownika. Jest niezbędne do prawidłowego obliczania aktywnego stażu pracy i analizy wpływu urlopu na rozwój kariery. Skąd pobrać Zdarzenie można znaleźć w historii danych o zatrudnieniu pracownika w module HR Core. Odpowiada ono działaniu dotyczącym zatrudnienia, takiemu jak „Leave of Absence”, z określoną datą rozpoczęcia. Rejestrowanie Pobierane z daty wejścia w życie działania „Start Leave” w historii zatrudnienia. Typ zdarzenia explicit
	Rozpoczęcie wdrożenia pracownika	Oznacza rozpoczęcie procesu lub workflow wdrożenia nowego pracownika w UKG Pro. Zdarzenie jest zazwyczaj wywoływane automatycznie lub ręcznie i przypisuje listę zadań nowemu pracownikowi, jego przełożonemu i działowi HR.
Dlaczego to ważne Śledzenie tej czynności pozwala mierzyć czas od oficjalnej daty zatrudnienia do rozpoczęcia integracji administracyjnej i organizacyjnej. To punkt wyjścia do analizy efektywności wdrożenia i wykrywania opóźnień. Skąd pobrać Zdarzenie można znaleźć w module Onboarding w UKG Pro. Można je ustalić na podstawie daty utworzenia listy kontrolnej wdrożenia lub instancji workflow przypisanej do pracownika. Rejestrowanie Ustalane na podstawie znacznika czasu utworzenia workflow wdrożenia pracownika lub jego listy zadań. Typ zdarzenia inferred
	Zakończenie procedury odejścia	Kamień milowy oznaczający wykonanie wszystkich obowiązkowych zadań związanych z odejściem pracownika. Obejmuje między innymi zwrot sprzętu, końcowe rozliczenie wynagrodzenia i odebranie dostępu do systemów.
Dlaczego to ważne Zdarzenie potwierdza, że wykonano wszystkie niezbędne czynności, aby zakończyć zatrudnienie pracownika w sposób bezpieczny i zgodny z wymaganiami. Pomaga mierzyć czas trwania procedury odejścia i wykrywać luki w zakresie zgodności. Skąd pobrać Zdarzenie można ustalić na podstawie znacznika czasu zakończenia całej listy kontrolnej lub workflow związanego z odejściem. Podobnie jak w przypadku zdarzenia „Wdrożenie pracownika zakończone”, dotyczy ono końcowego etapu zatrudnienia. Rejestrowanie Ustalane na podstawie znacznika czasu zakończenia głównej listy kontrolnej odejścia pracownika. Typ zdarzenia inferred
	Zmiana przełożonego	Zdarzenie jest generowane po aktualizacji pola „Reports To” lub „Manager ID” pracownika. Oznacza zmianę jego bezpośredniej podległości służbowej.
Dlaczego to ważne Zmiana przełożonego może znacząco wpłynąć na zaangażowanie i wyniki pracownika. Śledzenie tego zdarzenia pozwala sprawdzić jego wpływ na późniejsze działania, takie jak oceny okresowe lub retencja. Skąd pobrać Zdarzenie trzeba ustalić, śledząc zmiany pola przełożonego lub kierownika w danych o zatrudnieniu pracownika. Wymaga to porównania identyfikatorów przełożonych w kolejnych rekordach tej samej osoby. Rejestrowanie Ustalane przez wykrycie zmiany pola „Reports To” w historii danych o zatrudnieniu pracownika. Typ zdarzenia inferred
	Zmiana stanowiska przetworzona	Oznacza zmianę stanowiska lub roli pracownika, która nie jest awansem, na przykład przeniesienie na równorzędne stanowisko lub do innego działu. Zdarzenie jest rejestrowane po aktualizacji odpowiednich danych o zatrudnieniu w systemie.
Dlaczego to ważne Analiza zmian stanowisk pozwala lepiej zrozumieć mobilność wewnętrzną, rozmieszczenie talentów i zmiany struktury organizacyjnej. Pokazuje, jak pracownicy przemieszczają się w organizacji. Skąd pobrać Zdarzenie można pobrać z historii danych o zatrudnieniu pracownika w module HR Core. Można je rozpoznać po działaniach dotyczących zatrudnienia, takich jak „Transfer”, „Re-assignment” lub „Position Change”, oraz ich datach wejścia w życie. Rejestrowanie Rozpoznawane na podstawie kodu działania „Transfer” lub podobnego w historii zatrudnienia pracownika. Typ zdarzenia explicit
	Zmiana wynagrodzenia	Zdarzenie obejmuje każdą zmianę wynagrodzenia zasadniczego, premii lub innych składników wynagrodzenia pracownika. Może być związane z awansem, podwyżką za wyniki lub dostosowaniem do warunków rynkowych.
Dlaczego to ważne Śledzenie zmian wynagrodzenia pomaga zrozumieć rozwój kariery i płac. Częste korekty po zatrudnieniu mogą wskazywać na błędy przy wprowadzaniu danych lub problemy z ustaleniem początkowego wynagrodzenia. Skąd pobrać Zdarzenie można znaleźć w tabeli historii wynagrodzeń pracownika w module HR Core lub Payroll. Każda zmiana jest zazwyczaj zapisywana wraz z datą wejścia w życie i kodem przyczyny. Rejestrowanie Rejestrowane na podstawie daty wejścia w życie nowego wpisu w historii wynagrodzeń pracownika. Typ zdarzenia explicit

Zalecane Opcjonalne

Instrukcje pobierania danych

Jak pobrać dane z UKG Pro

Kroki

Wymagania wstępne: Zainstaluj Python 3.6 lub nowszy oraz biblioteki requests i pandas. Można je zainstalować poleceniem pip: pip install requests pandas.
Dostęp do API i uwierzytelnianie: Poproś administratora UKG Pro o utworzenie konta usługi. Potrzebne będą API Key, User Name i Password. Konto usługi musi mieć uprawnienia do wymaganych punktów końcowych API, w tym danych kadrowych, płacowych, wdrożeniowych, dotyczących ocen efektywności i szkoleń.
Skonfiguruj skrypt: Otwórz dostarczony skrypt Python w edytorze tekstu lub środowisku IDE. W sekcji konfiguracji u góry pliku zastąp wartości zastępcze UKG_BASE_URL, API_KEY, USERNAME, PASSWORD i COMPANY_ID danymi logowania i informacjami o środowisku.
Ustaw zakres dat pobierania: W sekcji konfiguracji określ zmienne START_DATE i END_DATE. Wyznaczają one okres, z którego zostaną pobrane zmiany i zdarzenia dotyczące pracowników. Na początek warto ustawić krótszy zakres, na przykład 3–6 miesięcy, aby przetestować skrypt.
Uruchom skrypt: W wierszu poleceń wpisz python your_script_name.py. Skrypt uwierzytelni się, pobierze dane z różnych punktów końcowych API UKG Pro dla każdego działania i wyświetli postęp w konsoli.
Uwzględnij limity API: Skrypt zawiera podstawowe opóźnienie time.sleep(), które pomaga przestrzegać limitów zapytań API. W razie błędów limitowania (HTTP 429) może być konieczne wydłużenie przerwy między wywołaniami API.
Przekształć i ujednolić dane: Każda funkcja skryptu pobiera surowe dane dotyczące konkretnego działania, wybiera odpowiednie pola i zmienia ich nazwy na zgodne ze standardowym formatem event logu (EmployeeId, ActivityName, EventTimestamp itp.).
Połącz dane o zdarzeniach: Główna część skryptu wywołuje funkcję dla każdego działania i dodaje uzyskane dane do jednej listy zdarzeń.
Utwórz event log: Po przetworzeniu wszystkich działań skrypt łączy dane w obiekt pandas DataFrame, sortuje je według identyfikatora pracownika i znacznika czasu, a następnie zapisuje do pliku CSV ukg_hire_to_retire_event_log.csv.
Sprawdź i prześlij dane: Otwórz utworzony plik CSV i upewnij się, że dane są kompletne i prawidłowo sformatowane. Plik jest gotowy do przesłania do narzędzia process mining.

Konfiguracja

Dane uwierzytelniające: Do uwierzytelniania API potrzebne są API Key, User Name i Password konta usługi.
Adres bazowy: UKG_BASE_URL instancji UKG Pro, na przykład https://service[##].ultipro.com/api.
Company ID: W przypadku wielu wywołań API potrzebny jest unikatowy COMPANY_ID organizacji w UKG Pro.
Zakres dat: Parametry START_DATE i END_DATE (w formacie „YYYY-MM-DD”) określają okres pobierania danych. Przy pierwszym uruchomieniu zaleca się zakres 3–6 miesięcy, aby ograniczyć ilość danych i sprawdzić wyniki.
Wersje punktów końcowych API: Skrypt korzysta z określonych wersji REST API, na przykład /personnel/v1/. Należy sprawdzić, czy instancja UKG Pro obsługuje te wersje.
Zależności od modułów: Pobranie niektórych działań wymaga licencji na odpowiednie moduły UKG Pro i ich aktywnego używania, na przykład Onboarding, Learning i Performance Management. Jeśli dany moduł nie jest używany, powiązane działanie nie zostanie pobrane.

Przykładowe zapytanie 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}")

Gotowi do rozpoczęcia?

Skorzystaj z tego szablonu, aby przygotować dane i lepiej poznać procesy HR. Już dziś zacznij usprawniać proces od zatrudnienia do odejścia pracownika.

Wróć do przewodnika ulepszania procesów

Pobierz szablon

Zacznij usprawniać cykl życia pracownika już dziś!

Skróć czas procesu od zatrudnienia do odejścia pracownika o 30% i zwiększ efektywność HR.

Rozpocznij bezpłatny okres próbny

Bez karty kredytowej. Szybka konfiguracja.

Szablon danych dla procesu od zatrudnienia do odejścia pracownika

Szablon danych dla procesu od zatrudnienia do odejścia pracownika

Atrybuty procesu od zatrudnienia do odejścia pracownika

Działania w procesie od zatrudnienia do odejścia pracownika

Instrukcje pobierania danych

Pobieranie danych skryptem Python przez REST API UKG Pro

Kroki

Konfiguracja

Przykładowe zapytanie python

Gotowi do rozpoczęcia?

Zacznij usprawniać cykl życia pracownika już dziś!