> Cải tiến quy trình liên tục > Quy trình tuyển dụng đến nghỉ việc > UKG Pro > Mẫu dữ liệu

Mẫu dữ liệu cho quy trình từ tuyển dụng đến nghỉ việc trong vòng đời nhân viên

UKG Pro

Thuộc tính của quy trình từ tuyển dụng đến nghỉ việc trong vòng đời nhân viên(21) Các hoạt động trong quy trình từ tuyển dụng đến nghỉ việc trong vòng đời nhân viên(15) Hướng dẫn trích xuất dữ liệu(1)

Mẫu dữ liệu cho quy trình từ tuyển dụng đến nghỉ việc trong vòng đời nhân viên

Mẫu này tổng hợp các dữ liệu cần thiết để phân tích hiệu quả quy trình từ tuyển dụng đến nghỉ việc. Mẫu nêu rõ những thuộc tính cần thu thập, các hoạt động chính cần theo dõi và cách trích xuất dữ liệu từ UKG Pro. Hãy dùng tài nguyên này để chuẩn bị dữ liệu gọn hơn và bắt đầu process mining thuận lợi.

Các thuộc tính nên thu thập
Các hoạt động chính cần theo dõi
Hướng dẫn trích xuất dữ liệu từ UKG Pro

Chưa quen với nhật ký sự kiện? Tìm hiểu cách tạo nhật ký sự kiện cho process mining.

Tải mẫu xuống

Thuộc tính của quy trình từ tuyển dụng đến nghỉ việc trong vòng đời nhân viên

Đây là các trường dữ liệu nên có trong event log để phân tích quy trình từ tuyển dụng đến nghỉ việc trong vòng đời nhân viên và tìm ra thông tin hữu ích.

5 Bắt buộc 7 Nên có 9 Không bắt buộc

	Tên	Mô tả
	Dấu thời gian sự kiện EventTimestamp	Ngày và giờ chính xác khi một sự kiện cụ thể trong vòng đời nhân viên diễn ra.
Mô tả Dấu thời gian sự kiện cho biết trình tự thời gian của từng hoạt động và là cơ sở để dựng luồng quy trình. Thông tin này ghi lại chính xác thời điểm một sự kiện như 'Offer Accepted' hoặc 'Promotion Approved' được lưu trong hệ thống. Khi phân tích, bạn dùng các dấu thời gian này để tính khoảng thời gian giữa các hoạt động, xác định chậm trễ và đo thời gian xử lý của các quy trình con quan trọng như tuyển dụng và hội nhập. Dấu thời gian chính xác rất cần thiết cho mọi KPI dựa trên thời gian và phân tích hiệu suất. Vì sao điều này quan trọng Thuộc tính này rất cần thiết để sắp xếp sự kiện theo trình tự thời gian và tính mọi chỉ số dựa trên thời gian, chẳng hạn như thời gian xử lý và thời lượng. Lấy dữ liệu ở đâu Lấy từ các trường ngày hoặc dấu thời gian gắn với sự kiện cụ thể trên UKG Pro, chẳng hạn như 'HireDate', 'TerminationDate' hoặc dấu thời gian thay đổi trạng thái trong các phân hệ quy trình làm việc. Ví dụ 2023-01-15T09:00:00Z2023-06-20T14:35:10Z2024-02-01T11:00:00Z
	Mã nhân viên EmployeeId	Mã định danh duy nhất được cấp cho mỗi nhân viên, dùng làm mã hồ sơ chính cho toàn bộ vòng đời làm việc của họ trong tổ chức.
Mô tả Mã nhân viên là thông tin liên kết mọi sự kiện liên quan đến một nhân viên, từ lúc nộp đơn đến khi hoàn tất thủ tục nghỉ việc. Mã này rất quan trọng để dựng bức tranh toàn bộ quy trình từ đầu đến cuối về hành trình của từng người. Trong phân tích process mining, mọi hoạt động như 'Employee Hired', 'Promotion Approved' hoặc 'Termination Initiated' đều được liên kết với mã duy nhất này. Nhờ đó, bạn có thể phân tích lộ trình của từng nhân viên, phân tích nhóm dựa trên thuộc tính nhân viên và tính chính xác thời lượng của các giai đoạn trong vòng đời. Vì sao điều này quan trọng Đây là mã hồ sơ thiết yếu, liên kết mọi sự kiện liên quan đến nhân viên và cho phép phân tích toàn bộ quy trình tuyển dụng đến nghỉ việc của từng người. Lấy dữ liệu ở đâu Đây là trường dữ liệu cốt lõi trên UKG Pro, thường có trong hồ sơ nhân viên hoặc bản ghi dữ liệu chính. Hãy xem tài liệu UKG Pro để biết tên bảng và trường cụ thể, thường được gọi là Employee Number hoặc Person ID. Ví dụ 10052198345210047
	Hệ thống nguồn SourceSystem	Xác định hệ thống đã trích xuất dữ liệu. Trong trường hợp này, đó là UKG Pro.
Mô tả Thuộc tính này cho biết nguồn gốc của dữ liệu quy trình. Trong trường hợp này, nguồn chính là UKG Pro, nhưng quy trình tuyển dụng đến nghỉ việc có thể sử dụng dữ liệu từ các hệ thống khác như hệ thống theo dõi ứng viên (ATS) hoặc hệ thống quản lý học tập (LMS). Khi phân tích, thuộc tính này giúp phân biệt nguồn dữ liệu nếu có nhiều hệ thống và hỗ trợ quản trị dữ liệu, xử lý sự cố. Nếu chỉ dùng một nguồn, thuộc tính vẫn cung cấp thông tin cần thiết về xuất xứ dữ liệu. Vì sao điều này quan trọng Cho biết nguồn gốc dữ liệu sự kiện, cung cấp thông tin cần thiết cho quản trị dữ liệu, đảm bảo chất lượng và truy xuất nguồn gốc. Lấy dữ liệu ở đâu Đây thường là giá trị cố định ('UKG Pro'), được thêm trong quá trình trích xuất và chuyển đổi dữ liệu. Ví dụ UKG ProUKGPro_CoreHRUKG
	Lần cập nhật dữ liệu gần nhất LastDataUpdate	Dấu thời gian cho biết lần gần nhất dữ liệu của sự kiện này được làm mới hoặc trích xuất từ hệ thống nguồn.
Mô tả Thuộc tính này cho biết thời điểm trích xuất dữ liệu gần nhất từ UKG Pro. Đây không phải thời điểm sự kiện nghiệp vụ diễn ra, mà là lúc bản ghi được đưa vào công cụ process mining. Thông tin này rất quan trọng để biết dữ liệu đang phân tích có mới hay không. Nhờ đó, chuyên viên phân tích và người dùng nghiệp vụ có thể biết dữ liệu quy trình được cập nhật đến đâu, đồng thời quản lý lịch làm mới dữ liệu và xác minh mức độ cập nhật của thông tin phân tích. Vì sao điều này quan trọng Cho biết dữ liệu mới đến đâu, yếu tố cần thiết để tin cậy kết quả phân tích và đưa ra quyết định kinh doanh kịp thời. Lấy dữ liệu ở đâu Dấu thời gian này được tạo và thêm vào từng bản ghi trong quá trình trích xuất, chuyển đổi và tải dữ liệu (ETL). Ví dụ 2024-03-15T02:00:00Z2024-03-16T02:00:00Z2024-03-17T02:00:00Z
	Tên hoạt động ActivityName	Tên sự kiện hoặc cột mốc cụ thể trong vòng đời nhân viên, chẳng hạn như 'Employee Hired' hoặc 'Performance Review Conducted'.
Mô tả Tên hoạt động mô tả một bước hoặc công việc trong quy trình tuyển dụng đến nghỉ việc. Các sự kiện này được gắn dấu thời gian và sắp xếp theo thứ tự để tạo luồng quy trình, sau đó được trực quan hóa và phân tích bằng process mining. Phân tích trình tự và tần suất hoạt động cho thấy quy trình thực tế diễn ra như thế nào. Qua đó, bạn có thể xác định các lộ trình phổ biến, điểm khác với quy trình chuẩn và điểm nghẽn giữa những hoạt động quan trọng như 'Onboarding Initiated' và 'Payroll Setup Completed'. Vì sao điều này quan trọng Thuộc tính này xác định các bước trên sơ đồ quy trình, giúp trực quan hóa và phân tích luồng công việc trong vòng đời nhân viên. Lấy dữ liệu ở đâu Thông tin này thường được lấy từ nhật ký sự kiện, thay đổi trạng thái quy trình làm việc hoặc các trường ngày cụ thể trong nhiều phân hệ UKG Pro, chẳng hạn như Recruiting, Onboarding và Performance Management. Thông thường, cần có quy tắc ánh xạ để tạo tên hoạt động thống nhất. Ví dụ Tuyển dụng nhân viênThực hiện đánh giá hiệu suấtBắt đầu quy trình nghỉ việc
	Chức danh công việc JobTitle	Chức danh chính thức của nhân viên, chẳng hạn như “Kỹ sư phần mềm” hoặc “Quản lý kinh doanh”.
Mô tả Chức danh mô tả vai trò hoặc vị trí của nhân viên trong tổ chức. Đây là tiêu chí quan trọng để phân tích sự khác biệt giữa các quy trình theo vai trò và cấp bậc. Bạn có thể dùng chức danh để so sánh thời gian hội nhập giữa các vai trò, đánh giá tốc độ thăng tiến hoặc xác định chức danh nào có tỷ lệ nghỉ việc sớm cao hơn. Từ đó, tổ chức có thể điều chỉnh quy trình nhân sự và chương trình hỗ trợ cho phù hợp với nhu cầu của từng nhóm nhân viên. Vì sao điều này quan trọng Cho phép phân tích theo vai trò để hiểu quy trình vòng đời nhân viên khác nhau thế nào giữa các chức năng công việc và cấp bậc. Lấy dữ liệu ở đâu Đây là trường tiêu chuẩn gắn với vị trí hoặc hồ sơ công việc của nhân viên trong mô-đun Core HR của UKG Pro. Ví dụ Kỹ sư phần mềm cấp IIQuản lý sản phẩm cấp caoĐối tác nhân sự kinh doanh
	Mã yêu cầu tuyển dụng JobRequisitionId	Mã định danh duy nhất của yêu cầu tuyển dụng khởi đầu quy trình tuyển dụng.
Mô tả Mã yêu cầu tuyển dụng là mã tham chiếu duy nhất cho một vị trí cần tuyển cụ thể. Mã này liên kết mọi hoạt động tuyển dụng giai đoạn đầu, từ tạo và phê duyệt yêu cầu đến tìm ứng viên và gửi thư mời. Mã này rất cần thiết để phân tích KPI 'Thời gian tuyển dụng', vì nó đánh dấu thời điểm thực sự bắt đầu quy trình tuyển dụng. Bạn có thể theo dõi toàn bộ quy trình tuyển dụng cho một vị trí và phân tích các chỉ số như 'Tỷ lệ yêu cầu tuyển dụng không hoạt động' bằng cách xác định những yêu cầu không tiến triển. Vì sao điều này quan trọng Xác định rõ điểm bắt đầu của quy trình tuyển dụng, giúp đo chính xác thời gian tuyển dụng và hiệu quả của yêu cầu tuyển dụng. Lấy dữ liệu ở đâu Tìm trong phân hệ Recruiting của UKG Pro hoặc hệ thống theo dõi ứng viên (ATS) được kết nối. Ví dụ REQ-2023-015REQ-2024-112REQ-2023-504
	Ngày tuyển dụng HireDate	Ngày chính thức bắt đầu làm việc của nhân viên tại tổ chức.
Mô tả Ngày tuyển dụng đánh dấu thời điểm nhân viên bắt đầu làm việc. Đây là mốc thời gian cơ bản để tính toán và phân tích nhiều khía cạnh trong vòng đời nhân viên. Thuộc tính này được dùng để tính thâm niên, yếu tố quan trọng khi phân tích “Tỷ lệ nhân viên mới nghỉ việc sớm”. Thuộc tính này cũng hỗ trợ phân tích theo nhóm nhân viên tuyển dụng cùng thời kỳ, giúp so sánh các mô hình vòng đời giữa những nhóm được tuyển vào các giai đoạn khác nhau. Vì sao điều này quan trọng Làm mốc tính thâm niên của nhân viên, đồng thời cần thiết cho phân tích theo nhóm và các KPI về tỷ lệ nghỉ việc. Lấy dữ liệu ở đâu Đây là trường tiêu chuẩn bắt buộc trong hồ sơ chính của nhân viên ở mô-đun Core HR của UKG Pro. Ví dụ 2022-08-152023-01-202021-05-10
	Người thực hiện hoạt động ActioningUser	Tên hoặc mã của người dùng, thường là nhân viên nhân sự hoặc quản lý, đã thực hiện hoạt động trên UKG Pro.
Mô tả Thuộc tính này xác định người chịu trách nhiệm thực hiện một bước cụ thể trong quy trình, chẳng hạn như chuyên viên tuyển dụng gửi thư mời hoặc quản lý phê duyệt thăng chức. Thuộc tính liên kết hoạt động trong quy trình với người thực hiện. Khi phân tích, thuộc tính này rất hữu ích để hiểu cách phân bổ khối lượng công việc, xác định nhu cầu đào tạo và phân tích hiệu suất của từng người dùng. Ví dụ, thuộc tính có thể giúp xác định liệu lỗi nhập dữ liệu sau bước 'Payroll Setup Completed' có tập trung ở một số người dùng cụ thể hay không, từ đó hỗ trợ KPI 'Tỷ lệ phải sửa dữ liệu sau hội nhập'. Vì sao điều này quan trọng Liên kết hoạt động trong quy trình với từng người dùng, giúp phân tích khối lượng công việc, so sánh hiệu suất và tìm hiểu nguyên nhân phải làm lại hoặc phát sinh lỗi. Lấy dữ liệu ở đâu Thông tin này thường có trong nhật ký kiểm tra hoặc trường 'Last Modified By' của các phân hệ UKG Pro. Tên trường cụ thể tùy theo phân hệ. Ví dụ j.does.smithhr_admin
	Phòng ban EmployeeDepartment	Phòng ban hoặc đơn vị tổ chức nơi nhân viên được phân công.
Mô tả Thuộc tính này chứa tên phòng ban được phân công cho nhân viên, chẳng hạn như 'Kinh doanh', 'Kỹ thuật' hoặc 'Tài chính'. Đây là chiều dữ liệu quan trọng để phân nhóm và so sánh hiệu suất quy trình. Phân tích theo phòng ban giúp so sánh cách thực hiện quy trình giữa các đơn vị kinh doanh. Ví dụ, bạn có thể xem thời gian tuyển dụng có dài hơn ở các phòng ban kỹ thuật hay không, hoặc mức độ tuân thủ đánh giá hiệu suất có khác biệt đáng kể giữa bộ phận Kinh doanh và Vận hành hay không. Từ đó, bạn có thể xác định hướng cải tiến phù hợp. Vì sao điều này quan trọng Cho phép lọc và phân nhóm quy trình theo cơ cấu tổ chức để so sánh, qua đó phát hiện khác biệt giữa các phòng ban. Lấy dữ liệu ở đâu Đây là trường dữ liệu tiêu chuẩn trong hồ sơ công việc hoặc vị trí của nhân viên thuộc phân hệ Core HR trên UKG Pro. Ví dụ Kỹ thuậtKinh doanhNhân sự
	Tên quản lý ManagerName	Tên của quản lý trực tiếp hoặc người giám sát nhân viên.
Mô tả Thuộc tính này xác định quản lý trực tiếp của nhân viên. Quản lý có vai trò quan trọng trong nhiều sự kiện vòng đời nhân viên, như đánh giá hiệu suất, thăng chức và phân công đào tạo. Phân tích theo quản lý giúp bạn hiểu sự khác biệt trong cách các nhóm thực hiện công việc và đánh giá hiệu quả quản lý. Chẳng hạn, dashboard “Phân tích tác động của việc thay đổi quản lý” dùng thuộc tính này để xem việc đổi quản lý ảnh hưởng thế nào đến các hoạt động tiếp theo. Thuộc tính này cũng là dữ liệu đầu vào quan trọng cho KPI “Thời gian để quản lý tái tham gia”. Vì sao điều này quan trọng Cho phép phân tích hiệu quả quy trình ở cấp nhóm và đánh giá tác động của quản lý đến các sự kiện trong vòng đời nhân viên. Lấy dữ liệu ở đâu Thông tin này nằm trong dữ liệu cơ cấu báo cáo của nhân viên ở mô-đun Core HR của UKG Pro. Ví dụ John SmithMaria GarciaChen Wei
	Trạng thái việc làm EmploymentStatus	Trạng thái việc làm hiện tại hoặc trước đây của nhân viên, chẳng hạn như 'Đang làm việc', 'Đã nghỉ việc' hoặc 'Đang nghỉ phép'.
Mô tả Thuộc tính này cho biết trạng thái chính thức của nhân viên trong công ty tại một thời điểm nhất định. Đây là chiều dữ liệu quan trọng để hiểu tình hình chung của lực lượng lao động và lọc phân tích theo từng nhóm nhân viên. Phân tích thay đổi trạng thái việc làm giúp mô hình hóa quy trình chính xác, chẳng hạn như phân biệt nghỉ phép tạm thời với chấm dứt việc làm chính thức. Thuộc tính này là cơ sở để tính tỷ lệ nhân viên nghỉ việc và hiểu kết quả của các lộ trình khác nhau trong vòng đời nhân viên. Vì sao điều này quan trọng Cung cấp thông tin cần thiết về tình trạng của nhân viên, giúp phân tích chính xác tỷ lệ nghỉ việc và phân nhóm lực lượng lao động. Lấy dữ liệu ở đâu Đây là trường dữ liệu cốt lõi trong hồ sơ chính của nhân viên thuộc phân hệ Core HR trên UKG Pro. Ví dụ Đang làm việcChấm dứt việc làmNghỉ phép
	Địa điểm Location	Địa điểm hoặc văn phòng nơi nhân viên làm việc.
Mô tả Thuộc tính này cho biết nơi làm việc chính của nhân viên, có thể là thành phố, quốc gia hoặc một tòa nhà văn phòng cụ thể. Đây là tiêu chí quan trọng để phân tích quy trình nhân sự theo khu vực địa lý. Phân tích hiệu quả quy trình theo địa điểm có thể giúp phát hiện khác biệt giữa các khu vực về hiệu quả tuyển dụng, cách hội nhập nhân viên hoặc tỷ lệ nghỉ việc. Ví dụ, bạn có thể so sánh “Thời gian tuyển dụng” giữa văn phòng New York và London để tìm ra cách làm hiệu quả hoặc điểm nghẽn tại từng địa phương. Vì sao điều này quan trọng Cho phép phân tích quy trình theo khu vực địa lý, qua đó làm rõ khác biệt về hiệu quả và tuân thủ giữa các khu vực. Lấy dữ liệu ở đâu Thông tin này nằm trong dữ liệu công việc hoặc dữ liệu cá nhân của nhân viên ở mô-đun Core HR của UKG Pro. Ví dụ New York, NYLondon, UKLàm việc từ xa
	Lý do nghỉ việc TerminationReason	Lý do nghỉ việc được ghi nhận, chẳng hạn như “Tự nguyện - Xin nghỉ” hoặc “Bắt buộc - Hiệu suất”.
Mô tả Thuộc tính này ghi nhận lý do chấm dứt việc làm của nhân viên. Lý do thường được chia thành hai nhóm: tự nguyện và bắt buộc, cùng các nhóm nhỏ cụ thể hơn. Đây là thuộc tính quan trọng để phân tích khả năng giữ chân nhân viên và tình trạng nghỉ việc. Khi phân nhóm nhân viên đã nghỉ theo lý do, tổ chức có thể hiểu rõ hơn nguyên nhân gốc rễ của tình trạng nghỉ việc. Ví dụ, phân tích “Tỷ lệ nhân viên mới nghỉ việc sớm” theo lý do nghỉ giúp phân biệt giữa tuyển dụng chưa phù hợp và nhân viên chuyển sang nơi khác vì có lời mời hấp dẫn hơn. Vì sao điều này quan trọng Giúp làm rõ nguyên nhân nhân viên nghỉ việc, từ đó xây dựng các biện pháp giữ chân phù hợp. Lấy dữ liệu ở đâu Trường này thường được ghi nhận trong quy trình chấm dứt việc làm hoặc nghỉ việc trên mô-đun Core HR của UKG Pro. Ví dụ Tự nguyện - Cơ hội khácBắt buộc - Hiệu suấtNghỉ hưu
	Lý do thay đổi vai trò RoleChangeReason	Lý do thay đổi vai trò của nhân viên, chẳng hạn như “Thăng chức”, “Chuyển ngang” hoặc “Tái cơ cấu”.
Mô tả Thuộc tính này cung cấp bối cảnh cho các sự kiện luân chuyển nội bộ, giải thích lý do thay đổi vai trò hoặc vị trí của nhân viên trong tổ chức. Đây là dữ liệu cần thiết cho dashboard và KPI “Thời gian luân chuyển nội bộ”, vì giúp phân biệt thăng chức với các hình thức chuyển vị trí khác. Phân tích quy trình theo lý do có thể cho thấy quy trình thăng chức có chậm hơn chuyển ngang không, từ đó giúp cải thiện lộ trình phát triển nghề nghiệp. Vì sao điều này quan trọng Giải thích bối cảnh của các đợt luân chuyển nội bộ, giúp phân tích rõ hơn các quy trình như thăng chức và chuyển ngang. Lấy dữ liệu ở đâu Thông tin này thường được ghi nhận trong giao dịch thay đổi công việc hoặc chuyển vị trí ở mô-đun Core HR của UKG Pro. Ví dụ Thăng chứcChuyển ngangTái cơ cấu
	Ngạch lương SalaryGrade	Ngạch hoặc bậc lương gắn với vai trò của nhân viên.
Mô tả Ngạch lương thể hiện mức đãi ngộ của một công việc cụ thể. Đây là thuộc tính quan trọng để phân tích các hoạt động và xu hướng liên quan đến lương thưởng. Thuộc tính này hữu ích khi phân tích các sự kiện “Thay đổi đãi ngộ” và có thể dùng để theo dõi KPI “Tỷ lệ phải sửa lại dữ liệu sau hội nhập” nếu ngạch lương thường xuyên được chỉnh sửa. Bạn cũng có thể phân nhóm để xem thời gian thăng chức hoặc tỷ lệ nghỉ việc có khác nhau theo mức lương hay không. Vì sao điều này quan trọng Cung cấp bối cảnh cho các hoạt động liên quan đến lương thưởng và cho phép phân tích quy trình theo mức lương. Lấy dữ liệu ở đâu Có trong hồ sơ lương thưởng hoặc hồ sơ công việc của nhân viên ở mô-đun Core HR của UKG Pro. Ví dụ IC3M2D1
	Ngày nghỉ việc TerminationDate	Ngày chính thức kết thúc việc làm của nhân viên.
Mô tả Ngày nghỉ việc đánh dấu thời điểm nhân viên kết thúc làm việc. Đây là mốc cuối trong vòng đời nhân viên tại tổ chức. Thuộc tính này cần thiết để tính tổng thâm niên và là thành phần quan trọng trong phân tích tình trạng nghỉ việc. Khoảng thời gian từ ngày tuyển dụng đến ngày nghỉ việc là cơ sở cho dashboard “Phân tích tình trạng nghỉ việc sớm theo thâm niên” và các KPI liên quan. Vì sao điều này quan trọng Xác định thời điểm kết thúc vòng đời nhân viên, giúp tính tổng thâm niên và hỗ trợ mọi phân tích liên quan đến tình trạng nghỉ việc. Lấy dữ liệu ở đâu Đây là trường tiêu chuẩn trong hồ sơ chính của nhân viên trên UKG Pro. Trường được điền khi hoàn tất quy trình nghỉ việc. Ví dụ 2023-11-302024-02-152022-12-31
	Nghỉ việc sớm IsEarlyChurn	Cờ đúng/sai cho biết nhân viên nghỉ việc trong khoảng thời gian đầu đã xác định, chẳng hạn 90 hoặc 180 ngày.
Mô tả Thuộc tính được tính toán này đánh dấu những nhân viên rời tổ chức không lâu sau khi được tuyển dụng. Tổ chức thường tự xác định ngưỡng “sớm”, chẳng hạn trong năm đầu tiên. Cờ này giúp đơn giản hóa việc phân tích cho dashboard “Phân tích tình trạng nghỉ việc sớm theo thâm niên” và KPI “Tỷ lệ nhân viên mới nghỉ việc sớm”. Bạn có thể nhanh chóng lọc và phân nhóm những trường hợp cần quan tâm, rồi phân tích đặc điểm và mô hình vòng đời của họ để tìm vấn đề trong tuyển dụng hoặc hội nhập. Vì sao điều này quan trọng Hỗ trợ trực tiếp việc phân tích tình trạng nghỉ việc sớm bằng cách đánh dấu các trường hợp có nguy cơ, giúp tìm nguyên nhân khiến nhân viên rời đi quá sớm. Lấy dữ liệu ở đâu Thuộc tính này được tính trong bước chuẩn bị dữ liệu. Logic so sánh khoảng cách giữa “TerminationDate” và “HireDate” với ngưỡng đã đặt trước, chẳng hạn 365 ngày. Ví dụ truefalse
	Tên khóa đào tạo TrainingName	Tên khóa học hoặc chương trình đào tạo được giao cho nhân viên.
Mô tả Thuộc tính này xác định khóa đào tạo hoặc mô-đun học tập cụ thể được giao cho nhân viên. Nội dung có thể là khóa đào tạo bắt buộc về tuân thủ hoặc chương trình phát triển kỹ năng theo vai trò. Đây là thuộc tính quan trọng của dashboard “Giao và hoàn thành khóa đào tạo” và KPI “Tỷ lệ hoàn thành đào tạo”. Thuộc tính này giúp theo dõi tiến độ, hiệu quả của từng chương trình và phân tích thời gian hoàn thành giữa các khóa học. Vì sao điều này quan trọng Cho phép theo dõi và phân tích từng chương trình đào tạo, giúp đo lường mức độ tuân thủ và hiệu quả phát triển năng lực. Lấy dữ liệu ở đâu Lấy từ mô-đun Learning của UKG Pro hoặc hệ thống quản lý học tập (LMS) được kết nối. Ví dụ Quy tắc ứng xử 2024Kỹ năng quản lý nâng caoNhận thức về an ninh mạng
	Thời điểm kết thúc sự kiện EventEndTime	Dấu thời gian ghi nhận lúc hoàn tất một hoạt động có thời lượng đo được.
Mô tả Với các hoạt động không diễn ra tức thời, thời điểm kết thúc sự kiện ghi nhận lúc hoạt động hoàn tất. Thông tin này khác với dấu thời gian sự kiện (StartTime), vốn ghi nhận thời điểm bắt đầu. Có cả thời điểm bắt đầu và kết thúc giúp tính chính xác thời gian xử lý của từng hoạt động, chẳng hạn như “Kiểm tra lý lịch” hoặc “Nhiệm vụ hội nhập”. Nhờ đó, bạn có thể phân tích chi tiết hơn thời gian được sử dụng ở từng bước trong quy trình. Vì sao điều này quan trọng Giúp tính chính xác thời gian xử lý của từng hoạt động và xác định những bước tốn nhiều thời gian nhất trong quy trình. Lấy dữ liệu ở đâu Lấy từ các trường ngày hoàn tất trong UKG Pro. Thường cần ghép sự kiện bắt đầu với sự kiện hoàn tất tương ứng trong dữ liệu nguồn. Ví dụ 2023-01-15T17:30:00Z2023-06-21T10:00:00Z2024-02-01T11:05:00Z
	Xếp loại hiệu suất PerformanceRating	Mức xếp loại dành cho nhân viên trong một kỳ đánh giá hiệu suất.
Mô tả Xếp loại hiệu suất là kết quả của hoạt động “Thực hiện đánh giá hiệu suất”. Kết quả thường được thể hiện theo thang điểm, chẳng hạn từ 1 đến 5, hoặc bằng nhãn mô tả như “Vượt kỳ vọng”. Chỉ số này thể hiện mức đánh giá hiệu suất của nhân viên. Thuộc tính này giúp đối chiếu các sự kiện trong quy trình với kết quả hiệu suất. Chẳng hạn, bạn có thể phân tích xem nhân viên có hiệu suất cao có được thăng chức nhanh hơn không, hoặc xếp loại hiệu suất có liên quan đến tình trạng nghỉ việc không. Đây là dữ liệu trọng tâm của dashboard “Tuân thủ chu kỳ đánh giá hiệu suất”. Vì sao điều này quan trọng Liên kết các sự kiện trong quy trình với kết quả hiệu suất, giúp phân tích hiệu quả quản lý nhân tài và tác động đến khả năng giữ chân nhân viên. Lấy dữ liệu ở đâu Có trong mô-đun Performance Management của UKG Pro và được liên kết với từng kỳ đánh giá. Ví dụ Vượt kỳ vọngĐạt kỳ vọngCần cải thiện5

Bắt buộc Nên có Không bắt buộc

Các hoạt động trong quy trình từ tuyển dụng đến nghỉ việc trong vòng đời nhân viên

Đây là các bước và cột mốc chính cần ghi lại trong event log để khám phá và cải tiến quy trình chính xác.

6 Nên có 9 Không bắt buộc

	Hoạt động	Mô tả
	Bắt đầu quy trình nghỉ việc	Đánh dấu thời điểm bắt đầu quy trình nghỉ việc, được ghi nhận khi ngày nghỉ việc trong tương lai được nhập vào hệ thống. Sự kiện này kích hoạt danh sách kiểm tra và quy trình làm việc nghỉ việc.
Vì sao điều này quan trọng Đây là cột mốc quan trọng, mở đầu quy trình nhân viên rời tổ chức. Phân tích khoảng thời gian từ sự kiện này đến khi nghỉ việc chính thức giúp đánh giá hiệu quả và mức độ đầy đủ của các bước nghỉ việc. Lấy dữ liệu ở đâu Thông thường, đây là thời điểm tạo bản ghi hành động 'Termination' trong dữ liệu công việc của nhân viên, với ngày hiệu lực trong tương lai. Sự kiện cũng có thể là lúc bắt đầu quy trình làm việc nghỉ việc trong một phân hệ cụ thể. Thu thập Ghi nhận khi giao dịch nghỉ việc có ngày hiệu lực trong tương lai được gửi đi. Loại sự kiện explicit
	Chấm dứt việc làm	Sự kiện cuối cùng trong vòng đời nhân viên, đánh dấu thời điểm việc làm chính thức kết thúc. Từ ngày chấm dứt có hiệu lực, hồ sơ nhân viên chuyển sang trạng thái không hoạt động trong hệ thống.
Vì sao điều này quan trọng Đây là sự kiện kết thúc chính thức của quy trình, rất quan trọng để tính tổng thời gian làm việc và phân tích tình trạng nhân viên nghỉ việc. Sự kiện khép lại hành trình làm việc của nhân viên tại công ty. Lấy dữ liệu ở đâu Đây là ngày hiệu lực của hành động 'Termination' cuối cùng trong lịch sử dữ liệu công việc của nhân viên thuộc phân hệ HR Core. Thông thường, vào ngày này hệ thống chuyển trạng thái nhân viên từ đang làm việc sang không hoạt động. Thu thập Lấy từ ngày hiệu lực của hành động 'Termination' trong lịch sử công việc của nhân viên. Loại sự kiện explicit
	Hoàn tất hội nhập nhân viên	Cột mốc quan trọng cho biết nhân viên đã hoàn tất thành công danh sách kiểm tra hoặc quy trình làm việc hội nhập ban đầu. Thông thường, điều này có nghĩa là nhân viên đã hoàn thành giấy tờ bắt buộc, yêu cầu cấp quyền truy cập hệ thống và các công việc hành chính ban đầu.
Vì sao điều này quan trọng Đánh dấu kết thúc giai đoạn thiết lập hành chính ban đầu, giúp phân tích tổng thời gian hội nhập. Đây là thời điểm nhân viên đã sẵn sàng về mặt hành chính để bắt đầu các nhiệm vụ chuyên môn. Lấy dữ liệu ở đâu Tìm trong phân hệ Onboarding. Thường có thể suy ra sự kiện từ dấu thời gian hoàn tất toàn bộ quy trình làm việc hội nhập hoặc thời điểm công việc bắt buộc cuối cùng được đánh dấu hoàn tất. Thu thập Suy ra từ dấu thời gian hoàn tất danh sách kiểm tra hội nhập tổng thể của nhân viên. Loại sự kiện inferred
	Phê duyệt thăng chức	Cho biết việc thăng chức của nhân viên đã được phê duyệt chính thức. Việc này thường đi kèm thay đổi chức danh và có thể cả mức lương. Đây là sự kiện riêng, diễn ra trước ngày thay đổi có hiệu lực.
Vì sao điều này quan trọng Hoạt động này rất quan trọng khi phân tích luân chuyển nội bộ và lộ trình nghề nghiệp. Khoảng thời gian từ lúc phê duyệt thăng chức đến ngày có hiệu lực có thể cho thấy điểm nghẽn hành chính trong hệ thống. Lấy dữ liệu ở đâu Được ghi nhận dưới dạng hành động công việc cụ thể, chẳng hạn như 'Promotion', trong lịch sử dữ liệu công việc của nhân viên thuộc phân hệ HR Core. Bản ghi có ngày phê duyệt và ngày hiệu lực riêng. Thu thập Lấy từ ngày ghi nhận hành động 'Promotion' trong lịch sử công việc của nhân viên. Loại sự kiện explicit
	Thực hiện đánh giá hiệu suất	Đánh dấu việc hoàn tất một chu kỳ đánh giá hiệu suất chính thức của nhân viên. Sự kiện này được ghi nhận khi quản lý hoặc bộ phận nhân sự hoàn tất và gửi biểu mẫu đánh giá.
Vì sao điều này quan trọng Đây là cột mốc quan trọng, lặp lại trong vòng đời nhân viên. Theo dõi tần suất và thời hạn hoàn tất giúp đánh giá mức độ tuân thủ quy trình quản lý hiệu suất và ảnh hưởng của quy trình đến lộ trình nghề nghiệp. Lấy dữ liệu ở đâu Tìm trong phân hệ Performance Management của UKG Pro. Có thể xác định sự kiện qua ngày hoàn tất biểu mẫu đánh giá hiệu suất hoặc khi trạng thái chu kỳ đánh giá chuyển thành 'Completed'. Thu thập Lấy từ dấu thời gian hoàn tất phiên bản quy trình làm việc đánh giá hiệu suất. Loại sự kiện explicit
	Tuyển dụng nhân viên	Đánh dấu thời điểm hồ sơ nhân viên chính thức được tạo trên UKG Pro và được cấp mã nhân viên. Sự kiện này thường được ghi nhận khi quản trị viên nhân sự hoàn tất quy trình tuyển dụng, chuyển ứng viên thành nhân viên đang làm việc trong hệ thống.
Vì sao điều này quan trọng Đây là sự kiện bắt đầu chính thức để phân tích quy trình tuyển dụng đến nghỉ việc. Sự kiện này tạo mốc cơ sở để đo thời gian đạt năng suất, hiệu quả hội nhập và tổng thời gian làm việc của nhân viên. Lấy dữ liệu ở đâu Sự kiện này có thể được ghi trong phân hệ HR Core hoặc Quản lý nhân sự. Bạn có thể xác định sự kiện qua ngày tạo hồ sơ việc làm chính của nhân viên hoặc bản ghi hành động 'Hire' trong lịch sử dữ liệu công việc. Thu thập Lấy từ ngày hiệu lực của hành động 'Hire' trong bảng lịch sử công việc của nhân viên. Loại sự kiện explicit
	Bắt đầu hội nhập nhân viên mới	Đánh dấu thời điểm bắt đầu quy trình hoặc quy trình làm việc hội nhập nhân viên mới trên UKG Pro. Sự kiện này thường được kích hoạt tự động hoặc thủ công, sau đó giao danh sách công việc cho nhân viên mới, quản lý và bộ phận nhân sự.
Vì sao điều này quan trọng Theo dõi hoạt động này giúp đo khoảng thời gian từ ngày tuyển dụng chính thức đến khi bắt đầu hòa nhập về mặt hành chính và văn hóa. Đây là mốc khởi đầu để phân tích hiệu quả quy trình hội nhập và xác định chậm trễ. Lấy dữ liệu ở đâu Tìm trong phân hệ Onboarding của UKG Pro. Có thể suy ra sự kiện từ ngày tạo danh sách kiểm tra hội nhập hoặc phiên bản quy trình làm việc gắn với nhân viên. Thu thập Suy ra từ dấu thời gian tạo quy trình làm việc hoặc danh sách công việc hội nhập của nhân viên. Loại sự kiện inferred
	Bắt đầu nghỉ phép	Đánh dấu thời điểm bắt đầu kỳ nghỉ phép đã được phê duyệt của nhân viên, chẳng hạn vì lý do sức khỏe hoặc cá nhân. Sự kiện được ghi nhận khi trạng thái nhân viên chuyển sang trạng thái không hoạt động hoặc đang nghỉ phép.
Vì sao điều này quan trọng Sự kiện này xác định các giai đoạn nhân viên tạm ngừng làm việc. Đây là thông tin quan trọng để tính chính xác thời gian làm việc thực tế và hiểu ảnh hưởng của kỳ nghỉ phép đến lộ trình nghề nghiệp. Lấy dữ liệu ở đâu Tìm trong lịch sử dữ liệu công việc của nhân viên thuộc phân hệ HR Core. Sự kiện tương ứng với hành động công việc như 'Leave of Absence' và có ngày bắt đầu hiệu lực cụ thể. Thu thập Lấy từ ngày hiệu lực của hành động 'Start Leave' trong lịch sử công việc. Loại sự kiện explicit
	Giao khóa đào tạo	Ghi nhận thời điểm một khóa đào tạo hoặc kế hoạch học tập cụ thể được giao cho nhân viên. Thông tin này thường được lưu trong phân hệ quản lý học tập của hệ thống.
Vì sao điều này quan trọng Hoạt động này giúp theo dõi việc tuân thủ các khóa đào tạo bắt buộc và giám sát quá trình phát triển của nhân viên. Phân tích khoảng thời gian từ lúc giao đến khi hoàn tất có thể cho thấy vấn đề về mức độ tham gia hoặc hiệu quả đào tạo. Lấy dữ liệu ở đâu Được ghi trong phân hệ quản lý học tập hoặc quản lý nhân tài của UKG Pro. Mỗi lần giao khóa học cần có bản ghi tương ứng với ngày giao và mã nhân viên. Thu thập Ghi nhận khi khóa học hoặc chương trình học được thêm vào kế hoạch học tập của nhân viên. Loại sự kiện explicit
	Hoàn tất quy trình nghỉ việc	Cột mốc cho biết mọi công việc nghỉ việc bắt buộc đã hoàn tất. Các công việc này gồm trả lại tài sản, tính lương cuối cùng và thu hồi quyền truy cập hệ thống.
Vì sao điều này quan trọng Sự kiện này xác nhận các bước cần thiết để nhân viên rời tổ chức an toàn và đúng quy định đã được thực hiện. Sự kiện giúp đo thời gian xử lý nghỉ việc và xác định thiếu sót về tuân thủ. Lấy dữ liệu ở đâu Có thể suy ra sự kiện này từ dấu thời gian hoàn tất danh sách kiểm tra hoặc quy trình làm việc nghỉ việc tổng thể, tương tự sự kiện 'Employee Onboarded' nhưng áp dụng cho quy trình rời tổ chức. Thu thập Suy ra từ dấu thời gian hoàn tất danh sách kiểm tra nghỉ việc tổng thể của nhân viên. Loại sự kiện inferred
	Hoàn tất thiết lập bảng lương	Cho biết mọi thông tin cần thiết để trả lương cho nhân viên, chẳng hạn như thông tin ngân hàng và biểu mẫu thuế, đã được nhập và xác minh. Đây là bước quan trọng để đảm bảo nhân viên được trả lương chính xác, đúng hạn.
Vì sao điều này quan trọng Cột mốc này rất quan trọng để đo mức độ sẵn sàng của nhân viên mới. Chậm trễ trong việc thiết lập bảng lương có thể khiến nhân viên không hài lòng và phát sinh công việc hành chính phải làm lại, vì vậy đây là KPI quan trọng của quy trình hội nhập. Lấy dữ liệu ở đâu Có thể suy ra sự kiện này từ phân hệ Payroll của UKG Pro. Dữ liệu có thể lấy từ ngày hoàn tất danh sách kiểm tra mức độ sẵn sàng trả lương hoặc ngày trạng thái nhân viên chuyển thành 'Ready for Payroll'. Thu thập Suy ra từ thay đổi trạng thái hoặc dấu thời gian hoàn tất trong hồ sơ bảng lương của nhân viên. Loại sự kiện inferred
	Thay đổi chế độ đãi ngộ	Sự kiện này ghi nhận mọi thay đổi về lương cơ bản, tiền thưởng hoặc các khoản đãi ngộ khác của nhân viên. Thay đổi có thể đi kèm với việc thăng chức, tăng lương theo thành tích hoặc điều chỉnh theo thị trường.
Vì sao điều này quan trọng Theo dõi thay đổi chế độ đãi ngộ rất quan trọng để hiểu lộ trình nghề nghiệp và mức lương. Nhiều lần điều chỉnh sau khi tuyển dụng có thể cho thấy lỗi nhập dữ liệu hoặc vấn đề trong việc xác định mức lương ban đầu. Lấy dữ liệu ở đâu Tìm trong bảng lịch sử đãi ngộ của nhân viên thuộc phân hệ HR Core hoặc Payroll. Mỗi thay đổi thường được ghi kèm ngày hiệu lực và mã lý do. Thu thập Ghi nhận từ ngày hiệu lực của mục mới trong hồ sơ lịch sử đãi ngộ của nhân viên. Loại sự kiện explicit
	Thay đổi quản lý trực tiếp	Sự kiện này được tạo khi trường 'Reports To' hoặc 'Manager ID' của nhân viên được cập nhật. Sự kiện thể hiện thay đổi trong tuyến báo cáo trực tiếp của nhân viên.
Vì sao điều này quan trọng Thay đổi quản lý có thể ảnh hưởng đáng kể đến mức độ gắn kết và hiệu suất của nhân viên. Theo dõi sự kiện này giúp phân tích tác động của thay đổi đến các hoạt động tiếp theo, chẳng hạn như đánh giá hiệu suất hoặc khả năng giữ chân nhân viên. Lấy dữ liệu ở đâu Cần suy ra sự kiện này bằng cách theo dõi thay đổi trong trường quản lý hoặc giám sát viên của nhân viên theo thời gian. Bạn cần so sánh mã quản lý giữa các bản ghi liên tiếp của cùng một nhân viên. Thu thập Suy ra bằng cách phát hiện thay đổi trong trường 'Reports To' ở lịch sử dữ liệu công việc của nhân viên. Loại sự kiện inferred
	Thực hiện phỏng vấn nghỉ việc	Đánh dấu việc hoàn tất phỏng vấn với nhân viên sắp rời tổ chức. Sự kiện này thường được ghi nhận dưới dạng công việc đã hoàn tất trong danh sách kiểm tra nghỉ việc.
Vì sao điều này quan trọng Theo dõi việc hoàn tất phỏng vấn nghỉ việc rất quan trọng để đảm bảo tuân thủ quy trình nhân sự và thu thập phản hồi có giá trị. Việc này giúp xác định liệu bước quan trọng này có bị bỏ qua trong quy trình nghỉ việc hay không. Lấy dữ liệu ở đâu Sự kiện này có thể nằm trong phân hệ Onboarding hoặc HR Help Desk của UKG Pro, dưới dạng một công việc cụ thể trong quy trình làm việc nghỉ việc. Việc ghi nhận tùy thuộc vào việc nhân sự có đánh dấu công việc là hoàn tất hay không. Thu thập Ghi nhận dưới dạng công việc đã hoàn tất trong danh sách kiểm tra nghỉ việc của nhân viên. Loại sự kiện explicit
	Xử lý thay đổi vị trí công việc	Đánh dấu thay đổi công việc hoặc vị trí của nhân viên không phải là thăng chức, chẳng hạn như chuyển ngang hoặc chuyển bộ phận. Sự kiện này được ghi nhận khi dữ liệu công việc liên quan được cập nhật trong hệ thống.
Vì sao điều này quan trọng Phân tích thay đổi vị trí giúp hiểu rõ hơn về luân chuyển nội bộ, bố trí nhân tài và tái cơ cấu tổ chức. Qua đó, bạn có thể xác định cách nhân viên di chuyển giữa các vị trí trong tổ chức. Lấy dữ liệu ở đâu Lấy từ lịch sử dữ liệu công việc của nhân viên trong phân hệ HR Core. Có thể xác định qua các hành động như 'Transfer', 'Re-assignment' hoặc 'Position Change' cùng ngày hiệu lực tương ứng. Thu thập Xác định qua mã hành động 'Transfer' hoặc mã tương tự trong dữ liệu lịch sử công việc của nhân viên. Loại sự kiện explicit

Nên có Không bắt buộc

Hướng dẫn trích xuất dữ liệu

Cách lấy dữ liệu từ UKG Pro

Các bước

Điều kiện cần: Đảm bảo bạn đã cài Python 3.6+ cùng các thư viện requests và pandas. Có thể cài bằng pip: pip install requests pandas.
Quyền truy cập API và xác thực: Liên hệ quản trị viên UKG Pro để tạo Service Account. Bạn cần API Key, User Name và Password. Service Account phải có quyền truy cập tất cả API endpoint cần thiết, bao gồm dữ liệu nhân sự, bảng lương, nhận việc, hiệu suất và học tập.
Cấu hình script: Mở script Python được cung cấp bằng trình soạn thảo văn bản hoặc IDE. Tìm phần cấu hình ở đầu script và thay các giá trị giữ chỗ UKG_BASE_URL, API_KEY, USERNAME, PASSWORD và COMPANY_ID bằng thông tin xác thực và môi trường của bạn.
Đặt khoảng ngày trích xuất: Trong phần cấu hình, xác định biến START_DATE và END_DATE. Các biến này đặt khoảng thời gian trích xuất thay đổi và sự kiện của nhân viên. Nên bắt đầu với khoảng ngắn hơn, chẳng hạn 3-6 tháng, để kiểm thử script.
Chạy script: Chạy script từ dòng lệnh bằng python your_script_name.py. Script sẽ xác thực, lấy dữ liệu từ nhiều UKG Pro API endpoint cho từng hoạt động và hiển thị tiến độ trong cửa sổ dòng lệnh.
Xử lý giới hạn tốc độ API: Script có dùng time.sleep() cơ bản để tuân thủ giới hạn tốc độ API. Nếu gặp lỗi giới hạn tốc độ (HTTP 429), bạn có thể cần tăng thời gian chờ giữa các lần gọi API.
Chuyển đổi và chuẩn hóa dữ liệu: Mỗi hàm trong script được thiết kế để lấy dữ liệu thô cho một hoạt động cụ thể, chọn các trường liên quan và đổi tên theo định dạng event log chuẩn (EmployeeId, ActivityName, EventTimestamp, v.v.).
Kết hợp dữ liệu sự kiện: Phần chính của script gọi từng hàm theo hoạt động rồi thêm dữ liệu thu được vào một danh sách sự kiện tổng.
Tạo event log: Sau khi xử lý tất cả hoạt động, script gộp dữ liệu vào pandas DataFrame, sắp xếp theo mã nhân viên và dấu thời gian, rồi lưu thành tệp CSV có tên ukg_hire_to_retire_event_log.csv.
Kiểm tra và tải lên: Mở tệp CSV vừa tạo để đảm bảo dữ liệu đầy đủ và đúng định dạng. Sau đó, bạn có thể tải tệp lên công cụ process mining.

Cấu hình

Thông tin xác thực: Cần API Key, User Name và Password của service account để xác thực API.
Base URL: UKG_BASE_URL của phiên bản UKG Pro bạn đang dùng (chẳng hạn https://service[##].ultipro.com/api).
Company ID: Nhiều lệnh gọi API cần COMPANY_ID riêng của tổ chức bạn trong UKG Pro.
Khoảng ngày: Các tham số START_DATE và END_DATE (định dạng 'YYYY-MM-DD') xác định khoảng thời gian trích xuất. Với lần chạy đầu tiên, nên chọn 3-6 tháng để kiểm soát lượng dữ liệu và kiểm tra kết quả.
Phiên bản API endpoint: Script dùng các phiên bản REST API cụ thể (chẳng hạn /personnel/v1/). Đảm bảo phiên bản UKG Pro của bạn hỗ trợ các phiên bản này.
Phụ thuộc vào mô-đun: Để trích xuất một số hoạt động, tổ chức của bạn cần có giấy phép và đang sử dụng các mô-đun UKG Pro tương ứng, chẳng hạn Onboarding, Learning và Performance Management. Nếu không dùng mô-đun nào, hoạt động tương ứng sẽ không được trích xuất.

Truy vấn mẫu 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}")

Sẵn sàng bắt đầu?

Dùng mẫu này để chuẩn bị dữ liệu và tìm ra thông tin quan trọng về các quy trình nhân sự. Bắt đầu tối ưu hành trình từ tuyển dụng đến nghỉ việc ngay hôm nay.

Quay lại hướng dẫn cải tiến

Tải mẫu xuống

Bắt đầu tối ưu vòng đời nhân viên từ tuyển dụng đến nghỉ việc ngay hôm nay!

Rút ngắn 30% thời gian quy trình từ tuyển dụng đến nghỉ việc và nâng cao hiệu quả nhân sự.

Bắt đầu dùng thử miễn phí

Không cần thẻ tín dụng, thiết lập nhanh chóng.

Mẫu dữ liệu cho quy trình từ tuyển dụng đến nghỉ việc trong vòng đời nhân viên

Mẫu dữ liệu cho quy trình từ tuyển dụng đến nghỉ việc trong vòng đời nhân viên

Thuộc tính của quy trình từ tuyển dụng đến nghỉ việc trong vòng đời nhân viên

Các hoạt động trong quy trình từ tuyển dụng đến nghỉ việc trong vòng đời nhân viên

Hướng dẫn trích xuất dữ liệu

Trích xuất bằng Python qua UKG Pro REST APIs

Các bước

Cấu hình

Truy vấn mẫu python

Sẵn sàng bắt đầu?

Bắt đầu tối ưu vòng đời nhân viên từ tuyển dụng đến nghỉ việc ngay hôm nay!