员工全生命周期流程数据模板

UKG Pro

← 返回改进指南

员工全生命周期流程属性(21) 员工全生命周期流程活动(15) 数据提取指南(1)

员工全生命周期流程数据模板

此模板概述了有效分析员工全生命周期流程所需的关键数据要素，包括应收集的重要属性、需要跟踪的关键活动，以及从UKG Pro提取数据的实用指南。借助此资源，您可以简化数据准备工作，顺利开启流程挖掘之旅。

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

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

下载模板

员工全生命周期流程属性

以下是建议纳入事件日志的数据字段，可用于全面分析员工全生命周期流程并获取相关洞察。

5 必填 7 建议填写 9 选填

	名称	说明
	事件时间戳 EventTimestamp	特定全生命周期事件发生的准确日期和时间。
说明事件时间戳为每项活动提供时间顺序信息，是流程图的基础。它记录系统登记“Offer Accepted”或“Promotion Approved”等事件的准确时刻。分析时，可利用这些时间戳计算活动间隔时长、发现延误，并衡量招聘和入职等关键子流程的周期时间。准确的时间戳是所有基于时间的KPI和绩效分析的关键。重要性此属性对于按时间顺序排列事件，以及计算周期时间和持续时长等所有时间指标至关重要。获取途径取自UKG Pro中与特定事件关联的日期或时间戳字段，例如“HireDate”“TerminationDate”，或工作流模块中的状态变更时间戳。示例 2023-01-15T09:00:00Z2023-06-20T14:35:10Z2024-02-01T11:00:00Z
	员工ID EmployeeId	分配给每位员工的唯一标识符，作为其在组织内整个任职周期的主要案例ID。
说明员工ID是串联员工所有相关事件的主线，从最初申请到最终办理离职手续都由它关联。构建个人职业历程的端到端流程视图时，这一标识符至关重要。在流程挖掘分析中，“Employee Hired”“Promotion Approved”或“Termination Initiated”等每项活动都会关联到此唯一ID。这样便可分析员工个人路径、根据员工属性开展群组分析，并准确计算全生命周期时长。重要性这是关联所有员工相关事件的关键案例标识符，可据此分析每位员工从入职到离职的端到端流程。获取途径这是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”。
说明活动名称用于描述从入职到离职流程中的单个步骤或任务。系统会为这些事件添加时间戳并按顺序排列，以构建流程挖掘中用于呈现和分析的流程图。分析活动的顺序和频率，可以了解流程的实际执行情况，发现常见路径、偏离标准流程的情况，以及“Onboarding Initiated”和“Payroll Setup Completed”等关键活动之间的瓶颈。重要性此属性定义流程图中的步骤，用于呈现和分析员工全生命周期流程。获取途径通常根据事件日志、工作流状态变更或UKG Pro各模块（如Recruiting、Onboarding、Performance Management）中的特定日期字段生成。通常需要通过映射规则生成标准化的活动名称。示例员工入职完成绩效评估启动离职流程
	源系统 SourceSystem	标识数据提取自哪个系统，本例中为UKG Pro。
说明此属性用于标明流程数据的来源。在此场景中，数据主要来自UKG Pro，但从入职到离职的流程也可能涉及其他系统的数据，例如申请人跟踪系统（ATS）或学习管理系统（LMS）。分析时，如果涉及多个系统，此属性有助于区分数据来源，对于数据治理和问题排查也至关重要。若要查看单一来源的数据，它还能提供必要的来源背景信息。重要性通过标明事件数据的来源，为数据治理、质量保障和可追溯性提供关键信息。获取途径通常在数据提取和转换过程中添加固定值（“UKG Pro”）。示例 UKG ProUKGPro_CoreHRUKG
	任职状态 EmploymentStatus	员工当前或历史任职状态，例如“在职”“已离职”或“休假”。
说明此属性表示员工在特定时间点的公司正式状态，是了解整体员工队伍状况以及筛选特定员工群体进行分析的重要维度。分析任职状态的变化有助于正确建模流程，例如区分临时休假和正式离职。它也是计算员工流失率、了解不同全生命周期路径结果的基础。重要性提供员工任职状态的关键信息，支持准确分析员工流失率并细分员工队伍。获取途径这是UKG Pro Core HR模块中员工主记录的核心字段。示例在职离职休假
	入职日期 HireDate	员工正式加入组织的日期。
说明入职日期标志着员工任职期的开始。这是一个基础日期字段，可作为员工生命周期相关时间计算和分析的基准。此属性用于计算员工任职时长，是分析“员工早期流失率”的重要依据。它也支持群组分析，便于比较不同入职时期员工的生命周期模式。重要性作为计算员工任职时长的基准，也是群组分析和流失率KPI的重要数据。获取途径这是UKG Pro核心人力资源模块中员工主记录的标准必填字段。示例 2022-08-152023-01-202021-05-10
	操作用户 ActioningUser	在UKG Pro中执行活动的用户姓名或ID，通常是HR代表或经理。
说明此属性用于识别负责执行特定流程步骤的人员，例如发出录用通知的招聘人员或批准晋升的经理，从而将流程活动与具体人员关联起来。分析时，此属性对于了解工作量分布、发现培训需求和分析个人绩效非常有价值。例如，它有助于确定“Payroll Setup Completed”之后的数据录入错误是否集中在特定用户身上，从而支持“入职后数据返工率”KPI的分析。重要性将流程活动与具体用户关联起来，以便分析工作量、比较绩效并调查返工或错误。获取途径通常可在UKG Pro模块的审计跟踪日志或“Last Modified By”字段中找到。具体字段名称因模块而异。示例 j.does.smithhr_admin
	经理姓名 ManagerName	员工直属经理或主管的姓名。
说明此属性用于识别员工的直属经理。经理在绩效评估、晋升和培训安排等多个员工生命周期事件中发挥重要作用。按经理分析有助于了解团队执行情况的差异以及经理的管理成效。例如，“经理变更影响分析”仪表板会使用此属性，查看经理变更对后续活动的影响。它也是“经理重新参与所需时间”KPI的关键数据。重要性支持您在团队层面分析流程绩效，并评估经理对员工生命周期事件的影响。获取途径此信息属于UKG Pro核心人力资源模块中的员工汇报关系数据。示例 John SmithMaria Garcia陈伟
	职位名称 JobTitle	员工的正式职位名称，例如“软件工程师”或“销售经理”。
说明职位名称用于描述员工在组织中的角色或职位。此属性是重要的分析维度，可用于比较不同职能和资历层级的流程差异。分析时，您可以按职位比较不同岗位的入职耗时、评估晋升速度，或识别哪些职位的员工早期离职率较高。这有助于根据不同员工群体的具体需求调整人力资源流程和支持计划。重要性支持按角色分析，帮助您了解不同职能和资历层级的员工生命周期流程有何差异。获取途径这是UKG Pro核心人力资源模块中与员工职位或工作记录关联的标准字段。示例二级软件工程师高级产品经理人力资源业务伙伴
	职位申请ID JobRequisitionId	启动招聘流程的职位申请的唯一标识符。
说明职位申请ID是特定职位空缺的唯一标识。它关联招聘早期的所有活动，从创建和审批职位申请，到寻找候选人和发出录用通知。此ID对于分析“招聘周期时间”KPI至关重要，因为它标记了招聘流程的实际起点。它可用于跟踪单个职位空缺的完整招聘漏斗，并通过识别未推进的职位申请来分析“未活跃职位申请率”等指标。重要性为招聘流程提供明确的起点，从而准确衡量招聘周期时间和职位申请的有效性。获取途径可在UKG Pro Recruiting模块或连接的申请人跟踪系统（ATS）中找到。示例 REQ-2023-015REQ-2024-112REQ-2023-504
	部门 EmployeeDepartment	员工所属的部门或组织单元。
说明此属性包含员工所属部门的名称，例如“销售”“工程”或“财务”。它是按组织维度细分和比较流程绩效的重要依据。利用部门信息进行分析，可以比较不同业务单元的流程执行情况。例如，可以分析技术部门的“招聘周期时间”是否更长，或销售与运营部门的“绩效评估完成率”是否存在明显差异，从而为改进提供有针对性的洞察。重要性您可以根据组织架构筛选和细分流程，开展有效的对比分析并发现各部门之间的差异。获取途径这是UKG Pro Core HR模块中员工工作或职位记录的标准字段。示例工程销售人力资源
	事件结束时间 EventEndTime	标记具有可测量时长的活动完成时间的时间戳。
说明对于非瞬时活动，事件结束时间记录活动完成的时刻。与之相对，事件时间戳（开始时间）记录活动开始的时刻。同时记录开始和结束时间，便可准确计算单项活动的处理时间，例如“背景调查”或“入职任务”。这有助于更细致地分析流程中各环节的耗时。重要性支持准确计算单项活动的处理时间，帮助您找出流程中最耗时的步骤。获取途径数据来自UKG Pro中的完成日期字段。通常需要将开始事件与源数据中对应的完成事件配对。示例 2023-01-15T17:30:00Z2023-06-21T10:00:00Z2024-02-01T11:05:00Z
	地点 Location	员工所在的地理位置或办公地点。
说明此属性指定员工的主要工作地点，可以是城市、国家或具体办公楼，是人力资源流程地理分析的重要维度。按地点分析流程绩效，有助于发现不同地区在招聘效率、入职实践或员工流失率方面的差异。例如，您可以比较纽约和伦敦办公室的“招聘周期时间”，以识别最佳实践或当地瓶颈。重要性支持按地理区域细分流程，帮助您发现各地区在绩效和合规方面的差异。获取途径此信息属于UKG Pro核心人力资源模块中的员工职位或个人数据。示例美国纽约州纽约市英国伦敦远程办公
	培训名称 TrainingName	分配给员工的培训课程名称。
说明此属性用于标识分配给员工的具体培训或学习模块，内容可以是强制性合规培训，也可以是针对特定岗位的技能培训。这是“培训分配与完成”仪表板和“培训完成率”KPI的重要数据。您可以据此跟踪特定培训计划的进度和成效，并分析不同课程的完成时间。重要性支持跟踪和分析具体培训计划，帮助您衡量合规情况和培训成效。获取途径数据来自UKG Pro学习模块或已连接的学习管理系统（LMS）。示例 2024年行为准则高级管理技能网络安全意识
	是否早期流失 IsEarlyChurn	布尔标记，用于指示员工是否在预先设定的任职早期时段内离职，例如入职后90天或180天内。
说明此计算属性用于标记入职后不久便离开组织的员工。早期流失的时间界限通常由业务部门定义，例如入职第一年内。此标记简化了“早期任职流失洞察”仪表板和“员工早期流失率”KPI所需的分析。您可以快速筛选和细分这类重点员工，分析其特征和生命周期模式，从而发现招聘或入职环节的问题。重要性通过标记存在早期流失风险的案例，直接支持早期流失分析，帮助您找出员工提前离职的根本原因。获取途径此属性在数据准备期间计算。计算逻辑会将“TerminationDate”与“HireDate”的差值和预设阈值进行比较（例如365天）。示例 truefalse
	离职原因 TerminationReason	记录的员工离职原因，例如“主动离职-辞职”或“非自愿离职-绩效原因”。
说明此属性记录员工离职的原因。离职原因通常分为主动离职和非自愿离职，并可进一步细分。这是员工留任和流失分析的重要属性。按离职原因细分离职员工，有助于组织深入了解人员流失的根本原因。例如，按离职原因分析“员工早期流失率”，可以区分招聘不当与员工接受了更有吸引力的外部机会。重要性帮助您深入了解员工流失的原因，从而制定有针对性的留任策略。获取途径此字段通常在UKG Pro核心人力资源模块的离职或离职交接流程中记录。示例主动离职-寻求其他机会非自愿离职-绩效原因退休
	离职日期 TerminationDate	员工正式结束任职的日期。
说明离职日期标志着员工任职期的结束，也是员工在组织内生命周期的终点。此属性用于计算员工的最终任职时长，也是流失分析的重要组成部分。入职日期与离职日期之间的时长，是“早期任职流失洞察”仪表板及相关KPI的计算依据。重要性标记员工生命周期的结束，支持计算总任职时长及各类人员流失分析。获取途径这是UKG Pro员工主记录中的标准字段，在离职流程完成后填入。示例 2023-11-302024-02-152022-12-31
	绩效评级 PerformanceRating	员工在绩效评估周期中获得的评级。
说明绩效评级是“完成绩效评估”活动的结果，通常采用等级制（如1至5分）或描述性标签（如“超出预期”），用于量化员工的绩效评估结果。此属性有助于分析流程事件与绩效结果之间的关系。例如，您可以分析高绩效员工是否晋升更快，或绩效评级是否与员工流失有关。它是“绩效评估周期合规情况”仪表板的核心数据。重要性将流程事件与绩效结果关联，支持您分析人才管理成效及其对员工留任的影响。获取途径此数据位于UKG Pro绩效管理模块中，并关联到具体的评估周期。示例超出预期达到预期有待改进5
	薪资等级 SalaryGrade	与员工角色对应的薪酬等级或区间。
说明薪资等级表示特定职位的薪酬水平，是分析薪酬相关活动和趋势的重要属性。此属性适用于分析“薪酬变更”等事件。如果发现薪资等级经常需要更正，也可用于跟踪“入职后数据返工率”KPI。此外，您还可以按薪酬水平细分流程，比较晋升周期时间或员工流失率。重要性为薪酬相关活动提供背景信息，并支持按薪酬水平细分流程。获取途径此信息可在UKG Pro核心人力资源模块中的员工薪酬或职位档案中找到。示例 IC3M2D1
	角色变更原因 RoleChangeReason	员工角色变更的原因，例如“晋升”“平级调动”或“组织重组”。
说明此属性为内部流动事件提供背景信息，说明员工在组织内变更角色或职位的原因。这是“内部流动周期时间”仪表板和KPI的重要数据，可用于区分晋升与其他类型的调动。按原因分析流程，可以发现晋升流程是否比平级调动更慢，从而帮助优化职业发展路径。重要性说明内部调动的背景，帮助您更细致地分析晋升和平级调动等内部流动流程。获取途径此信息通常记录在UKG Pro核心人力资源模块的职位变更或调动事务中。示例晋升平级调动组织重组

必填建议填写选填

员工全生命周期流程活动

以下是建议记录在事件日志中的关键流程步骤和里程碑，有助于准确发现和优化流程。

6 建议填写 9 选填

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

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

准备好开始了吗？

使用此模板准备数据，有把握地发现人力资源流程中的关键问题。立即开始优化员工全生命周期流程。

返回改进指南

下载模板

立即优化员工全生命周期流程！

将员工全生命周期周期时间缩短30%，提升人力资源效率。

开始免费试用

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

员工全生命周期流程数据模板

员工全生命周期流程数据模板

员工全生命周期流程属性

员工全生命周期流程活动

数据提取指南

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

步骤

配置

查询示例 python

准备好开始了吗？

立即优化员工全生命周期流程！