> 持续流程改进 > 记录到报告：期末结账与对账 > Oracle Fusion Financials > 数据模板

您的记录到报告流程：期间关账与对账数据模板

Oracle Fusion Financials

记录到报告流程：期间关账与对账属性(22) 记录到报告流程：期间关账与对账活动(14) 数据提取指南(1)

您的记录到报告流程：期间关账与对账数据模板

此模板为收集数据提供全面指南，帮助您分析记录到报告流程：期间关账与对账。模板列出了需要收集的关键属性，以及需要在事件日志中跟踪的主要活动。此外，您还可以了解如何从Oracle Fusion Financials提取这些数据，为开始流程挖掘做好准备。

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

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

下载模板

记录到报告流程：期间关账与对账属性

以下是建议纳入事件日志的数据字段，可用于全面分析记录到报告流程：期间关账与对账。

5 必填 8 建议填写 9 选填

	名称	说明
	开始时间 EventTime	表示特定活动或事件发生时间的时间戳。
说明开始时间，也称事件时间戳，记录活动执行或状态变更的准确日期和时间。这是按时间顺序排列事件和计算耗时的关键数据。在流程挖掘中，此时间戳用于构建每个财务期间的事件顺序、计算活动耗时并衡量流程总体周期时间。它是绩效分析、瓶颈识别和截止期限监控的基础。重要性此时间戳对于排列事件顺序、计算周期时间和活动耗时等所有基于时间的指标，以及了解流程时间线都至关重要。获取途径此信息通常位于Oracle Fusion Financials各模块中日记账、对账和期间状态相关记录的创建日期、最后更新日期或交易日期字段。示例 2023-01-28T09:00:00Z2023-02-01T14:30:15Z2023-02-03T11:21:05Z2023-02-05T17:00:00Z
	活动 ActivityName	期间结账流程中发生的具体任务或事件的名称。
说明此属性记录期间结账工作流中的各个步骤，例如“子分类账期间已关闭”“账户对账已开始”或“财务报表已生成”。每项活动都代表流程中的一个里程碑或操作。活动分析是流程挖掘的基础。它可以呈现流程图，通过衡量活动间的用时识别瓶颈，并分析流程变体以了解与标准流程的偏差。重要性此属性定义流程步骤，对于呈现流程走向、发现瓶颈和分析偏差至关重要。获取途径通常根据Oracle Fusion Financials各模块中的交易说明、状态变更或事件日志生成，例如总账、子分类账会计以及财务合并与结账模块。示例期间已开启子分类账期间已关闭对账已批准财务报表已生成
	财务期间 FinancialPeriod	财务结账期间的唯一标识，例如特定月份或季度。
说明财务期间是主要案例标识，用于汇总特定报告周期内与账户结账和对账相关的所有活动。每个期间，例如“2023年1月”或“2024年第1季度”，都代表一个独立的期间结账流程实例。在流程挖掘分析中，此属性可用于全面查看期间结账流程的始末。它可用于计算总体周期时间、比较不同期间的绩效，并识别结账流程随时间推移出现的趋势或系统性延迟。重要性这是将所有相关结账活动关联到同一流程实例的核心标识，可支持对每个期间结账周期进行端到端分析。获取途径通常根据总账模块中的期间名称或ID生成，在Oracle Fusion Financials中可从GL_PERIOD_STATUSES等表中找到。示例 2023年1月2023年2月2024年第1季度2024年3月
	数据最后更新时间 LastDataUpdate	表示数据最近一次从源系统刷新时间的时间戳。
说明此属性记录最近一次从Oracle Fusion Financials提取数据的日期和时间，反映流程挖掘工具中待分析数据的新鲜度。用户需要了解分析所依据的数据有多新。此时间戳有助于判断实时仪表板和报告的可靠性，确保决策基于最新信息。重要性此属性可让用户了解数据的时效性，这对于依据流程分析结果做出决策至关重要。获取途径这是数据接入管道生成并存储的元数据字段，用于记录数据提取作业的时间戳。示例 2023-03-10T02:00:00Z2023-03-11T02:00:00Z
	源系统 SourceSystem	提取数据的系统。
说明此属性用于标识事件数据的来源信息系统。对于此流程，来源始终为Oracle Fusion Financials；如果数据来自多个系统，此属性也能发挥作用。在分析中，它可说明数据来源，为数据治理、验证和了解流程所依托的技术环境提供重要背景。这有助于确保洞察正确归属于相应的应用环境。重要性此属性提供重要的数据来源信息，有助于在多系统环境中明确数据出处并支持数据治理。获取途径通常在数据提取过程中添加为静态值，用于标记数据集的来源。示例 Oracle Fusion FinancialsOracle Cloud ERP
	公司代码 CompanyCode	执行期间结账的法人实体或公司的标识。
说明公司代码在Oracle术语中也称法人实体标识，代表正在执行期间结账的特定业务实体。全球性组织通常拥有多个公司代码，每个代码都有自己的结账流程。此属性对于比较分析至关重要。管理层可以据此对标不同法人实体的期间结账绩效，识别遵循标准流程的实体，并准确定位偏差或延迟。它也是逐级下钻至业务特定部分的重要筛选条件。重要性此属性可用于筛选和比较不同法人实体的结账流程，对于统一全球流程至关重要。获取途径此属性对应会计科目表中的法人实体或平衡段值，是Oracle Fusion Financials中几乎所有财务交易的关键属性。示例 101210US01DE01
	对账类型 ReconciliationType	所执行账户对账的类别。
说明此属性用于区分对账类型，例如资产负债表、损益或公司间对账。不同类型的对账可能采用不同的工作流，复杂程度和风险也各不相同。此属性用于支持“按类型查看对账绩效”仪表板。分析人员可按此属性筛选，对比不同对账类别的周期时间和数量，找出最容易延误或积压、需要改进流程的类型。重要性此属性支持对账流程的定向分析，帮助识别特定账户类型（如高风险账户或公司间账户）中的瓶颈。获取途径此属性可从会计科目表中的账户类型获取；如果使用了Account Reconciliation Cloud Service（ARCS）模块，也可从该模块的属性中获取。示例资产负债表损益银行对账公司间
	日记账分录类型 JournalEntryType	日记账分录的分类，例如“标准”“冲销”或“调整”。
说明此属性根据用途对日记账分录进行分类。此流程中的一种重要类型是“调整”，通常表示对账活动产生的更正或重新分类。此属性是“调整分录数量”KPI和仪表板的重要依据。组织可筛选调整分录，监控更正频率；频繁更正往往反映出交易处理或会计政策中的上游问题。减少此类调整是流程改进的重要目标。重要性此属性有助于将调整分录与常规记账区分开来，从而集中分析结账期间的返工和更正活动。获取途径此信息通常位于GL_JE_HEADERS表的JE_CATEGORY和JE_SOURCE字段中。可能需要通过映射生成简化后的类型。示例标准调整重新分类应计
	活动状态 ActivityStatus	活动的完成状态，例如“已完成”“进行中”或“失败”。
说明此属性记录期间结账中某项任务的结果或当前状态。例如，日记账导入可能为“成功”或“失败”，对账可能为“已批准”或“已拒绝”。此状态对于了解流程异常和结果至关重要。分析人员可据此识别自动作业的失败率、跟踪审批工作流中的驳回循环，并查看哪些活动待处理、哪些已完成，从而监控结账的实时进度。重要性跟踪状态有助于发现异常、失败和返工循环，了解流程的质量与可靠性。获取途径此信息通常位于Oracle Fusion Financials模块中交易标头或行项目的状态字段。示例已完成进行中已批准已拒绝错误
	目标完成日期 TargetCompletionDate	某项活动或整个期间结账的计划截止日期。
说明此属性记录结账流程关键里程碑的预期完成日期，日期由结账日历或内部SLA规定。它是衡量实际绩效的基准。此日期是“结账截止日期达成情况”仪表板和“按时结账率”KPI的基础。系统可将实际完成时间（EventTime）与目标日期进行比较，自动标记延误并衡量进度达成情况，帮助结账流程按计划执行。重要性此属性支持衡量按时完成情况和截止日期达成情况，这对于及时出具财务报告至关重要。获取途径此信息通常由结账管理工具维护，也可能来自Oracle Financials中的自定义结账日历配置。示例 2023-01-31T23:59:59Z2023-02-02T17:00:00Z2023-02-28T23:59:59Z
	结束时间 EndTime	表示活动完成时间的时间戳。
说明结束时间记录活动完成的准确日期和时间。开始时间标记活动起点，结束时间标记活动完成时间，两者可用于精确计算耗时。此属性对于计算各项活动的处理时间至关重要。分析人员通过结束时间减去开始时间，可以准确找出期间结账流程中最耗时的步骤，直接定位瓶颈和低效环节。重要性此属性可用于计算活动处理时间，是识别瓶颈和衡量运营效率的基础。获取途径与开始时间类似，此信息通常位于Oracle Fusion Financials交易表的最后更新日期字段或特定完成日期字段中。示例 2023-01-28T09:05:10Z2023-02-01T15:00:00Z2023-02-03T11:45:30Z
	责任用户 ResponsibleUser	执行活动的用户或员工。
说明此属性用于识别负责执行特定任务的用户，例如批准对账的会计人员或生成财务报表的财务总监。通常与用户ID或员工姓名关联。分析责任用户有助于了解工作负荷分布、识别培训需求并评估团队或个人绩效。这对于构建监控工作负荷平衡的仪表板至关重要，也有助于确保在结账高峰期合理分配任务。重要性此属性对于分析工作负荷分布、资源分配以及发现自动化或培训机会至关重要。获取途径此信息通常可在Oracle Fusion Financials交易记录（如日记账分录或对账对象）的“创建者”或“最后更新者”字段中找到。示例 john.doejane.smithcontroller_ussarah.jones
	部门 Department	与活动或案例相关的业务部门或成本中心。
说明此属性用于标明负责或参与期间结账活动的部门，例如“企业会计”“FP&A”或“内部审计”，为流程提供组织层面的背景。按部门划分流程是一种有效的分析方法。它可以比较不同业务单元的结账效率，了解部门间交接如何影响时间安排，并分析各部门的工作负荷分布。重要性此属性可用于比较组织不同部门的流程，帮助发现最佳实践并统一流程。获取途径此属性可根据用户资料、总账账户的成本中心段，或Oracle Fusion Financials中的法人实体组织结构推导。示例企业会计应付账款资金管理FP&A
	国家/地区 Country	法律实体或公司代码所属的国家/地区。
说明此属性指定法律实体运营所在的国家/地区，为期间结账流程提供地理背景。按国家/地区分析流程，可以发现当地法定要求、业务实践或区域共享服务中心绩效造成的差异，也有助于进行区域对标，了解地区差异对流程效率的影响。重要性此属性支持按地区分析结账流程，突出显示当地法规或区域团队绩效造成的差异。获取途径此信息通常根据Oracle Fusion Financials中的法律实体或业务单元配置得出。示例 USA德国日本巴西
	总账账户 GLAccountNumber	正在对账或记账的总账账户编号。
说明此属性提供活动涉及的具体总账账户编号，例如对账或调整分录。它能为财务分析提供更细致的信息。此属性用于分析调整分录数量和单个账户的对账绩效，帮助找出经常需要调整或对账耗时较长的问题账户，这些情况可能表明子流程存在潜在问题。重要性通过细化视图，找出持续需要调整或对账延误的问题账户。获取途径这是GL_JE_LINES等总账表中的基础字段，也是对账流程的核心字段。示例 111001401000625003212001
	日记账分录ID JournalEntryId	日记账分录的唯一标识符。
说明此属性是系统为总账日记账分录生成的唯一ID，尤其适用于手动记账或调整分录相关活动。此ID用于在日记账分录的整个生命周期中跟踪单条分录，尤其是调整分录。它有助于统计调整数量，并将返工追溯到具体的财务记账。重要性此属性可跟踪具体的财务记账，对于审计以及分析调整分录的数量和性质至关重要。获取途径这是GL_JE_HEADERS表中的主键，通常命名为JE_HEADER_ID。示例 JE1002345JE1002378JE1002412
	日记账分录金额 JournalEntryAmount	日记账分录的借方或贷方总额。
说明此属性记录日记账分录的金额，可表示调整、应计或其他财务记账的金额大小。分析调整分录金额有助于了解流程错误或异常造成的财务影响。金额较大或频繁发生的调整可能表明控制存在重大缺陷，或存在需要立即处理的问题。将金额纳入分析，也能进一步评估日记账分录的重大性。重要性此属性有助于评估调整的财务影响和重大性，区分轻微更正与重大的财务报表重述。获取途径此值需要通过汇总GL_JE_LINES表中指定日记账分录的借方金额计算得出。示例 15000.00250.75125000.50
	是否为公司间交易 IsIntercompanyTransaction	用于标记交易是否发生在同一公司内的两个不同法律实体之间。
说明此布尔属性（true/false）用于识别涉及公司间合作方的交易或对账。这类活动通常更复杂，也更容易出现不匹配和延误。此标记是“公司间对账流程”仪表板和“公司间对账率”KPI的重要依据。它可用于单独分析这一子流程，识别跨实体交易中的特有瓶颈，并提高合并财务报表的准确性。重要性此属性可单独识别复杂且容易出现问题的公司间对账流程，便于开展针对性分析和优化。获取途径可从Oracle的专用公司间模块（AGIS）中识别，也可分析日记账分录：如果各行或平衡段中的公司代码段不同，则可能属于公司间交易。示例 truefalse
	是否为返工 IsRework	用于识别返工活动的计算标记。
说明此布尔属性根据流程顺序得出，用于标记表示返工的活动。期间结账中的一个常见例子是：同一账户在“对账已批准”之后又发生“调整分录已过账”，这可能表明对账不充分。此属性用于量化返工的频率和影响，而返工是造成效率低下的主要原因之一。通过识别和分析返工循环，组织可以诊断错误的根本原因，例如培训不足或流程不完善，并采取纠正措施。重要性此属性通过标记纠正先前工作的活动，直接量化流程低效情况，帮助找出错误的根本原因。获取途径可在流程挖掘工具中定义返工模式来计算，例如将“审批”后接“更正”设为返工模式。示例 truefalse
	是否按时完成 IsOnTime	用于标记活动是否在目标日期前完成的计算字段。
说明此布尔属性将活动的实际完成时间戳（EventTime或EndTime）与计划截止日期（TargetCompletionDate）进行比较。按时或提前完成时值为true，延误时值为false。此属性以简单明了的方式衡量进度达成情况，也是“按时结账率”KPI的依据。它有助于快速发现导致错过截止日期的瓶颈，并为管理者提供清晰的指标，以监控结账日历的执行情况。重要性此属性以清晰的二元值衡量进度达成情况，便于跟踪关键结账截止日期的执行情况。获取途径在数据转换过程中，通过比较EventTime和TargetCompletionDate计算得出（EventTime <= TargetCompletionDate）。示例 truefalse
	期间结账周期时间 PeriodCloseCycleTime	整个期间结账流程从开始到结束所需的总时间。
说明这是按案例计算的指标，表示一个财务期间结账所需的总时长。计算方法是：指定财务期间内最后一项活动的时间戳减去第一项活动的时间戳。这是记录到报告流程的核心关键绩效指标（KPI），用于衡量端到端流程的整体效率，并跟踪旨在加快结账速度的改进举措。重要性此KPI衡量结账流程的端到端效率，是财务高层关注的重点。获取途径在流程挖掘工具中按案例计算，方法是用案例中最晚的StartTime减去最早的StartTime。示例 P5D4HP7D12HP4D20H
	账簿 LedgerName	交易和余额所属账簿的名称。
说明在Oracle Fusion Financials中，账簿是按照会计科目表、日历和币种定义的财务交易记录。账簿可以是法人实体的主账簿，也可以是用于不同会计准则的次级账簿或报告账簿。按账簿分析有助于了解因会计要求不同而存在差异的流程，例如IFRS与US GAAP。它有助于确保流程符合各项报告准则的要求，并保持高效。重要性此属性提供重要的会计背景信息，可按不同会计准则或报告要求划分分析结果。获取途径此属性与财务数据一同存储在核心总账表中，通常通过GL_JE_HEADERS和GL_BALANCES等表中的LEDGER_ID引用。示例 US主账簿UK主账簿IFRS报告账簿

必填建议填写选填

记录到报告流程：期间关账与对账活动

以下是建议记录在事件日志中的关键流程步骤和里程碑，可帮助您准确发现并分析财务关账流程。

6 建议填写 8 选填

	活动	说明
	对账已批准	表示审核人员已正式批准账户对账，确认其准确、完整。这是对账工作流完成的重要里程碑。
重要性批准标志着账户对账周期结束。这是衡量对账绩效和启动后续结账步骤的关键里程碑。获取途径在Oracle ARCS中，获授权审核人员将对账状态更新为“Approved”或“Closed”时，会记录此明确事件及其时间戳。采集从对账系统审计跟踪中状态变为“Approved”时的时间戳获取。事件类型 explicit
	期间已开启	标记特定会计期间正式开始结账。通常由获授权用户在总账模块中执行明确操作，以允许过账交易。
重要性此活动是期间结账案例的明确开始事件。它对于衡量期间结账总周期时间以及识别结账启动延迟至关重要。获取途径当期间状态变为“Open”时，总账模块会记录此事件。相关信息可在GL_PERIOD_STATUSES表中找到，该表记录每个期间的状态和时间戳。采集从GL_PERIOD_STATUSES中财务期间的状态变更日志获取。事件类型 explicit
	期间已永久关闭	标志着总账中的会计期间最终且不可逆地关闭。执行此操作后，期间无法重新打开，也不能再进行任何更改。
重要性此活动是期间结账案例的明确结束事件。它提供衡量结账总周期时间的最终时间戳，并确保报告数据完整。获取途径这是一个明确的操作，会将GL_PERIOD_STATUSES表中的期间状态更新为“Permanently Closed”。系统会记录此操作及其时间戳。采集从GL_PERIOD_STATUSES中财务期间变为“Permanently Closed”的状态变更日志获取。事件类型 explicit
	调整日记账分录已过账	表示将手工日记账分录过账到总账，以更正余额、记录应计项目或调整对账中发现的其他问题。每笔过账都是单独记录的交易。
重要性调整分录数量较多，尤其是在对账获批后，通常意味着存在返工或上游流程问题。跟踪这些分录是改善数据质量的关键。获取途径记录在GL_JE_HEADERS和GL_JE_LINES表中。通常可根据日记账类别或来源识别调整分录，其值一般为“Manual”或“Adjustment”。采集根据期间内类别为“Adjustment”的日记账分录创建日期和过账日期识别。事件类型 explicit
	财务报表已生成	此事件标志着主要财务报表已生成，例如利润表、资产负债表和现金流量表。通常由用户发起，后续由系统处理。
重要性这是一个重要里程碑，标志着数据处理阶段结束，最终审核和审批阶段开始。衡量财务报表审批时间时，此事件至关重要。获取途径可根据财务报告作业成功完成情况，或Oracle Fusion报告工具（如Financial Reporting Studio或Narrative Reporting）中已发布报告的创建时间戳推断。采集根据生成最终报告包的计划作业完成时间戳推断。事件类型 inferred
	账户对账已开始	此事件表示特定总账账户或一组账户开始对账。通常可根据对账的首项操作推断，例如分配给编制人员或首次变更状态。
重要性这标志着一个关键且通常耗时较长的子流程开始。衡量从此事件到审批的用时，有助于计算对账周期时间并识别积压。获取途径在Oracle Account Reconciliation Cloud Service（ARCS）中，可根据对账状态变为“Open with Preparer”或类似初始状态的时间戳推断此事件。采集根据该期间特定账户对账从“Pending”或“New”状态变更后的最早时间戳推断。事件类型 inferred
	公司间对账已完成	表示同一组织内不同法人实体之间的交易已完成对账。这是一项专门的对账活动，用于确保公司间余额相抵为零。
重要性公司间对账经常导致结账延迟，流程也较为复杂。准确掌握其耗时，有助于优化合并报告中的关键路径活动。获取途径当期间的公司间对账状态变为“Reconciled”或“Closed”时，可从公司间交易模块或ARCS中捕获此事件。采集根据该期间公司间对账批次被标记为完成时的时间戳推断。事件类型 inferred
	合并流程已执行	表示执行合并例程，将多个子公司或业务单元的财务数据汇总为母公司的一套财务报表。这是一个单独记录的流程。
重要性对于拥有多个实体的组织，合并是一项关键且复杂的步骤。跟踪其执行情况和耗时，对于了解集团层面的结账时间安排至关重要。获取途径在Oracle Financial Consolidation and Close Cloud（FCCS）中，合并规则和流程的执行会记录开始和结束时间戳。可从作业调度程序提取这些数据。采集从FCCS模块中的合并作业或业务规则执行日志获取。事件类型 explicit
	子分类账期间已关闭	表示应付账款、应收账款和资产等子分类账已完成本期结账。此操作会阻止新交易过账到子分类账，也是关闭总账的前提。
重要性子分类账关闭延迟是常见瓶颈，会直接影响总账结账的启动。跟踪此活动有助于尽早定位流程中的延迟来源。获取途径从Oracle Fusion Financials中各子分类账会计期间的状态变更记录获取。通常，各子分类账模块都会记录带时间戳的状态变更。采集根据子分类账期间状态表中指定应用（例如应付账款、应收账款）的“Closed”状态推导。事件类型 explicit
	对账已提交审核	此活动标志着账户对账从编制人员移交给负责审核和批准的人员。通常，对账工具中会明确记录状态变更。
重要性此交接环节可能出现等待或形成瓶颈。分析提交到批准之间的用时，有助于发现审核周期中的延迟，并为资源分配提供依据。获取途径当Oracle ARCS中的对账状态从“Preparation”变为“Pending Review”或“Submitted”时捕获此事件。状态变更会记录时间戳。采集根据对账系统中状态变为“Pending Approval”或等效状态时的时间戳确定。事件类型 explicit
	日记账分录已导入	此活动表示将汇总后的子分类账交易和其他外部数据导入总账，为对账和调整整合财务数据。
重要性跟踪数据导入是否完成，是了解数据收集周期时间的关键。这标志着总账已包含结账流程继续推进所需的原始数据。获取途径可通过GL_JE_BATCHES和GL_IMPORT_REFERENCES表中成功完成的日记账导入流程识别，并按相关会计期间筛选。采集根据日记账批次的创建日期识别，来源字段应显示为子分类账导入或外部导入。事件类型 explicit
	期间状态设为“Closed”	这是最后一个可撤销步骤：将总账期间状态改为“Closed”。除非重新打开期间，否则无法再向该期间过账新的日记账分录。
重要性此活动标志着会计期间结账在操作层面结束，但并非不可逆的最终步骤。它是合规与控制的重要里程碑。获取途径 GL_PERIOD_STATUSES表会明确记录此状态变更，包括用户、时间戳以及期间的新状态“Closed”。采集从GL_PERIOD_STATUSES中财务期间变为“Closed”的状态变更日志获取。事件类型 explicit
	试算平衡表已生成	此活动表示已生成本期试算平衡表报告。这是准备最终财务报表前的重要检查点，用于确保借方总额等于贷方总额。
重要性首次成功生成试算平衡表是一个重要里程碑，表明主要调整可能已完成。这是进入最终报告阶段前的关键步骤。获取途径可根据“Trial Balance Report”并发请求或计划流程成功完成推断。系统会记录这些作业的执行时间。采集根据系统流程调度程序日志中试算平衡表报告生成作业的完成时间戳推断。事件类型 inferred
	财务报表已审核	表示管理层已完成对生成的财务报表的审核。这通常是人工流程，可能需要根据相关系统活动或人工输入推断其记录。
重要性审核周期通常占结账“最后阶段”的很大一部分。跟踪此环节有助于发现管理层审核延迟，缩短整体报告周期。获取途径此事件难以直接捕获。可以根据叙述性报告工具中的报告状态变更时间戳，或工作流工具中的明确审批任务推断。采集可能需要根据其他系统事件推断，例如BPM工作流中的审批任务完成记录，或人工录入。事件类型 inferred

建议填写选填

数据提取指南

如何从Oracle Fusion Financials获取数据

步骤

准备工作：确保已安装Python 3.6或更新版本。使用pip安装所需库：pip install requests pandas。获取Oracle Fusion基础URL（例如https://[your-fusion-instance].oraclecloud.com），并为具有适当数据访问权限的用户账户准备安全API凭据。该用户应具有“财务分析师”和“总账经理”等角色。
配置脚本：将提供的Python脚本复制到文件中，例如extract_r2r.py。将BASE_URL、USERNAME和PASSWORD的占位值替换为您的Oracle Fusion环境信息。
设置提取参数：调整脚本中的START_DATE和END_DATE变量，确定数据提取的时间范围。建议先选择较短的时间段，例如三个月，以便控制数据量。
运行脚本：在终端中运行命令python extract_r2r.py。脚本将通过Oracle Fusion REST API进行身份验证，并开始获取各项指定活动的数据。
监控运行情况：脚本会在获取各类活动数据时向控制台输出进度信息。所需时间可能较长，具体取决于日期范围和数据量。请留意可能表示身份验证失败或API异常的错误信息。
获取数据并处理分页：脚本会自动处理分页，反复调用API端点，直至获取指定日期范围内的所有记录。它会收集全部14项所需活动的数据。
转换并整合数据：对于从API获取的每条记录，脚本都会将其转换为标准格式，并将JSON字段映射到所需的事件日志列，例如FinancialPeriod、ActivityName和EventTime。所有活动都会汇总到同一数据结构中。
添加元数据列：获取并转换全部数据后，脚本会添加SourceSystem和LastDataUpdate列，用于说明数据来源并跟踪数据时效性。
导出事件日志：最终整合的数据集将导出为oracle_fusion_r2r_event_log.csv，并保存在脚本所在目录。
检查并上传：在电子表格应用中打开生成的CSV文件，检查数据是否完整、准确。上传到ProcessMind前，请确认所有列均存在且已按预期填充。

配置

身份验证：脚本使用基本身份验证。在生产环境中，为增强安全性，强烈建议修改脚本以使用OAuth 2.0，这需要在Oracle Identity Cloud Service中设置机密应用程序。
API端点：脚本主要使用Financials REST API资源，包括用于查询期间状态的glPeriods和用于查询日记账分录详情的journalBatches。对于标准REST端点未涵盖的活动（如报告生成），脚本会查询Enterprise Scheduler Service（ESS）作业历史记录。
日期范围：脚本中的START_DATE和END_DATE参数用于控制提取时间范围。首次分析建议使用3至6个月的范围，以控制数据量和脚本运行时间。
筛选：脚本在API请求中加入q参数，根据lastUpdateDate筛选数据。您可以添加其他筛选条件缩小范围，例如按特定LedgerId筛选，以指定单个公司或法人实体。
分页：API调用中的limit参数设为每次请求500条记录，以提升性能并避免超时。脚本会自动循环翻页，获取完整数据集。
前提条件：需要访问Oracle Fusion Financials环境。用于提取数据的用户账户必须具备通过REST API读取总账数据所需的安全角色和权限。

查询示例 python

import requests
import pandas as pd
from datetime import datetime
import os

class=class="hl-string">"hl-comment"># --- Configuration ---
class=class="hl-string">"hl-comment"># Replace with your Oracle Fusion instance details
BASE_URL = class="hl-string">"https://[your-fusion-instance].oraclecloud.com"
USERNAME = os.environ.get(class="hl-string">"FUSION_USER", class="hl-string">"your_username")
PASSWORD = os.environ.get(class="hl-string">"FUSION_PASSWORD", class="hl-string">"your_password")

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

class=class="hl-string">"hl-comment"># --- Generic API Fetch Function ---
def fetch_data(endpoint, q_filter, fields):
    all_items = []
    offset = 0
    limit = 500
    url = fclass="hl-string">"{BASE_URL}{endpoint}"
    
    headers = {
        class="hl-string">'Content-Type': class="hl-string">'application/vnd.oracle.adf.resourceitem+json'
    }
    
    while True:
        params = {
            class="hl-string">'q': q_filter,
            class="hl-string">'fields': fields,
            class="hl-string">'limit': limit,
            class="hl-string">'offset': offset,
            class="hl-string">'onlyData': class="hl-string">'true'
        }
        try:
            response = requests.get(url, auth=(USERNAME, PASSWORD), headers=headers, params=params)
            response.raise_for_status()
            data = response.json()
            items = data.get(class="hl-string">'items', [])
            all_items.extend(items)
            
            if not data.get(class="hl-string">'hasMore', False):
                break
            offset += limit
        except requests.exceptions.RequestException as e:
            print(fclass="hl-string">"Error fetching data from {endpoint}: {e}")
            break
            
    return all_items

class=class="hl-string">"hl-comment"># --- Main Extraction Logic ---
def main():
    event_log = []
    now_utc = datetime.utcnow().isoformat() + class="hl-string">'Z'
    date_filter = fclass="hl-string">"lastUpdateDate between '{START_DATE}T00:00:00.000Z' and '{END_DATE}T23:59:59.999Z'"

    class=class="hl-string">"hl-comment"># 1. Period Opened, Closed, Permanently Closed
    print(class="hl-string">"Fetching Period Status changes...")
    period_data = fetch_data(class="hl-string">'/fscmRestApi/resources/11.13.18.05/glPeriods', date_filter, class="hl-string">"periodName,periodStatus,lastUpdateDate,lastUpdatedBy,ledgerName,ledgerId")
    for p in period_data:
        activity_map = {
            class="hl-string">'OPEN': class="hl-string">'Period Opened',
            class="hl-string">'CLOSED': class="hl-string">'Period Set to \'Closed\class="hl-string">'',
            class="hl-string">'PERMANENTLY_CLOSED': class="hl-string">'Period Permanently Closed'
        }
        activity_name = activity_map.get(p.get(class="hl-string">'periodStatus'))
        if activity_name:
            event_log.append({
                class="hl-string">'FinancialPeriod': p.get(class="hl-string">'periodName'),
                class="hl-string">'ActivityName': activity_name,
                class="hl-string">'EventTime': p.get(class="hl-string">'lastUpdateDate'),
                class="hl-string">'EndTime': p.get(class="hl-string">'lastUpdateDate'),
                class="hl-string">'ResponsibleUser': p.get(class="hl-string">'lastUpdatedBy'),
                class="hl-string">'CompanyCode': p.get(class="hl-string">'ledgerId'),
                class="hl-string">'ActivityStatus': class="hl-string">'Completed',
                class="hl-string">'JournalEntryType': None,
                class="hl-string">'ReconciliationType': None,
                class="hl-string">'Department': None,
                class="hl-string">'TargetCompletionDate': None
            })
            
    class=class="hl-string">"hl-comment"># 2. Subledger Period Closed
    print(class="hl-string">"Fetching Subledger Period Close status...")
    class=class="hl-string">"hl-comment"># This is inferred from the GL period's closingStatus property.
    class=class="hl-string">"hl-comment"># A status of class="hl-string">'C' (Closed) or class="hl-string">'W' (Close pending) in sub-fields often indicates subledger closure.
    class=class="hl-string">"hl-comment"># For a more direct approach, specific subledger period APIs would be needed.
    subledger_period_data = fetch_data(class="hl-string">'/fscmRestApi/resources/11.13.18.05/glPeriods', date_filter, class="hl-string">"periodName,closingStatus,lastUpdateDate,lastUpdatedBy,ledgerName,ledgerId")
    for p in subledger_period_data:
        if p.get(class="hl-string">'closingStatus') in [class="hl-string">'C', class="hl-string">'W']:
            event_log.append({
                class="hl-string">'FinancialPeriod': p.get(class="hl-string">'periodName'),
                class="hl-string">'ActivityName': class="hl-string">'Subledger Period Closed',
                class="hl-string">'EventTime': p.get(class="hl-string">'lastUpdateDate'),
                class="hl-string">'EndTime': p.get(class="hl-string">'lastUpdateDate'),
                class="hl-string">'ResponsibleUser': p.get(class="hl-string">'lastUpdatedBy'),
                class="hl-string">'CompanyCode': p.get(class="hl-string">'ledgerId'),
                class="hl-string">'ActivityStatus': class="hl-string">'Completed',
                class="hl-string">'JournalEntryType': None,
                class="hl-string">'ReconciliationType': None,
                class="hl-string">'Department': None,
                class="hl-string">'TargetCompletionDate': None
            })

    class=class="hl-string">"hl-comment"># 3. Journal Entries Imported & 8. Adjusting Journal Entry Posted
    print(class="hl-string">"Fetching Journal Entries...")
    journal_filter = fclass="hl-string">"actualFlag='A' and postedDate between '{START_DATE}' and '{END_DATE}'"
    journal_data = fetch_data(class="hl-string">'/fscmRestApi/resources/11.13.18.05/journalBatches', journal_filter, class="hl-string">"journalBatchName,postedDate,createdBy,jeSource,jeCategory,periodName,ledgerId")
    for j in journal_data:
        class=class="hl-string">"hl-comment"># Imported journals often come from specific sources like class="hl-string">'Payables', class="hl-string">'Receivables', etc.
        if j.get(class="hl-string">'jeSource') not in [class="hl-string">'Manual']:
            activity_name = class="hl-string">'Journal Entries Imported'
            entry_type = class="hl-string">'Imported'
        else:
            activity_name = class="hl-string">'Adjusting Journal Entry Posted'
            entry_type = class="hl-string">'Adjusting'
        event_log.append({
            class="hl-string">'FinancialPeriod': j.get(class="hl-string">'periodName'),
            class="hl-string">'ActivityName': activity_name,
            class="hl-string">'EventTime': j.get(class="hl-string">'postedDate'),
            class="hl-string">'EndTime': j.get(class="hl-string">'postedDate'),
            class="hl-string">'ResponsibleUser': j.get(class="hl-string">'createdBy'),
            class="hl-string">'CompanyCode': j.get(class="hl-string">'ledgerId'),
            class="hl-string">'ActivityStatus': class="hl-string">'Completed',
            class="hl-string">'JournalEntryType': entry_type,
            class="hl-string">'ReconciliationType': None,
            class="hl-string">'Department': None,
            class="hl-string">'TargetCompletionDate': None
        })

    class=class="hl-string">"hl-comment"># 4, 5, 6, 7. Reconciliation Activities (Placeholder - requires ARCS or equivalent module)
    print(class="hl-string">"Fetching Reconciliation activities (Placeholder)...")
    class=class="hl-string">"hl-comment"># These activities are typically in Oracle ARCS. The endpoint below is a professional placeholder.
    class=class="hl-string">"hl-comment"># You would need to use the ARCS REST API if you have that module.
    class=class="hl-string">"hl-comment"># Example endpoint: /armRestApi/v1/reconciliations

    class=class="hl-string">"hl-comment"># 9, 10, 11. Report Generation and Consolidation (via ESS Jobs)
    print(class="hl-string">"Fetching ESS Job history for reports and consolidation...")
    ess_filter = fclass="hl-string">"(jobDefinitionName like '%TrialBalance%' or jobDefinitionName like '%Consolidation%' or jobDefinitionName like '%FinancialStatement%') and lastUpdateDate between '{START_DATE}T00:00:00.000Z' and '{END_DATE}T23:59:59.999Z'"
    class=class="hl-string">"hl-comment"># Note: The ESS job history endpoint is often accessed via SOAP APIs or specific REST resources.
    class=class="hl-string">"hl-comment"># The below is a representation of what such a query might look like.
    class=class="hl-string">"hl-comment"># A common method is a BI Publisher report on ESS tables, exposed as a REST service.
    
    class=class="hl-string">"hl-comment"># 12. Financial Statements Reviewed
    class=class="hl-string">"hl-comment"># This is often a manual step and may not be logged in a standard way. It could be a specific ESS job
    class=class="hl-string">"hl-comment"># status change, a custom object, or inferred from a subsequent action.

    class=class="hl-string">"hl-comment"># --- Final Data Processing ---
    if not event_log:
        print(class="hl-string">"No events found for the specified criteria.")
        return

    df = pd.DataFrame(event_log)
    df[class="hl-string">'SourceSystem'] = class="hl-string">'Oracle Fusion Financials'
    df[class="hl-string">'LastDataUpdate'] = now_utc

    class=class="hl-string">"hl-comment"># Reorder and fill missing columns
    final_cols = [class="hl-string">'FinancialPeriod', class="hl-string">'ActivityName', class="hl-string">'EventTime', class="hl-string">'EndTime', class="hl-string">'ResponsibleUser', class="hl-string">'Department', class="hl-string">'CompanyCode', class="hl-string">'ReconciliationType', class="hl-string">'ActivityStatus', class="hl-string">'JournalEntryType', class="hl-string">'TargetCompletionDate', class="hl-string">'SourceSystem', class="hl-string">'LastDataUpdate']
    for col in final_cols:
        if col not in df.columns:
            df[col] = None
    df = df[final_cols]
    
    class=class="hl-string">"hl-comment"># Sort by time
    df[class="hl-string">'EventTime'] = pd.to_datetime(df[class="hl-string">'EventTime'])
    df = df.sort_values(by=[class="hl-string">'FinancialPeriod', class="hl-string">'EventTime']).reset_index(drop=True)

    df.to_csv(class="hl-string">'oracle_fusion_r2r_event_log.csv', index=False)
    print(class="hl-string">"Extraction complete. Event log saved to oracle_fusion_r2r_event_log.csv")

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

准备好开始了吗？

此数据模板为您优化记录到报告流程：期间关账与对账奠定基础。利用这些洞察发现瓶颈，提升财务运营效率。

返回改进指南

下载模板

立即改进您的记录到报告流程：期间关账

将R2R周期时间缩短30%，消除瓶颈并提升准确性。

开始免费试用

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

您的记录到报告流程：期间关账与对账数据模板

您的记录到报告流程：期间关账与对账数据模板

记录到报告流程：期间关账与对账属性

记录到报告流程：期间关账与对账活动

数据提取指南

使用Fusion Financials REST API通过Python提取数据

步骤

配置

查询示例 python

准备好开始了吗？

立即改进您的记录到报告流程：期间关账