> 持续流程改进 > 招聘到离职：员工生命周期 > UKG Pro > 数据模板

您的招聘至离职员工生命周期数据模板

UKG Pro

← 返回改进指南

招聘到离职：员工生命周期属性 (21) 招聘到离职：员工生命周期活动 (15) 数据提取指南 (1)

您的招聘至离职员工生命周期数据模板

此模板全面概述了有效分析招聘至离职流程所需的关键数据元素，包括应收集的重要属性、应跟踪的关键活动，以及从UKG Pro提取数据的实用指南。使用此资源简化数据准备工作，顺利开启流程挖掘。

建议收集的属性
需跟踪的关键活动
UKG Pro数据提取指南

刚接触事件日志？了解如何创建流程挖掘事件日志.

下载模板

招聘到离职：员工生命周期属性

以下是建议纳入事件日志的数据字段，用于全面分析招聘到离职的员工生命周期并获得流程洞察。

5 必需 7 建议 9 可选

	名称	说明
	事件时间戳 EventTimestamp	特定生命周期事件发生的准确日期和时间。
说明事件时间戳为每项活动提供时间顺序背景，是流程的基础。它记录系统登记“接受录用通知”或“批准晋升”等事件的确切时刻。在分析中，这些时间戳用于计算活动之间的持续时间、识别延迟，并衡量招聘和入职等关键子流程的周期时间。准确的时间戳对于所有基于时间的KPI和绩效分析都至关重要。为什么重要此属性对于按时间顺序排列事件，以及计算周期时间和持续时长等所有基于时间的指标至关重要。获取位置来源于UKG Pro中与特定事件关联的日期或时间戳字段，例如“HireDate”“TerminationDate”，或工作流模块中的状态变更时间戳。示例 2023-01-15T09:00:00Z2023-06-20T14:35:10Z2024-02-01T11:00:00Z
	员工ID EmployeeId	分配给每位员工的唯一标识符，作为其在组织整个生命周期中的主要案例ID。
说明 Employee ID是连接员工相关所有事件的主线，从最初申请到最终离职均通过该标识符关联。这一标识对于构建个人完整的端到端流程视图至关重要。在流程挖掘分析中，“Employee Hired”“Promotion Approved”或“Termination Initiated”等每项活动，都会关联回这一唯一ID。借助它，您可以分析单个员工的流程路径，基于员工属性开展群组分析，并准确计算生命周期持续时间。为什么重要这是连接所有员工相关事件的核心案例标识，使您能够分析每位员工的端到端Hire to Retire流程。获取位置这是UKG Pro中的核心字段，通常位于员工档案或主数据记录中。具体表名和字段名请参阅UKG Pro文档，通常标记为Employee Number或Person ID。示例 10052198345210047
	最后数据更新时间 LastDataUpdate	表示该事件数据上次从源系统刷新或提取时间的时间戳。
说明此属性提供从UKG Pro上次提取数据的时间戳。它不是业务事件发生的时间，而是记录被导入流程挖掘工具的时间。该信息对于了解分析数据的新鲜度至关重要。分析人员和业务用户可以据此判断流程视图的时效性，并管理数据刷新计划、验证洞察的时效。为什么重要用于表示数据的新鲜度，这对于信任分析结果并及时制定业务决策至关重要。获取位置此时间戳在数据提取、转换和加载（ETL）过程中生成并附加到每条记录。示例 2024-03-15T02:00:00Z2024-03-16T02:00:00Z2024-03-17T02:00:00Z
	活动名称 ActivityName	员工生命周期中发生的具体事件或里程碑的名称，例如“Employee Hired”或“Performance Review Conducted”。
说明活动名称描述招聘到离职流程中的单个步骤或任务。这些事件带有时间戳并按顺序排列，用于构建流程挖掘中可视化和分析的流程。分析这些活动的顺序和频率，可以揭示流程的实际执行情况，帮助识别常见路径、偏离标准流程的情况，以及“启动入职”和“完成薪资设置”等关键活动之间的瓶颈。为什么重要此属性定义流程图中的步骤，用于展示和分析员工生命周期流程。获取位置通常源自事件日志、工作流状态变更，或UKG Pro各模块中的特定日期字段，例如Recruiting、Onboarding和Performance Management。通常需要通过映射逻辑生成标准化的活动名称。示例员工入职完成绩效评估启动离职流程
	源系统 SourceSystem	用于标识数据提取来源系统，本例中为UKG Pro。
说明此属性用于说明流程数据的来源。在当前场景中，主要来源是UKG Pro，但Hire to Retire流程也可能涉及其他系统的数据，例如Applicant Tracking System（ATS）或学习管理系统（LMS）。在分析中，如果涉及多个系统，该属性有助于区分数据来源，对数据治理和问题排查也十分重要。对于单一来源视图，它可以提供数据来源的必要背景。为什么重要通过标识事件数据的来源，为数据治理、质量保证和可追溯性提供重要背景。获取位置通常是在数据转换和提取过程中添加的静态值（“UKG Pro”）。示例 UKG ProUKGPro_CoreHRUKG
	入职日期 HireDate	员工正式加入组织的日期。
说明入职日期标志着员工任职期的开始，是员工生命周期相关时间计算和分析的基础日期字段。此属性用于计算员工任职时长，对于分析“Early Employee Churn Rate”至关重要。它还支持队列分析，用于比较不同时期入职员工的生命周期模式。为什么重要作为计算员工任职时长的基准，支持队列分析和流失率KPI。获取位置这是UKG Pro Core HR模块中员工主记录的标准必填字段。示例 2022-08-152023-01-202021-05-10
	执行用户 ActioningUser	在UKG Pro中执行该活动的用户姓名或ID，通常为HR代表或经理。
说明此属性用于标识负责执行特定流程步骤的人员，例如发出录用通知的招聘人员或批准晋升的经理。它将流程活动与具体执行人员关联起来。在分析中，该属性对于了解工作量分配、识别培训需求和分析用户级绩效非常有价值。例如，它可以帮助确定“Payroll Setup Completed”之后的数据录入错误是否集中在特定用户，从而支持“Post-Onboarding Data Rework Rate”KPI。为什么重要将流程活动与具体用户关联，支持工作量分析、绩效对比，以及返工或错误调查。获取位置通常位于UKG Pro各模块的审计跟踪日志或“Last Modified By”字段中。具体字段名因模块而异。示例 j.does.smithhr_admin
	经理姓名 ManagerName	员工直属经理或主管的姓名。
说明此属性用于标识员工的直属经理。经理在绩效评估、晋升和培训分配等多个生命周期事件中发挥重要作用。按经理分析有助于了解团队层面的执行差异和经理效能。例如，“Manager Transition Impact Analysis”仪表板依靠此属性分析经理变更对后续活动的影响。它也是“Time to Managerial Re-engagement”KPI的关键数据。为什么重要支持在团队层面分析流程绩效，并帮助评估经理对员工生命周期事件的影响。获取位置该信息属于UKG Pro Core HR模块中的员工汇报关系数据。示例 John SmithMaria GarciaChen Wei
	职位名称 JobTitle	员工的正式职位名称，例如“Software Engineer”或“Sales Manager”。
说明职位名称描述员工在组织中的角色或岗位，是分析不同职能和职级流程差异的重要维度。在分析中，职位名称可用于比较不同岗位的入职时长、评估晋升速度，或识别某些职位是否存在更高的早期流失率。这有助于根据不同员工群体的具体需求调整HR流程和支持计划。为什么重要支持基于岗位的分析，帮助了解生命周期流程如何因职能和职级而异。获取位置这是UKG Pro Core HR模块中与员工岗位或职位记录关联的标准字段。示例软件工程师II高级产品经理人力资源业务伙伴
	职位申请ID JobRequisitionId	发起招聘流程的职位申请的唯一标识符。
说明职位申请ID是特定职位空缺的唯一引用编号，将从创建和审批到候选人寻源、发出录用通知等早期招聘活动关联起来。该ID对于分析“Recruitment Cycle Time”KPI至关重要，因为它标志着招聘流程的真正起点。您可以据此跟踪单个职位空缺的完整招聘漏斗，并通过识别未继续推进的申请来分析“Inactive Job Requisition Rate”等指标。为什么重要为招聘流程提供清晰的起点，支持准确衡量招聘周期时间和职位申请的有效性。获取位置位于UKG Pro Recruiting模块或连接的Applicant Tracking System（ATS）中。示例 REQ-2023-015REQ-2024-112REQ-2023-504
	部门 EmployeeDepartment	员工所属的部门或组织单元。
说明此属性包含员工所属部门的名称，例如“Sales”“Engineering”或“Finance”。它是细分和比较流程绩效的重要组织维度。按部门分析可以比较不同业务单元的流程执行情况。例如，可以分析技术部门的“Recruitment Cycle Time”是否更长，或比较Sales与Operations之间的“Performance Review Adherence”是否存在显著差异，从而为改进提供针对性洞察。为什么重要支持强大的对比分析，您可以根据组织结构筛选和细分流程，从而发现不同部门之间的差异。获取位置这是UKG Pro Core HR模块中员工职位或岗位记录的标准字段。示例工程销售人力资源
	雇佣状态 EmploymentStatus	员工当前或历史雇佣状态，例如“Active”“Terminated”或“On Leave”。
说明此属性表示员工在特定时间点于公司的正式状态，是了解整体员工队伍状态，以及筛选特定员工群体进行分析的重要维度。分析雇佣状态变化有助于正确建模流程，例如区分临时休假和永久离职。它也是计算流失率、了解不同生命周期路径结果的基础。为什么重要提供员工任职状态的重要背景，支持准确的流失分析和员工队伍细分。获取位置这是UKG Pro Core HR模块中员工主记录的核心字段。示例在职已离职请假
	事件结束时间 EventEndTime	标记具有可衡量时长的活动完成时间的时间戳。
说明对于非瞬时活动，事件结束时间记录活动完成的时刻。这与标记开始时间的事件时间戳（StartTime）相对应。同时记录开始和结束时间，可以准确计算“Background Check”或“Onboarding Task”等单项活动的处理时长，从而更细致地分析流程中各环节的时间消耗。为什么重要支持准确计算单项活动的处理时长，帮助定位流程中最耗时的步骤。获取位置来源于UKG Pro中的完成日期字段。通常需要将开始事件与源数据中的对应完成事件配对。示例 2023-01-15T17:30:00Z2023-06-21T10:00:00Z2024-02-01T11:05:00Z
	地点 Location	员工所在的地理位置或办公地点。
说明此属性指定员工的主要工作地点，可以是城市、国家或具体办公楼，是HR流程地理分析的重要维度。按地点分析流程绩效，可以发现招聘效率、入职实践或离职率方面的区域差异。例如，您可以比较“New York”和“London”办公室的“Recruitment Cycle Time”，识别最佳实践或本地瓶颈。为什么重要支持按地理位置细分流程，揭示不同区域在绩效和合规方面的差异。获取位置该信息属于UKG Pro Core HR模块中的员工职位或个人数据。示例纽约州纽约市英国伦敦远程办公
	培训名称 TrainingName	分配给员工的培训课程名称或标题。
说明此属性用于标识员工被分配的具体培训或学习模块，范围可以从强制性合规培训到岗位技能发展课程。它是“Training Assignment & Completion”仪表板和“Training Completion Rate”KPI的关键属性，支持跟踪特定培训项目的进度和成效，并分析不同课程的完成时长。为什么重要支持跟踪和分析具体培训项目，帮助衡量合规情况和发展成效。获取位置来源于UKG Pro Learning模块或连接的Learning Management System（LMS）。示例 2024年行为准则高级管理技能网络安全意识
	岗位变更原因 RoleChangeReason	员工岗位变更的原因，例如“Promotion”“Lateral Transfer”或“Reorganization”。
说明此属性为内部流动事件提供背景，说明员工在组织内变更角色或岗位的原因。它对于“Internal Mobility Cycle Time”仪表板和KPI至关重要，因为可以区分晋升与其他类型的调动。按变更原因分析流程，可以发现晋升流程是否比平级调动更慢，从而优化职业发展路径。为什么重要说明内部调动背后的原因，支持更细致地分析晋升与平级调动等内部流动流程。获取位置通常作为UKG Pro Core HR模块中岗位变更或调动交易的一部分记录。示例晋升平级调动组织重组
	是否早期流失 IsEarlyChurn	用于标识员工是否在预先定义的早期任职期内离职的布尔标记，例如90天或180天内。
说明此计算属性用于标记入职后不久离开组织的员工。“早期”的阈值通常由业务定义，例如入职第一年内。该标记简化了“Early Tenure Churn Insights”仪表板和“Early Employee Churn Rate”KPI所需的分析。您可以快速筛选和细分这一重点群体，分析其特征和生命周期模式，从而发现招聘或入职环节的问题。为什么重要通过标记高风险案例直接支持早期流失分析，帮助识别员工过早离职的根本原因。获取位置此属性在数据准备阶段计算。计算逻辑将“TerminationDate”与“HireDate”的差值与预定义阈值进行比较，例如365天。示例 truefalse
	离职原因 TerminationReason	记录在案的员工离职原因，例如“Voluntary - Resignation”或“Involuntary - Performance”。
说明此属性记录员工终止雇佣关系的原因。原因通常分为自愿和非自愿两类，并进一步细分。这是员工留任和流失分析的关键属性。按离职原因细分员工，可以深入了解人员流失的根本原因。例如，按离职原因分析“Early Employee Churn Rate”，可以区分招聘决策不当与竞争性录用机会等因素。为什么重要深入揭示员工流失的驱动因素，支持制定有针对性的留任策略。获取位置通常在UKG Pro Core HR模块的离职或离职交接流程中记录。示例自愿离职，寻找其他机会非自愿离职，绩效原因退休
	离职日期 TerminationDate	员工正式结束雇佣关系的日期。
说明离职日期标志着员工任职期的结束，也是员工在组织内生命周期的终点。此属性用于计算员工最终任职时长，是流失分析的重要组成部分。入职日期与离职日期之间的时间构成“Early Tenure Churn Insights”仪表板及相关KPI的计算基础。为什么重要定义员工生命周期的结束，支持计算总任职时长和开展所有与人员流失相关的分析。获取位置这是UKG Pro员工主记录中的标准字段，在离职流程完成后填充。示例 2023-11-302024-02-152022-12-31
	绩效评级 PerformanceRating	员工在绩效评估周期中获得的评级。
说明绩效评级是“Performance Review Conducted”活动的结果，通常采用等级制（例如1至5级）或描述性标签（例如“Exceeds Expectations”），用于量化员工绩效评估结果。此属性有助于分析流程事件与绩效结果之间的关联。例如，可以研究高绩效员工是否晋升更快，或绩效评级与员工流失之间是否存在关联。它是“Performance Review Cycle Compliance”仪表板的核心数据。为什么重要将流程事件与绩效结果关联，支持分析人才管理成效及其对员工留任的影响。获取位置位于UKG Pro Performance Management模块中，并与具体评估周期关联。示例超出预期达到预期需要改进5
	薪资等级 SalaryGrade	与员工岗位关联的薪酬等级或薪资区间。
说明薪资等级表示特定岗位的薪酬级别，是分析薪酬相关活动和趋势的重要属性。此属性对于分析“Compensation Changed”等事件非常重要。如果频繁修正薪资等级，还可以用于跟踪“Post-Onboarding Data Rework Rate”KPI。此外，它支持按薪酬级别细分流程，比较不同级别的晋升周期时间或流失率。为什么重要为薪酬相关活动提供背景，并支持按薪资级别细分流程。获取位置位于UKG Pro Core HR模块中的员工薪酬或职位档案。示例 IC3M2D1

必需建议可选

招聘到离职：员工生命周期活动

以下是建议记录的关键流程步骤和里程碑，用于准确发现流程并进行优化。

6 建议 9 可选

	活动	说明
	启动离职流程	表示离职流程开始，即系统录入未来离职日期时记录此事件。该事件会触发离职任务清单和工作流。
为什么重要这是启动员工离职流程的关键里程碑。分析该事件与最终离职之间的时间，有助于评估离职流程的效率和完整性。获取位置通常表现为员工工作数据中创建一条具有未来生效日期的“Termination”操作记录，也可能表现为特定模块中离职工作流的启动。采集提交未来日期的离职交易时记录。事件类型 explicit
	员工入职	标志着UKG Pro中正式创建员工记录并分配Employee ID。通常，当HR管理员完成候选人的招聘流程、将其转为系统中的在职员工时，系统会记录此事件。
为什么重要这是Hire to Retire流程分析的明确开始事件，为衡量达到生产力所需时间、入职效率和员工整体任职时长提供基准。获取位置该事件可能记录在HR Core或Personnel Administration模块中。可以通过员工主要雇佣记录的创建日期，或员工工作数据历史中的特定“Hire”操作记录来识别。采集取自员工工作历史表中“Hire”操作的生效日期。事件类型 explicit
	员工完成入职	表示初始入职任务清单或工作流已成功完成的重要里程碑。通常意味着新员工所需的全部入职文件、系统访问申请和初始行政任务均已完成。
为什么重要标志着初始行政设置结束，可用于分析完整的入职周期时间，也表示员工已具备开始履行岗位职责所需的行政条件。获取位置位于Onboarding模块中。通常根据整体入职工作流的完成时间戳，或最后一项必需入职任务被标记为完成的时间推断。采集根据员工主入职任务清单的完成时间戳推断。事件类型 inferred
	员工正式离职	员工生命周期中的最终事件，表示雇佣关系正式结束。自离职生效日期起，员工记录在系统中变为非在职状态。
为什么重要这是流程的明确结束事件，对于计算员工最终任职时长和分析人员流失至关重要，也标志着员工在公司的完整历程结束。获取位置这是HR Core模块员工工作数据历史中最终“Termination”操作的生效日期。系统通常会在该日期将员工状态从在职变为非在职。采集取自员工工作历史中“Termination”操作的生效日期。事件类型 explicit
	完成绩效评估	表示员工正式绩效评估周期的完成。当经理或HR最终确定并提交评估表时，系统会记录此事件。
为什么重要这是员工生命周期中定期发生的重要里程碑。跟踪其频率和及时性，有助于评估绩效管理合规情况及其对职业发展的影响。获取位置可在UKG Pro Performance Management模块中找到。可以通过绩效评估表的完成日期，或评估周期状态变为“Completed”来识别。采集取自绩效评估工作流实例的完成时间戳。事件类型 explicit
	晋升获批	表示员工晋升已获得正式批准，通常包括职位名称变更，并可能涉及薪酬调整。这是一个独立事件，发生在变更生效日期之前。
为什么重要此活动是分析内部人才流动和职业发展的关键。晋升获批与变更生效之间的时间，可以揭示系统中的行政瓶颈。获取位置在HR Core模块的员工工作数据历史中，作为“Promotion”等特定工作操作记录。该记录会包含独立的审批日期和生效日期。采集取自员工工作历史中“Promotion”操作的记录日期。事件类型 explicit
	分配培训	记录向员工分配特定培训课程或学习计划的时间。通常，该事件会记录在系统的学习管理模块中。
为什么重要此活动有助于跟踪必修培训合规情况并监控员工发展。分析分配与完成之间的时间，可以发现参与度问题或培训效果问题。获取位置记录在UKG Pro的学习管理或人才管理模块中。每项分配都应有对应记录，包括分配日期和员工ID。采集在向员工学习计划分配课程或课程体系时记录。事件类型 explicit
	启动入职	表示UKG Pro中新员工入职流程或工作流的开始。通常，这是由系统自动触发或人工触发的事件，会向新员工、其经理和HR分配任务清单。
为什么重要跟踪此活动有助于衡量正式入职日期与行政融入和文化融入开始之间的时间。这是分析入职流程效率和识别延迟的起点。获取位置可在UKG Pro Onboarding模块中找到。该事件可以根据与员工关联的入职任务清单或工作流实例的创建日期推断。采集根据员工入职工作流或任务列表的创建时间戳推断。事件类型 inferred
	完成离职流程	表示所有必需的离职任务均已完成的里程碑，包括资产归还、最终薪资计算和系统访问权限撤销等活动。
为什么重要该事件确认已采取所有必要步骤，以安全、合规地完成员工离职。它有助于衡量离职周期时间并识别合规缺口。获取位置可根据整体离职任务清单或工作流的完成时间戳推断，类似于“Employee Onboarded”事件，但用于离职流程。采集根据员工主离职任务清单的完成时间戳推断。事件类型 inferred
	完成离职面谈	标志着与离职员工的离职面谈完成。通常会作为离职任务清单中的已完成任务记录。
为什么重要跟踪离职面谈完成情况，对于确保HR合规和收集有价值的反馈非常重要，也有助于识别离职流程中是否遗漏了这一关键步骤。获取位置该事件可能出现在UKG Pro Onboarding或HR Help Desk模块中，作为离职工作流中的具体任务。是否记录取决于HR是否手动将任务标记为完成。采集作为员工离职任务清单中的已完成任务记录。事件类型 explicit
	岗位变更处理完成	表示员工工作或职位发生变更，但不属于晋升，例如平级调动或部门调动。当系统更新相关工作数据时，会记录此事件。
为什么重要分析岗位变更有助于了解内部人才流动、人才配置和组织重组情况，并识别员工在组织内部的流动路径。获取位置取自HR Core模块中的员工工作数据历史。可以通过“Transfer”“Re-assignment”或“Position Change”等工作操作及其生效日期进行识别。采集通过员工工作历史数据中的“Transfer”或类似操作代码识别。事件类型 explicit
	开始休假	标志着员工获批休假开始，例如因医疗或个人原因休假。当员工状态变为非在职或休假状态时记录此事件。
为什么重要用于识别员工生命周期中的非活跃期间，对于准确计算在职年限和了解休假对职业发展的影响至关重要。获取位置可在HR Core模块的员工工作数据历史中找到，对应“Leave of Absence”等工作操作及具体生效开始日期。采集取自工作历史中“Start Leave”操作的生效日期。事件类型 explicit
	经理变更	当员工的“Reports To”或“Manager ID”字段更新时生成此事件，表示员工的直接汇报关系发生变化。
为什么重要经理变更可能显著影响员工参与度和绩效。跟踪此事件有助于分析其对后续活动的影响，例如绩效评估或员工留任。获取位置必须通过持续跟踪员工工作数据中的经理或主管字段变化来推断此事件。需要比较同一员工连续记录中的经理ID。采集通过检测员工工作数据历史中“Reports To”字段的变化推断。事件类型 inferred
	薪资设置完成	表示处理员工薪资所需的全部信息，例如银行账户信息和税务表单，均已录入并完成验证。这是确保员工按时、准确获得薪资的关键步骤。
为什么重要这一里程碑对于衡量新员工就绪度至关重要。薪资设置延迟可能导致员工不满和行政返工，因此是入职流程的重要绩效指标。获取位置该事件可能从UKG Pro Payroll模块推断得出。可以根据薪资就绪任务清单的完成日期，或员工状态变为“Ready for Payroll”的日期确定。采集根据员工薪资档案中的状态变更或完成时间戳得出。事件类型 inferred
	薪酬变更	记录员工基本工资、奖金结构或其他薪酬组成部分的任何变更。该事件可能源于晋升、绩效加薪或市场调薪。
为什么重要跟踪薪酬变更对于了解职业发展和薪资变化至关重要。入职后频繁调整可能表明存在数据录入错误，或初始薪资设定存在问题。获取位置可在HR Core或Payroll模块的员工薪酬历史表中找到。每次变更通常都会记录生效日期和原因代码。采集根据员工薪酬历史记录中新条目的生效日期记录。事件类型 explicit

建议可选

数据提取指南

如何从UKG Pro获取数据

步骤

**前提条件：**确保已安装Python 3.6及以上版本，以及requests和pandas库。可使用以下命令通过pip安装：pip install requests pandas。
**API访问与身份验证：**联系UKG Pro管理员创建服务账户。您需要API Key、User Name和Password。服务账户必须有权访问所有所需API端点，包括人员、薪资、入职、绩效和学习数据。
**配置脚本：**在文本编辑器或IDE中打开提供的Python脚本。找到脚本顶部的配置部分，将UKG_BASE_URL、API_KEY、USERNAME、PASSWORD和COMPANY_ID的占位值替换为您的具体凭据和环境信息。
**设置提取日期范围：**在配置部分定义START_DATE和END_DATE变量，确定提取员工变更和事件的时间窗口。建议先使用3至6个月的较小范围测试脚本。
**执行脚本：**在命令行中使用python your_script_name.py运行脚本。脚本将完成身份验证，从各个UKG Pro API端点获取每项活动的数据，并在控制台显示进度。
**处理API限流：**脚本包含基础的time.sleep()，用于遵守API速率限制。如果遇到限流错误（HTTP 429），可能需要延长API调用之间的等待时间。
**转换和标准化数据：**脚本中的每个函数都用于获取特定活动的原始数据，选择相关字段，并将其重命名为标准事件日志格式（EmployeeId、ActivityName、EventTimestamp等）。
**合并事件数据：**脚本主体会调用各项活动对应的函数，并将结果追加到统一的事件主列表中。
**生成事件日志：**处理完所有活动后，脚本会将数据整合为pandas DataFrame，按员工ID和时间戳排序，并保存为名为ukg_hire_to_retire_event_log.csv的CSV文件。
**检查并上传：**打开生成的CSV文件，确认数据完整且格式正确。随后即可将该文件上传到流程挖掘工具。

配置

身份验证凭据：API身份验证需要服务账户的API Key、User Name和Password。
基础URL：您的UKG Pro实例对应的UKG_BASE_URL，例如https://service[##].ultipro.com/api。
公司ID：UKG Pro中您所在组织的唯一COMPANY_ID，许多API调用都需要该参数。
日期范围：START_DATE和END_DATE参数（格式为“YYYY-MM-DD”）用于控制提取窗口。首次运行建议使用3至6个月的时间段，以控制数据量并验证结果。
API端点版本：脚本使用特定版本的REST API，例如/personnel/v1/。请确认您的UKG Pro实例支持这些版本。
模块依赖：提取某些活动需要您的组织已购买并正在使用相应的UKG Pro模块，例如Onboarding、Learning和Performance Management。如果未使用某个模块，则不会提取对应活动。

a 示例查询 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}")

准备好开始了吗？

借助此模板自信完成数据准备，深入了解HR流程中的关键问题。立即开始优化您的招聘至离职流程。

返回改进指南下载模板

立即开始优化您的招聘至离职员工生命周期！

将招聘至离职周期时间缩短30%，提升HR效率。

开始免费试用

无需信用卡，快速完成设置。

您的招聘至离职员工生命周期数据模板

您的招聘至离职员工生命周期数据模板

招聘到离职：员工生命周期属性

招聘到离职：员工生命周期活动

数据提取指南

通过UKG Pro REST API使用Python脚本提取

步骤

配置

a 示例查询 python

准备好开始了吗？

立即开始优化您的招聘至离职员工生命周期！

我们重视您的隐私