> 持续流程改进 > 记录到报告流程：期间结账与对账 > Workiva > 数据模板

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

Workiva

← 返回改进指南

记录到报告：期间结账与对账属性(18) 记录到报告：期间结账与对账活动(14) 数据提取指南(3)

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

此模板为收集分析记录到报告：期间结账与对账流程所需的关键数据提供清晰指引。模板列出了需要收集的重要属性、需要跟踪的关键活动，以及从Workiva提取这些信息的实用说明。借助此资源，确保数据已准备就绪，可用于深入的流程分析与优化。

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

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

下载模板

记录到报告：期间结账与对账属性

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

5 必填 6 建议填写 7 选填

	名称	说明
	事件时间戳 EventTimestamp	记录特定活动或事件的准确日期和时间。
说明事件时间戳标记活动发生的时间，是正确排列事件顺序并计算事件间隔时长的基础。完整的事件日志会为每项活动记录时间戳，从“期间结账已启动”到“期间结账已完成”。此时间戳是流程挖掘中所有时间分析的基础，可用于计算周期时间、等待时间和处理时间。这些指标对于“期间结账端到端周期时间”和“对账瓶颈分析”等仪表板至关重要。准确的时间戳是开展有效流程分析的必要条件。重要性此属性提供事件的时间顺序，是计算周期时间等时间指标和识别流程延迟的必要依据。获取途径可在Workiva的事件日志、审计跟踪或交易记录中找到，对应任务的创建或完成时间。示例 2024-04-01T09:00:00Z2024-04-05T14:32:15Z2024-04-10T11:05:00Z
	活动名称 ActivityName	期间结账流程中发生的具体任务或事件名称。
说明活动名称用于描述记录到报告工作流中的步骤，例如“源数据已导入”或“对账已提交审核”。这些活动构成流程图的基本要素，并带有时间戳以显示事件顺序。分析活动是流程挖掘的基础，有助于直观呈现流程、识别任务顺序、发现与标准程序的偏差，并衡量每个步骤的频率和耗时。这对于找出瓶颈、返工循环和自动化机会至关重要。重要性此属性构成流程图的核心，可用于直观呈现和分析结账周期中的步骤顺序。获取途径通常可在Workiva的审计跟踪、任务管理或工作流日志中找到，并与具体的结账或对账任务相关联。示例期间结账已启动提交对账以供审核调整分录已过账财务报表已生成
	财务期间 FinancialPeriod	特定财务报告周期（如月份或季度）的唯一标识符，也是期末结账流程的案例标识。
说明财务期间是主要案例标识符，用于汇总特定时间范围内与结账相关的所有活动。例如，“2024-Q1”或“2024-03”代表一个案例。在流程挖掘中，按财务期间分析可全面了解整个记录到报告周期。通过比较不同期间的结账流程，您可以发现趋势、衡量周期时间的改善情况，并找出反复出现的瓶颈。将每个期间视为一个案例，组织便可分析流程变体，以及流程随时间推移与标准程序的一致性。重要性这是重要的案例标识符，为分析提供范围，可端到端衡量并比较每个期间的结账周期。获取途径通常根据Workiva财务报告或结账管理模块中的报告期间信息得出。具体字段名称请参阅Workiva文档。示例 2024-032024年第一季度2023财年P122024年4月
	上次数据更新 LastDataUpdate	表示流程数据最近一次刷新的时间戳。
说明此属性记录数据集最近一次从源系统更新的时间，是每次刷新时应用于整个数据集的元数据字段。在仪表板中显示上次数据更新时间戳是一项良好实践，可让用户了解所分析数据的新鲜度，合理判断分析结果的时效性，也有助于运营监控。重要性此属性可告知用户数据的时效性，帮助他们了解分析背景以及信息最近一次刷新的时间。获取途径数据管道或ETL工具会在提取数据时生成并存储此信息。示例 2024-05-10T08:00:00Z2024-05-09T08:00:00Z
	源系统 SourceSystem	事件数据最初来源的系统。
说明此属性用于识别生成数据的应用程序或平台。本次分析的数据主要来自“Workiva”，也可用于区分从ERP等其他系统导入的数据。在多系统环境中，了解源系统是掌握数据沿袭和评估数据质量的关键。发现数据不一致时，它有助于分析根本原因，也能为活动的执行方式提供背景信息。重要性此属性提供数据来源的重要背景信息，有助于验证数据并了解流程所处的技术环境。获取途径通常在数据提取和转换过程中设置此值，用于标记记录来源。示例 WorkivaSAP S/4HANAOracle NetSuite
	公司代码 CompanyCode	执行财务结账的法律实体的唯一标识符。
说明公司代码代表组织内的特定法律实体。合并之前，通常会按公司代码分别执行财务结账流程。此属性对于筛选和比较不同法律实体的流程至关重要。它支持“对账状态与账龄”仪表板，可将分析逐级下钻至具体公司，帮助发现某些实体是否经常延迟或调整率较高，从而定位实体特有的流程或数据问题。重要性此属性支持比较组织内不同法律实体的结账效率和合规情况。获取途径此属性与Workiva中的财务数据、账户和交易相关联，可能继承自源ERP系统。示例 1000US01DE015400
	对账状态 ReconciliationStatus	账户对账的当前状态。
说明此属性跟踪对账在工作流中的状态，例如“已打开”“进行中”“待审批”或“已批准”，可呈现对账活动的当前进度。这是“对账状态与账龄”仪表板的关键属性。经理可借此监控未完成和进行中的事项，识别停滞的对账，并优先安排工作以确保按时完成。跟踪状态随时间的变化，也有助于发现事项长时间等待、无法进入下一状态的瓶颈。重要性此属性支持实时监控对账进度，帮助发现并处理停滞事项，确保结账按计划推进。获取途径这是Workiva对账或结账管理模块中的核心属性。示例已打开已编制已提交审核已批准已拒绝
	对账类别 ReconciliationCategory	正在对账的账户类别或类型，例如银行账户或公司间账户。
说明此属性将总账账户归入不同类别，以便进行更高层级的分析。例如“现金”“固定资产”“应计项目”和“公司间账户”。此分类有助于了解不同类型对账的流程绩效。在“对账瓶颈分析”中，按对账类别筛选至关重要。此分析有助于判断延迟是否集中在特定领域，例如公司间对账是否总比银行对账耗时更长。根据这些发现，团队可针对各类别的具体问题制定改进措施。重要性此属性支持汇总和比较不同账户类型的对账绩效，揭示特定类别的瓶颈。获取途径此属性可能属于会计科目表主数据，由Workiva管理或继承自ERP。示例银行账户公司间账户固定资产应计项目预付费用
	总账账户 GLAccount	正在对账或调整的总账账户编号。
说明此属性指定对账或日记账分录涉及的总账账户，可用于细致分析结账流程。按总账账户分析对于“对账瓶颈分析”和“对账状态与账龄”仪表板至关重要。此分析有助于找出问题最多的具体账户，例如对账耗时最长或需要最多调整的账户。团队可据此将改进工作集中在影响最大的领域，例如复杂账户或数据质量较差的账户。重要性此属性可细致呈现对账绩效，帮助识别导致延迟或需要频繁调整的问题账户。获取途径这是Workiva中任何对账或日记账分录数据的关键字段。示例 11010012105003410000012300-001
	负责人 ResponsibleUser	执行或受指派负责该活动人员的用户ID或姓名。
说明此属性用于识别期间结账流程中特定任务的责任人，例如编制对账的人员或批准对账的经理。它是分析工作量和绩效的基础。负责人是“期间结账工作量分布”仪表板的关键属性，可帮助经理了解任务在团队成员之间的分配情况、识别潜在的过劳风险，并确保资源分配均衡。如果特定用户反复参与返工循环或流程偏差，也可据此发现培训需求。重要性此属性支持分析工作量分布、用户绩效和资源分配，是管理团队效率的重要依据。获取途径通常可在Workiva的任务管理或工作流日志中找到，字段名称可能为“分配给”“所有者”或“完成者”。示例 j.doeasmithRobert.Paulsonuser123
	部门 Department	负责该活动的部门或职能团队。
说明此属性表示与用户或活动相关的业务单元或部门，例如“企业会计”或“内部审计”，可用于按更高层级汇总流程数据。按部门分析流程对于“期间结账工作量分布”仪表板，以及比较组织不同部门的流程绩效至关重要。此分析有助于发现部门内部的系统性问题、比较团队效率，并了解部门间交接对整体周期时间的影响。重要性此属性支持按业务领域细分流程分析，便于比较绩效并发现部门特有的问题。获取途径此信息可能存储在Workiva的用户档案中，也可能与任务元数据相关联。示例北美企业会计欧洲、中东和非洲共享服务内部审计财务规划与分析
	审批后调整 IsPostApprovalAdjustment	如果调整分录在相应对账获批后过账，则此计算标记为真。
说明此布尔标记根据事件顺序计算。对于指定账户和财务期间，如果“调整分录已过账”活动发生在“对账已审核并批准”活动之后，则标记为真；否则为假。此属性对于“对账后调整趋势”仪表板和“对账后调整率”KPI至关重要。此类事件数量较多，可能意味着控制不足、上游系统数据质量不佳或流程失效，并导致大量返工和合规风险上升。重要性此属性专门识别审批后发生的高风险调整，有助于衡量流程控制和数据质量问题。获取途径这不是源字段，而是由流程挖掘工具比较相关活动的时间戳后，根据逻辑计算得出。示例 truefalse
	拒绝原因 RejectionReason	审核过程中对账或财务报表被拒绝时提供的原因。
说明事项被拒绝时，审核人员通常会说明原因。此属性记录相关文本或代码，解释事项未达到审批标准的原因，例如“支持性文件不正确”或“计算错误”。分析拒绝原因有助于发现常见错误和返工来源。通过分类统计这些原因，管理层可以找出需要改进流程、加强编制人员培训或明确工作说明的领域。这些数据有助于减少返工循环并提高首次审批通过率。重要性此属性直接揭示返工和质量问题的根本原因，为有针对性的培训和流程改进提供依据。获取途径用户在Workiva工作流中执行“拒绝”操作时，相关信息通常会记录在备注字段或预设列表中。示例缺少支持文档计算错误期间错误违反政策
	日记账分录ID JournalEntryId	调整日记账分录的唯一标识符。
说明此属性为结账流程中过账的每笔日记账分录提供唯一ID，尤其适用于对账后进行的调整，可将具体调整追溯至其来源活动。跟踪日记账分录ID对于“对账后调整趋势”仪表板很重要。它有助于统计手动调整的数量，并调查流程后期录入的具体分录。此追溯能力是了解调整根本原因和提升初始数据质量的关键。重要性此属性为每项财务调整提供唯一参考，支持详细分析手动分录的数量、时间和原因。获取途径这是Workiva或源ERP中任何日记账分录数据的关键字段。示例 JE202404-00123ADJ-593029100004567
	是否自动执行 IsAutomated	用于标记活动由自动化系统还是人工用户执行。
说明此布尔属性用于区分系统自动执行的任务（例如数据导入或系统生成的报告）与用户手动执行的任务。此属性对于发现自动化机会至关重要。通过分析手动任务与自动化任务的比例及其处理时间，组织可以为自动化重复且耗时的步骤提供商业论证。它还可帮助准确衡量人工操作与系统处理的效率。重要性区分人工活动与系统活动，这对于发现自动化机会和衡量现有自动化的影响至关重要。获取途径可根据活动关联的用户ID（例如“system”或“bot”用户）推断，也可读取活动类型本身的特定标记。示例 truefalse
	期间结账周期时间 PeriodCloseCycleTime	单个财务期间从启动结账到完成结账所用的总时间。
说明此计算指标表示整个期间结账案例的端到端耗时。对于指定财务期间，用最后一个活动“期间结账已完成”的时间减去第一个活动“期间结账已启动”的时间即可得出。此属性是“期间结账端到端周期时间”仪表板及相应KPI的主要衡量指标。持续跟踪该指标，可帮助管理层了解流程改进的影响，并比较不同业务单元或时段的结账效率。这是衡量流程表现的重要高级指标之一。重要性这是衡量整个期间结账流程从开始到结束的整体效率和速度的关键绩效指标。获取途径流程挖掘工具会在案例层级计算此指标：对每个案例，用最晚结束时间减去最早开始时间。示例 P10DT5HP8DT12HP12D
	目标完成日期 TargetCompletionDate	计划完成期间结账的日期或截止日期。
说明目标完成日期是期间结账流程必须完成的内部或外部截止日期，可作为衡量实际绩效的基准。此日期是计算按时结账率KPI的必要依据。通过比较“期间结账已完成”活动的实际完成时间戳与目标日期，分析可判断结账是按时、提前还是延迟完成。这是衡量流程可靠性以及是否遵守财务报告时间要求的重要指标。重要性此属性是衡量是否按时完成的基准，也是评估结账流程可靠性和可预测性的关键指标。获取途径通常会在Workiva的结账管理或规划模块中为每个财务期间设置此日期。示例 2024-04-102024-01-152023-10-12
	调整金额 AdjustmentAmount	调整分录的金额。
说明此属性记录调整的财务金额，可用于了解结账过程中变更的重大程度。分析调整金额有助于优先调查对账后的调整。金额较大的调整可能表明基础数据或流程存在重大问题，需要立即关注。此属性还可用于计算“手动调整比例”KPI，从而按金额而非单纯按数量分析调整。重要性此属性有助于量化调整的财务影响，让团队根据重大程度确定调查优先级。获取途径 Workiva或已连接ERP中的分录数据表通常会包含此标准字段。示例 15250.75-500.00120000.00

必填建议填写选填

记录到报告：期间结账与对账活动

以下是需要记录在事件日志中的关键流程步骤和里程碑，可用于准确发现并优化财务结账流程。

7 建议填写 7 选填

	活动	说明
	对账已审核并批准	这是一个重要里程碑，表示经理或审核人员已正式批准编制完成的对账，确认其准确性。通常，任务变为“已批准”或“已完成”状态时会记录此活动。
重要性此活动对于计算平均对账周期时间和平均审核与审批周期时间至关重要，也标志着流程中的质量检查已完成。获取途径通常可根据对账任务的状态变化，或Workiva任务审计跟踪中的明确审批事件推断得出。采集记录状态变为“已批准”或“已认证”时的时间戳。事件类型 inferred
	期间结账已启动	此活动标志着特定期间财务结账流程正式开始。通常，用户在Workiva中创建或启动期间结账清单或流程工作流时，此活动便会触发。
重要性这是端到端流程的主要开始事件，可用于准确衡量期间结账端到端周期时间，并确定流程正式启动的时间。获取途径此事件可能根据Workiva中特定财务期间的主要期间结账流程对象、任务列表或工作流的创建时间推断得出。采集使用该财务期间父流程或清单的创建时间戳。事件类型 inferred
	期间结账已完成	此活动标志着该财务期间的记录到报告流程正式完成，也是Workiva工作流中的最后一步。
重要性这是流程的主要结束事件，可用于准确衡量期间结账端到端周期时间和按时结账率。获取途径可根据Workiva中上级期间结账流程、检查清单或工作流的完成时间戳推断得出，也可能通过手动更改状态记录。采集使用上级流程或结账检查清单中最后一个任务的完成时间戳。事件类型 inferred
	试算平衡表已编制	此里程碑表示试算平衡表已定稿，可用于生成财务报表。可根据特定任务完成或报告生成情况推断得出。
重要性这是生成财务报表的关键前提。衡量此节点之后的耗时，有助于分析报告最终阶段的效率。获取途径通常可根据Workiva检查清单中的“定稿试算平衡表”任务完成情况，或最终试算平衡表报告的生成时间戳推断得出。采集 “编制试算平衡表”任务完成或最终试算平衡表报告生成时的时间戳。事件类型 inferred
	调整分录已过账	表示根据对账过程中发现的问题创建并过账更正分录。Workiva可以跟踪日记账分录及其状态。
重要性此活动是对账后调整率KPI的重要依据。对账获批后仍有大量调整，可能表明源数据质量或流程控制存在问题。获取途径这通常是Workiva日记账分录模块中记录的明确事件，包含创建时间戳和表示已过账的状态。采集使用日记账分录状态变为“已过账”时的时间戳。事件类型 explicit
	财务报表已批准	高级管理层或审计委员会对财务报表的最终审批。这是该期间正式结账前的最后一个重要签署确认节点。
重要性这是表明报告已定稿的关键里程碑，也是衡量财务报表平均审核与审批周期时间的重要依据。获取途径通常通过电子签名、认证流程，或Workiva主要报告文档或任务的最终状态变为“已批准”来记录。采集财务报表最终审批状态变更或认证事件的时间戳。事件类型 inferred
	财务报表已生成	表示已创建财务报表草稿，例如资产负债表、利润表和现金流量表。Workiva生成报告文档时会记录此活动。
重要性此活动的时间对于财务报表生成滞后时间KPI至关重要，标志着流程从数据汇总转入最终报告编制阶段。获取途径可根据该期间Workiva平台中财务报表文档或报告的创建时间，或最近一次重大更新的时间戳推断得出。采集使用主要财务报表文档的创建时间或“上次更新”时间戳。事件类型 inferred
	对账被拒绝	审核人员发现已提交的对账存在问题，并退回给编制人员更正时，会发生此事件。任务状态变为“已拒绝”或“需要返工”时会记录此活动。
重要性跟踪拒绝情况对于识别返工循环、衡量一次通过率，以及找出反复出现质量问题的账户或编制人员至关重要。获取途径可根据对账任务状态变为“已拒绝”“已退回”或其他表示需要返工的状态时的时间戳推断得出。采集记录状态变为“已拒绝”或等效状态时的时间戳。事件类型 inferred
	开始公司间对账	标记具体且通常较复杂的公司间交易对账流程的开始。公司间对账模块或相关任务启动时，系统会记录此活动。
重要性公司间对账经常导致延迟。单独跟踪此活动有助于衡量其耗时，并识别此类交易特有的瓶颈。获取途径可根据Workiva工作流中专门用于公司间账户的任务状态变化推断得出。采集标记为“公司间”的任务变为“进行中”状态时的时间戳。事件类型 inferred
	开始账户对账	此活动表示编制人员已开始处理某个账户的对账。通常，当用户首次在Workiva流程中打开或认领对账任务时，系统会记录此活动。
重要性跟踪对账工作的开始时间，对于衡量编制人员的周期时间，以及识别任务分配与实际开始处理之间的延迟至关重要。获取途径可根据Workiva检查清单或工作流中对账任务状态首次从“未开始”变为“进行中”或类似状态的记录推断得出。采集检测对账任务状态首次变为“进行中”等活跃状态的时间戳。事件类型 inferred
	提交对账以供审核	编制人员完成对账工作并正式提交审批时，会发生此事件。在Workiva中，通常通过任务状态变化记录，例如状态变为“待审核”。
重要性此节点标记从编制人员到审核人员的交接，可用于衡量审核队列等待时间，也是分析审核与审批工作流效率的重要里程碑。获取途径可根据对账任务状态从“进行中”变为“待审核”或“已提交”时的时间戳推断得出。采集记录状态变为“待审核”或等效状态时的时间戳。事件类型 inferred
	期间重新打开	这是一项例外活动，表示已结账期间因补记延迟调整或更正而重新打开。期间状态从“已关闭”变为活跃状态时会记录此活动。
重要性这表明流程出现重大例外和返工。跟踪其发生频率有助于发现流程控制和结账最终性方面的潜在问题。获取途径可根据上级期间结账流程对象的状态变化推断得出，例如从已完成或已关闭状态退回到打开或进行中状态。采集检测期间对象的状态是否从“已关闭”变为“已打开”。事件类型 inferred
	源数据已导入	表示数据已从源ERP系统加载到Workiva平台。这可能包括试算平衡表数据、交易明细及对账所需的其他辅助明细表。
重要性数据延迟到位是常见的瓶颈。跟踪此活动有助于将数据集成问题与后续对账和报告工作区分开来。获取途径这可能是Workiva数据集成日志或审计跟踪中的明确事件，也可能根据对账任务开始前该期间最后一次数据更新的时间戳推断得出。采集该期间数据导入成功完成或ERP连接刷新成功完成的时间戳。事件类型 inferred
	财务报表已审核	用户或用户组审核已生成的财务报表，确认其准确性和完整性时，会发生此活动。可通过审核任务的状态更新记录。
重要性跟踪审核周期有助于了解最终审批阶段的延迟。此环节耗时过长会显著影响整体结账周期。获取途径可根据Workiva流程中审核任务的状态变化推断得出，例如从“待审核”变为“审核完成”或“已批准”。采集表示财务报表审核周期已完成的状态变化时间戳。事件类型 inferred

建议填写选填

数据提取指南

如何从Workiva获取数据

步骤

登录您的Workiva环境，在主应用切换器中进入流程部分。
在流程仪表板中，点击报告选项卡，进入报告界面。
点击创建按钮，选择流程报告以创建新报告。
在报告设置中，从可用流程列表中选择要分析的特定期末结账流程。例如，选择“2023年第三季度财务结账”。
进入报告生成器的列或数据部分。添加事件日志所需的数据列，包括：任务名称、状态、上次状态变更日期、分配用户、完成用户，以及组织用于公司代码、总账科目或部门的任何自定义元数据字段。
配置报告筛选器。设置涵盖所需财务期间的日期范围，通常至少为3至6个月。还可添加其他相关筛选条件，例如特定公司代码或流程类型。
运行报告并生成数据预览。检查列和行是否符合预期。
确认预览无误后，导出报告。选择CSV格式，并将文件下载到本地设备。
在电子表格应用中打开导出的CSV文件。数据通常按任务当前状态或每次状态变更各占一行。您需要将数据转换为有效的事件日志格式。
新建ActivityName、EventTimestamp和FinancialPeriod列，并将Workiva导出的数据映射到这些列。例如，名称为“对账现金账户”、状态为“已提交审核”的任务，应转换为“对账已提交审核”活动。“上次状态变更日期”对应EventTimestamp。
根据报告中的任务名称和状态变更，为14项必需活动分别创建独立行。这可能需要根据单个任务的历史记录创建多行。
将转换后的完整文件保存为CSV。确保最终列标题与上传到流程挖掘工具所需的属性一致。

配置

选择流程：选择要分析的具体财务结账流程，例如“月度结账清单”或“季度报告流程”，其中应包含您要分析的任务。
报告类型：选择能够提供历史任务数据的报告类型，例如“流程审计跟踪”或包含状态变更历史的“任务明细报告”。简单的汇总报告无法满足需求。
日期范围：为确保分析结果有参考价值，请将报告的数据提取范围设为至少3至6个完整财务期间，以便比较各周期并识别趋势。
报告列：报告必须包含能够记录事件详情的列。请添加任务名称、任务状态、开始日期、到期日期、完成日期、分配用户、完成用户以及最后一次状态变更的时间戳。还需添加可映射到CompanyCode、部门或GLAccount的自定义字段。
筛选器：使用筛选器缩小提取范围。您可以按FinancialPeriod名称范围、CompanyCode或任务状态筛选，以控制导出数据量并聚焦相关数据。
前提条件：执行提取的用户必须至少拥有Workiva中相关流程的读取权限，并具备创建和运行报告的权限。

查询示例 config

// Workiva Process Report Configuration
// This is not an executable script, but a representation of the settings to be configured in the Workiva UI.

ReportType: "Process Task Detail" or "Process Audit Trail"

// Select the primary process to report on
ProcessFilter: "[Your Period Close Process Name]"

// Define the time frame for the data export
DateRange: {
  StartDate: "[YYYY-MM-DD]",
  EndDate: "[YYYY-MM-DD]"
}

// Columns to include in the exported report
// These fields will be mapped to the event log attributes during data transformation
Columns: [
  "Process Name",         // Maps to FinancialPeriod
  "Task Name",            // Used to derive ActivityName
  "Current Status",       // Used to derive ActivityName
  "Status Change Date",   // Maps to EventTimestamp
  "Assigned To User",     // Maps to ResponsibleUser
  "Completed By User",    // Maps to ResponsibleUser
  "Start Date",           // Potential timestamp for 'Started' activities
  "Completion Date",      // Potential timestamp for 'Completed' activities

  // Add custom metadata fields configured in your Workiva process
  "[Custom Field for Company Code]", // Maps to CompanyCode
  "[Custom Field for Department]",   // Maps to Department
  "[Custom Field for GL Account]",   // Maps to GLAccount
  "[Custom Field for Reconciliation Category]" // Maps to ReconciliationCategory
]

// Filters to apply to the dataset
Filters: {
  // Add any specific filters if needed, for example, by company code
  "[Custom Field for Company Code]": "[Filter by specific company codes]"
}

// Export Format
Format: "CSV"

步骤

确认您的Workiva环境已启用Wdata和Wdata Chains，配置了所需的源连接，并获准读取期间结账、对账、分录、试算平衡表和财务报表数据。Workiva配置因环境而异，因此请根据[您的系统配置]选择连接和对象，不要假定菜单路径固定。
确定包含期间结账工作流历史、源数据加载历史、账户对账历史、公司间对账历史、分录状态历史、试算平衡表里程碑及财务报表工作流历史的Wdata表或源输出。在Chain的配置部分记录准确的对象名称和列名称。
创建Wdata Chain，并设置输入的开始日期、结束日期和可选的公司筛选条件。为每个源数据集添加查询或读取表的步骤。每个源步骤都必须返回财务期间、事件时间戳、可用时的负责人、部门、公司代码、总账科目、对账状态、对账类别和上次刷新时间戳。
将各数据源的状态和里程碑记录映射到所需的ActivityName值。映射必须明确生成以下活动对应的行：期间结账已启动、源数据已导入、账户对账已开始、公司间对账已开始、对账已提交审核、对账已审核并批准、对账已拒绝、调整分录已过账、试算平衡表已编制、财务报表已生成、财务报表已审核、财务报表已批准、期间结账已完成，以及期间已重新打开。
将所有源步骤的输出统一为相同的数据结构。将时间戳转换为统一的时区和格式，保留源时间戳作为EventTimestamp，将SourceSystem设为来源系统名称，并将LastDataUpdate设为源刷新时间戳或Chain执行时的刷新时间戳。除非源数据明确记录了某个里程碑，否则不要仅根据其他事件的存在推断该事件。
合并标准化后的输出。仅删除重复提取产生的完全重复记录，并保留时间戳、用户、状态或源标识不同的事件。同一FinancialPeriod中的多个有效事件不得合并。
验证所有必需列均已提供，并确认存在相应源记录时，输出中包含全部14个活动名称。检查时间戳顺序、期间覆盖范围、重复记录处理情况，以及推荐属性的空值比例。
将标准化事件日志写入指定的Wdata表，或通过已配置的Chain输出步骤发送到获批的外部目标位置。将[Your output table name]和[Configure based on your system]替换为适用于您环境的值。
按所需频率安排Chain运行，通常在结账期间每天运行，其他时段降低频率，并保留执行日志。若要上传到ProcessMind，请导出包含FinancialPeriod、ActivityName、EventTimestamp、SourceSystem、LastDataUpdate及所有可用推荐属性的平面文件。将FinancialPeriod设为案例标识符，ActivityName设为活动，EventTimestamp设为事件时间戳。

配置

源对象：选择包含明确工作流、状态、里程碑和刷新历史的Wdata表或已连接的源输出。不要假设Workiva表名或列名是标准统一的。
活动映射：为全部14项活动配置明确的源条件。请根据您的环境确认Pending Review、Approved、Completed、Rejected、Needs Rework、Closed和活跃状态等状态值。
日期范围：提取至少3至6个月的数据用于运营分析。如果一个财务期间跨越数月，或需要分析历史重新打开的情况，请延长日期范围。
增量提取：使用基于EventTimestamp或源更新时间戳的水位标记。设置较短的重叠时间窗口，以捕获延迟到达的更新，然后删除完全重复的记录。
筛选器：仅在需要时按公司代码、FinancialPeriod、部门、对账类别、单据类型和源系统筛选。启用筛选器前，请确认准确的字段名称和允许值。
必需输出列：每行输出都必须包含FinancialPeriod、ActivityName、EventTimestamp、SourceSystem和LastDataUpdate。
推荐输出列：如有数据，请包含ResponsibleUser、Department、CompanyCode、GLAccount、ReconciliationStatus和ReconciliationCategory。
性能：按日期和公司限制源数据读取范围，仅选择所需列，使用增量加载，并避免反复扫描大型历史表。根据配置的Wdata设计，在支持的情况下对数据进行分区或暂存。
计划运行：在源数据刷新完成后安排Chain运行。期间结账期间通常适合每天运行，但具体频率取决于源数据刷新时间和运营要求。
前提条件：系统管理员必须确认所需权限、源连接、Wdata访问权限、Wdata Chains可用性、目标位置写入权限，以及适用的Workiva许可证。
环境专属配置：连接名称、表名、列名、状态值、时区和外部交付设置均须根据您的系统进行配置。

查询示例 config

WITH
period_close_initiated AS (
    SELECT
        FinancialPeriod,
        'Period Close Initiated' AS ActivityName,
        EventTimestamp,
        SourceSystem,
        LastDataUpdate,
        ResponsibleUser,
        Department,
        CompanyCode,
        GLAccount,
        ReconciliationStatus,
        ReconciliationCategory
    FROM [Your period close event source]
    WHERE EventTimestamp >= [Start date parameter]
      AND EventTimestamp < [End date parameter]
      AND ([Company Code filter] IS NULL OR CompanyCode = [Company Code filter])
      AND [Source activity or status condition for Period Close Initiated]
),
source_data_imported AS (
    SELECT
        FinancialPeriod,
        'Source Data Imported' AS ActivityName,
        EventTimestamp,
        SourceSystem,
        LastDataUpdate,
        ResponsibleUser,
        Department,
        CompanyCode,
        GLAccount,
        ReconciliationStatus,
        ReconciliationCategory
    FROM [Your source data load event source]
    WHERE EventTimestamp >= [Start date parameter]
      AND EventTimestamp < [End date parameter]
      AND ([Company Code filter] IS NULL OR CompanyCode = [Company Code filter])
      AND [Source activity or status condition for Source Data Imported]
),
account_reconciliation_started AS (
    SELECT
        FinancialPeriod,
        'Account Reconciliation Started' AS ActivityName,
        EventTimestamp,
        SourceSystem,
        LastDataUpdate,
        ResponsibleUser,
        Department,
        CompanyCode,
        GLAccount,
        ReconciliationStatus,
        ReconciliationCategory
    FROM [Your account reconciliation event source]
    WHERE EventTimestamp >= [Start date parameter]
      AND EventTimestamp < [End date parameter]
      AND ([Company Code filter] IS NULL OR CompanyCode = [Company Code filter])
      AND [Source activity or status condition for Account Reconciliation Started]
),
intercompany_reconciliation_started AS (
    SELECT
        FinancialPeriod,
        'Intercompany Reconciliation Started' AS ActivityName,
        EventTimestamp,
        SourceSystem,
        LastDataUpdate,
        ResponsibleUser,
        Department,
        CompanyCode,
        GLAccount,
        ReconciliationStatus,
        ReconciliationCategory
    FROM [Your intercompany reconciliation event source]
    WHERE EventTimestamp >= [Start date parameter]
      AND EventTimestamp < [End date parameter]
      AND ([Company Code filter] IS NULL OR CompanyCode = [Company Code filter])
      AND [Source activity or status condition for Intercompany Reconciliation Started]
),
reconciliation_submitted_for_review AS (
    SELECT
        FinancialPeriod,
        'Reconciliation Submitted for Review' AS ActivityName,
        EventTimestamp,
        SourceSystem,
        LastDataUpdate,
        ResponsibleUser,
        Department,
        CompanyCode,
        GLAccount,
        ReconciliationStatus,
        ReconciliationCategory
    FROM [Your reconciliation status history source]
    WHERE EventTimestamp >= [Start date parameter]
      AND EventTimestamp < [End date parameter]
      AND ([Company Code filter] IS NULL OR CompanyCode = [Company Code filter])
      AND [Source status condition for Reconciliation Submitted for Review]
),
reconciliation_reviewed_and_approved AS (
    SELECT
        FinancialPeriod,
        'Reconciliation Reviewed and Approved' AS ActivityName,
        EventTimestamp,
        SourceSystem,
        LastDataUpdate,
        ResponsibleUser,
        Department,
        CompanyCode,
        GLAccount,
        ReconciliationStatus,
        ReconciliationCategory
    FROM [Your reconciliation status history source]
    WHERE EventTimestamp >= [Start date parameter]
      AND EventTimestamp < [End date parameter]
      AND ([Company Code filter] IS NULL OR CompanyCode = [Company Code filter])
      AND [Source status condition for Reconciliation Reviewed and Approved]
),
reconciliation_rejected AS (
    SELECT
        FinancialPeriod,
        'Reconciliation Rejected' AS ActivityName,
        EventTimestamp,
        SourceSystem,
        LastDataUpdate,
        ResponsibleUser,
        Department,
        CompanyCode,
        GLAccount,
        ReconciliationStatus,
        ReconciliationCategory
    FROM [Your reconciliation status history source]
    WHERE EventTimestamp >= [Start date parameter]
      AND EventTimestamp < [End date parameter]
      AND ([Company Code filter] IS NULL OR CompanyCode = [Company Code filter])
      AND [Source status condition for Reconciliation Rejected]
),
adjusting_journal_entry_posted AS (
    SELECT
        FinancialPeriod,
        'Adjusting Journal Entry Posted' AS ActivityName,
        EventTimestamp,
        SourceSystem,
        LastDataUpdate,
        ResponsibleUser,
        Department,
        CompanyCode,
        GLAccount,
        ReconciliationStatus,
        ReconciliationCategory
    FROM [Your journal entry event source]
    WHERE EventTimestamp >= [Start date parameter]
      AND EventTimestamp < [End date parameter]
      AND ([Company Code filter] IS NULL OR CompanyCode = [Company Code filter])
      AND [Source status or journal type condition for Adjusting Journal Entry Posted]
),
trial_balance_prepared AS (
    SELECT
        FinancialPeriod,
        'Trial Balance Prepared' AS ActivityName,
        EventTimestamp,
        SourceSystem,
        LastDataUpdate,
        ResponsibleUser,
        Department,
        CompanyCode,
        GLAccount,
        ReconciliationStatus,
        ReconciliationCategory
    FROM [Your trial balance milestone source]
    WHERE EventTimestamp >= [Start date parameter]
      AND EventTimestamp < [End date parameter]
      AND ([Company Code filter] IS NULL OR CompanyCode = [Company Code filter])
      AND [Source activity or status condition for Trial Balance Prepared]
),
financial_statements_generated AS (
    SELECT
        FinancialPeriod,
        'Financial Statements Generated' AS ActivityName,
        EventTimestamp,
        SourceSystem,
        LastDataUpdate,
        ResponsibleUser,
        Department,
        CompanyCode,
        GLAccount,
        ReconciliationStatus,
        ReconciliationCategory
    FROM [Your financial statement generation source]
    WHERE EventTimestamp >= [Start date parameter]
      AND EventTimestamp < [End date parameter]
      AND ([Company Code filter] IS NULL OR CompanyCode = [Company Code filter])
      AND [Source activity or status condition for Financial Statements Generated]
),
financial_statements_reviewed AS (
    SELECT
        FinancialPeriod,
        'Financial Statements Reviewed' AS ActivityName,
        EventTimestamp,
        SourceSystem,
        LastDataUpdate,
        ResponsibleUser,
        Department,
        CompanyCode,
        GLAccount,
        ReconciliationStatus,
        ReconciliationCategory
    FROM [Your financial statement review source]
    WHERE EventTimestamp >= [Start date parameter]
      AND EventTimestamp < [End date parameter]
      AND ([Company Code filter] IS NULL OR CompanyCode = [Company Code filter])
      AND [Source activity or status condition for Financial Statements Reviewed]
),
financial_statements_approved AS (
    SELECT
        FinancialPeriod,
        'Financial Statements Approved' AS ActivityName,
        EventTimestamp,
        SourceSystem,
        LastDataUpdate,
        ResponsibleUser,
        Department,
        CompanyCode,
        GLAccount,
        ReconciliationStatus,
        ReconciliationCategory
    FROM [Your financial statement approval source]
    WHERE EventTimestamp >= [Start date parameter]
      AND EventTimestamp < [End date parameter]
      AND ([Company Code filter] IS NULL OR CompanyCode = [Company Code filter])
      AND [Source activity or status condition for Financial Statements Approved]
),
period_close_completed AS (
    SELECT
        FinancialPeriod,
        'Period Close Completed' AS ActivityName,
        EventTimestamp,
        SourceSystem,
        LastDataUpdate,
        ResponsibleUser,
        Department,
        CompanyCode,
        GLAccount,
        ReconciliationStatus,
        ReconciliationCategory
    FROM [Your period close event source]
    WHERE EventTimestamp >= [Start date parameter]
      AND EventTimestamp < [End date parameter]
      AND ([Company Code filter] IS NULL OR CompanyCode = [Company Code filter])
      AND [Source activity or status condition for Period Close Completed]
),
period_reopened AS (
    SELECT
        FinancialPeriod,
        'Period Re-Opened' AS ActivityName,
        EventTimestamp,
        SourceSystem,
        LastDataUpdate,
        ResponsibleUser,
        Department,
        CompanyCode,
        GLAccount,
        ReconciliationStatus,
        ReconciliationCategory
    FROM [Your period close status history source]
    WHERE EventTimestamp >= [Start date parameter]
      AND EventTimestamp < [End date parameter]
      AND ([Company Code filter] IS NULL OR CompanyCode = [Company Code filter])
      AND [Source status transition condition for Period Re-Opened]
),
all_events AS (
    SELECT * FROM period_close_initiated
    UNION ALL
    SELECT * FROM source_data_imported
    UNION ALL
    SELECT * FROM account_reconciliation_started
    UNION ALL
    SELECT * FROM intercompany_reconciliation_started
    UNION ALL
    SELECT * FROM reconciliation_submitted_for_review
    UNION ALL
    SELECT * FROM reconciliation_reviewed_and_approved
    UNION ALL
    SELECT * FROM reconciliation_rejected
    UNION ALL
    SELECT * FROM adjusting_journal_entry_posted
    UNION ALL
    SELECT * FROM trial_balance_prepared
    UNION ALL
    SELECT * FROM financial_statements_generated
    UNION ALL
    SELECT * FROM financial_statements_reviewed
    UNION ALL
    SELECT * FROM financial_statements_approved
    UNION ALL
    SELECT * FROM period_close_completed
    UNION ALL
    SELECT * FROM period_reopened
),
deduplicated_events AS (
    SELECT DISTINCT
        FinancialPeriod,
        ActivityName,
        EventTimestamp,
        SourceSystem,
        LastDataUpdate,
        ResponsibleUser,
        Department,
        CompanyCode,
        GLAccount,
        ReconciliationStatus,
        ReconciliationCategory
    FROM all_events
)
SELECT
    FinancialPeriod,
    ActivityName,
    EventTimestamp,
    SourceSystem,
    LastDataUpdate,
    ResponsibleUser,
    Department,
    CompanyCode,
    GLAccount,
    ReconciliationStatus,
    ReconciliationCategory
FROM deduplicated_events
ORDER BY FinancialPeriod, EventTimestamp, ActivityName;

步骤

前提条件：在Workiva中生成API凭据
- 使用具有OAuth2授权管理权限的账户登录Workiva。
- 前往Workiva管理控制台，选择OAuth2授权部分。
- 为提取脚本新建授权，并选择读取流程、任务和用户数据所需的范围。常见范围包括processes:read、tasks:read和users:read。
- 安全保存生成的Client ID和Client Secret。Python脚本将使用这些凭据进行身份验证。
设置Python环境
- 确保运行脚本的计算机已安装Python 3.6或更新版本。
- 使用pip安装所需的Python库。主要包括用于向API发送HTTP请求的requests，以及用于数据处理和导出CSV的pandas。
- 打开命令提示符或终端并运行：pip install requests pandas
配置Python脚本
- 将提供的Python脚本复制到文件中，例如extract_workiva_log.py。
- 替换脚本顶部的占位值，包括CLIENT_ID、CLIENT_SECRET、START_DATE、END_DATE和PROCESS_TEMPLATE_IDS。
- PROCESS_TEMPLATE_IDS应填写您要分析的Record to Report流程模板的唯一标识符列表。
了解脚本逻辑
- 脚本首先使用提供的凭据通过Workiva API进行身份验证，以获取访问令牌。
- 随后，脚本会查询/processes端点，查找指定日期范围内创建且符合模板ID的所有流程实例（每个实例对应一个FinancialPeriod案例）。
- 对于每个流程实例，脚本都会从/tasks端点获取所有关联任务。
- 脚本会遍历任务及其历史记录或状态变更，生成事件日志行，并将任务名称和状态更新映射到预定义的14项活动列表。
运行提取脚本
- 在命令行或终端中运行：python extract_workiva_log.py
- 脚本会在从API获取数据时向控制台输出进度信息。
- 请耐心等待。由于API分页和速率限制，提取较长时间段的数据可能需要几分钟。
检查输出数据
- 脚本成功运行后，会在同一目录下生成workiva_event_log.csv文件。
- 在电子表格应用中打开CSV文件并检查数据。确认FinancialPeriod、ActivityName、EventTimestamp、SourceSystem和LastDataUpdate列均已正确填充。
准备上传到ProcessMind
- 生成的CSV文件可直接用于ProcessMind，通常无需进一步调整格式。请确认列标题与ProcessMind实例中的目标数据模型一致。

配置

API凭据：身份验证需要Client ID和Client Secret。请在Workiva管理控制台中生成凭据，并设置允许读取流程和任务数据的范围。
流程模板ID：请指定要提取数据的期末结账流程模板的唯一标识符，确保只提取相关流程。
日期范围：脚本中的START_DATE和END_DATE变量用于定义提取时间范围。建议先选择较短的范围，例如3至6个月，以控制数据量和API调用次数。
API端点URL：脚本使用Workiva v1 API端点。如果您的Workiva环境所在区域与默认区域不同，请确认端点URL是否正确。
用户权限：与API凭据关联的用户账户至少需要对待提取的流程和任务拥有只读权限。权限不足会导致错误或数据不完整。
环境变量：为加强安全性，强烈建议将Client ID和Client Secret存储为环境变量，而不要直接写入脚本。

查询示例 python

import requests
import pandas as pd
import datetime
import time

class=class="hl-string">"hl-comment"># --- Configuration Settings --- #
class=class="hl-string">"hl-comment"># Replace with your Workiva API credentials
CLIENT_ID = class="hl-string">'YOUR_CLIENT_ID'
CLIENT_SECRET = class="hl-string">'YOUR_CLIENT_SECRET'

class=class="hl-string">"hl-comment"># Define the date range for the extraction
START_DATE = class="hl-string">'YYYY-MM-DD'
END_DATE = class="hl-string">'YYYY-MM-DD'

class=class="hl-string">"hl-comment"># Define the Process Template IDs for your Record to Report processes
PROCESS_TEMPLATE_IDS = [class="hl-string">'YOUR_PROCESS_TEMPLATE_ID_1', class="hl-string">'YOUR_PROCESS_TEMPLATE_ID_2']

class=class="hl-string">"hl-comment"># API Base URL
BASE_URL = class="hl-string">'https://api.workiva.com/v1'

class=class="hl-string">"hl-comment"># --- Function to get an OAuth2 Token --- #
def get_access_token():
    url = fclass="hl-string">'{BASE_URL}/oauth2/token'
    payload = {
        class="hl-string">'grant_type': class="hl-string">'client_credentials',
        class="hl-string">'client_id': CLIENT_ID,
        class="hl-string">'client_secret': CLIENT_SECRET
    }
    response = requests.post(url, data=payload)
    response.raise_for_status() class=class="hl-string">"hl-comment"># Raises an exception for bad status codes
    return response.json()[class="hl-string">'access_token']

class=class="hl-string">"hl-comment"># --- Function to handle paginated API calls --- #
def get_all_pages(url, headers, params):
    all_items = []
    while url:
        response = requests.get(url, headers=headers, params=params)
        response.raise_for_status()
        data = response.json()
        all_items.extend(data[class="hl-string">'data'])
        url = data.get(class="hl-string">'metadata', {}).get(class="hl-string">'nextPageUrl')
        params = None class=class="hl-string">"hl-comment"># Subsequent requests use the full nextPageUrl
        if url:
            print(fclass="hl-string">'Fetching next page: {url}')
            time.sleep(0.5) class=class="hl-string">"hl-comment"># Be respectful of API rate limits
    return all_items

class=class="hl-string">"hl-comment"># --- Main Extraction Logic --- #
def main():
    print(class="hl-string">'Starting Workiva data extraction...')
    access_token = get_access_token()
    headers = {class="hl-string">'Authorization': fclass="hl-string">'Bearer {access_token}'}
    event_log = []
    last_data_update = datetime.datetime.utcnow().isoformat() + class="hl-string">'Z'

    class=class="hl-string">"hl-comment"># 1. Fetch relevant processes (our cases)
    print(class="hl-string">'Fetching processes...')
    process_params = {
        class="hl-string">'filter[templateId]': class="hl-string">','.join(PROCESS_TEMPLATE_IDS),
        class="hl-string">'filter[created]': fclass="hl-string">'ge({START_DATE});lt({END_DATE})'
    }
    processes = get_all_pages(fclass="hl-string">'{BASE_URL}/processes', headers, process_params)
    print(fclass="hl-string">'Found {len(processes)} processes to analyze.')

    class=class="hl-string">"hl-comment"># 2. Iterate through each process to fetch tasks and create events
    for process in processes:
        financial_period = process.get(class="hl-string">'name', process[class="hl-string">'id'])
        process_id = process[class="hl-string">'id']
        process_owner_id = process.get(class="hl-string">'owner', {}).get(class="hl-string">'id')

        class=class="hl-string">"hl-comment"># Activity: Period Close Initiated
        event_log.append({
            class="hl-string">'FinancialPeriod': financial_period,
            class="hl-string">'ActivityName': class="hl-string">'Period Close Initiated',
            class="hl-string">'EventTimestamp': process[class="hl-string">'created'],
            class="hl-string">'ResponsibleUser': process_owner_id,
            class="hl-string">'CompanyCode': process.get(class="hl-string">'customProperties', {}).get(class="hl-string">'CompanyCode'),
            class="hl-string">'Department': None,
            class="hl-string">'GLAccount': None,
            class="hl-string">'ReconciliationStatus': None,
            class="hl-string">'ReconciliationCategory': None
        })

        class=class="hl-string">"hl-comment"># 3. Fetch all tasks for the current process
        print(fclass="hl-string">'Fetching tasks for process: {financial_period}')
        tasks = get_all_pages(fclass="hl-string">'{BASE_URL}/tasks?filter[processId]={process_id}', headers, None)

        for task in tasks:
            task_name = task.get(class="hl-string">'name', class="hl-string">'').lower()
            task_assignee_id = task.get(class="hl-string">'assignee', {}).get(class="hl-string">'id')
            task_status = task.get(class="hl-string">'status', {}).get(class="hl-string">'value', class="hl-string">'').lower()
            reconciliation_category = task.get(class="hl-string">'customProperties', {}).get(class="hl-string">'ReconciliationCategory')
            gl_account = task.get(class="hl-string">'customProperties', {}).get(class="hl-string">'GLAccount')

            class=class="hl-string">"hl-comment"># Map task creation to class="hl-string">'Started' activities
            activity_map_start = {
                class="hl-string">'import source data': class="hl-string">'Source Data Imported',
                class="hl-string">'reconcile account': class="hl-string">'Account Reconciliation Started',
                class="hl-string">'intercompany reconciliation': class="hl-string">'Intercompany Reconciliation Started',
                class="hl-string">'prepare trial balance': class="hl-string">'Trial Balance Prepared',
                class="hl-string">'generate financial statements': class="hl-string">'Financial Statements Generated',
                class="hl-string">'review financial statements': class="hl-string">'Financial Statements Reviewed',
                class="hl-string">'post adjusting journal entry': class="hl-string">'Adjusting Journal Entry Posted'
            }
            for key, activity in activity_map_start.items():
                if key in task_name:
                    event_log.append({
                        class="hl-string">'FinancialPeriod': financial_period,
                        class="hl-string">'ActivityName': activity,
                        class="hl-string">'EventTimestamp': task[class="hl-string">'created'],
                        class="hl-string">'ResponsibleUser': task_assignee_id,
                        class="hl-string">'CompanyCode': process.get(class="hl-string">'customProperties', {}).get(class="hl-string">'CompanyCode'),
                        class="hl-string">'Department': task.get(class="hl-string">'customProperties', {}).get(class="hl-string">'Department'),
                        class="hl-string">'GLAccount': gl_account,
                        class="hl-string">'ReconciliationStatus': class="hl-string">'In Progress',
                        class="hl-string">'ReconciliationCategory': reconciliation_category
                    })

            class=class="hl-string">"hl-comment"># Map task status changes and completion to other activities
            if task.get(class="hl-string">'completed'):
                activity_map_completed = {
                    class="hl-string">'reconcile account': class="hl-string">'Reconciliation Submitted for Review',
                    class="hl-string">'intercompany reconciliation': class="hl-string">'Reconciliation Submitted for Review',
                    class="hl-string">'approve reconciliation': class="hl-string">'Reconciliation Reviewed and Approved',
                    class="hl-string">'approve financial statements': class="hl-string">'Financial Statements Approved',
                    class="hl-string">'close period': class="hl-string">'Period Close Completed'
                }
                for key, activity in activity_map_completed.items():
                    if key in task_name:
                         event_log.append({
                            class="hl-string">'FinancialPeriod': financial_period,
                            class="hl-string">'ActivityName': activity,
                            class="hl-string">'EventTimestamp': task[class="hl-string">'completed'],
                            class="hl-string">'ResponsibleUser': task.get(class="hl-string">'completedBy',{}).get(class="hl-string">'id'),
                            class="hl-string">'CompanyCode': process.get(class="hl-string">'customProperties', {}).get(class="hl-string">'CompanyCode'),
                            class="hl-string">'Department': task.get(class="hl-string">'customProperties', {}).get(class="hl-string">'Department'),
                            class="hl-string">'GLAccount': gl_account,
                            class="hl-string">'ReconciliationStatus': class="hl-string">'Approved' if class="hl-string">'approve' in key else class="hl-string">'Submitted',
                            class="hl-string">'ReconciliationCategory': reconciliation_category
                        })

            if task_status == class="hl-string">'rejected':
                 event_log.append({
                    class="hl-string">'FinancialPeriod': financial_period,
                    class="hl-string">'ActivityName': class="hl-string">'Reconciliation Rejected',
                    class="hl-string">'EventTimestamp': task.get(class="hl-string">'updated'), class=class="hl-string">"hl-comment"># Use last updated time for rejection event
                    class="hl-string">'ResponsibleUser': task_assignee_id,
                    class="hl-string">'CompanyCode': process.get(class="hl-string">'customProperties', {}).get(class="hl-string">'CompanyCode'),
                    class="hl-string">'Department': task.get(class="hl-string">'customProperties', {}).get(class="hl-string">'Department'),
                    class="hl-string">'GLAccount': gl_account,
                    class="hl-string">'ReconciliationStatus': class="hl-string">'Rejected',
                    class="hl-string">'ReconciliationCategory': reconciliation_category
                })

        class=class="hl-string">"hl-comment"># Activity: Period Re-Opened (Example logic, assumes a status on the process itself)
        if process.get(class="hl-string">'status', {}).get(class="hl-string">'value') == class="hl-string">'re-opened':
            event_log.append({
                class="hl-string">'FinancialPeriod': financial_period,
                class="hl-string">'ActivityName': class="hl-string">'Period Re-Opened',
                class="hl-string">'EventTimestamp': process[class="hl-string">'updated'],
                class="hl-string">'ResponsibleUser': process_owner_id,
                class="hl-string">'CompanyCode': process.get(class="hl-string">'customProperties', {}).get(class="hl-string">'CompanyCode'),
                class="hl-string">'Department': None,
                class="hl-string">'GLAccount': None,
                class="hl-string">'ReconciliationStatus': None,
                class="hl-string">'ReconciliationCategory': None
            })

    if not event_log:
        print(class="hl-string">'No events found for the given criteria.')
        return

    class=class="hl-string">"hl-comment"># 4. Create and save the DataFrame
    print(class="hl-string">'Creating DataFrame and saving to CSV...')
    df = pd.DataFrame(event_log)

    class=class="hl-string">"hl-comment"># Add static columns
    df[class="hl-string">'SourceSystem'] = class="hl-string">'Workiva'
    df[class="hl-string">'LastDataUpdate'] = last_data_update

    class=class="hl-string">"hl-comment"># Reorder columns to a logical format
    final_columns = [
        class="hl-string">'FinancialPeriod', class="hl-string">'ActivityName', class="hl-string">'EventTimestamp', class="hl-string">'SourceSystem', class="hl-string">'LastDataUpdate',
        class="hl-string">'ResponsibleUser', class="hl-string">'Department', class="hl-string">'CompanyCode', class="hl-string">'GLAccount', class="hl-string">'ReconciliationStatus', class="hl-string">'ReconciliationCategory'
    ]
    df = df[final_columns]

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

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

准备好开始了吗？

使用此模板简化数据准备工作，深入了解记录到报告：期间结账与对账流程。立即开始优化财务结账。

返回改进指南

下载模板

立即优化记录到报告结账与对账流程

找出瓶颈、简化流程，将周期时间缩短30%。

立即开始免费试用

无需信用卡

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

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

记录到报告：期间结账与对账属性

记录到报告：期间结账与对账活动

数据提取指南

Workiva流程报告与电子表格导出

步骤

配置

查询示例 config

通过Workiva Wdata Chains自动提取数据

步骤

配置

查询示例 config

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

步骤

配置

查询示例 python

准备好开始了吗？

立即优化记录到报告结账与对账流程