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

您的从招聘到离职职位管理数据模板

SAP SuccessFactors Employee Central

← 返回改进指南

招聘到离职：职位管理属性 (19) 招聘到离职：职位管理活动 (13) 提取指南 (3)

您的从招聘到离职职位管理数据模板

此模板全面介绍如何收集分析从招聘到离职职位管理流程所需的数据，包括应收集的关键属性、应跟踪的主要活动，以及实用的数据提取指导。使用此资源，确保为成功开展流程挖掘收集所有相关信息。

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

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

下载模板

招聘到离职：职位管理属性

以下是建议纳入事件日志的数据字段，用于全面分析招聘到离职职位管理流程。

5 必需 5 建议 9 可选

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

必需建议可选

招聘到离职：职位管理活动

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

6 建议 7 可选

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

建议可选

提取指南

如何从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 Management Log”。
提取“Position Created”事件：这是第一个事件。从基础Position实体映射字段。对于ActivityName字段，使用“Set Fixed Value”选项并输入“Position Created in HR System”。将PositionId映射到code字段，将EventTime映射到createdDate字段。
提取工作流事件（Initiated、Approved、Rejected）：要捕获工作流事件，需要关联工作流数据。在Position实体中找到“positionWorkOrder”导航属性，然后进入wfRequestNav，再进入wfRequestSteps。
- 右键点击实体树中的根节点，选择“Add Sibling Element”。
- 对于新元素，按照上述路径浏览相关实体。
- 为ActivityName创建计算字段，例如“Position Request Initiated”“Position Request Approved by Manager”等。根据wfRequestSteps实体的stepNum（步骤编号）和status（“APPROVED”或“REJECTED”）使用条件逻辑。
- 将EventTime映射到工作流步骤的completedOn字段。
提取状态变更事件（Activated、Deactivated等）：许多活动来自Position有效日期记录的变更。
- 再添加一个同级元素，仍从Position实体开始。
- 选择带时钟图标的记录，进入实体历史记录，从而访问随时间发生的变更。
- 要检测特定状态变更，需要筛选当前记录的status，例如“A”（Active），并确认上一条记录的状态不同。Integration Center支持部分高级筛选，但可能需要使用计算字段进行判断。
- 对于每种状态变更（Activated、Frozen、Deactivated、Closed），分别创建一个带适当筛选条件的同级元素，并为ActivityName设置固定值。
提取属性修改事件：根据Position的有效日期历史记录再添加一个同级元素。创建筛选条件，纳入lastModifiedDateTime处于报告时间范围内的记录，同时排除已捕获的其他特定事件，例如创建或特定状态变更。这一过程可能较为复杂。将ActivityName设置为“Position Attributes Modified”。
配置目标设置：进入“Destination Settings”选项卡。输入SFTP服务器详细信息，包括主机地址、端口、用户名和身份验证信息。指定文件名和输出文件夹路径。
设置筛选和排序：在“Filter”选项卡中创建基于时间的筛选条件，限制提取的数据。强烈建议根据Position对象的lastModifiedDateTime进行筛选，以执行增量加载。首次运行时，可以根据createdDate进行筛选。按PositionId再按EventTime对数据排序，确保事件按时间顺序排列。
安排集成任务：进入“Scheduling”选项卡。指定任务运行频率，例如每天或每周运行一次，确保流程挖掘数据保持最新。
检查并运行：在最后一个选项卡中检查所有设置。您可以运行测试，或将集成设置为活跃状态。任务运行后，CSV文件将放置在指定的SFTP服务器上，可上传到ProcessMind。

配置

Integration Type：Outbound Scheduled CSV。按固定周期生成平面文件。
Starting Entity：主要实体为Position。大多数其他所需数据都通过从Position导航至相关实体获取，例如有效日期历史记录、工作流请求（wfRequestNav）和基础对象。
Key Filters：按lastModifiedDateTime筛选对于提升性能和生成可管理的增量数据至关重要。首次加载历史数据时，可按指定时间段内的createdDate筛选，例如最近6至12个月。可进一步按company或businessUnit筛选，将范围限制在组织的相关部分。
Paging：数据量较大时，请确保在目标设置中启用“Server Side Pagination”，避免超时。根据性能测试结果调整页面大小。
Prerequisites：您必须配置SFTP服务器，并确保SAP SuccessFactors实例可以访问该服务器。配置集成的用户需要具备Integration Center访问权限，以及所查询全部实体（Position、WfRequest、User等）的OData API权限。

a 示例查询 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作为案例标识符配置报告关联。将职位记录与工作流记录、审计或历史记录，以及已配置的合规记录关联。每个事件保留一行输出，不要将事件聚合为每个职位一行。
配置所有必需活动的事件提取逻辑：Position Request Initiated、Position Request Approved by Manager、Position Request Approved by HR、Position Budget Approved、Position Created in HR System、Position Activated、Position Attributes Modified、Position Reclassified、Position Reviewed for Compliance、Position Frozen/Suspended、Position Deactivated、Position Request Rejected和Position Closed。
将每个事件映射到ActivityName和EventTime。Position Request Initiated使用工作流提交时间戳，审批活动使用审批完成时间戳，Position Created in HR System使用职位创建时间戳，变更使用审计或历史时间戳，Position Reviewed for Compliance使用已配置的合规审查时间戳，基于状态的活动使用已配置的状态或审计时间戳。
添加必需的输出列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对象或其他可审计数据源配置Position Reviewed for Compliance。不要基于未经支持的假设创建此事件。
状态值：映射租户配置的Active、Frozen、Suspended、Inactive、Deactivated、Closed和Eliminated值。尽可能保留原始PositionStatus值。
属性变更：配置审计或历史记录提取，捕获职位属性变更。对于Position Reclassified，应特别识别已配置的Job Code或Job Classification字段变更。
刷新时间戳：使用报告执行时间或源数据刷新时间填充LastDataUpdateTime，并确保同一次提取中的所有行保持一致。
性能：限制初始日期范围，仅选择必需列，避免不必要的多对多关联，并测试关联是否导致行数倍增。大型审计和工作流数据集可能需要分区调度，或先分别提取，再进行受控合并。
传输：使用租户批准的凭据、加密方式、目录、文件命名和保留设置，通过安全FTP传输。ProcessMind摄取前，验证传输文件完整无误。
前提条件：所需的Employee Central和Position Management配置、Report Center访问权限、所有所选对象的报告权限、审计或历史权限、工作流可见性、安全FTP传输能力，以及适用的报告或集成许可证。

a 示例查询 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、Company 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状态代码或工作流步骤名称）和值（所需的Activity名称）。
执行脚本：在终端中使用以下命令运行脚本：python extract_position_management.py。脚本将连接SuccessFactors API，获取Position和Workflow数据，并自动处理分页。
处理数据：脚本在内存中处理原始API数据，识别创建事件、状态变更、修改和工作流步骤，并将其转换为标准事件日志格式。每个独立的业务事件都会生成单独一行。
处理自定义事件：对于高度依赖自定义配置的“Position Reviewed for Compliance”活动，在脚本中找到占位函数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实现增量记录管理逻辑，避免重复处理数据。

a 示例查询 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出站导出

步骤

配置

a 示例查询 sql

SuccessFactors Report Center Canvas Report导出

步骤

配置

a 示例查询 sql

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

步骤

配置

a 示例查询 python

准备好开始了吗？

立即提升从招聘到离职职位管理效率！

您的从招聘到离职职位管理数据模板

您的从招聘到离职职位管理数据模板

招聘到离职：职位管理属性

招聘到离职：职位管理活动

提取指南

SuccessFactors Integration Center出站导出

步骤

配置

a 示例查询 sql

SuccessFactors Report Center Canvas Report导出

步骤

配置

a 示例查询 sql

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

步骤

配置

a 示例查询 python

准备好开始了吗？

立即提升从招聘到离职职位管理效率！

我们重视您的隐私