您的采购到付款：采购订单数据模板

SAP Ariba

← 返回改进指南

采购到付款-采购订单属性 (22) 采购到付款-采购订单活动 (14) 提取指南 (2)

您的采购到付款：采购订单数据模板

此模板全面介绍如何收集分析采购到付款：采购订单流程所需的关键数据，列出需要跟踪的重要属性和活动，并提供从源系统提取数据的实用指导。使用此资源，为流程发现和优化建立完整、准确的数据基础。

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

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

下载模板

采购到付款-采购订单属性

以下是建议纳入事件日志的数据字段，用于全面分析采购到付款-采购订单流程。

3 必需 6 建议 13 可选

	名称	说明
	事件时间 EventTime	特定活动或事件发生的准确日期和时间。
说明事件时间是与每项活动关联的时间戳，用于记录活动开始时间。该数据对于按时间顺序排列事件，以及计算流程中不同步骤之间的持续时间和周期时间至关重要。该属性对于几乎所有基于时间的分析都很关键，包括采购订单端到端周期时间和采购订单审批周期时间仪表板。通过计算“Purchase Order Created”和“Purchase Order Approved”活动时间戳之间的差值，可以得到“Average PO Approval Cycle Time”等关键绩效指标。为什么重要该时间戳是正确排列事件顺序并计算所有基于时长的指标的基础，例如周期时间和等待时间。获取位置通常可在SAP Ariba采购订单文档的审计轨迹或变更日志数据中找到。示例 2023-04-15T10:30:00Z2023-04-16T14:05:22Z2023-05-01T09:00:15Z
	活动名称 ActivityName	采购订单流程中某一时点发生的具体事件或任务名称。
说明活动名称描述采购订单生命周期中的一个步骤，例如“采购订单已创建”“采购订单已批准”或“收货已过账”。这些活动按顺序构成流程图的基础。分析这些活动是流程挖掘的核心。它有助于展示流程、识别常见和罕见的流程变体，并衡量不同步骤之间的持续时间。了解“采购订单已更改”等活动的顺序和频率，对于Purchase Order Change Rate Analysis等仪表板至关重要。为什么重要该属性定义流程中的各个步骤，用于展示流程、识别瓶颈、返工和偏差。获取位置通过映射SAP Ariba底层表中与文档历史和工作流相关的状态变更、交易代码或事件日志生成。示例采购订单已审批采购订单已变更收货已过账已收到针对采购订单的发票
	采购订单 PurchaseOrderNumber	每个采购订单文档的唯一标识符，也是流程的核心案例标识符。
说明采购订单编号是连接整个采购生命周期中所有相关活动和事件的主键。每个编号代表一笔独立的采购交易，从订单初次创建到最终完成或取消。在流程挖掘中，该属性是进行案例级分析的基础。它可以重建每个采购订单的端到端历程，计算周期时间、识别流程变体，并跟踪单个订单的状态。按采购订单编号分析流程，有助于了解完整流程，识别特定交易中的瓶颈或偏差。为什么重要这是连接所有流程步骤的核心案例ID，可用于分析每个采购订单的端到端生命周期。获取位置这是SAP Ariba Buying and Invoicing或SAP Ariba Sourcing中采购订单文档的主要字段。示例 PO7000123456PO7000123457PO7000123458
	供应商名称 VendorName	提供所采购货物或服务的供应商名称。
说明该属性标识参与采购订单的外部合作伙伴。供应商是采购到付款流程中的关键实体，其绩效会直接影响整个流程的效率。供应商名称是绩效分析的重要维度，也是供应商交付绩效仪表板的基础，可用于比较不同供应商的交付日期。按供应商分析流程，可以发现哪些供应商经常延迟交付、导致更多返工或拥有更复杂的开票流程，为供应商关系管理提供有价值的洞察。为什么重要支持分析供应商绩效，帮助识别可靠合作伙伴，并定位造成延迟或其他问题的供应商。获取位置这是SAP Ariba采购订单文档抬头层级中的标准字段。示例 Global Office Supplies Inc.Tech Solutions LLCAdvanced Industrial Parts
	收货日期 GoodsReceiptDate	系统正式记录商品收货或服务完成的日期。
说明此属性标记“收货过账”或“录入服务确认”活动的时间戳，表示系统已正式确认收到订购物品。该日期对于衡量实际交付时间至关重要。它与“RequestedDeliveryDate”相对应，用于计算交付偏差和及时性KPI。收货过账及时性仪表板依赖此属性评估交付后收货记录的及时程度，这对于确保库存准确和及时支付发票非常重要。为什么重要表示实际交付日期，是计算交付表现和识别供应链延迟的关键数据。获取位置这是引用采购订单的收货或服务录入表单文档的时间戳。示例 2023-06-02T11:00:00Z2023-07-14T15:30:00Z2023-08-22T09:45:00Z
	用户名 UserName	执行该活动的用户姓名或ID。
说明该属性标识负责执行特定流程步骤的人员，例如审批采购订单或收货过账的人员。它可以是唯一用户ID或完整姓名。按用户分析绩效有助于识别培训需求或发现高绩效人员。它对于合规相关分析也很重要，例如采购订单审批合规偏差仪表板，可用于确定谁绕过了必要的审批步骤。此外，它还可用于了解工作量分布和资源配置。为什么重要提供责任追踪能力，并支持分析用户绩效、工作量和合规情况，这对于识别培训需求或流程偏差至关重要。获取位置这些信息通常可在SAP Ariba的工作流和文档历史日志中找到，并且通常与每个事件关联。示例 john.smithLROSSIjane.doe
	请求交付日期 RequestedDeliveryDate	请求方期望商品或服务交付的日期。
说明这是业务部门在创建采购申请或采购订单时指定的目标交付日期，也是衡量实际交付表现的基准。此属性是供应商交付表现仪表板和收货及时率KPI的基础。通过比较请求交付日期与实际收货日期，组织可以衡量供应商准时交付情况、计算交付偏差，并识别持续无法满足交付时限的供应商。这项分析对于管理供应商关系和降低供应链风险至关重要。为什么重要作为衡量准时交付表现的基准，对于评估供应商可靠性和供应链效率至关重要。获取位置这是采购订单文档行项目层级中的标准日期字段。示例 2023-06-012023-07-152023-08-20
	部门名称 DepartmentName	与采购订单关联的业务部门或成本中心。
说明该属性表示发起采购申请的组织单元，或采购所服务的组织单元。它通常根据采购订单中的成本中心信息推导。该维度对于部门采购订单处理效率仪表板至关重要，可直接比较不同部门的周期时间和流程变体。它有助于识别遵循最佳实践的部门，以及可能需要额外培训或流程改进的部门，也是计算部门采购订单周期时间差异KPI的关键。为什么重要支持比较不同业务单元的绩效，帮助识别部门瓶颈并分享最佳实践。获取位置这些信息可在采购订单的抬头或行项目层级找到，通常与成本中心或申请人档案关联。示例市场营销IT运营设施管理研发
	采购订单金额 PurchaseOrderAmount	采购订单的货币总值。
说明此属性表示采购订单中列出的所有商品和服务的总成本，除非另有说明，不包括税费及其他费用。它是了解流程中交易价值的关键财务指标。在分析中，采购订单金额通常用于细分流程。例如，高价值订单可能遵循与低价值订单不同且更严格的审批路径。您可以据此优先改进金额较大的交易，并按部门或供应商分析支出模式。为什么重要为每个案例提供财务背景，支持基于价值的分析，从而确定改进优先级，并了解订单价值如何影响流程行为。获取位置这是采购订单文档抬头层级中的标准计算字段，用于汇总所有行项目的金额。示例 1500.0025000.50500.75
	上次数据更新 LastDataUpdate	表示该事件数据上次从源系统刷新或提取时间的时间戳。
说明该属性提供从SAP Ariba最近一次提取数据的日期和时间，是了解所分析数据新鲜度的重要元数据。在任何流程挖掘分析中，了解数据的时效性对于报告和决策都至关重要。借助该时间戳，用户可以确认仪表板和KPI（例如采购订单吞吐量趋势）是否基于最新信息。为什么重要表明数据的新鲜度，帮助用户了解分析所依据的数据有多新，并增强对洞察的信任。获取位置该时间戳通常在数据提取、转换和加载（ETL）过程中生成并附加到数据集。示例 2023-10-27T02:00:00Z2023-10-28T02:00:00Z
	事件结束时间 EventEndTime	表示活动完成时间的时间戳，用于计算人工活动的处理时间。
说明 StartTime表示活动开始时间，EventEndTime则表示活动结束时间。对于许多系统生成的事件，两者相同。但对于人工任务或长时间运行的自动化作业，开始时间与结束时间的差值就是活动的处理时间。该属性用于计算“ProcessingTime”指标，对于采购订单活动时长分析仪表板至关重要。它有助于定位完成时间最长的具体任务，从而发现培训、资源重新配置或自动化机会。为什么重要支持计算单项活动的精确处理时间，帮助识别最耗时的具体任务。获取位置请参阅SAP Ariba文档。如果系统未明确提供该字段，可能需要根据后续活动的开始时间推导。示例 2023-04-15T10:45:00Z2023-04-16T14:05:30Z2023-05-01T11:00:00Z
	交付偏差 DeliveryVariance	请求交付日期与实际收货日期之间的计算时间差。
说明此指标通过衡量交付提前或延迟的时间，量化供应商交付表现。计算方式为用“GoodsReceiptDate”减去“RequestedDeliveryDate”。正值表示延迟交付，负值表示提前交付，零表示按时交付。这是“供应商交付表现”仪表板和“供应商交付表现偏差”KPI的核心计算。通过跨供应商分析偏差，组织可以识别可靠和不可靠的合作伙伴，为供应商谈判和风险管理策略提供依据。相比简单标记准时或延迟，该指标还能反映交付偏差的具体程度。为什么重要通过精确衡量交付延迟或提前的时间，量化供应商准时性，对于管理供应商表现至关重要。获取位置在数据转换层计算，方法是用“GoodsReceiptDate”减去“RequestedDeliveryDate”。示例 P2D-P1DP0D
	是否返工 IsRework	用于标识采购订单是否经历过返工循环的计算标记，例如被拒绝后重新提交。
说明此布尔属性根据活动顺序计算得出。如果采购订单在流程中回退，例如“审批采购订单”之后出现“更改采购订单”，随后再次审批，则该属性设为“true”。这表示流程偏离了理想的直通路径。此标记对于计算采购订单返工循环率KPI以及筛选流程图、突出低效流转至关重要。识别出返工案例后，分析人员可以调查数据录入错误或需求不明确等根因，并采取措施提高一次审批通过率。为什么重要直接标记存在流程低效和返工的案例，帮助分析人员量化循环影响并针对性消除这些循环。获取位置此属性不在源系统中，而是在数据转换期间根据每个案例的活动顺序计算得出。示例 truefalse
	源系统 SourceSystem	标识数据提取来源系统，本例中为SAP Ariba。
说明该属性说明流程数据的来源。在多个系统集成的环境中，它对于区分不同来源的数据并确保数据血缘至关重要。在分析中，它有助于将数据筛选到特定系统，或了解不同平台之间的流程交互。它也是数据治理和验证的重要元数据，可确保分析基于正确的数据集。为什么重要提供有关数据来源的重要背景信息，对于多系统环境中的数据治理、验证和分析至关重要。获取位置这是一个静态值（“SAP Ariba”），通常在数据提取和转换过程中添加。示例 SAP AribaSAP-Ariba-USAribaCloud
	物料组 MaterialGroup	用于将特征相似的物料或服务归为一组的分类。
说明物料组在Ariba中称为商品代码，用于对采购项目进行分类。借此可以分析支出，并针对不同类型的商品或服务采用不同的采购策略。在流程挖掘中，此属性支持按采购内容分析采购流程。例如，IT硬件的审批流程可能不同于办公用品。这样可以获得更细致的洞察，并针对具体采购类别制定流程改进方案。为什么重要支持根据所采购商品或服务的类别分析流程，揭示不同采购项目在采购方式上的差异。获取位置这是采购订单行项目层级中的标准字段，通常标记为“商品代码”。示例 IT.HardwareOffice.SuppliesProfessional.Services
	货币 DocumentCurrency	采购订单货币金额所使用的货币代码。
说明此属性指定采购订单金额所使用的货币，例如USD、EUR或GBP，是所有财务数据不可或缺的背景信息。分析覆盖多个国家或地区的流程时，单据货币对于正确解读和比较金额至关重要。所有财务KPI和仪表板都必须使用此字段筛选单一货币，或应用适当的汇率，以确保汇总和比较准确。为什么重要为所有金额字段提供必要背景，确保财务分析准确，并避免错误汇总不同货币的金额。获取位置这是SAP Ariba采购订单文档抬头层级中的标准字段。示例 USDEURGBPJPY
	采购申请编号 PurchaseRequisitionNumber	采购订单之前的采购申请唯一标识符。
说明此属性将采购订单关联回其来源采购申请。并非所有采购订单都有前置采购申请，例如直接创建采购订单的情况。该关联对于分析从初始申请开始的完整端到端采购流程至关重要，也是采购申请到采购订单转化漏斗仪表板和采购申请到采购订单转化时间KPI的基础。分析这一关联有助于识别申请获批与正式向供应商下单之间的延迟。为什么重要将采购订单与初始申请连接起来，支持从创建采购申请到完成订单履行的真正端到端分析。获取位置此信息通常作为采购订单行项目中的参考字段提供。示例 PR10004567PR10004568PR10004569
	采购组织 PurchasingOrganization	负责采购物料和服务并与供应商协商的组织单位。
说明采购组织是采购结构中的关键实体，负责采购的战略层面。不同地区或业务部门可能设有不同的采购组织。按采购组织分析流程，可以揭示公司各部门在效率、合规和供应商管理策略方面的差异。这有助于统一最佳实践，并识别组织层面的瓶颈或低效来源。为什么重要支持在不同战略采购单位之间开展高层次的流程效率和合规分析。获取位置这是采购订单文档抬头层级中的标准组织数据字段。示例 PO_US01PO_EMEAPO_GLOBAL
	采购订单是否更改 IsPurchaseOrderChanged	用于标识采购订单是否在初始创建后被修改的布尔标记。
说明如果某个案例存在“采购订单已更改”活动，此派生属性将设为“true”。它以简单的案例级指标简化变更率分析。此标记用于计算采购订单变更率KPI。您可以据此快速细分数据，对比已更改和未更改订单的流程，从而发现变更带来的后续影响，例如周期时间延长或发票差异增加。采购订单变更率分析仪表板使用此属性量化变更频率。为什么重要提供简单标记，用于识别所有已更改的采购订单，便于计算变更率并分析其影响。获取位置此标记在数据转换期间生成，方法是检查每个采购订单编号是否存在“采购订单已更改”事件。示例 truefalse
	采购订单状态 PurchaseOrderStatus	采购订单在生命周期中的当前状态。
说明此属性表示采购订单的当前状态，例如“订购中”“收货中”“已开票”或“已完成”，用于快速了解采购订单在整体流程中的位置。流程挖掘通过活动重建流程，而当前状态则适合用于筛选案例和了解当前工作量。例如，分析人员可能只关注尚未完成的“进行中”采购订单。此属性还可用于验证流程轨迹中的最终活动。为什么重要快速显示采购订单在生命周期中的位置，便于筛选并聚焦于进行中或已完成的案例。获取位置这是SAP Ariba采购订单文档抬头中的标准状态字段。示例订购中收货中已完成已取消
	采购订单端到端周期时间 POEndToEndCycleTime	从创建第一条采购申请到采购订单最终完成所经过的总时间。
说明此计算属性衡量整个采购订单流程的总时长。通常从“已创建采购申请”事件开始，到“采购订单已完成”或最终“收货过账”事件结束，全面反映流程效率。这是“端到端采购订单周期时间”KPI和“采购订单端到端周期时间”仪表板的主要指标。组织可以据此跟踪整体表现及流程改进的影响。按供应商、部门或物料组拆解总周期时间，可以发现导致交付周期过长的主要因素。为什么重要表示采购订单的总处理时间，为整体流程效率和客户体验提供高层次衡量指标。获取位置在数据转换期间计算，方法是求指定案例最早与最晚时间戳之差。示例 P15DP30D12HP7D
	采购订单类型 PurchaseOrderType	采购订单的分类，例如标准订单、框架订单或分包订单。
说明采购订单类型根据业务目的对订单进行分类。不同类型的订单可能遵循不同的流程路径，并适用不同的审批和履行规则。此属性支持细分流程，从而开展更有针对性的分析。例如，将“标准采购订单”与“服务采购订单”的周期时间分开分析，可以发现不同类型的瓶颈。它还有助于创建更同质的数据子集，更清晰地了解具体采购场景。为什么重要支持按订单类型细分分析，从而获得更准确的洞察，因为不同类型通常具有不同的流程。获取位置请参阅SAP Ariba文档。此字段通常可在采购订单抬头层级配置。示例标准采购订单服务采购订单框架采购订单

必需建议可选

采购到付款-采购订单活动

以下是应在事件日志中记录的关键流程步骤和里程碑，用于准确发现采购到付款-采购订单流程。

6 建议 8 可选

	活动	说明
	创建采购申请	此活动表示创建采购申请，即在采购订单之前提出的货物或服务正式申请。在SAP Ariba中，通常在用户保存并提交新的采购申请文档时记录，并生成带有创建时间戳的明确记录。
为什么重要这是采购流程的主要起点。分析从该事件到采购订单创建之间的时间，对于了解采购申请到订单的周期时间并识别早期瓶颈至关重要。获取位置此事件取自SAP Ariba Buying模块中采购申请文档对象的创建日期。状态变更为“Submitted”通常表示流程正式开始。采集依据采购申请文档的创建时间戳。事件类型 explicit
	创建采购订单	此活动表示在SAP Ariba中创建正式采购订单文档，可以由已审批的采购申请生成，也可以直接创建。该事件取自采购订单文档的创建时间戳，代表采购订单生命周期正式开始。
为什么重要对于直接创建的采购订单，这是流程起点，也是衡量采购申请到采购订单转换时间和采购订单整体处理周期的关键里程碑。获取位置取自SAP Ariba Buying中PurchaseOrder文档对象的创建时间戳。此时状态通常为“Composing”或“Submitted”。采集依据采购订单文档的创建时间戳。事件类型 explicit
	收货已过账	表示货物已实际收货，并已记录在SAP Ariba中。当用户针对采购订单行项目创建并提交Receipt文档时，系统会记录这一明确事件。
为什么重要这是确认交付的关键里程碑，也是衡量供应商交付绩效的终点。在三方匹配场景中，该事件还授权支付发票。获取位置取自与PurchaseOrder关联的Receipt文档创建或提交时间戳。采集依据Goods Receipt文档的提交时间戳。事件类型 explicit
	采购订单已发送给供应商	表示已审批的采购订单正式发送给供应商的时刻，通常通过Ariba Network完成。该事件在采购订单状态变更为“Sent”或“Ordered”时记录。
为什么重要这标志着流程从内部处理转入外部履约，是衡量供应商交付周期和交付绩效的起点。获取位置根据PurchaseOrder文档状态变更为“Sent”或“Ordered”时的时间戳推断。这是Ariba中的标准状态转换。采集根据状态变更为“Sent”或类似状态时的时间戳推断。事件类型 inferred
	采购订单已完成	此活动标志着采购订单生命周期成功结束，表示货物或服务已全部收取并完成开票。通常根据采购订单状态变更为“Received”“Invoiced”或类似终止状态推断。
为什么重要这是流程成功完成的主要终点。衡量达到该状态所需的时间，可以得到端到端周期时间，这是评估整体流程效率的重要指标。获取位置根据PurchaseOrder状态变更为“Received”等最终状态时的时间戳推断。当所有行项目均已全部收货时，采购订单视为完成。采集根据采购订单状态变更为“Received”或类似完成状态推断。事件类型 inferred
	采购订单已审批	表示采购订单已获得所有必要的内部审批，可以发送给供应商。该事件根据采购订单完成指定工作流后，文档状态变更为“Approved”推断。
为什么重要这是衡量审批周期时间和识别管理审核瓶颈的关键里程碑。此处的延迟会直接影响供应商交付周期和采购效率。获取位置根据PurchaseOrder文档的状态或“ApprovedState”字段变更为“Approved”时的时间戳推断。审批历史日志可提供详细数据。采集根据采购订单审批流中最终审批操作的时间戳推断。事件类型 inferred
	供应商已确认采购订单	表示供应商已收到并确认采购订单，确认其履约意向。供应商通过Ariba Network提交Order Confirmation文档后，采购订单状态会更新，此时记录该事件。
为什么重要此活动表明供应商正在处理订单，有助于跟踪供应商响应速度和初始订单的准确性。获取位置根据供应商提交Order Confirmation后PurchaseOrder状态更新为“Confirmed”时的时间戳推断。采集依据相关Order Confirmation文档的创建日期或采购订单状态变更记录。事件类型 inferred
	已收到针对采购订单的发票	表示已收到供应商开具的、引用该采购订单的发票，并已录入SAP Ariba。此事件将采购流程与后续付款流程连接起来。
为什么重要此活动是采购与财务之间的关键集成点。其时间安排对于管理营运资金和确保按时向供应商付款非常重要。获取位置取自Ariba Invoicing中Invoice文档的创建时间戳，该文档包含对PurchaseOrder的引用。采集依据与采购订单关联的发票文档创建时间戳。事件类型 explicit
	已收到预发货通知	供应商通过Ariba Network发送Advance Ship Notice（ASN）时记录此活动，表示货物已发出。ASN包含货物、数量和跟踪信息等装运详情。
为什么重要 ASN为供应链提供可视性，使收货部门能够为交付做好准备，也是跟踪在途库存和预测交付时间的重要输入。获取位置取自与PurchaseOrder行项目关联的ShipNotice文档创建日期。采集依据Advance Ship Notice（ASN）文档的创建时间戳。事件类型 explicit
	服务确认已录入	表示服务已完成确认，相当于服务类采购中的收货。针对服务类采购订单创建并审批Service Sheet时记录此事件。
为什么重要此活动对于跟踪服务订单履约和授权付款至关重要。分析其及时性有助于管理服务交付和相关支出。获取位置取自与PurchaseOrder关联的ServiceSheet文档审批时间戳。采集依据Service Sheet文档的审批时间戳。事件类型 explicit
	货物已退回供应商	此活动记录向供应商退货的情况，通常原因包括货物损坏、存在缺陷或交付错误。针对原始收货创建退货收货单或借项通知单时记录。
为什么重要跟踪退货有助于发现供应商质量和交付准确性问题。分析退货频率及原因，可以改进供应商选择和管理。获取位置可根据创建退货专用收货文档，或收货数量为负数进行推断。具体方式可能因配置而异。采集根据创建数量为负数或特定“Return”类型的收货记录推断。事件类型 inferred
	采购申请已审批	表示采购申请已获得所有必要相关方的最终审批，可转换为采购订单。通常根据采购申请文档状态变更为“Approved”，以及最终审批操作的时间戳推断。
为什么重要这一里程碑标志着申请内部审批阶段结束。跟踪该节点有助于衡量采购订单创建前内部控制和审批工作流的效率。获取位置根据采购申请文档的审批历史或状态字段推断。事件时间戳对应状态变更为“Approved”的日期。采集根据采购申请的“ApprovedState”字段变更为“Approved”时的时间戳推断。事件类型 inferred
	采购订单已取消	表示采购订单在履约前终止。该操作可以由采购组织发起，少数情况下也可能由供应商发起。
为什么重要这是一个重要的异常和流程终点。分析采购订单取消原因，可以发现计划、预算或供应商可靠性方面的问题。获取位置根据PurchaseOrder文档状态变更为“Cancelled”或“Closed”时的时间戳推断。采集根据状态变更为“Cancelled”时的时间戳推断。事件类型 inferred
	采购订单已变更	此活动记录采购订单初次创建后发生的任何修改，例如数量、价格或交付日期变更。系统会创建采购订单文档的新版本，并通常触发重新审批工作流。
为什么重要跟踪变更对于识别流程低效、返工循环和采购错误根因至关重要。较高的变更率可能表明前期需求收集不充分。获取位置通过识别同一PurchaseOrder文档的多个版本进行记录。每个新版本都有创建时间戳，可用于记录此事件。采集创建并保存采购订单文档新版本时记录。事件类型 explicit

建议可选

提取指南

如何从SAP Ariba获取数据

步骤

访问分析报告：使用具有报告管理员或报告用户权限的账号登录SAP Ariba实例。依次点击Manage > Analytical Reporting，进入报告仪表板。
创建新报告：点击Create按钮并选择Report。在可用选项中选择Transactional Report，基于事务数据事实构建报告。
选择数据模型（Fact）：选择包含采购数据的适当数据模型。其名称通常为Procurement Workspace Data、Sourcing and Procurement Data，或类似的自定义事实模型，例如[Your Procurement Data Mart]。选择该模型作为报告基础。
添加报告内容（事实和维度）：在Data Fields面板中，通过向报告查询添加所需对象来调整报告。从Purchase Order、Purchase Requisition、Receipt、Invoice和User中至少包含相应事实。将所需字段拖放到Report Columns区域。
定义报告列：添加构建事件日志所需的全部字段。这将是一个“宽表”导出文件，之后需要转换。包括：
- Purchase Order.ID（作为PurchaseOrderNumber）
- Purchase Requisition.Time Created
- Purchase Requisition.Approved Date
- Purchase Order.Time Created
- Purchase Order.Approved Date
- Purchase Order.Version Time Created（用于记录变更）
- Purchase Order.Ordered Date（用于Sent to Vendor）
- Order Confirmation.Confirmation Date
- Advance Ship Notice.Time Created
- Receipt.Receipt Date（作为GoodsReceiptDate）
- Service Sheet.Approved Date
- Invoice.Time Created
- Purchase Order.Closed Date（用于Completed）
- Purchase Order.Canceled Date
- 另外添加User.Name、Department.Name、Supplier.Name、Purchase Order.Total Cost和Purchase Order.Req Delivery Date。
设置报告筛选条件：进入Filters选项卡，为主要时间戳设置筛选条件，以限制数据量。常用做法是选择Purchase Order.Time Created，筛选最近3至6个月的数据。还可添加Company Code或Purchasing Organization等关键筛选条件，将数据限定在分析范围内。
保存并运行报告：使用清晰的名称保存报告，例如ProcessMind_P2P_PO_Extraction。对于大型数据集，请使用Schedule选项安排夜间运行，避免影响系统性能。不要立即运行。
导出报告数据：报告运行完成后，进入已安排的报告，找到已完成的实例并下载输出文件。为确保与数据转换工具兼容，建议选择CSV格式。
转换数据：导出的CSV为宽表格式（每个采购订单一行），必须转换为长表格式的事件日志。使用Microsoft Excel Power Query、Python或专用ETL工具，对日期列执行“取消透视”。对于原文件中的每一行，为每个非空日期列创建一行新记录。每行新记录应包含PurchaseOrderNumber、ActivityName（由原日期列标题生成）和EventTime（该日期列的值）。
完成并上传：确保最终转换后的CSV包含所需列标题（PurchaseOrderNumber、ActivityName、EventTime等）。完成后即可将文件上传到您的流程挖掘平台。

配置

前提条件：需要具有“Reporting User”或“Reporting Administrator”权限的用户账号，才能创建、运行和安排分析报告。
报告类型：使用Transactional Report。该类型支持将多个数据事实（例如PO、Requisition和Invoice）合并到一份报告中，是记录端到端流程的必要条件。
数据模型（Fact）：报告必须基于完整的采购数据集市，例如Procurement Workspace Data或等效的自定义模型，并将采购订单与相关单据关联起来。
日期范围筛选：始终应用日期筛选条件，以限制数据集大小。建议先按Purchase Order Creation Date筛选最近3至6个月的活动数据。
关键数据筛选条件：为确保数据相关性并控制数据量，请按Company Code和/或Purchasing Organization筛选，将提取范围限定到特定业务单元。
性能注意事项：当采购订单数量超过数万条时，请始终安排报告在业务低峰期运行。按需运行大型复杂报告可能影响所有用户的系统性能。

a 示例查询 sql

/*
This is a conceptual SQL query representing the logic to be built in the SAP Ariba Analytical Reporting UI.
The final output is a single CSV file that is later transformed into an event log.
The Ariba UI does not use SQL directly; this query illustrates the required data structure and joins.
*/

-- Activity: Purchase Requisition Created
SELECT
  po.PO_NUMBER AS "PurchaseOrderNumber",
  'Purchase Requisition Created' AS "ActivityName",
  pr.CREATION_TIME AS "EventTime",
  pr_creator.USER_NAME AS "UserName",
  dept.DEPARTMENT_NAME AS "DepartmentName",
  vendor.VENDOR_NAME AS "VendorName",
  po.TOTAL_AMOUNT AS "PurchaseOrderAmount",
  po.REQUESTED_DELIVERY_DATE AS "RequestedDeliveryDate",
  NULL AS "GoodsReceiptDate"
FROM [Ariba.POHeader] po
LEFT JOIN [Ariba.PRHeader] pr ON po.PR_ID = pr.PR_ID
LEFT JOIN [Ariba.Users] pr_creator ON pr.CREATED_BY_USER_ID = pr_creator.USER_ID
LEFT JOIN [Ariba.Departments] dept ON po.DEPARTMENT_ID = dept.DEPT_ID
LEFT JOIN [Ariba.Vendors] vendor ON po.VENDOR_ID = vendor.VENDOR_ID
WHERE po.CREATION_TIME BETWEEN '[START_DATE]' AND '[END_DATE]' AND po.COMPANY_CODE IN ('[Your Company Code]')

UNION ALL

-- Activity: Purchase Requisition Approved
SELECT
  po.PO_NUMBER AS "PurchaseOrderNumber",
  'Purchase Requisition Approved' AS "ActivityName",
  pr.APPROVAL_TIME AS "EventTime",
  pr_approver.USER_NAME AS "UserName",
  dept.DEPARTMENT_NAME AS "DepartmentName",
  vendor.VENDOR_NAME AS "VendorName",
  po.TOTAL_AMOUNT AS "PurchaseOrderAmount",
  po.REQUESTED_DELIVERY_DATE AS "RequestedDeliveryDate",
  NULL AS "GoodsReceiptDate"
FROM [Ariba.POHeader] po
LEFT JOIN [Ariba.PRHeader] pr ON po.PR_ID = pr.PR_ID
LEFT JOIN [Ariba.Users] pr_approver ON pr.APPROVED_BY_USER_ID = pr_approver.USER_ID
LEFT JOIN [Ariba.Departments] dept ON po.DEPARTMENT_ID = dept.DEPT_ID
LEFT JOIN [Ariba.Vendors] vendor ON po.VENDOR_ID = vendor.VENDOR_ID
WHERE po.CREATION_TIME BETWEEN '[START_DATE]' AND '[END_DATE]' AND po.COMPANY_CODE IN ('[Your Company Code]') AND pr.APPROVAL_TIME IS NOT NULL

UNION ALL

-- Activity: Purchase Order Created
SELECT
  po.PO_NUMBER AS "PurchaseOrderNumber",
  'Purchase Order Created' AS "ActivityName",
  po.CREATION_TIME AS "EventTime",
  po_creator.USER_NAME AS "UserName",
  dept.DEPARTMENT_NAME AS "DepartmentName",
  vendor.VENDOR_NAME AS "VendorName",
  po.TOTAL_AMOUNT AS "PurchaseOrderAmount",
  po.REQUESTED_DELIVERY_DATE AS "RequestedDeliveryDate",
  NULL AS "GoodsReceiptDate"
FROM [Ariba.POHeader] po
LEFT JOIN [Ariba.Users] po_creator ON po.CREATED_BY_USER_ID = po_creator.USER_ID
LEFT JOIN [Ariba.Departments] dept ON po.DEPARTMENT_ID = dept.DEPT_ID
LEFT JOIN [Ariba.Vendors] vendor ON po.VENDOR_ID = vendor.VENDOR_ID
WHERE po.CREATION_TIME BETWEEN '[START_DATE]' AND '[END_DATE]' AND po.COMPANY_CODE IN ('[Your Company Code]')

UNION ALL

-- Activity: Purchase Order Approved
SELECT
  po.PO_NUMBER AS "PurchaseOrderNumber",
  'Purchase Order Approved' AS "ActivityName",
  po.APPROVAL_TIME AS "EventTime",
  po_approver.USER_NAME AS "UserName",
  dept.DEPARTMENT_NAME AS "DepartmentName",
  vendor.VENDOR_NAME AS "VendorName",
  po.TOTAL_AMOUNT AS "PurchaseOrderAmount",
  po.REQUESTED_DELIVERY_DATE AS "RequestedDeliveryDate",
  NULL AS "GoodsReceiptDate"
FROM [Ariba.POHeader] po
LEFT JOIN [Ariba.Users] po_approver ON po.APPROVED_BY_USER_ID = po_approver.USER_ID
LEFT JOIN [Ariba.Departments] dept ON po.DEPARTMENT_ID = dept.DEPT_ID
LEFT JOIN [Ariba.Vendors] vendor ON po.VENDOR_ID = vendor.VENDOR_ID
WHERE po.CREATION_TIME BETWEEN '[START_DATE]' AND '[END_DATE]' AND po.COMPANY_CODE IN ('[Your Company Code]') AND po.APPROVAL_TIME IS NOT NULL

UNION ALL

-- Activity: Purchase Order Changed
SELECT
  po.PO_NUMBER AS "PurchaseOrderNumber",
  'Purchase Order Changed' AS "ActivityName",
  ver.VERSION_CREATION_TIME AS "EventTime",
  changer.USER_NAME AS "UserName",
  dept.DEPARTMENT_NAME AS "DepartmentName",
  vendor.VENDOR_NAME AS "VendorName",
  po.TOTAL_AMOUNT AS "PurchaseOrderAmount",
  po.REQUESTED_DELIVERY_DATE AS "RequestedDeliveryDate",
  NULL AS "GoodsReceiptDate"
FROM [Ariba.POHeader] po
INNER JOIN [Ariba.POVersions] ver ON po.PO_ID = ver.PO_ID AND ver.VERSION_NUMBER > 1
LEFT JOIN [Ariba.Users] changer ON ver.CHANGED_BY_USER_ID = changer.USER_ID
LEFT JOIN [Ariba.Departments] dept ON po.DEPARTMENT_ID = dept.DEPT_ID
LEFT JOIN [Ariba.Vendors] vendor ON po.VENDOR_ID = vendor.VENDOR_ID
WHERE po.CREATION_TIME BETWEEN '[START_DATE]' AND '[END_DATE]' AND po.COMPANY_CODE IN ('[Your Company Code]')

UNION ALL

-- Activity: Purchase Order Sent To Vendor
SELECT
  po.PO_NUMBER AS "PurchaseOrderNumber",
  'Purchase Order Sent To Vendor' AS "ActivityName",
  po.ORDERED_TIME AS "EventTime",
  sender.USER_NAME AS "UserName",
  dept.DEPARTMENT_NAME AS "DepartmentName",
  vendor.VENDOR_NAME AS "VendorName",
  po.TOTAL_AMOUNT AS "PurchaseOrderAmount",
  po.REQUESTED_DELIVERY_DATE AS "RequestedDeliveryDate",
  NULL AS "GoodsReceiptDate"
FROM [Ariba.POHeader] po
LEFT JOIN [Ariba.Users] sender ON po.ORDERED_BY_USER_ID = sender.USER_ID
LEFT JOIN [Ariba.Departments] dept ON po.DEPARTMENT_ID = dept.DEPT_ID
LEFT JOIN [Ariba.Vendors] vendor ON po.VENDOR_ID = vendor.VENDOR_ID
WHERE po.CREATION_TIME BETWEEN '[START_DATE]' AND '[END_DATE]' AND po.COMPANY_CODE IN ('[Your Company Code]') AND po.ORDERED_TIME IS NOT NULL

UNION ALL

-- Activity: Vendor Confirmed Purchase Order
SELECT
  po.PO_NUMBER AS "PurchaseOrderNumber",
  'Vendor Confirmed Purchase Order' AS "ActivityName",
  oc.CONFIRMATION_TIME AS "EventTime",
  'System/Vendor' AS "UserName",
  dept.DEPARTMENT_NAME AS "DepartmentName",
  vendor.VENDOR_NAME AS "VendorName",
  po.TOTAL_AMOUNT AS "PurchaseOrderAmount",
  po.REQUESTED_DELIVERY_DATE AS "RequestedDeliveryDate",
  NULL AS "GoodsReceiptDate"
FROM [Ariba.POHeader] po
INNER JOIN [Ariba.OrderConfirmations] oc ON po.PO_ID = oc.PO_ID
LEFT JOIN [Ariba.Departments] dept ON po.DEPARTMENT_ID = dept.DEPT_ID
LEFT JOIN [Ariba.Vendors] vendor ON po.VENDOR_ID = vendor.VENDOR_ID
WHERE po.CREATION_TIME BETWEEN '[START_DATE]' AND '[END_DATE]' AND po.COMPANY_CODE IN ('[Your Company Code]') AND oc.CONFIRMATION_TIME IS NOT NULL

UNION ALL

-- Activity: Advance Ship Notice Received
SELECT
  po.PO_NUMBER AS "PurchaseOrderNumber",
  'Advance Ship Notice Received' AS "ActivityName",
  asn.CREATION_TIME AS "EventTime",
  'System/Vendor' AS "UserName",
  dept.DEPARTMENT_NAME AS "DepartmentName",
  vendor.VENDOR_NAME AS "VendorName",
  po.TOTAL_AMOUNT AS "PurchaseOrderAmount",
  po.REQUESTED_DELIVERY_DATE AS "RequestedDeliveryDate",
  NULL AS "GoodsReceiptDate"
FROM [Ariba.POHeader] po
INNER JOIN [Ariba.ASNs] asn ON po.PO_ID = asn.PO_ID
LEFT JOIN [Ariba.Departments] dept ON po.DEPARTMENT_ID = dept.DEPT_ID
LEFT JOIN [Ariba.Vendors] vendor ON po.VENDOR_ID = vendor.VENDOR_ID
WHERE po.CREATION_TIME BETWEEN '[START_DATE]' AND '[END_DATE]' AND po.COMPANY_CODE IN ('[Your Company Code]') AND asn.CREATION_TIME IS NOT NULL

UNION ALL

-- Activity: Goods Receipt Posted
SELECT
  po.PO_NUMBER AS "PurchaseOrderNumber",
  'Goods Receipt Posted' AS "ActivityName",
  rcpt.RECEIPT_TIME AS "EventTime",
  receiver.USER_NAME AS "UserName",
  dept.DEPARTMENT_NAME AS "DepartmentName",
  vendor.VENDOR_NAME AS "VendorName",
  po.TOTAL_AMOUNT AS "PurchaseOrderAmount",
  po.REQUESTED_DELIVERY_DATE AS "RequestedDeliveryDate",
  rcpt.RECEIPT_TIME AS "GoodsReceiptDate"
FROM [Ariba.POHeader] po
INNER JOIN [Ariba.Receipts] rcpt ON po.PO_ID = rcpt.PO_ID
LEFT JOIN [Ariba.Users] receiver ON rcpt.CREATED_BY_USER_ID = receiver.USER_ID
LEFT JOIN [Ariba.Departments] dept ON po.DEPARTMENT_ID = dept.DEPT_ID
LEFT JOIN [Ariba.Vendors] vendor ON po.VENDOR_ID = vendor.VENDOR_ID
WHERE po.CREATION_TIME BETWEEN '[START_DATE]' AND '[END_DATE]' AND po.COMPANY_CODE IN ('[Your Company Code]') AND rcpt.RECEIPT_TYPE = 'Goods'

UNION ALL

-- Activity: Services Confirmation Entered
SELECT
  po.PO_NUMBER AS "PurchaseOrderNumber",
  'Services Confirmation Entered' AS "ActivityName",
  ss.APPROVAL_TIME AS "EventTime",
  ss_creator.USER_NAME AS "UserName",
  dept.DEPARTMENT_NAME AS "DepartmentName",
  vendor.VENDOR_NAME AS "VendorName",
  po.TOTAL_AMOUNT AS "PurchaseOrderAmount",
  po.REQUESTED_DELIVERY_DATE AS "RequestedDeliveryDate",
  ss.APPROVAL_TIME AS "GoodsReceiptDate"
FROM [Ariba.POHeader] po
INNER JOIN [Ariba.ServiceSheets] ss ON po.PO_ID = ss.PO_ID
LEFT JOIN [Ariba.Users] ss_creator ON ss.CREATED_BY_USER_ID = ss_creator.USER_ID
LEFT JOIN [Ariba.Departments] dept ON po.DEPARTMENT_ID = dept.DEPT_ID
LEFT JOIN [Ariba.Vendors] vendor ON po.VENDOR_ID = vendor.VENDOR_ID
WHERE po.CREATION_TIME BETWEEN '[START_DATE]' AND '[END_DATE]' AND po.COMPANY_CODE IN ('[Your Company Code]') AND ss.APPROVAL_TIME IS NOT NULL

UNION ALL

-- Activity: Goods Returned To Vendor
SELECT
  po.PO_NUMBER AS "PurchaseOrderNumber",
  'Goods Returned To Vendor' AS "ActivityName",
  rcpt.RECEIPT_TIME AS "EventTime",
  returner.USER_NAME AS "UserName",
  dept.DEPARTMENT_NAME AS "DepartmentName",
  vendor.VENDOR_NAME AS "VendorName",
  po.TOTAL_AMOUNT AS "PurchaseOrderAmount",
  po.REQUESTED_DELIVERY_DATE AS "RequestedDeliveryDate",
  NULL AS "GoodsReceiptDate"
FROM [Ariba.POHeader] po
INNER JOIN [Ariba.Receipts] rcpt ON po.PO_ID = rcpt.PO_ID AND rcpt.RECEIPT_TYPE = 'Return'
LEFT JOIN [Ariba.Users] returner ON rcpt.CREATED_BY_USER_ID = returner.USER_ID
LEFT JOIN [Ariba.Departments] dept ON po.DEPARTMENT_ID = dept.DEPT_ID
LEFT JOIN [Ariba.Vendors] vendor ON po.VENDOR_ID = vendor.VENDOR_ID
WHERE po.CREATION_TIME BETWEEN '[START_DATE]' AND '[END_DATE]' AND po.COMPANY_CODE IN ('[Your Company Code]')

UNION ALL

-- Activity: Invoice Received Against PO
SELECT
  po.PO_NUMBER AS "PurchaseOrderNumber",
  'Invoice Received Against PO' AS "ActivityName",
  inv.CREATION_TIME AS "EventTime",
  'System/AP' AS "UserName",
  dept.DEPARTMENT_NAME AS "DepartmentName",
  vendor.VENDOR_NAME AS "VendorName",
  po.TOTAL_AMOUNT AS "PurchaseOrderAmount",
  po.REQUESTED_DELIVERY_DATE AS "RequestedDeliveryDate",
  NULL AS "GoodsReceiptDate"
FROM [Ariba.POHeader] po
INNER JOIN [Ariba.Invoices] inv ON po.PO_ID = inv.PO_ID
LEFT JOIN [Ariba.Departments] dept ON po.DEPARTMENT_ID = dept.DEPT_ID
LEFT JOIN [Ariba.Vendors] vendor ON po.VENDOR_ID = vendor.VENDOR_ID
WHERE po.CREATION_TIME BETWEEN '[START_DATE]' AND '[END_DATE]' AND po.COMPANY_CODE IN ('[Your Company Code]')

UNION ALL

-- Activity: Purchase Order Completed
SELECT
  po.PO_NUMBER AS "PurchaseOrderNumber",
  'Purchase Order Completed' AS "ActivityName",
  po.COMPLETED_TIME AS "EventTime",
  'System' AS "UserName",
  dept.DEPARTMENT_NAME AS "DepartmentName",
  vendor.VENDOR_NAME AS "VendorName",
  po.TOTAL_AMOUNT AS "PurchaseOrderAmount",
  po.REQUESTED_DELIVERY_DATE AS "RequestedDeliveryDate",
  NULL AS "GoodsReceiptDate"
FROM [Ariba.POHeader] po
LEFT JOIN [Ariba.Departments] dept ON po.DEPARTMENT_ID = dept.DEPT_ID
LEFT JOIN [Ariba.Vendors] vendor ON po.VENDOR_ID = vendor.VENDOR_ID
WHERE po.CREATION_TIME BETWEEN '[START_DATE]' AND '[END_DATE]' AND po.COMPANY_CODE IN ('[Your Company Code]') AND po.STATUS = 'Completed'

UNION ALL

-- Activity: Purchase Order Cancelled
SELECT
  po.PO_NUMBER AS "PurchaseOrderNumber",
  'Purchase Order Cancelled' AS "ActivityName",
  po.CANCELLED_TIME AS "EventTime",
  canceller.USER_NAME AS "UserName",
  dept.DEPARTMENT_NAME AS "DepartmentName",
  vendor.VENDOR_NAME AS "VendorName",
  po.TOTAL_AMOUNT AS "PurchaseOrderAmount",
  po.REQUESTED_DELIVERY_DATE AS "RequestedDeliveryDate",
  NULL AS "GoodsReceiptDate"
FROM [Ariba.POHeader] po
LEFT JOIN [Ariba.Users] canceller ON po.CANCELLED_BY_USER_ID = canceller.USER_ID
LEFT JOIN [Ariba.Departments] dept ON po.DEPARTMENT_ID = dept.DEPT_ID
LEFT JOIN [Ariba.Vendors] vendor ON po.VENDOR_ID = vendor.VENDOR_ID
WHERE po.CREATION_TIME BETWEEN '[START_DATE]' AND '[END_DATE]' AND po.COMPANY_CODE IN ('[Your Company Code]') AND po.STATUS = 'Cancelled'

步骤

前提条件：确保您拥有SAP Ariba开发者账号，并已创建具有API访问权限的应用。您需要API Key、OAuth Client ID和OAuth Client Secret。该应用必须获得批准，并被授予Analytical Reporting API权限。
配置报告视图：在SAP Ariba管理界面中，确保已配置分析报告视图（也称为视图模板），包含采购订单生命周期所需的全部字段。该视图应关联申请、采购订单、收货和发票数据。记下视图模板的准确名称，因为API调用需要使用该名称。
安装Python库：设置Python环境并安装必要的库：用于发起API调用的requests和用于数据处理的pandas。可使用以下命令安装：pip install requests pandas。
设置Python脚本：将提供的Python脚本复制到文件中，例如ariba_p2p_extractor.py。将脚本顶部的占位变量替换为您的Ariba凭据、API端点和报告视图模板名称。
身份验证并获取令牌：脚本的第一部分负责OAuth 2.0身份验证，将您的凭据发送到Ariba身份验证端点，以获取后续API调用所需的临时访问令牌。
定义并提交报告任务：脚本构建定义报告任务的JSON负载，指定要使用的视图模板，并设置采购订单创建日期范围等筛选条件。随后将任务提交到Ariba Reporting API，异步启动报告生成。
轮询任务完成状态：由于报告异步生成，脚本会进入轮询循环，定期向API发送请求检查任务状态，直到状态变为Completed。
下载报告数据：任务完成后，脚本从状态响应中获取下载URL，下载以GZIP压缩CSV文件提供的报告数据，并将其解压。
将数据转换为事件日志：将下载的CSV加载到pandas DataFrame中。该数据通常为宽表格式（每个采购订单一行）。脚本随后将宽表转换为长表事件日志格式，遍历对应不同业务事件的列（例如pr.TimeCreated、po.ApprovedDate），并为每个有效时间戳创建一行对应活动记录。
映射属性：转换过程中，脚本为每个事件填充所需列：PurchaseOrderNumber（Case ID）、ActivityName和EventTime。同时将UserName、VendorName和PurchaseOrderAmount等相关信息映射到每个事件行。
保存最终事件日志：处理完所有活动并生成完整事件日志后，脚本按案例ID和事件时间排序数据。最后将结果DataFrame保存为ariba_p2p_event_log.csv，即可上传到流程挖掘工具。

配置

API应用：必须在SAP Ariba Developer Portal中注册应用，并启用Analytical Reporting API访问权限。
报告视图模板：此方法的核心是预先构建的报告视图。必须在Ariba中配置该视图，关联所有必要的单据类型（Purchase Requisition、Purchase Order、Receipt、Service Sheet、Invoice），并提供所需的日期和属性字段。
身份验证：脚本使用OAuth 2.0进行身份验证。您必须提供Ariba应用的有效API Key、Client ID和Client Secret。
日期范围筛选：API调用应包含采购订单创建日期（po.TimeCreated）筛选条件，以限制提取范围。通常选择3至12个月的数据，在详细程度和性能之间取得平衡。
Realm名称：构建API端点时需要使用您公司专属的Ariba realm名称。
API端点：确保使用正确的身份验证基础URL（api.ariba.com）和报告基础URL（[your-realm].ariba.com）。
数据粒度：根据流程分析所需的详细程度，将报告视图配置为Purchase Order抬头级别或行项目级别。

a 示例查询 python

import requests
import pandas as pd
import json
import time
import gzip
import io

class=class="hl-string">"hl-comment"># --- Configuration Settings --- #
class=class="hl-string">"hl-comment"># Replace with your SAP Ariba Developer Portal application credentials
API_KEY = class="hl-string">'[Your_API_Key]'
CLIENT_ID = class="hl-string">'[Your_OAuth_Client_ID]'
CLIENT_SECRET = class="hl-string">'[Your_OAuth_Client_Secret]'

class=class="hl-string">"hl-comment"># Replace with your company's Ariba realm information
REALM = class="hl-string">'[Your_Company_Ariba_Realm]'

class=class="hl-string">"hl-comment"># Replace with the exact name of your pre-configured reporting view in Ariba
VIEW_TEMPLATE_NAME = class="hl-string">'[Your_P2P_View_Template]'

class=class="hl-string">"hl-comment"># --- API Endpoints --- #
AUTH_URL = class="hl-string">'https://api.ariba.com/v2/oauth/token'
API_BASE_URL = fclass="hl-string">'https://{REALM}.ariba.com/api/analytics-reporting-view/v1'

class=class="hl-string">"hl-comment"># --- Helper Functions --- #
def get_access_token():
    class="hl-string">"""Authenticates with Ariba and returns an access token."""
    auth_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
    }
    try:
        response = requests.post(AUTH_URL, data=auth_payload)
        response.raise_for_status()
        return response.json()[class="hl-string">'access_token']
    except requests.exceptions.RequestException as e:
        print(fclass="hl-string">"Error getting access token: {e}")
        print(fclass="hl-string">"Response body: {response.text}")
        return None

def main():
    class="hl-string">"""Main function to run the extraction process."""
    access_token = get_access_token()
    if not access_token:
        return

    headers = {
        class="hl-string">'Authorization': fclass="hl-string">'Bearer {access_token}',
        class="hl-string">'apiKey': API_KEY,
        class="hl-string">'Content-Type': class="hl-string">'application/json'
    }

    class=class="hl-string">"hl-comment"># Define the reporting job with filters
    report_job_payload = {
        class="hl-string">"viewTemplateName": VIEW_TEMPLATE_NAME,
        class="hl-string">"filters": {
            class="hl-string">"createdDateFrom": class="hl-string">"2023-01-01T00:00:00Z",
            class="hl-string">"createdDateTo": class="hl-string">"2023-12-31T23:59:59Z"
        },
        class="hl-string">"outputFormat": class="hl-string">"csv"
    }

    class=class="hl-string">"hl-comment"># 1. Submit the report generation job
    print(class="hl-string">"Submitting report job...")
    try:
        submit_response = requests.post(fclass="hl-string">'{API_BASE_URL}/jobs', headers=headers, json=report_job_payload)
        submit_response.raise_for_status()
        job_id = submit_response.json()[class="hl-string">'jobId']
        print(fclass="hl-string">"Job submitted successfully. Job ID: {job_id}")
    except requests.exceptions.RequestException as e:
        print(fclass="hl-string">"Error submitting job: {e}")
        print(fclass="hl-string">"Response body: {submit_response.text}")
        return

    class=class="hl-string">"hl-comment"># 2. Poll for job completion
    while True:
        print(class="hl-string">"Checking job status...")
        try:
            status_response = requests.get(fclass="hl-string">'{API_BASE_URL}/jobs/{job_id}', headers=headers)
            status_response.raise_for_status()
            status = status_response.json()[class="hl-string">'status']
            print(fclass="hl-string">"Current job status: {status}")
            if status == class="hl-string">'COMPLETED':
                download_url = status_response.json()[class="hl-string">'downloadUrl']
                break
            elif status in [class="hl-string">'FAILED', class="hl-string">'NO_DATA']:
                print(fclass="hl-string">"Job finished with status: {status}")
                return
            time.sleep(30)  class=class="hl-string">"hl-comment"># Wait for 30 seconds before polling again
        except requests.exceptions.RequestException as e:
            print(fclass="hl-string">"Error checking job status: {e}")
            return

    class=class="hl-string">"hl-comment"># 3. Download the report data
    print(fclass="hl-string">"Job completed. Downloading data from: {download_url}")
    try:
        download_headers = {class="hl-string">'Authorization': fclass="hl-string">'Bearer {access_token}', class="hl-string">'apiKey': API_KEY}
        data_response = requests.get(download_url, headers=download_headers)
        data_response.raise_for_status()
        class=class="hl-string">"hl-comment"># Decompress the gzipped content
        gzip_file = gzip.GzipFile(fileobj=io.BytesIO(data_response.content))
        df_raw = pd.read_csv(gzip_file)
    except requests.exceptions.RequestException as e:
        print(fclass="hl-string">"Error downloading data: {e}")
        return

    class=class="hl-string">"hl-comment"># 4. Transform data into event log
    print(class="hl-string">"Transforming data into event log format...")
    event_log = []

    class=class="hl-string">"hl-comment"># Rename columns for clarity, assuming view template field names like class="hl-string">'Purchase Order Id',
    class=class="hl-string">"hl-comment"># class="hl-string">'Requisition TimeCreated', class="hl-string">'PO ApprovedDate', etc. Adjust these to match your view template.
    class=class="hl-string">"hl-comment"># Placeholder names are used here.
    column_mapping = {
        class="hl-string">'[Purchase Order Id]': class="hl-string">'PurchaseOrderNumber',
        class="hl-string">'[Requisition TimeCreated]': class="hl-string">'pr_created_time',
        class="hl-string">'[Requisition ApprovedDate]': class="hl-string">'pr_approved_time',
        class="hl-string">'[PO TimeCreated]': class="hl-string">'po_created_time',
        class="hl-string">'[PO ApprovedDate]': class="hl-string">'po_approved_time',
        class="hl-string">'[PO LastModifiedDate]': class="hl-string">'po_changed_time',
        class="hl-string">'[PO OrderedDate]': class="hl-string">'po_sent_time',
        class="hl-string">'[PO ConfirmedDate]': class="hl-string">'po_confirmed_time',
        class="hl-string">'[ASN TimeCreated]': class="hl-string">'asn_received_time',
        class="hl-string">'[Receipt Date]': class="hl-string">'goods_receipt_time',
        class="hl-string">'[Service Sheet End Date]': class="hl-string">'service_confirmed_time',
        class="hl-string">'[Return Date]': class="hl-string">'goods_returned_time',
        class="hl-string">'[Invoice Date]': class="hl-string">'invoice_received_time',
        class="hl-string">'[PO CompletedDate]': class="hl-string">'po_completed_time',
        class="hl-string">'[PO CancelledDate]': class="hl-string">'po_cancelled_time',
        class="hl-string">'[PO Submitter]': class="hl-string">'UserName',
        class="hl-string">'[Department Name]': class="hl-string">'DepartmentName',
        class="hl-string">'[Vendor Name]': class="hl-string">'VendorName',
        class="hl-string">'[PO TotalAmount]': class="hl-string">'PurchaseOrderAmount',
        class="hl-string">'[PO DeliveryDate]': class="hl-string">'RequestedDeliveryDate',
        class="hl-string">'[Receipt Date]': class="hl-string">'GoodsReceiptDate'
    }
    df_raw.rename(columns=column_mapping, inplace=True)

    class=class="hl-string">"hl-comment"># Define activities and their corresponding timestamp columns
    activities = {
        class="hl-string">'Purchase Requisition Created': class="hl-string">'pr_created_time',
        class="hl-string">'Purchase Requisition Approved': class="hl-string">'pr_approved_time',
        class="hl-string">'Purchase Order Created': class="hl-string">'po_created_time',
        class="hl-string">'Purchase Order Approved': class="hl-string">'po_approved_time',
        class="hl-string">'Purchase Order Changed': class="hl-string">'po_changed_time',
        class="hl-string">'Purchase Order Sent To Vendor': class="hl-string">'po_sent_time',
        class="hl-string">'Vendor Confirmed Purchase Order': class="hl-string">'po_confirmed_time',
        class="hl-string">'Advance Ship Notice Received': class="hl-string">'asn_received_time',
        class="hl-string">'Goods Receipt Posted': class="hl-string">'goods_receipt_time',
        class="hl-string">'Services Confirmation Entered': class="hl-string">'service_confirmed_time',
        class="hl-string">'Goods Returned To Vendor': class="hl-string">'goods_returned_time',
        class="hl-string">'Invoice Received Against PO': class="hl-string">'invoice_received_time',
        class="hl-string">'Purchase Order Completed': class="hl-string">'po_completed_time',
        class="hl-string">'Purchase Order Cancelled': class="hl-string">'po_cancelled_time'
    }

    for index, row in df_raw.iterrows():
        base_event = {
            class="hl-string">'PurchaseOrderNumber': row.get(class="hl-string">'PurchaseOrderNumber'),
            class="hl-string">'UserName': row.get(class="hl-string">'UserName'),
            class="hl-string">'DepartmentName': row.get(class="hl-string">'DepartmentName'),
            class="hl-string">'VendorName': row.get(class="hl-string">'VendorName'),
            class="hl-string">'PurchaseOrderAmount': row.get(class="hl-string">'PurchaseOrderAmount'),
            class="hl-string">'RequestedDeliveryDate': row.get(class="hl-string">'RequestedDeliveryDate'),
            class="hl-string">'GoodsReceiptDate': row.get(class="hl-string">'GoodsReceiptDate')
        }

        for activity_name, time_col in activities.items():
            if time_col in row and pd.notna(row[time_col]):
                event = base_event.copy()
                event[class="hl-string">'ActivityName'] = activity_name
                event[class="hl-string">'EventTime'] = row[time_col]
                
                class=class="hl-string">"hl-comment"># Special handling for class="hl-string">'Purchase Order Changed'
                class=class="hl-string">"hl-comment"># This event should only be created if it's after the PO creation time
                if activity_name == class="hl-string">'Purchase Order Changed':
                    if pd.notna(row.get(class="hl-string">'po_created_time')) and pd.to_datetime(row[time_col]) > pd.to_datetime(row[class="hl-string">'po_created_time']):
                        event_log.append(event)
                else:
                    event_log.append(event)

    df_event_log = pd.DataFrame(event_log)
    df_event_log[class="hl-string">'EventTime'] = pd.to_datetime(df_event_log[class="hl-string">'EventTime'])
    df_event_log.sort_values(by=[class="hl-string">'PurchaseOrderNumber', class="hl-string">'EventTime'], inplace=True)

    class=class="hl-string">"hl-comment"># 5. Save the final event log
    output_filename = class="hl-string">'ariba_p2p_event_log.csv'
    df_event_log.to_csv(output_filename, index=False, date_format=class="hl-string">'%Y-%m-%dT%H:%M:%SZ')
    print(fclass="hl-string">"Event log successfully created and saved to {output_filename}")

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

准备开始了吗？

使用此模板简化数据准备工作，自信地开始优化您的采购到付款：采购订单流程。提升效率，从这里开始。

返回改进指南下载模板

立即优化您的采购到付款：采购订单流程！

将SAP Ariba中的周期时间缩短30%，消除瓶颈。

开始免费试用

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

您的采购到付款：采购订单数据模板

您的采购到付款：采购订单数据模板

采购到付款-采购订单属性

采购到付款-采购订单活动

提取指南

SAP Ariba分析报告CSV/Excel导出

步骤

配置

a 示例查询 sql

使用SAP Ariba Reporting API的Python脚本

步骤

配置

a 示例查询 python

准备开始了吗？

立即优化您的采购到付款：采购订单流程！

您的采购到付款：采购订单数据模板

您的采购到付款：采购订单数据模板

采购到付款-采购订单属性

采购到付款-采购订单活动

提取指南

SAP Ariba分析报告CSV/Excel导出

步骤

配置

a 示例查询 sql

使用SAP Ariba Reporting API的Python脚本

步骤

配置

a 示例查询 python

准备开始了吗？

立即优化您的采购到付款：采购订单流程！

我们重视您的隐私