> 持续流程改进 > 从入职到离职流程：职位管理 > SAP SuccessFactors Employee Central > 数据模板

您的从入职到离职流程职位管理数据模板

SAP SuccessFactors Employee Central

← 返回改进指南

从入职到离职流程中职位管理的属性(19) 从入职到离职流程中职位管理的活动(13) 数据提取指南(3)

您的从入职到离职流程职位管理数据模板

此模板介绍如何收集分析从入职到离职流程中职位管理所需的数据，涵盖应收集的关键属性、应跟踪的主要活动以及实用的数据提取指南。借助此资源，您可以收集流程挖掘所需的相关信息。

建议收集的属性
需要跟踪的关键活动
SAP SuccessFactors Employee Central数据提取指南

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

下载模板

从入职到离职流程中职位管理的属性

建议将这些数据字段纳入事件日志，以便全面分析从入职到离职流程中的职位管理。

5 必填 5 建议填写 9 选填

	名称	说明
	Position ID PositionId	组织岗位的唯一标识符，也是岗位管理流程的主要案例标识符。
说明 Position ID将与单个组织岗位相关的所有活动和数据点关联起来。借助它，您可以端到端跟踪岗位的完整生命周期，从最初申请和创建，到后续修改、重新分类，直至最终停用或关闭。在流程挖掘中，每个唯一的Position ID代表一个案例。通过此标识符分析流程，有助于了解岗位的完整历程、衡量整个生命周期的时长，并发现影响岗位从创建到结束的模式或瓶颈。它是构建流程图和计算案例级KPI的基础属性。重要性这是关键的案例标识符，可关联所有相关事件，从而追踪岗位的完整生命周期并分析其流程路径。获取途径此标识符是SAP SuccessFactors Employee Central岗位管理模块的核心要素，通常位于Position对象中。示例 POS-1002345POS-1002346POS-2039871
	事件时间 EventTime	指示特定活动发生时间的时间戳。
说明事件时间记录活动在系统中执行或登记的准确日期和时间，并确定每个岗位生命周期中事件的先后顺序。此时间戳是流程挖掘中所有时间分析的关键。它用于计算活动间的周期时间、衡量整个流程的时长、通过分析步骤间耗时发现瓶颈，以及跟踪绩效趋势。没有准确的时间戳，就无法进行流程分析。重要性此属性提供事件的时间顺序，是计算周期时间、发现瓶颈和了解流程绩效的基础。获取途径对应于SAP SuccessFactors岗位管理审计日志或交易记录中与事件或状态变更相关的创建日期或最后修改日期字段。示例 2023-04-15T09:00:00Z2023-04-15T14:30:15Z2023-05-01T11:20:00Z
	活动名称 ActivityName	岗位在特定时间发生的业务事件名称。
说明此属性描述岗位管理生命周期中的具体步骤或节点，例如“发起岗位申请”“在HR系统中创建岗位”或“停用岗位”。每项活动都代表流程中的一个独立事件。分析活动的顺序和频率是流程挖掘的核心。通过这种分析，您可以直观查看流程图，识别常见及替代流程路径（变体），并找出步骤间的延迟或返工。这是了解流程实际运行方式的基础。重要性它定义流程中的各个步骤，便于呈现流程图，并分析工作流、瓶颈和偏差。获取途径此信息通常取自SAP SuccessFactors Employee Central系统中的事件日志、状态变更记录或审计轨迹。可能需要将技术事件代码或状态转换映射为便于用户理解的名称。示例发起岗位申请在HR系统中创建岗位修改岗位属性停用岗位
	上次数据更新 LastDataUpdateTime	数据上次从源系统刷新或提取的时间戳。
说明此属性表示流程数据上次在流程挖掘工具中更新的时间，反映所分析数据的新鲜度。用户可据此了解分析所用数据的时效性，并合理预期数据的及时程度。这是任何仪表板或报告的重要元数据。重要性它告知用户数据的新鲜度，这对于确保分析和决策基于最新信息至关重要。获取途径此时间戳由数据提取和转换管道在执行时生成。示例 2023-10-27T08:00:00Z
	源系统 SourceSystemId	提取数据的系统。
说明此属性用于标识事件数据的来源系统。对于此流程，来源始终是SAP SuccessFactors Employee Central。在单一数据源模型中，此字段看似多余，但对于数据治理和保留上下文至关重要，尤其是在可能合并多个系统数据的环境中。它能明确数据来源。重要性它清晰标示数据来源，对于数据治理、故障排查以及涉及多个数据源的场景至关重要。获取途径通常在数据转换过程中添加固定值，用于标记数据集的来源。示例 SAP SuccessFactors Employee Central
	事件结束时间 EventEndTime	指示特定活动完成时间的时间戳。
说明事件结束时间标记活动完成的时刻。在许多系统中，活动只记录为一个时间点，此时结束时间与开始时间相同。但对于有可衡量时长的活动，例如正在处理的审批步骤，此字段会记录活动完成的时刻。此属性对于计算单项活动的处理时间至关重要。它有助于区分等待时间（活动之间的间隔）和处理时间（活动本身持续的时间），从而更细致地了解流程效率。重要性它可用于计算活动处理时间，帮助区分处理任务所花的时间与等待下一步所花的时间。获取途径此信息可能存在于审计日志中，也可能需要推断。对于原子事件，它通常与StartTime相同。示例 2023-04-15T09:05:12Z2023-04-15T14:45:00Z2023-05-01T11:20:00Z
	审批人ID ApproverId	参与审批活动的经理或审批人的标识符。
说明此属性用于识别执行审批步骤的具体用户，例如“经理批准职位申请”或“HR批准职位申请”。它不同于通用的用户ID，专门用于标识审批任务中的用户。按审批人分析审批耗时，有助于发现流程中的瓶颈，或识别审批速度特别快、可作为最佳实践参考的人员。这也能为“部门审批瓶颈”仪表板提供更细致的分析数据。重要性此属性支持对审批步骤进行细致分析，帮助您识别个人审批人层面的瓶颈或表现出色者。获取途径此数据存储在SAP SuccessFactors的工作流或审批日志中，并与职位申请交易相关联。示例 m.joness.patele.williams
	岗位状态 PositionStatus	事件发生时岗位所处的状态。
说明此属性表示岗位状态，例如“待招聘”“已填补”“冻结”或“已取消”。岗位状态通常会随流程中的特定活动而变化。分析岗位状态随时间的转换，对于了解岗位生命周期并确保状态使用一致至关重要。“岗位状态转换分析”仪表板依靠此属性识别非标准流程路径，并检查状态是否符合既定模型。它有助于了解岗位在特定状态下持续了多久。重要性跟踪状态变更是分析岗位生命周期、确保流程一致性并了解岗位在各状态下停留时长的关键。获取途径对应于SAP SuccessFactors Employee Central中Position对象的状态字段。示例待招聘已填补冻结已取消
	用户ID UserId	执行活动的用户标识符。
说明此属性记录执行特定事件的员工或系统用户的唯一ID，例如批准岗位申请的经理，或在系统中创建岗位的HR管理员。按用户ID分析对于了解工作量分布、识别表现突出的员工和发现培训需求至关重要。它还有助于资源分析、合规分析，以及识别由系统或服务账户执行的活动，从而发现自动化情况。重要性它有助于将流程活动归属到具体用户，以便分析工作量、衡量绩效并识别自动化活动。获取途径此信息通常位于SAP SuccessFactors中Position对象审计日志或交易数据的“Changed By”或“User”字段。示例 c.bakerj.smithSYSTEM_USER
	部门 DepartmentName	岗位所属部门的名称。
说明此属性用于指定岗位所属的组织部门，例如“财务”“销售”或“信息技术”。部门是比较分析的重要维度。您可以据此比较组织不同部门的流程绩效，例如比较各部门的岗位审批时间。这对于“部门审批瓶颈”仪表板至关重要，也有助于发现局部低效环节或最佳实践。重要性此属性支持跨业务部门比较绩效和分析瓶颈，帮助您定位特定部门的问题。获取途径这是SAP SuccessFactors Employee Central中Position对象的标准属性。示例财务北美销售研发
	业务单元 BusinessUnitName	职位所属的业务单元。
说明此属性用于识别职位所属的较大业务部门或单元，其层级可能高于部门。与部门类似，业务单元可用于高层级的对比分析。高级管理者可以据此比较企业主要业务板块的职位管理效率，例如“消费品”与“企业软件”。重要性支持跨部门的高层级流程绩效比较，并帮助您将流程指标与战略业务单元相结合。获取途径这是SAP SuccessFactors中Position对象提供的标准组织结构属性。示例消费品企业软件全球服务
	变更原因 ChangeReason	岗位修改或重新分类时提供的原因。
说明修改或重新分类岗位时，用户通常会说明变更原因。此属性记录这些原因，例如“组织重组”“职责范围变更”或“年度审查”。此属性对于根因分析至关重要，有助于解释重新分类或属性修改等流程事件背后的原因。分析最常见的变更原因，可以发现潜在问题，例如初始职位说明不清晰或组织频繁调整。这也是“岗位重新分类分析”仪表板的重要目标。重要性它为根因分析提供必要的业务背景，解释重新分类或修改等变更发生的原因。获取途径此数据通常记录在SAP SuccessFactors中修改Position对象的交易所用的“reason”或“comment”字段。示例组织重组范围变更年度评审
	国家/地区 CountryCode	职位所在的国家/地区。
说明此属性用于指定职位所在地所属的国家/地区，是重要的地理分析维度。按国家/地区分析流程，可发现效率、合规要求或流程执行方面的区域差异。例如，受当地劳动法规或员工委员会参与等因素影响，某个国家/地区的职位审批时间可能明显更长。此类分析有助于了解并解决特定地点的流程差异。重要性支持地理维度分析，帮助您发现流程绩效的区域差异，并了解当地法规或惯例可能造成的影响。获取途径这是SAP SuccessFactors中Position对象关联的地点信息之一。示例 USADEUINDGBR
	岗位名称 PositionTitle	岗位对应的正式职位名称。
说明此属性记录岗位的职位名称，例如“高级财务分析师”或“软件工程师II”。岗位名称并非流程路径的主要影响因素，但能提供重要的业务背景。您可以按特定岗位筛选分析，或查看某些职位名称是否与较长的创建周期或更频繁的修改相关。这为分析补充了便于业务理解的细节。重要性它提供有价值的业务背景，便于按具体岗位或职级筛选和细分分析。获取途径这是SAP SuccessFactors Employee Central中Position对象的标准属性，通常与Job Classification关联。示例高级财务分析师软件工程师II市场协调员
	已修改的属性 ModifiedAttribute	职位中发生变更的具体属性或字段。
说明发生“修改职位属性”活动时，此字段会注明变更的属性，例如“部门”“职位名称”或“汇报对象”。此信息对于“职位属性变更频率”仪表板至关重要。您不仅可以了解是否发生变更，还可以分析哪些属性变更最频繁。某个属性的变更量较大，可能说明其定义不够清晰，或该字段的初始数据经常有误。重要性此属性为变更事件补充关键信息，帮助您分析哪些具体数据项最不稳定或最容易出错。获取途径此信息来自SAP SuccessFactors的详细审计日志，其中记录了字段级变更及其新旧值。示例部门主管成本中心职位名称
	是否一次做对 IsFirstTimeRight	用于标记职位是否首次创建正确，且创建后未立即修改。
说明此计算属性为布尔值（true/false），用于检查“在HR系统中创建职位”活动之后，是否在预设的短时间内（例如24小时）发生“修改职位属性”活动。如果没有发生修改，则标记为“true”。此属性直接支持“一次做对的创建比例”KPI。它可以衡量数据质量和流程成效，帮助您发现初始数据录入不准确或不完整、导致立即返工的案例。一次做对率偏低，可能意味着培训、系统易用性或数据验证规则存在问题。重要性此指标衡量职位创建流程的质量，帮助您发现录入环节的返工和数据质量问题。获取途径此布尔标记在数据转换过程中，根据每个职位ID对应的事件顺序计算得出。示例 truefalse
	职位审批时间 PositionApprovalCycleTime	从发起职位申请到HR批准所需的总时间。
说明这是一个计算所得的KPI，用于衡量新职位整个审批阶段的时长。系统会在案例层面计算“职位申请已发起”事件与“HR已批准职位申请”事件之间的时间差。此属性直接衡量“平均职位审批时间”KPI，也是“职位审批周期时间”仪表板的主要指标。它能反映组织的响应能力和招聘前期流程的效率。重要性此关键绩效指标直接衡量职位审批工作流的效率，帮助您跟踪并减少延误。获取途径此指标由流程挖掘平台或数据转换层根据相关活动的时间戳，在案例层面计算。示例 P3D4H30MP10DP1DT12H
	职位族 PositionJobFamily	岗位所属的职位族或职能领域。
说明职位族是一种分类方式，用于归纳相关职位，例如“工程”“财务”或“人力资源”。与具体岗位名称相比，它提供了更高层级的分类。此属性对于“岗位重新分类分析”仪表板至关重要。分析人员可以据此跟踪岗位在不同职位族之间重新分类的频率并识别趋势。例如，从“IT支持”重新分类到“网络安全”的比例较高，可能表明组织正在进行战略调整。重要性此属性对于分析重新分类趋势，以及了解职能层面的组织架构变化至关重要。获取途径这是SAP SuccessFactors中与Position对象关联的职位分类结构的一部分。示例工程财务人力资源
	预算审批状态 BudgetApprovalStatus	职位申请的预算审批状态。
说明此属性用于跟踪新职位的财务审批状态，取值包括“待处理”“已批准”或“已拒绝”，专门用于监控财务审批环节。此状态是计算“预算审批周期时间”KPI和生成“职位预算审批时长”仪表板的必要依据。它可以单独分析流程中的财务审批部分，帮助您聚焦由预算问题造成的延误。预算问题可能成为职位创建流程中的重要瓶颈。重要性此属性直接支持预算审批阶段的分析，帮助您发现并减少新职位财务审批中的延误。获取途径此信息应包含在SAP SuccessFactors的职位申请工作流数据中，可能作为特定审批步骤的状态记录。示例等待财务审批已批准已拒绝

必填建议填写选填

从入职到离职流程中职位管理的活动

要准确发现流程，建议在事件日志中记录这些关键步骤和里程碑。

6 建议填写 7 选填

	活动	说明
	HR批准岗位申请	此活动表示人力资源部门已批准岗位申请，是审批工作流中明确记录的关键完成节点。
重要性 HR最终审批通常标志着主要审批阶段结束，之后才会进行预算分配或系统创建。衡量到达此步骤所需的时间，对“岗位平均审批时间”KPI至关重要。获取途径此事件取自与岗位申请相关的工作流日志，时间戳对应HR代表完成指定审批步骤的时间。采集 HR审批人完成工作流中的步骤时记录。事件类型 explicit
	关闭岗位	这是岗位生命周期的最后一个事件，表示岗位已永久关闭或取消。通常根据岗位状态变更为“已关闭”或“已取消”等终止状态推断。
重要性此活动是流程明确的终点，可用于准确分析端到端周期时间，并确认岗位已正式退出。获取途径通过跟踪Position MDF对象历史记录中“Status”字段的变更来推断。字段变为“已关闭”或“已取消”时的时间戳即为事件时间。采集根据岗位状态变更为终止状态推断。事件类型 inferred
	发起岗位申请	此事件标志着岗位管理流程开始，即用户正式提交新建岗位申请。在SAP SuccessFactors中触发岗位创建工作流时，系统会明确记录此事件。
重要性这是流程的主要开始事件。分析从此活动到岗位审批或创建等其他活动所需的时间，是衡量整体流程效率的关键。获取途径此事件记录自与岗位申请相关的工作流实例启动时起。相关数据可在工作流申请表中找到，例如与Position对象关联的WfRequest。采集新岗位工作流启动时记录。事件类型 explicit
	启用岗位	此事件表示新建岗位已启用，可用于人员配置或招聘。通常根据岗位状态字段变更为“活跃”来推断。
重要性启用是开始招聘前的最后一步。跟踪从创建到启用所需的时间，有助于发现岗位准备就绪过程中的延迟。获取途径通过跟踪Position MDF对象历史记录中“Status”或“Effective Status”字段的变更来推断此事件。字段变为“活跃”时的时间戳即为事件时间。采集根据岗位状态字段变更为“活跃”推断。事件类型 inferred
	在HR系统中创建岗位	此活动标志着岗位记录正式创建于SAP SuccessFactors Employee Central。系统会从Position MDF对象的审计轨迹或历史记录中明确提取此事件，并使用创建时间戳。
重要性这是确认岗位正式存在的重要节点。“岗位创建周期时间”KPI衡量从申请发起到此事件的时长，反映整体效率。获取途径此事件取自特定Position ID对应的Position Metadata Framework（MDF）对象审计历史中的“Created On”或“Created Date”系统字段。采集从Position对象记录的创建时间戳提取。事件类型 explicit
	岗位申请被拒绝	此事件标志着岗位申请在审批工作流的任一阶段被拒绝。审批人选择“拒绝”或“退回”选项时，工作流引擎会明确记录此事件。
重要性拒绝是重要的流程偏差，可能表明申请数据、预算或理由存在问题。分析拒绝原因有助于提高后续申请的质量。获取途径此事件取自与岗位申请相关的工作流日志数据，对应工作流步骤状态变为“已拒绝”。采集审批人拒绝工作流中的步骤时记录。事件类型 explicit
	修改岗位属性	表示对现有岗位属性所做的任何更改，例如职位名称、部门或成本中心。此事件通过Position MDF对象的审计日志明确记录。
重要性频繁修改可能表明数据质量存在问题，或组织设计不稳定。分析这些事件有助于衡量“岗位属性变更率”和返工情况。获取途径此类事件取自Position MDF对象的审计历史。每条带有“last modified date”时间戳和用户信息的变更记录，都代表一次修改活动。采集 Position对象的审计轨迹会记录任何字段变更。事件类型 explicit
	停用岗位	表示正式停用岗位，使其不再活跃且无法使用。可根据岗位状态变更为“非活跃”或“已停用”推断。
重要性这是岗位退出流程中的关键步骤。跟踪从暂停到停用所需的时间，对衡量“岗位停用提前期”KPI至关重要。获取途径通过Position MDF对象的审计历史，识别“Status”或“Effective Status”字段变更为“非活跃”的时间来推断。采集根据岗位状态字段变更为“非活跃”推断。事件类型 inferred
	冻结／暂停岗位	此事件表示岗位暂时搁置，无法用于人员配置。可根据岗位状态字段变更为“冻结”或“暂停”等值推断。
重要性此活动通常发生在停用或关闭之前。分析岗位保持冻结状态的时长，有助于优化人力规划和编制管理。获取途径通过跟踪Position MDF对象历史记录中“Status”字段的变更来推断。字段变为“冻结”或类似值时的时间戳即为事件时间。采集根据岗位状态字段变更为“冻结”推断。事件类型 inferred
	审查岗位合规情况	表示定期或因特定事件触发的岗位审查，以确保岗位符合内部政策或外部法规。此事件的记录方式高度依赖客户的具体配置，例如自定义工作流或MDF对象。
重要性此活动对于监测并确保组织合规至关重要，可直接支持“岗位审查合规率”等KPI，并帮助降低风险。获取途径需要进行系统分析。此事件可能记录在与Position关联的自定义MDF对象中，也可能通过自定义工作流状态更新或附件日志捕获。采集取决于自定义实施方式，可能记录为自定义MDF对象条目。事件类型 explicit
	岗位预算获批	表示财务部门或预算负责人已批准新岗位的财务事项。这通常是工作流中的明确步骤，发生在经理和HR审批之后。
重要性预算审批延迟可能严重拖慢招聘流程。单独分析此活动，有助于评估并优化岗位管理中的财务审批阶段。获取途径此事件取自岗位申请的工作流日志，对应财务审批步骤完成的时间。审批人通常标记为“财务”或“预算负责人”角色。采集财务审批人完成工作流中的步骤时记录。事件类型 explicit
	经理批准岗位申请	表示完成第一级审批，通常由招聘经理或直线经理执行。这是岗位管理工作流中明确记录的已完成步骤。
重要性跟踪经理审批时间有助于发现特定部门或管理层级的瓶颈，也是了解审批周期初期阶段的重要节点。获取途径此事件作为步骤完成记录在特定岗位申请的工作流日志数据中。可根据审批人的角色及工作流步骤的“已批准”状态识别。采集用户完成工作流中的审批步骤时记录。事件类型 explicit
	重新分类岗位	此活动表示岗位核心定义发生重大变化，例如职位代码或职位族变更。可根据Position MDF对象中“Job Code”或“Job Classification”字段的变更推断。
重要性重新分类率偏高可能表明初始岗位设计存在问题，或业务需求不断变化。跟踪此指标有助于分析组织架构的稳定性。获取途径通过监测Position MDF对象的审计历史中关键分类字段（如“jobCode”）的变更来推断。此类变更的时间戳即为事件时间。采集根据Position对象的“jobCode”字段变更推断。事件类型 inferred

建议填写选填

数据提取指南

如何从SAP SuccessFactors Employee Central获取数据

步骤

进入Integration Center：登录您的SAP SuccessFactors环境。使用搜索栏查找并进入Integration Center。
创建新集成：点击“My Integrations”按钮，选择“Create”，然后选择“More Integration Types”。
选择初始设置：
- 集成类型：选择“Scheduled”。
- 源类型：选择“SuccessFactors”。
- 目标类型：选择“SFTP”。
- 格式：选择“CSV”，然后点击“Create”。
配置核心实体：在“Configure Fields”选项卡中，搜索并选择“Position”实体作为起始实体。为集成设置一个易于识别的名称，例如“ProcessMind职位管理日志”。
提取“职位已创建”事件：这是第一个事件。映射Position基础实体中的字段。对于ActivityName字段，使用“Set Fixed Value”选项并输入“在HR系统中创建职位”。将PositionId映射到code字段，将EventTime映射到createdDate字段。
提取工作流事件（已发起、已批准、已拒绝）：要捕获工作流事件，需要关联工作流数据。在Position实体中找到“positionWorkOrder”导航属性，然后依次进入wfRequestNav和wfRequestSteps。
- 右键点击实体树中的根节点，选择“Add Sibling Element”。
- 对于这个新元素，按上述路径导航到相关实体。
- 创建ActivityName计算字段，例如“职位申请已发起”“经理已批准职位申请”等。根据wfRequestSteps实体中的stepNum（步骤编号）和status（“APPROVED”或“REJECTED”）设置条件逻辑。
- 将EventTime映射到工作流步骤的completedOn字段。
提取状态变更事件（已激活、已停用等）：许多活动可通过Position的有效期记录变更推导得出。
- 再添加一个同级元素，仍以Position实体为起点。
- 点击带时钟图标的记录，进入实体历史记录，查看不同时期的变更。
- 要检测特定状态变更，需要筛选当前记录的status，例如“A”（活跃），并确认前一条记录的状态不同。Integration Center支持部分高级筛选，但可能需要通过计算字段进行判断。
- 对每种状态变更（已激活、已冻结、已停用、已关闭），分别创建同级元素，设置相应筛选条件，并为ActivityName指定固定值。
提取属性修改事件：根据Position的有效期历史记录添加另一个同级元素。创建筛选条件，纳入lastModifiedDateTime处于报告时间范围内的记录，同时排除已捕获的其他特定事件（例如创建或特定状态变更）。此步骤可能较复杂。将ActivityName设为“已修改职位属性”。
配置目标设置：进入“Destination Settings”选项卡，填写SFTP服务器信息，包括主机地址、端口、用户名和身份验证信息。指定文件名和输出文件夹路径。
设置筛选和排序：在“Filter”选项卡中创建基于时间的筛选条件，限制提取的数据。强烈建议根据Position对象的lastModifiedDateTime筛选，以执行增量加载。首次运行时，可以按createdDate筛选。按PositionId和EventTime排序，确保事件按时间先后排列。
设置集成计划：进入“Scheduling”选项卡，设置任务运行频率，例如每天或每周运行，确保流程挖掘数据保持最新。
检查并运行：在最后一个选项卡中检查所有设置。您可以运行测试，也可以激活集成。任务运行后，CSV文件将保存到指定的SFTP服务器，可供上传至ProcessMind。

配置

集成类型：定时导出CSV。系统会按固定周期生成扁平文件。
起始实体：主要实体为Position。大多数其他必需数据可通过Position导航到相关实体获取，例如有效期历史记录、工作流申请（wfRequestNav）和基础对象。
关键筛选条件：按lastModifiedDateTime筛选对于提升性能和生成易于管理的增量数据至关重要。首次加载历史数据时，可按createdDate筛选指定时间段，例如最近6至12个月。还可按company或businessUnit筛选，限定相关组织范围。
分页：处理大量数据时，请确保在目标设置中启用“Server Side Pagination”，以避免超时。根据性能测试结果调整每页大小。
前提条件：您必须配置SFTP服务器，并确保SuccessFactors环境可以访问。配置集成的用户需要有权访问Integration Center，并拥有所查询实体（Position、WfRequest、User等）的OData API权限。

查询示例 sql

/*
Integration Center is a UI-based tool. This script represents the logical configuration
of the entities, fields, and filters for each activity within a single integration job.
Each 'BLOCK' would be configured as a sibling element in the Integration Center UI.
*/

// BLOCK 1: Position Created in HR System
// This is the root element of the integration.
ENTITY: Position
FIELDS:
  PositionId = Position.code
  ActivityName = 'Position Created in HR System' (Fixed Value)
  EventTime = Position.createdDate
  SourceSystemId = '[Your SFTP Server Name]' (Fixed Value)
  LastDataUpdateTime = Current Execution Time (System Variable)
  EventEndTime = Position.createdDate
  UserId = Position.createdBy
  DepartmentName = Position.department.name
  PositionStatus = Position.status
  ApproverId = null (Fixed Value)
FILTERS:
  Position.createdDate >= [Start Date]

-- UNION ALL (Configured by adding a sibling element)

// BLOCK 2: Workflow Events (Initiated, Approved, Rejected)
// This single block uses calculated columns to generate multiple event types.
ENTITY: Position -> positionWorkOrder -> wfRequestNav
FIELDS:
  PositionId = Position.code
  ActivityName = Calculated Field:
    IF wfRequestNav.wfRequestSteps.stepNum = 1 AND wfRequestNav.status = 'PENDING' THEN 'Position Request Initiated'
    IF wfRequestNav.wfRequestSteps.stepNum = [Manager Approval Step Number] AND wfRequestNav.wfRequestSteps.status = 'APPROVED' THEN 'Position Request Approved by Manager'
    IF wfRequestNav.wfRequestSteps.stepNum = [HR Approval Step Number] AND wfRequestNav.wfRequestSteps.status = 'APPROVED' THEN 'Position Request Approved by HR'
    IF wfRequestNav.wfRequestSteps.stepNum = [Budget Approval Step Number] AND wfRequestNav.wfRequestSteps.status = 'APPROVED' THEN 'Position Budget Approved'
    IF wfRequestNav.wfRequestSteps.status = 'REJECTED' THEN 'Position Request Rejected'
    ELSE null
  EventTime = wfRequestNav.wfRequestSteps.completedOn
  SourceSystemId = '[Your SFTP Server Name]' (Fixed Value)
  LastDataUpdateTime = Current Execution Time (System Variable)
  EventEndTime = wfRequestNav.wfRequestSteps.completedOn
  UserId = wfRequestNav.wfRequestSteps.processedBy
  DepartmentName = Position.department.name
  PositionStatus = Position.status
  ApproverId = wfRequestNav.wfRequestSteps.approverId
FILTERS:
  ActivityName IS NOT null
  wfRequestNav.wfRequestSteps.lastModifiedDateTime >= [Start Date]

-- UNION ALL (Configured by adding a sibling element)

// BLOCK 3: Position Activated
ENTITY: Position (Effective Dated History)
FIELDS:
  PositionId = Position.code
  ActivityName = 'Position Activated' (Fixed Value)
  EventTime = Position.effectiveStartDate
  SourceSystemId = '[Your SFTP Server Name]' (Fixed Value)
  LastDataUpdateTime = Current Execution Time (System Variable)
  EventEndTime = Position.effectiveStartDate
  UserId = Position.lastModifiedBy
  DepartmentName = Position.department.name
  PositionStatus = Position.status
  ApproverId = null (Fixed Value)
FILTERS:
  Position.status = 'A' (Active)
  // This requires an advanced filter to check the status of the previous record, which can be complex in Integration Center.
  Position.lastModifiedDateTime >= [Start Date]

-- UNION ALL (Configured by adding a sibling element)

// BLOCK 4: Position Attributes Modified
ENTITY: Position (Effective Dated History)
FIELDS:
  PositionId = Position.code
  ActivityName = 'Position Attributes Modified' (Fixed Value)
  EventTime = Position.lastModifiedDateTime
  SourceSystemId = '[Your SFTP Server Name]' (Fixed Value)
  LastDataUpdateTime = Current Execution Time (System Variable)
  EventEndTime = Position.lastModifiedDateTime
  UserId = Position.lastModifiedBy
  DepartmentName = Position.department.name
  PositionStatus = Position.status
  ApproverId = null (Fixed Value)
FILTERS:
  // This filter should exclude records that are purely status changes captured in other blocks.
  Position.lastModifiedDateTime >= [Start Date]

-- UNION ALL (Configured by adding a sibling element)

// BLOCK 5: Position Reclassified
ENTITY: Position (Effective Dated History)
FIELDS:
  PositionId = Position.code
  ActivityName = 'Position Reclassified' (Fixed Value)
  EventTime = Position.effectiveStartDate
  SourceSystemId = '[Your SFTP Server Name]' (Fixed Value)
  LastDataUpdateTime = Current Execution Time (System Variable)
  EventEndTime = Position.effectiveStartDate
  UserId = Position.lastModifiedBy
  DepartmentName = Position.department.name
  PositionStatus = Position.status
  ApproverId = null (Fixed Value)
FILTERS:
  // Requires advanced filter to check if Position.jobCode has changed from the previous record.
  Position.lastModifiedDateTime >= [Start Date]

-- UNION ALL (Configured by adding a sibling element)

// BLOCK 6: Position Reviewed for Compliance
// This requires a custom MDF object or workflow configured by the customer.
ENTITY: Position -> cust_ComplianceReview.position
FIELDS:
  PositionId = Position.code
  ActivityName = 'Position Reviewed for Compliance' (Fixed Value)
  EventTime = cust_ComplianceReview.lastModifiedDate
  SourceSystemId = '[Your SFTP Server Name]' (Fixed Value)
  LastDataUpdateTime = Current Execution Time (System Variable)
  EventEndTime = cust_ComplianceReview.lastModifiedDate
  UserId = cust_ComplianceReview.lastModifiedBy
  DepartmentName = Position.department.name
  PositionStatus = Position.status
  ApproverId = cust_ComplianceReview.reviewerId
FILTERS:
  cust_ComplianceReview.lastModifiedDate >= [Start Date]

-- UNION ALL (Configured by adding a sibling element)

// BLOCK 7: Position Frozen/Suspended
ENTITY: Position (Effective Dated History)
FIELDS:
  PositionId = Position.code
  ActivityName = 'Position Frozen/Suspended' (Fixed Value)
  EventTime = Position.effectiveStartDate
  SourceSystemId = '[Your SFTP Server Name]' (Fixed Value)
  LastDataUpdateTime = Current Execution Time (System Variable)
  EventEndTime = Position.effectiveStartDate
  UserId = Position.lastModifiedBy
  DepartmentName = Position.department.name
  PositionStatus = Position.status
  ApproverId = null (Fixed Value)
FILTERS:
  Position.status = '[Your Frozen Status Code]'
  Position.lastModifiedDateTime >= [Start Date]

-- UNION ALL (Configured by adding a sibling element)

// BLOCK 8: Position Deactivated
ENTITY: Position (Effective Dated History)
FIELDS:
  PositionId = Position.code
  ActivityName = 'Position Deactivated' (Fixed Value)
  EventTime = Position.effectiveStartDate
  SourceSystemId = '[Your SFTP Server Name]' (Fixed Value)
  LastDataUpdateTime = Current Execution Time (System Variable)
  EventEndTime = Position.effectiveStartDate
  UserId = Position.lastModifiedBy
  DepartmentName = Position.department.name
  PositionStatus = Position.status
  ApproverId = null (Fixed Value)
FILTERS:
  Position.status = 'I' (Inactive)
  Position.lastModifiedDateTime >= [Start Date]

-- UNION ALL (Configured by adding a sibling element)

// BLOCK 9: Position Closed
ENTITY: Position (Effective Dated History)
FIELDS:
  PositionId = Position.code
  ActivityName = 'Position Closed' (Fixed Value)
  EventTime = Position.effectiveStartDate
  SourceSystemId = '[Your SFTP Server Name]' (Fixed Value)
  LastDataUpdateTime = Current Execution Time (System Variable)
  EventEndTime = Position.effectiveStartDate
  UserId = Position.lastModifiedBy
  DepartmentName = Position.department.name
  PositionStatus = Position.status
  ApproverId = null (Fixed Value)
FILTERS:
  Position.status = '[Your Closed/Eliminated Status Code]'
  Position.lastModifiedDateTime >= [Start Date]

步骤

确认环境中已启用并可使用Report Center Canvas Reports、Employee Central Position Management、Position MDF审计或历史数据、工作流数据和安全FTP传输。请与SuccessFactors管理员确认所需的报告和审计权限。
在Report Center中创建Canvas Report，并选择环境中可用的Employee Central职位、工作流、审计及客户特定合规数据源。对象和字段名称因配置而异，请选择已配置的对应对象，不要假定名称均为标准名称。
使用Position ID作为案例标识符配置报告关联。将职位记录与工作流记录、审计或历史记录以及已配置的合规记录关联。每个事件必须保留一行输出，不要将事件汇总为每个职位一行。
配置事件提取逻辑，涵盖所有必需活动：职位申请已发起、经理已批准职位申请、HR已批准职位申请、职位预算已批准、在HR系统中创建职位、职位已激活、已修改职位属性、职位已重新分类、职位合规性审查、职位已冻结/暂停、职位已停用、职位申请已拒绝，以及职位已关闭。
将每个事件映射到ActivityName和EventTime。职位申请已发起使用工作流提交时间戳；审批活动使用审批完成时间戳；在HR系统中创建职位使用职位创建时间戳；变更使用审计或历史时间戳；职位合规性审查使用已配置的合规审查时间戳。基于状态的活动使用已配置的状态时间戳或审计时间戳。
添加必需的输出列：PositionId、ActivityName、EventTime、SourceSystemId和LastDataUpdateTime。如果数据源提供相应信息，也请添加EventEndTime、UserId、DepartmentName、PositionStatus和ApproverId。将SourceSystemId设为稳定值，例如SuccessFactors Employee Central，并使用报告刷新或提取时间填充LastDataUpdateTime。
使用[Start date parameter]和[End date parameter]对EventTime设置日期筛选。仅在字段已配置且确有需要时，才应用[Company Code filter]或[Document Type filter]等客户特定筛选条件。确保筛选条件不会排除所选流程周期内所需的历史事件。
测试后安排Canvas Report运行。配置定期执行和安全FTP传输，并使用环境批准的目标位置、文件命名规则、分隔符、字符编码和保留设置。除非平台要求使用托管凭据，否则不要将凭据直接写入报告定义。
从安全FTP位置获取生成的CSV文件，并检查表头、分隔符、编码、时间戳格式、重复行和空值。如有需要，请调整文件结构，确保每个活动单独占一行，并在每行重复填写PositionId。
将最终CSV文件加载到ProcessMind。将PositionId映射为案例标识符，将ActivityName映射为活动，将EventTime映射为事件时间戳，其余列映射为事件属性。验证ProcessMind按原样读取事件日志，不依赖推断得出的活动。

配置

报告类型：使用SuccessFactors Report Center Canvas Report。具体源对象名称、关联方式和字段标签取决于环境配置。
必需事件列：PositionId、ActivityName、EventTime、SourceSystemId和LastDataUpdateTime。
建议事件列：EventEndTime、UserId、DepartmentName、PositionStatus和ApproverId。
案例标识符：PositionId必须在工作流、职位、审计、历史和合规记录中保持稳定。
活动逻辑：为全部13项活动明确配置事件行。状态变更和字段变更必须分别记录为事件行，不能只作为当前状态属性。
日期范围：测试和日常提取可先使用3至6个月的数据。确认报告性能和历史数据可用性后，再扩大范围。
日期筛选：尽可能按事件时间戳筛选。避免仅按当前职位记录日期筛选，否则可能会排除历史工作流和审计事件。
重要筛选条件：仅在业务范围需要且环境中已配置时，使用[Company Code filter]、[Document Type filter]、组织范围、职位状态和有效期筛选条件。
有效期：确认所选职位和MDF数据源是否包含有效期信息。如有事件时间戳以及相关有效开始或结束日期，请予以保留。
工作流配置：确定与经理审批、HR审批、预算审批、拒绝和退回相对应的已配置工作流步骤。必须明确映射客户特定的工作流步骤名称。
合规审查：只有在客户特定工作流、MDF对象或其他可审计数据源可用时，才能配置“职位合规性审查”事件。不要根据未经证实的假设创建此事件。
状态值：映射环境中配置的活跃、冻结、暂停、非活跃、已停用、已关闭和已取消等状态值。尽可能保留原始PositionStatus值。
属性变更：配置审计或历史数据提取，以记录职位属性变更。对于职位重新分类，需明确识别已配置的Job Code或Job Classification字段变更。
刷新时间戳：为所有行一致填充LastDataUpdateTime，使用报告执行时间或源数据刷新时间。
性能：缩小初始日期范围，仅选择必需列，避免不必要的多对多关联，并测试关联是否导致行数膨胀。大型审计和工作流数据集可能需要分区安排提取任务，或分别提取后再进行受控合并。
传输：使用环境批准的凭据、加密方式、目录、文件命名和保留设置，通过安全FTP传输。导入ProcessMind前，请验证交付文件完整无误。
前提条件：需要配置Employee Central和Position Management、Report Center访问权限、所有所选对象的报告权限、审计或历史记录权限、工作流可见性、安全FTP传输能力，以及适用的报告或集成许可证。

查询示例 sql

SELECT
    PositionId,
    ActivityName,
    EventTime,
    SourceSystemId,
    LastDataUpdateTime,
    EventEndTime,
    UserId,
    DepartmentName,
    PositionStatus,
    ApproverId
FROM [Your configured Canvas Report output for Position Request Initiated]
WHERE EventTime >= [Start date parameter]
  AND EventTime < [End date parameter]
UNION ALL
SELECT
    PositionId,
    ActivityName,
    EventTime,
    SourceSystemId,
    LastDataUpdateTime,
    EventEndTime,
    UserId,
    DepartmentName,
    PositionStatus,
    ApproverId
FROM [Your configured Canvas Report output for Position Request Approved by Manager]
WHERE EventTime >= [Start date parameter]
  AND EventTime < [End date parameter]
UNION ALL
SELECT
    PositionId,
    ActivityName,
    EventTime,
    SourceSystemId,
    LastDataUpdateTime,
    EventEndTime,
    UserId,
    DepartmentName,
    PositionStatus,
    ApproverId
FROM [Your configured Canvas Report output for Position Request Approved by HR]
WHERE EventTime >= [Start date parameter]
  AND EventTime < [End date parameter]
UNION ALL
SELECT
    PositionId,
    ActivityName,
    EventTime,
    SourceSystemId,
    LastDataUpdateTime,
    EventEndTime,
    UserId,
    DepartmentName,
    PositionStatus,
    ApproverId
FROM [Your configured Canvas Report output for Position Budget Approved]
WHERE EventTime >= [Start date parameter]
  AND EventTime < [End date parameter]
UNION ALL
SELECT
    PositionId,
    ActivityName,
    EventTime,
    SourceSystemId,
    LastDataUpdateTime,
    EventEndTime,
    UserId,
    DepartmentName,
    PositionStatus,
    ApproverId
FROM [Your configured Canvas Report output for Position Created in HR System]
WHERE EventTime >= [Start date parameter]
  AND EventTime < [End date parameter]
UNION ALL
SELECT
    PositionId,
    ActivityName,
    EventTime,
    SourceSystemId,
    LastDataUpdateTime,
    EventEndTime,
    UserId,
    DepartmentName,
    PositionStatus,
    ApproverId
FROM [Your configured Canvas Report output for Position Activated]
WHERE EventTime >= [Start date parameter]
  AND EventTime < [End date parameter]
UNION ALL
SELECT
    PositionId,
    ActivityName,
    EventTime,
    SourceSystemId,
    LastDataUpdateTime,
    EventEndTime,
    UserId,
    DepartmentName,
    PositionStatus,
    ApproverId
FROM [Your configured Canvas Report output for Position Attributes Modified]
WHERE EventTime >= [Start date parameter]
  AND EventTime < [End date parameter]
UNION ALL
SELECT
    PositionId,
    ActivityName,
    EventTime,
    SourceSystemId,
    LastDataUpdateTime,
    EventEndTime,
    UserId,
    DepartmentName,
    PositionStatus,
    ApproverId
FROM [Your configured Canvas Report output for Position Reclassified]
WHERE EventTime >= [Start date parameter]
  AND EventTime < [End date parameter]
UNION ALL
SELECT
    PositionId,
    ActivityName,
    EventTime,
    SourceSystemId,
    LastDataUpdateTime,
    EventEndTime,
    UserId,
    DepartmentName,
    PositionStatus,
    ApproverId
FROM [Your configured Canvas Report output for Position Reviewed for Compliance]
WHERE EventTime >= [Start date parameter]
  AND EventTime < [End date parameter]
UNION ALL
SELECT
    PositionId,
    ActivityName,
    EventTime,
    SourceSystemId,
    LastDataUpdateTime,
    EventEndTime,
    UserId,
    DepartmentName,
    PositionStatus,
    ApproverId
FROM [Your configured Canvas Report output for Position Frozen or Suspended]
WHERE EventTime >= [Start date parameter]
  AND EventTime < [End date parameter]
UNION ALL
SELECT
    PositionId,
    ActivityName,
    EventTime,
    SourceSystemId,
    LastDataUpdateTime,
    EventEndTime,
    UserId,
    DepartmentName,
    PositionStatus,
    ApproverId
FROM [Your configured Canvas Report output for Position Deactivated]
WHERE EventTime >= [Start date parameter]
  AND EventTime < [End date parameter]
UNION ALL
SELECT
    PositionId,
    ActivityName,
    EventTime,
    SourceSystemId,
    LastDataUpdateTime,
    EventEndTime,
    UserId,
    DepartmentName,
    PositionStatus,
    ApproverId
FROM [Your configured Canvas Report output for Position Request Rejected]
WHERE EventTime >= [Start date parameter]
  AND EventTime < [End date parameter]
UNION ALL
SELECT
    PositionId,
    ActivityName,
    EventTime,
    SourceSystemId,
    LastDataUpdateTime,
    EventEndTime,
    UserId,
    DepartmentName,
    PositionStatus,
    ApproverId
FROM [Your configured Canvas Report output for Position Closed]
WHERE EventTime >= [Start date parameter]
  AND EventTime < [End date parameter];

步骤

准备Python环境：确保已安装Python 3.6或更高版本。使用pip安装所需库：pip install requests pandas。
配置API访问：获取SAP SuccessFactors API凭据，包括API服务器URL、公司ID，以及技术用户的用户名和密码（或OAuth 2.0客户端ID和密钥）。该用户必须有权访问Position、WfRequest、WfRequestStep等实体的OData API，以及相关基础对象。
设置脚本参数：打开提供的Python脚本。在顶部找到配置部分，将API_ENDPOINT、COMPANY_ID、API_USER、API_PASSWORD的占位值替换为实际值，并设置所需的提取起止日期START_DATE和END_DATE。
自定义映射：检查脚本中的STATUS_ACTIVITY_MAP和WORKFLOW_STEP_MAP字典。根据组织在SuccessFactors中的具体配置，调整键（SuccessFactors状态代码或工作流步骤名称）和值（所需的活动名称）。
运行脚本：在终端中执行命令：python extract_position_management.py。脚本将连接SuccessFactors API，获取职位和工作流数据，并自动处理分页。
数据处理：脚本会在内存中处理原始API数据，识别创建事件、状态变更、属性修改和工作流步骤，并将其转换为标准事件日志格式。每个独立业务事件都会生成单独一行。
处理自定义事件：对于高度定制的“职位合规性审查”活动，请在脚本中找到占位函数get_compliance_review_events，并根据系统配置实现查询相关自定义MDF对象或工作流的逻辑。
检查输出：脚本运行完毕后，会生成名为position_management_event_log.csv的CSV文件，其中包含提取的事件日志。
验证数据：打开CSV文件，按照验证步骤执行检查。确认案例数量、活动分布和属性完整度符合预期。
准备上传：确保CSV文件表头符合ProcessMind数据模型要求。必须包含PositionId、ActivityName和EventTime列，且格式正确。文件现已准备好，可上传至ProcessMind。

配置

API用户权限：API技术用户必须拥有以下OData实体的读取权限：Position、WfRequest、WfRequestStep、用户、FODepartment，以及属性补充所需的其他实体。权限应包括OData API Position Export和OData API Workflow Export。
日期范围筛选：脚本使用START_DATE和END_DATE，根据lastModifiedDateTime筛选记录。首次加载建议选择12至24个月，以覆盖完整生命周期。增量加载时，将上次成功提取的时间戳设为新的START_DATE。
分页：脚本使用$top和$skip参数处理API分页。您可以调整PAGE_SIZE变量；通常设置为200至500，可兼顾性能和内存使用。
实体选择：脚本主要查询Position和WfRequest实体。使用$select参数将查询范围限制为必要字段，以提升API性能。
状态和工作流映射：脚本包含STATUS_ACTIVITY_MAP和WORKFLOW_STEP_MAP字典，用于将SuccessFactors中的技术值（例如表示活跃状态的“A”和工作流步骤名称“WF_STEP_HR”）映射为易于业务人员理解的活动名称。请根据您的环境配置这些映射。
增量逻辑：脚本用于提取指定日期范围内的完整数据。定期提取时，请根据LastDataUpdateTime实现增量记录管理逻辑，避免重复处理数据。

查询示例 python

import requests
import pandas as pd
from datetime import datetime
import json

class=class="hl-string">"hl-comment"># --- Configuration ---
class=class="hl-string">"hl-comment"># Replace with your SuccessFactors API details
API_ENDPOINT = class="hl-string">"https://apiX.successfactors.com/odata/v2"
COMPANY_ID = class="hl-string">"[Your_Company_ID]"
API_USER = class="hl-string">"[Your_API_User]@[Your_Company_ID]"
API_PASSWORD = class="hl-string">"[Your_API_Password]"

class=class="hl-string">"hl-comment"># Date range for extraction (YYYY-MM-DD format)
START_DATE = class="hl-string">"2023-01-01"
END_DATE = class="hl-string">"2023-12-31"

class=class="hl-string">"hl-comment"># Pagination size
PAGE_SIZE = 500

class=class="hl-string">"hl-comment"># Mappings (Customize to your SF configuration)
STATUS_ACTIVITY_MAP = {
    class="hl-string">'A': class="hl-string">'Position Activated',
    class="hl-string">'I': class="hl-string">'Position Deactivated',
    class="hl-string">'S': class="hl-string">'Position Frozen/Suspended',
    class="hl-string">'E': class="hl-string">'Position Closed',
    class="hl-string">'F': class="hl-string">'Position Frozen/Suspended'
}

class=class="hl-string">"hl-comment"># Note: Workflow step names can be found in WF_REQUEST_STEP.step_name
WORKFLOW_STEP_MAP = {
    class="hl-string">'Manager Approval': class="hl-string">'Position Request Approved by Manager',
    class="hl-string">'HR Approval': class="hl-string">'Position Request Approved by HR',
    class="hl-string">'Budget Approval': class="hl-string">'Position Budget Approved'
}

class=class="hl-string">"hl-comment"># --- Helper Functions ---
def fetch_sf_data(entity, select_fields, filter_query):
    class="hl-string">"""Fetches paginated data from a SuccessFactors OData entity."""
    all_records = []
    skip = 0
    while True:
        url = fclass="hl-string">"{API_ENDPOINT}/{entity}?$format=json&$top={PAGE_SIZE}&$skip={skip}"
        if select_fields:
            url += fclass="hl-string">"&$select={','.join(select_fields)}"
        if filter_query:
            url += fclass="hl-string">"&$filter={filter_query}"
        
        print(fclass="hl-string">"Fetching {entity} data, page starting at record {skip}...")
        response = requests.get(url, auth=(API_USER, API_PASSWORD))
        if response.status_code != 200:
            print(fclass="hl-string">"Error fetching {entity}: {response.status_code} {response.text}")
            break

        data = response.json()[class="hl-string">'d'][class="hl-string">'results']
        if not data:
            break

        all_records.extend(data)
        skip += PAGE_SIZE

    return all_records

def parse_sf_timestamp(sf_date):
    class="hl-string">"""Parses SuccessFactors OData timestamp format /Date(...)/."""
    if not sf_date:
        return None
    try:
        class=class="hl-string">"hl-comment"># Extract timestamp in milliseconds and convert to datetime
        ts = int(sf_date.split(class="hl-string">'(')[1].split(class="hl-string">')')[0])
        return datetime.fromtimestamp(ts / 1000)
    except (IndexError, ValueError):
        return None

class=class="hl-string">"hl-comment"># --- Main Extraction Logic ---
def main():
    events = []
    source_system_id = class="hl-string">"SAP SuccessFactors"
    last_data_update_time = datetime.now()

    class=class="hl-string">"hl-comment"># 1. Fetch Position history data
    position_filter = fclass="hl-string">"lastModifiedDateTime ge datetime'{START_DATE}T00:00:00Z' and lastModifiedDateTime le datetime'{END_DATE}T23:59:59Z'"
    position_fields = [class="hl-string">"code", class="hl-string">"effectiveStartDate", class="hl-string">"status", class="hl-string">"jobCode", class="hl-string">"lastModifiedBy", class="hl-string">"lastModifiedDateTime", class="hl-string">"createdBy", class="hl-string">"createdDateTime", class="hl-string">"departmentNav/name"]
    positions_raw = fetch_sf_data(class="hl-string">"Position", position_fields, position_filter)

    class=class="hl-string">"hl-comment"># Group by position code to process history
    positions_by_code = {}
    for pos in positions_raw:
        code = pos.get(class="hl-string">'code')
        if code not in positions_by_code:
            positions_by_code[code] = []
        positions_by_code[code].append(pos)

    class=class="hl-string">"hl-comment"># Process Position history for events
    for pos_id, history in positions_by_code.items():
        class=class="hl-string">"hl-comment"># Sort records by effective date and last modified date to establish order
        history.sort(key=lambda x: (parse_sf_timestamp(x[class="hl-string">'createdDateTime']), parse_sf_timestamp(x[class="hl-string">'lastModifiedDateTime'])))

        class=class="hl-string">"hl-comment"># Event: Position Created in HR System
        creation_record = history[0]
        events.append({
            class="hl-string">'PositionId': pos_id,
            class="hl-string">'ActivityName': class="hl-string">'Position Created in HR System',
            class="hl-string">'EventTime': parse_sf_timestamp(creation_record[class="hl-string">'createdDateTime']),
            class="hl-string">'UserId': creation_record.get(class="hl-string">'createdBy'),
            class="hl-string">'DepartmentName': creation_record.get(class="hl-string">'departmentNav', {}).get(class="hl-string">'name'),
            class="hl-string">'PositionStatus': creation_record.get(class="hl-string">'status'),
            class="hl-string">'ApproverId': None
        })
        
        last_status = creation_record.get(class="hl-string">'status')
        last_job_code = creation_record.get(class="hl-string">'jobCode')

        for i in range(len(history)):
            record = history[i]
            event_time = parse_sf_timestamp(record[class="hl-string">'lastModifiedDateTime'])
            department = record.get(class="hl-string">'departmentNav', {}).get(class="hl-string">'name')

            class=class="hl-string">"hl-comment"># Events from status changes (Activated, Deactivated, Frozen, Closed)
            current_status = record.get(class="hl-string">'status')
            if current_status != last_status and current_status in STATUS_ACTIVITY_MAP:
                events.append({
                    class="hl-string">'PositionId': pos_id,
                    class="hl-string">'ActivityName': STATUS_ACTIVITY_MAP[current_status],
                    class="hl-string">'EventTime': event_time,
                    class="hl-string">'UserId': record.get(class="hl-string">'lastModifiedBy'),
                    class="hl-string">'DepartmentName': department,
                    class="hl-string">'PositionStatus': current_status,
                    class="hl-string">'ApproverId': None
                })
            last_status = current_status

            class=class="hl-string">"hl-comment"># Event: Position Reclassified (Job Code changed)
            current_job_code = record.get(class="hl-string">'jobCode')
            if current_job_code != last_job_code and i > 0: class=class="hl-string">"hl-comment"># Avoid flagging on creation
                events.append({
                    class="hl-string">'PositionId': pos_id,
                    class="hl-string">'ActivityName': class="hl-string">'Position Reclassified',
                    class="hl-string">'EventTime': event_time,
                    class="hl-string">'UserId': record.get(class="hl-string">'lastModifiedBy'),
                    class="hl-string">'DepartmentName': department,
                    class="hl-string">'PositionStatus': current_status,
                    class="hl-string">'ApproverId': None
                })
            last_job_code = current_job_code

            class=class="hl-string">"hl-comment"># Event: Position Attributes Modified (generic modification)
            if i > 0: class=class="hl-string">"hl-comment"># This fires for any modification after creation
                 events.append({
                    class="hl-string">'PositionId': pos_id,
                    class="hl-string">'ActivityName': class="hl-string">'Position Attributes Modified',
                    class="hl-string">'EventTime': event_time,
                    class="hl-string">'UserId': record.get(class="hl-string">'lastModifiedBy'),
                    class="hl-string">'DepartmentName': department,
                    class="hl-string">'PositionStatus': current_status,
                    class="hl-string">'ApproverId': None
                })


    class=class="hl-string">"hl-comment"># 2. Fetch Workflow (WfRequest) data for position creations
    wf_filter = fclass="hl-string">"lastModifiedDateTime ge datetime'{START_DATE}T00:00:00Z' and (module eq 'POSITION' or objectType eq 'Position')"
    wf_fields = [class="hl-string">"wfRequestId", class="hl-string">"status", class="hl-string">"effectiveDate", class="hl-string">"createdBy", class="hl-string">"createdDate", class="hl-string">"wfRequestSteps/processedBy", class="hl-string">"wfRequestSteps/status", class="hl-string">"wfRequestSteps/createdDate", class="hl-string">"wfRequestSteps/stepName", class="hl-string">"objectKey"]
    wf_requests_raw = fetch_sf_data(class="hl-string">"WfRequest", wf_fields, wf_filter)

    for wf in wf_requests_raw:
        pos_id = wf.get(class="hl-string">'objectKey')
        if not pos_id: continue

        class=class="hl-string">"hl-comment"># Event: Position Request Initiated
        events.append({
            class="hl-string">'PositionId': pos_id,
            class="hl-string">'ActivityName': class="hl-string">'Position Request Initiated',
            class="hl-string">'EventTime': parse_sf_timestamp(wf[class="hl-string">'createdDate']),
            class="hl-string">'UserId': wf.get(class="hl-string">'createdBy'),
            class="hl-string">'DepartmentName': None, class=class="hl-string">"hl-comment"># Department info is not in WfRequest
            class="hl-string">'PositionStatus': class="hl-string">'Pending',
            class="hl-string">'ApproverId': None
        })

        class=class="hl-string">"hl-comment"># Event: Position Request Rejected
        if wf[class="hl-string">'status'] == class="hl-string">'REJECTED':
            last_step = wf.get(class="hl-string">'wfRequestSteps', {}).get(class="hl-string">'results', [])[-1] if wf.get(class="hl-string">'wfRequestSteps') else {}
            events.append({
                class="hl-string">'PositionId': pos_id,
                class="hl-string">'ActivityName': class="hl-string">'Position Request Rejected',
                class="hl-string">'EventTime': parse_sf_timestamp(last_step.get(class="hl-string">'createdDate')),
                class="hl-string">'UserId': last_step.get(class="hl-string">'processedBy'),
                class="hl-string">'DepartmentName': None,
                class="hl-string">'PositionStatus': class="hl-string">'Rejected',
                class="hl-string">'ApproverId': last_step.get(class="hl-string">'processedBy')
            })

        class=class="hl-string">"hl-comment"># Events for approval steps
        if wf.get(class="hl-string">'wfRequestSteps') and class="hl-string">'results' in wf[class="hl-string">'wfRequestSteps']:
            for step in wf[class="hl-string">'wfRequestSteps'][class="hl-string">'results']:
                step_name = step.get(class="hl-string">'stepName', class="hl-string">'')
                if step[class="hl-string">'status'] == class="hl-string">'APPROVED' and step_name in WORKFLOW_STEP_MAP:
                    events.append({
                        class="hl-string">'PositionId': pos_id,
                        class="hl-string">'ActivityName': WORKFLOW_STEP_MAP[step_name],
                        class="hl-string">'EventTime': parse_sf_timestamp(step[class="hl-string">'createdDate']),
                        class="hl-string">'UserId': step.get(class="hl-string">'processedBy'),
                        class="hl-string">'DepartmentName': None,
                        class="hl-string">'PositionStatus': class="hl-string">'In Approval',
                        class="hl-string">'ApproverId': step.get(class="hl-string">'processedBy')
                    })

    class=class="hl-string">"hl-comment"># 3. Placeholder for class="hl-string">'Position Reviewed for Compliance'
    class=class="hl-string">"hl-comment"># This event is highly customer-specific. You need to implement the logic here.
    class=class="hl-string">"hl-comment"># Example: Query a custom MDF object or a specific workflow type.
    class=class="hl-string">"hl-comment"># compliance_events = get_compliance_review_events(START_DATE, END_DATE)
    class=class="hl-string">"hl-comment"># events.extend(compliance_events)

    class=class="hl-string">"hl-comment"># --- Final Dataframe Creation ---
    if not events:
        print(class="hl-string">"No events found for the specified period.")
        return

    df = pd.DataFrame(events)

    class=class="hl-string">"hl-comment"># Add standard columns
    df[class="hl-string">'SourceSystemId'] = source_system_id
    df[class="hl-string">'LastDataUpdateTime'] = last_data_update_time
    df[class="hl-string">'EventEndTime'] = df[class="hl-string">'EventTime'] class=class="hl-string">"hl-comment"># For atomic events, end time is the same as start time

    class=class="hl-string">"hl-comment"># Standardize column names and order
    final_columns = [
        class="hl-string">'PositionId', class="hl-string">'ActivityName', class="hl-string">'EventTime', class="hl-string">'EventEndTime', class="hl-string">'UserId',
        class="hl-string">'DepartmentName', class="hl-string">'PositionStatus', class="hl-string">'ApproverId', class="hl-string">'SourceSystemId', class="hl-string">'LastDataUpdateTime'
    ]
    df = df.reindex(columns=final_columns)

    class=class="hl-string">"hl-comment"># Clean up and save
    df.dropna(subset=[class="hl-string">'PositionId', class="hl-string">'ActivityName', class="hl-string">'EventTime'], inplace=True)
    df.sort_values(by=[class="hl-string">'PositionId', class="hl-string">'EventTime'], inplace=True)

    output_filename = class="hl-string">'position_management_event_log.csv'
    df.to_csv(output_filename, index=False)
    print(fclass="hl-string">"Event log successfully created: {output_filename}")

if __name__ == class="hl-string">'__main__':
    main()

准备好开始了吗？

立即使用此数据模板，着手优化从入职到离职流程中的职位管理。发现流程洞察，提升整个组织的效率。

返回改进指南

下载模板

立即提升从入职到离职流程中职位管理的效率！

快速发现瓶颈，将从入职到离职流程的周期时间缩短30%。

开始免费试用

无需信用卡，几分钟即可完成设置。

您的从入职到离职流程职位管理数据模板

您的从入职到离职流程职位管理数据模板

从入职到离职流程中职位管理的属性

从入职到离职流程中职位管理的活动

数据提取指南

SuccessFactors Integration Center定时导出

步骤

配置

查询示例 sql

SuccessFactors Report Center Canvas Report导出

步骤

配置

查询示例 sql

通过SuccessFactors OData API使用Python脚本提取数据

步骤

配置

查询示例 python

准备好开始了吗？

立即提升从入职到离职流程中职位管理的效率！