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

SAP Ariba

← 返回改进指南

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

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

此模板提供完整指南，帮助您收集分析采购到付款：采购订单流程所需的关键数据。模板列出了需要跟踪的重要属性和活动，并提供从源系统提取数据的实用说明。借助此资源，您可以为流程发现与优化打好完整、准确的数据基础。

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

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

下载模板

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

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

3 必填 6 建议填写 13 选填

	名称	说明
	事件时间 EventTime	特定活动或事件发生的准确日期和时间。
说明事件时间是与每项活动关联的时间戳，记录活动的开始时间。该数据对于按时间顺序排列事件，以及计算流程不同步骤之间的耗时和周期时间至关重要。几乎所有基于时间的分析都离不开此属性，包括“采购订单端到端周期时间”和“采购订单审批周期时间”仪表板。通过计算“采购订单已创建”和“采购订单已批准”活动时间戳之间的差值，您可以得出“采购订单平均审批周期时间”等关键绩效指标。重要性该时间戳是正确排列事件顺序并计算各类时长指标的基础，例如周期时间和等待时间。获取途径通常可在SAP Ariba采购订单文档的审计跟踪或变更日志数据中找到。示例 2023-04-15T10:30:00Z2023-04-16T14:05:22Z2023-05-01T09:00:15Z
	活动名称 ActivityName	采购订单流程中某个时间点发生的具体事件或任务名称。
说明活动名称用于描述采购订单生命周期中的步骤，例如“采购订单已创建”“采购订单已批准”或“已过账收货”。这些活动按顺序构成流程图的基础。分析活动是流程挖掘的核心。通过分析，您可以直观了解流程走向，识别常见和少见的流程变体，并衡量不同步骤之间的耗时。了解“采购订单已更改”等活动的顺序和频率，对于“采购订单变更率分析”等仪表板至关重要。重要性该属性定义流程中的步骤，便于展示流程走向，并识别瓶颈、返工和偏差。获取途径通过映射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
	事件结束时间 EventEndTime	指示活动完成时间的时间戳，用于计算人工活动的处理时间。
说明开始时间记录活动何时开始，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
	最近数据更新时间 LastDataUpdate	指示此事件的数据最近一次从源系统刷新或提取的时间戳。
说明该属性记录最近一次从SAP Ariba提取数据的日期和时间，是了解分析数据新鲜度的重要元数据。在任何流程挖掘分析中，了解数据的时效性对于报告和决策都至关重要。借助此时间戳，您可以确认仪表板和KPI（例如“采购订单吞吐量趋势”）是否基于最新数据。重要性显示数据的新鲜度，让您了解分析所依据的数据有多新，并增强对分析结果的信任。获取途径该时间戳通常在数据提取、转换和加载（ETL）过程中生成并添加到数据集中。示例 2023-10-27T02:00:00Z2023-10-28T02:00:00Z
	币种 DocumentCurrency	采购订单金额所用的币种代码。
说明该属性用于指定采购订单金额所用的币种，例如USD、EUR或GBP，是理解财务数据的必要背景信息。分析涉及多个国家或地区的流程时，单据币种对于正确解读和比较金额至关重要。所有财务KPI和仪表板都必须使用此字段，按单一币种筛选，或应用适当的汇率，以确保汇总和比较准确。重要性为所有金额字段提供必要背景，确保财务分析准确，并避免错误汇总不同币种的金额。获取途径这是SAP Ariba采购订单文档抬头中的标准字段。示例 USDEURGBPJPY
	是否返工 IsRework	计算得出的标记，用于指示采购订单是否经历返工循环，例如被驳回后重新提交。
说明该布尔属性根据活动顺序计算得出。如果采购订单在流程中出现回退，例如“批准采购订单”后又发生“更改采购订单”，随后再次审批，则该属性设为“true”。这表示流程偏离了理想的直通路径。此标记是计算“采购订单返工循环率”KPI和筛选流程图以突出低效路径的重要依据。识别出返工案例后，分析人员可以调查根本原因，例如数据录入错误或要求不明确，并采取措施提高首次审批通过率。重要性直接标记流程低效和返工案例，帮助分析人员量化循环的影响，并确定需要消除的问题环节。获取途径源系统中没有此属性；它是在数据转换过程中根据每个案例的活动顺序计算得出的。示例 truefalse
	源系统 SourceSystem	标识数据提取自哪个系统，此处为SAP Ariba。
说明该属性用于标明流程数据的来源。在集成多个系统的环境中，它对于区分不同来源的数据和确保数据沿袭至关重要。分析时，您可以据此筛选特定系统的数据，或了解不同平台之间的流程交互。它也是数据治理和验证的重要元数据，可确保分析基于正确的数据集。重要性提供数据来源的关键信息，对于多系统环境中的数据治理、验证和分析至关重要。获取途径这是一个静态值（“SAP Ariba”），通常在数据提取和转换过程中添加。示例 SAP AribaSAP-Ariba-USAribaCloud
	物料组 MaterialGroup	用于归类特征相似的物料或服务。
说明物料组在Ariba中也称为商品代码，用于对采购项目进行分类。这样便于分析支出，并针对不同类型的商品或服务采用不同的采购策略。在流程挖掘中，该属性可用于按采购内容分析流程。例如，IT硬件的审批流程可能不同于办公用品。通过按类别分析，您可以获得更细致的洞察，并针对不同采购类别制定相应的流程改进措施。重要性支持按所采购商品或服务的类别分析流程，揭示不同项目采购方式的差异。获取途径这是采购订单行项目层级的标准字段，通常标记为“商品代码”。示例 IT.HardwareOffice.SuppliesProfessional.Services
	采购申请编号 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模块中采购申请单对象的创建日期。状态变为“已提交”通常表示流程正式开始。采集根据采购申请单的创建时间戳确定。事件类型 explicit
	创建采购订单	此活动表示在SAP Ariba中创建正式采购订单，可以根据已批准的采购申请生成，也可以直接创建。此活动取自采购订单单据的创建时间戳，标志着采购订单生命周期正式开始。
重要性对于直接创建的采购订单，这是流程的起点。此里程碑是衡量从采购申请到采购订单的转换时间以及采购订单整体处理周期的关键依据。获取途径此活动取自SAP Ariba Buying中PurchaseOrder单据对象的创建时间戳。此时状态通常为“Composing”或“Submitted”。采集根据采购订单单据的创建时间戳确定。事件类型 explicit
	向供应商发送采购订单	表示已批准的采购订单正式发送给供应商，通常通过Ariba Network发送。采购订单状态变为“Sent”或“Ordered”时记录此事件。
重要性此事件标志着流程从内部处理转入外部履约，是衡量供应商交付周期和交付绩效的起点。获取途径根据PurchaseOrder单据状态变为“Sent”或“Ordered”的时间戳推断。这是Ariba中的标准状态转换。采集根据状态变为“Sent”或类似状态的时间戳推断。事件类型 inferred
	收货已过账	表示货物已实际收货并记录在SAP Ariba中。用户针对采购订单行项目创建并提交收货单时，系统会明确记录此事件。
重要性这是确认交付的重要里程碑，也是衡量供应商交付绩效的终点。在三方匹配场景中，此事件还授权支付发票。获取途径此活动取自与PurchaseOrder关联的收货单创建或提交时间戳。采集根据收货单的提交时间戳确定。事件类型 explicit
	采购订单已完成	此活动标志着采购订单生命周期顺利结束，表示货物或服务已全部收货且发票已开具。通常根据采购订单状态变为“Received”“Invoiced”或类似终止状态推断此事件。
重要性这是流程成功完成的主要终点。衡量到达此状态所需的时间，可以得出端到端周期时间，这是评估整体流程效率的关键指标。获取途径根据PurchaseOrder状态变为“Received”等最终状态的时间戳推断。所有行项目均已全部收货时，采购订单才视为完成。采集根据采购订单状态变为“Received”或类似完成状态推断。事件类型 inferred
	采购订单已批准	表示采购订单已获得所有必要的内部审批，可以发送给供应商。通常在指定工作流完成后，根据采购订单状态变为“已批准”推断此事件。
重要性这是衡量审批周期时间和识别管理审核瓶颈的关键里程碑。此处的延误会直接影响供应商交付周期和采购效率。获取途径根据PurchaseOrder单据的状态或“ApprovedState”字段变为“Approved”的时间戳推断。审批历史日志可提供详细数据。采集根据采购订单审批流程中最终审批操作的时间戳推断。事件类型 inferred
	供应商确认采购订单	表示供应商已收到并确认采购订单，承诺履行订单。供应商通过Ariba Network提交订单确认单后，系统会更新采购订单状态并记录此事件。
重要性此活动表明供应商正在处理订单，有助于跟踪供应商的响应速度以及初始订单的准确性。获取途径供应商提交订单确认单后，根据PurchaseOrder状态变为“Confirmed”的时间戳推断。采集根据相关订单确认单的创建日期或采购订单状态变更确定。事件类型 inferred
	修改采购订单	此活动记录采购订单创建后的任何修改，例如数量、价格或交付日期变更。系统会创建采购订单的新版本，并且通常会触发重新审批工作流。
重要性跟踪修改对于发现流程低效、返工循环和采购错误的根本原因至关重要。修改率较高可能表明前期需求收集不充分。获取途径通过识别同一PurchaseOrder单据的多个版本来记录此活动。每个新版本都有创建时间戳，可用于确定事件时间。采集创建并保存采购订单单据的新版本时记录。事件类型 explicit
	取消采购订单	表示采购订单在履约前终止。通常由采购组织发起，少数情况下也可能由供应商发起。
重要性这是重要的例外情况，也是流程的一个终点。分析采购订单取消原因，有助于发现计划、预算或供应商可靠性方面的问题。获取途径根据PurchaseOrder单据状态变为“Cancelled”或“Closed”的时间戳推断。采集根据状态变为“Cancelled”的时间戳推断。事件类型 inferred
	录入服务确认	表示确认服务已完成，相当于服务类采购中的货物收货。针对服务类采购订单创建并批准服务单时，系统会记录此活动。
重要性此活动对于跟踪服务订单履行情况和授权付款至关重要。分析其处理是否及时，有助于管理服务交付和相关支出。获取途径此活动取自与PurchaseOrder关联的ServiceSheet单据审批时间戳。采集根据服务单的审批时间戳确定。事件类型 explicit
	收到采购订单对应的发票	表示已收到供应商开具的采购订单相关发票，并将其录入SAP Ariba。此事件将采购流程与后续付款流程关联起来。
重要性此活动是采购与财务之间的重要衔接点。其发生时间对于管理营运资金和确保按时向供应商付款至关重要。获取途径此活动取自Ariba Invoicing中Invoice单据的创建时间戳，该单据包含PurchaseOrder引用信息。采集根据与采购订单关联的发票单据创建时间戳确定。事件类型 explicit
	收到预先发货通知	供应商通过Ariba Network发送预先发货通知（ASN），表明货物已发运时，系统会记录此活动。ASN包含货运详情，例如物品、数量和跟踪信息。
重要性 ASN可提高供应链可见性，让收货部门提前做好交付准备。它也是跟踪在途库存和预测交付时间的重要数据来源。获取途径此活动取自与PurchaseOrder行项目关联的ShipNotice单据创建日期。采集根据预先发货通知（ASN）单据的创建时间戳确定。事件类型 explicit
	退货给供应商	此活动记录退货给供应商的情况，通常是因为货物损坏、有缺陷或交付错误。针对原收货单创建退货收货单或借项通知单时，系统会记录此活动。
重要性跟踪退货有助于发现供应商质量和交付准确性问题。分析退货频率和原因，有助于改进供应商选择与管理。获取途径可以根据退货专用收货单的创建记录或收货单上的负数量推断此活动。具体方式可能因系统配置而异。采集根据创建负数量收货单或特定“Return”类型的收货单推断。事件类型 inferred
	采购申请已批准	表示所有相关方已最终批准采购申请，授权将其转为采购订单。通常根据申请单状态变为“已批准”以及最终审批操作的时间戳推断此事件。
重要性此里程碑标志着申请的内部审批阶段结束。跟踪此事件有助于衡量采购订单创建前内部控制和审批工作流的效率。获取途径根据采购申请单的审批历史或状态字段推断。事件时间戳对应状态变为“已批准”的日期。采集根据采购申请的“ApprovedState”字段变为“Approved”的时间戳推断。事件类型 inferred

建议填写选填

数据提取指南

如何从SAP Ariba获取数据

步骤

进入分析报告：使用具有报告管理员或报告用户权限的账号登录SAP Ariba实例。点击“管理”>“分析报告”，进入报告仪表板。
创建新报告：点击“创建”并选择“报告”。在可用选项中选择“事务报告”，以便根据事务数据事实构建报告。
选择数据模型（事实）：选择包含采购数据的适当数据模型。其名称通常为“采购工作空间数据”“寻源与采购数据”，也可能是类似[您的采购数据集市]的自定义事实。选择该模型作为报告基础。
添加报告内容（事实和维度）：在“数据字段”面板中，将所需对象添加到报告查询，以此调整报告内容。至少应包含采购订单、采购申请、收货、发票和用户的事实。将这些对象中的必需字段拖放到“报告列”区域。
定义报告列：添加构建事件日志所需的所有字段。导出结果将采用“宽表”格式，之后还需转换。请包含：
- 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（用于记录发送给供应商）
- Order Confirmation.Confirmation Date
- Advance Ship Notice.Time Created
- Receipt.Receipt Date（作为GoodsReceiptDate）
- Service Sheet.Approved Date
- Invoice.Time Created
- Purchase Order.Closed Date（用于记录完成）
- Purchase Order.Canceled Date
- 另请添加User.Name、Department.Name、Supplier.Name、Purchase Order.Total Cost和Purchase Order.Req Delivery Date。
设置报告筛选条件：打开“筛选器”选项卡。为主要时间戳设置筛选条件，以限制数据量。常见做法是选择最近3至6个月的Purchase Order.Time Created。还可添加公司代码或采购组织等关键筛选条件，将数据限定在分析范围内。
保存并运行报告：为报告设置清晰的名称，例如ProcessMind_P2P_PO_Extraction。对于大型数据集，请使用“计划”选项在夜间运行报告，避免影响系统性能。不要立即运行。
导出报告数据：报告运行完毕后，进入计划报告，找到已完成的报告实例并下载输出文件。为确保与数据转换工具兼容，建议选择CSV格式。
转换数据：导出的CSV为宽表格式（每行对应一个采购订单），需要转换成长表事件日志。可使用Microsoft Excel Power Query、Python或专用ETL工具对日期列进行“逆透视”。对于原文件中的每一行，为每个非空日期列在新文件中创建一行。每行包含PurchaseOrderNumber、ActivityName（根据原日期列标题生成）和EventTime（该日期列的值）。
完成并上传：确保转换后的CSV文件包含必需的列标题（PurchaseOrderNumber、ActivityName、EventTime等）。现在即可将文件上传到流程挖掘平台。

配置

前提条件：需要使用具有“报告用户”或“报告管理员”权限的账号，才能创建、运行和安排分析报告。
报告类型：使用事务报告。此类报告可将多个数据事实（例如采购订单、采购申请和发票）合并到一个报告中，这是记录端到端流程所必需的。
数据模型（事实）：报告必须基于完整的采购数据集市，例如“采购工作空间数据”或自定义的同类模型，并且该模型应关联采购订单及相关单据。
日期范围筛选：务必设置日期筛选条件，以限制数据集大小。建议先筛选最近3至6个月的采购订单创建日期。
关键数据筛选条件：按公司代码和/或采购组织筛选，以确保数据相关性并控制数据量，将提取范围限定到特定业务单元。
性能注意事项：如果数据集包含数万张以上采购订单，请务必安排在非高峰时段运行报告。按需运行大型复杂报告可能会影响所有用户的系统性能。

查询示例 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安装：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（案例ID）、ActivityName和EventTime。还会将UserName、VendorName和PurchaseOrderAmount等相关信息映射到每条事件记录。
保存最终事件日志：处理完所有活动并生成完整事件日志后，脚本会按案例ID和事件时间对数据排序。最后，将DataFrame保存为ariba_p2p_event_log.csv，即可上传到流程挖掘工具。

配置

API应用：必须在SAP Ariba Developer Portal注册应用，并启用对“Analytical Reporting API”的访问权限。
报告视图模板：此方法依赖预置报告视图。必须在Ariba中配置该视图，关联所有必要的单据类型（采购申请、采购订单、收货、服务单、发票），并提供所需的日期和属性字段。
身份验证：脚本使用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）。
数据粒度：根据流程分析所需的详细程度，将报告视图配置为采购订单抬头级或行项目级。

查询示例 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()

准备好开始了吗？

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

返回改进指南

下载模板

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

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

开始免费试用

无需信用卡，几分钟即可开通免费试用。

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

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

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

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

数据提取指南

SAP Ariba分析报告CSV/Excel导出

步骤

配置

查询示例 sql

使用SAP Ariba Reporting API的Python脚本

步骤

配置

查询示例 python

准备好开始了吗？

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