> 持续流程改进 > 合同管理 > SAP Ariba Contracts > 数据模板

您的合同管理数据模板

SAP Ariba Contracts

← 返回改进指南

合同管理属性(19) 合同管理活动(14) 数据提取指南(2)

您的合同管理数据模板

此模板将指导您收集分析合同管理流程所需的数据，说明需要收集的关键属性、需要跟踪的主要活动，以及如何从源系统提取这些信息。您可以使用此模板简化数据准备工作，开始流程挖掘。

建议收集的属性
需要跟踪的合同管理关键活动
实用的数据提取指南

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

下载模板

合同管理属性

以下是建议纳入事件日志的关键数据字段，可用于全面分析合同管理流程。

3 必填 6 建议填写 10 选填

	名称	说明
	事件时间戳 EventTime	活动或事件发生的准确日期和时间。
说明此时间戳记录合同管理流程中每项活动的开始时间，是计算周期时间、持续时间和步骤间等待时间等时间指标的关键依据。流程挖掘工具会根据此时间戳排列事件，从而准确还原每份合同的活动顺序。这有助于分析流程绩效随时间的变化，并识别与时间相关的瓶颈，例如法务审查阶段的延误。重要性此属性是计算周期时间和等待时间等时间指标，以及正确排列流程事件的基础。获取途径可在SAP Ariba Contracts的事件日志、审计跟踪或状态变更历史表中，与活动信息一同找到。示例 2023-04-15T10:22:05Z2023-05-01T14:00:12Z2023-05-20T09:30:00Z
	合同ID ContractId	每个合同工作空间的唯一标识符，也是主要案例标识符。
说明此属性是主要案例标识符，用于关联合同生命周期中的所有活动和事件。借助它，您可以还原每份合同从创建到关闭的端到端历程。在流程挖掘中，具有相同合同ID的所有事件都视为同一个流程实例。这是分析流程变体、计算周期时间，以及识别特定合同或合同类型瓶颈的基础。重要性这是跟踪合同完整历程的关键标识符，可用于案例级分析和流程可视化。获取途径这是SAP Ariba Contracts中的核心标识符，通常在所有合同相关表和视图中以合同工作空间ID的形式出现。示例 CW2023-00123CW-MSA-45892CW2024-FIN-001CW19876
	活动 ActivityName	实际发生的具体业务流程步骤或事件的名称。
说明此属性描述在特定时间点完成的任务或里程碑，例如“合同已起草”或“法务审查已开始”。这些活动按顺序排列，构成流程图的基础。分析活动有助于了解实际开展的工作、各步骤的发生频率和顺序。您可以据此识别常见流程路径、偏差和返工循环，例如反复出现“合同已修订”活动。重要性此属性定义流程中的步骤，便于呈现流程并识别瓶颈和返工。获取途径通常根据SAP Ariba Contracts模块中的任务状态变更、审计日志或事件表生成。示例开始内部审核合同已签署修订已发起合同已关闭
	事件结束时间 EventEndTime	表示活动完成时间的时间戳。
说明此属性记录活动的完成时间。StartTime表示活动开始时间，EndTime表示活动结束时间，因此可以准确衡量非瞬时活动的持续时间。分析时，EndTime与StartTime的差值即为活动处理时间。这对详细的瓶颈分析至关重要，有助于区分实际处理任务的时间和任务间的等待时间。例如，您可以准确衡量“法务审查”活动的持续时间。重要性此属性可准确计算活动处理时间，对于识别瓶颈和衡量资源效率至关重要。获取途径请参阅SAP Ariba Contracts文档。相关信息可能记录在审计日志或任务完成记录中。示例 2023-04-16T11:45:10Z2023-05-03T17:21:09Z2023-05-20T10:05:00Z
	合同类型 ContractType	合同的分类，例如MSA、NDA或SOW。
说明此属性根据合同的法律或业务用途对合同进行分类。常见类型包括主服务协议（MSA）、保密协议（NDA）和工作说明书（SOW）。按合同类型分析流程，有助于了解流程差异。不同类型的合同通常具有不同的审批路径、SLA和复杂程度。例如，NDA的流程可能简单且快速，而MSA可能需要多层法务和财务审查。此属性是仪表板中的关键筛选条件，可用于比较不同合同类别的周期时间和合规率。重要性此属性可细分分析，揭示不同合同类型对流程、复杂程度和持续时间的影响。获取途径这是SAP Ariba Contracts合同工作空间详情中的标准分类字段。示例主服务协议保密协议工作说明书销售协议
	合同金额 ContractAmount	合同的总金额。
说明此属性表示合同协议的金额，是了解每份合同业务影响和相关风险的重要指标。分析时，您可以根据合同金额优先监控高价值合同，或识别业务量趋势。“已签署合同金额趋势”仪表板使用此属性汇总一段时间内签署合同的金额，帮助您了解业务绩效。此属性也适用于根因分析，可用于判断高价值合同是否采用了不同或较慢的流程。重要性此属性量化合同的财务影响，支持基于价值的分析、优先级排序和业务绩效跟踪。获取途径请参阅SAP Ariba Contracts文档。合同工作空间中通常包含此标准字段，字段名称可能为“金额”或“合同金额”。示例 150000.0025000.501200000.00
	法律顾问 LegalCounsel	负责审查合同的指定法务团队成员。
说明此属性用于识别负责合同法务审查任务的律师或法务专业人员。与执行其他活动的一般用户相比，此属性对应的角色通常更具体。此属性是“法务审查工作量与效率”仪表板的重要依据。您可以跟踪分配给每位法律顾问的合同数量、平均审查时间，以及法务部门的整体处理量。这有助于平衡工作量、识别绩效突出的人员或做法，并优化法务资源分配。重要性此属性支持详细分析法务审查阶段，帮助管理法务团队工作量、识别瓶颈并提高效率。获取途径请参阅SAP Ariba Contracts文档。相关信息可能记录在任务分配详情中，或作为审批流程中的特定角色。示例 s.jonesm.riverad.chen
	用户 UserName	执行活动的用户姓名或ID。
说明此属性用于识别在合同生命周期中负责完成特定任务或活动的人员，例如合同负责人、法务审查人员或审批人。按用户分析有助于了解工作量分布和个人绩效，并发现有针对性的培训机会。例如，在法务审查工作量仪表板中，您可以查看每位法律顾问负责处理的合同数量及其平均审查时间。重要性此属性有助于了解工作量分布和用户绩效，从而支持资源管理和效率分析。获取途径可在SAP Ariba Contracts的审计跟踪或事件日志表中找到，通常对应“更改人”或“用户ID”字段。示例 john.doejane.smithlegal_team_member_1
	部门 Department	发起合同或负责合同的业务部门。
说明此属性指定负责合同的组织部门，例如销售、IT或采购，为流程分析提供必要的业务背景。按部门细分流程分析，有助于识别各部门特有的行为、瓶颈或合规问题。例如，分析可能发现销售部门的合同审批流程明显慢于其他部门，进而促使您针对其具体做法开展调查。重要性此属性可按业务领域细分流程，帮助识别部门特有的瓶颈和绩效差异。获取途径通常可在SAP Ariba Contracts的合同标题或工作空间详情中找到，也可能与合同负责人的用户资料关联。示例销售信息技术采购法务
	SLA达标状态 SlaAdherenceStatus	表示审查活动是否在规定的SLA时限内完成。
说明此属性根据审查活动的完成时间与“审查SLA”的比较结果，将活动分类为“达标”“超时”或“不适用”。计算时会将“活动处理时间”与目标SLA时长进行比较。此属性可直观呈现服务级别协议的达标情况，是“内部与法务审查SLA达标情况”KPI和仪表板的核心指标。通过查看此状态，管理者可以快速了解审查达标率，并逐级下钻查看超时情况及其原因。重要性此属性直接衡量绩效是否达到服务目标，支持清晰监控SLA达标情况并快速识别超时。获取途径这是一个派生属性，在数据转换过程中通过比较ActivityProcessingTime与SlaForReview计算得出。示例达标已超时不适用
	合同到期日 ContractExpirationDate	合同预定到期的日期。
说明此属性记录已签署合同的正式到期日，是管理合同签署后生命周期的重要数据。此日期是“合同义务与续签状态”仪表板的基础，可用于提醒即将续签或到期的合同，避免合同意外失效。分析此数据有助于组织主动管理合同组合、降低合同过期带来的风险，并把握续签机会。重要性此属性对主动管理合同生命周期至关重要，可帮助您及时续签、防止合同意外失效并管理相关义务。获取途径这是SAP Ariba Contracts合同工作空间中的标准字段，通常位于标题或期限详情部分。示例 2025-12-31T23:59:59Z2024-08-15T23:59:59Z2026-06-30T23:59:59Z
	合同总周期时间 TotalContractCycleTime	从创建合同工作空间到最终签署所经过的总时间。
说明此计算属性用于衡量单份合同从开始到结束的完整时长。通常以首次活动和最后一次活动之间的时间差计算，例如“合同工作空间已创建”到“合同已签署”。这是一个核心绩效指标，即“合同端到端周期时间”，用于整体衡量合同管理流程的效率。您可以在仪表板中跟踪其变化，并比较不同合同类型、部门或地区的周期时间，从而找出主要的改进方向。重要性该指标汇总了整个合同生命周期的表现，可用于衡量流程速度和效率。获取途径这是在流程挖掘工具中按案例计算的指标，也可以在数据转换过程中计算。示例 P35DP12DT5HP90D
	合同状态 ContractStatus	合同生命周期中的当前总体状态。
说明此属性表示合同当前的总体状态，例如“草稿”“审查中”“已签署”“已过期”或“已终止”。它与活动不同：活动是单个事件，而状态表示一段时间内的状态。此属性对“合同义务与续签状态”等仪表板至关重要，可概览当前合同组合。它有助于识别停滞的合同，并管理续签和到期等生命周期事件。分析状态之间的转换，也能揭示流程中的瓶颈或低效之处。重要性此属性概览合同当前状态，对合同组合管理、状态跟踪和生命周期分析至关重要。获取途径这是SAP Ariba Contracts合同工作空间标题中的主要状态字段。示例草稿审批中已签署已过期
	地区 Region	与合同或合同对方相关的地理区域。
说明此属性定义合同适用的地理区域，例如北美、EMEA或APAC。通常根据合同对方所在地或负责合同的业务单元确定。按地区细分流程，有助于识别各地区在绩效、合规和流程行为方面的差异。例如，分析可能发现APAC地区的合同周期时间较长，原因是需要执行特定的监管审查步骤。这些洞察有助于根据地区需求制定流程改进方案并分配资源。重要性此属性支持地理区域分析，帮助识别各地区在流程绩效、周期时间和合规方面的差异。获取途径请参阅SAP Ariba Contracts文档。此信息可能是合同工作空间中的字段，也可能根据合同对方的地址推导得出。示例北美EMEAAPACLATAM
	审查SLA SlaForReview	完成审查活动的目标时长或截止时间。
说明此属性定义特定审查任务（例如“内部审查”或“法务审查”）约定的服务级别协议（SLA），即完成审查的目标时限。此属性是“内部与法务审查SLA达标情况”仪表板和KPI的重要依据。将实际审查时间与目标时限进行比较，组织即可衡量内部服务水平的达标情况。这有助于识别系统性延误、明确团队责任，并避免审查流程成为主要瓶颈。重要性此属性设定审查活动的绩效目标，支持衡量SLA达标情况并识别延误。获取途径请参阅SAP Ariba Contracts文档。此设置可能配置在审批工作流规则或模板中。示例 P3DP5DP10D
	对方名称 CounterpartyName	合同对方的名称，例如供应商或客户。
说明此属性用于识别合同的另一方，可能是供应商、客户或合作伙伴，为合同管理流程提供重要的业务背景。按对方分析有助于发现特定合作伙伴相关的规律。例如，与某些对方的谈判可能总是耗时较长，这表明需要采用标准化模板或预先协商条款。此属性还可用于评估合同组合中的合作关系状况和供应商绩效。重要性此属性支持按外部合作方分析流程绩效，帮助识别谈判难点并管理供应商关系。获取途径此信息通常存储在SAP Ariba Contracts合同工作空间中的供应商或客户信息部分。示例 Acme CorporationGlobal Tech Inc.Innovate Solutions LLC
	数据上次更新时间 LastDataUpdate	表示此事件数据上次刷新或提取时间的时间戳。
说明此属性记录从源系统上次提取数据的日期和时间。它表示记录载入流程挖掘平台的时间，而非事件发生时间。此信息对数据治理和判断分析数据的新鲜度至关重要。它有助于您确认当前查看的数据是否为最新数据，也是管理增量数据载入的必要依据。重要性此属性可帮助您了解数据的时效性，这对准确、及时地分析和监控流程至关重要。获取途径此时间戳在数据载入流程挖掘工具时生成并添加。示例 2024-05-21T02:00:00Z2024-05-22T02:00:00Z
	是否返工 IsRework	用于标记某项活动是否为返工或重复执行之前的步骤。
说明如果同一合同案例中的某项活动（例如“合同已修订”）发生多次，此布尔属性将设为true。它有助于明确识别并量化流程中的返工循环。此标记对于计算“合同返工率”KPI和在流程图中呈现返工至关重要。分析人员可按此属性筛选，快速找出需要大量修订的合同，调查根因，并衡量返工对整体周期时间的影响。它能揭示流程起草和谈判阶段的低效之处。重要性此属性量化返工情况，便于衡量流程低效、分析根因并跟踪改进成效。获取途径这是一个派生属性，在数据转换过程中通过检测同一案例中重复发生的活动计算得出。示例 truefalse
	源系统 SourceSystem	数据来源系统。
说明此属性用于标识生成事件数据的源系统。对于此流程，值始终为“SAP Ariba Contracts”。纳入此属性是数据治理和可追溯性的最佳实践。在合并多个系统的数据时，这一属性尤为重要，可明确数据来源，并帮助排查数据质量问题。重要性此属性提供数据来源的重要背景信息，确保数据可追溯，并支持多系统分析。获取途径通常在数据提取和转换过程中添加固定值，用于标记数据集来源。示例 SAP Ariba Contracts

必填建议填写选填

合同管理活动

以下是建议纳入事件日志的核心流程步骤和关键里程碑，可帮助准确发现合同管理流程。

6 建议填写 8 选填

	活动	说明
	创建合同工作空间	此活动标志着合同管理流程的启动。在SAP Ariba中创建合同工作空间，作为存放特定合同相关文件、任务和沟通记录的中央资料库。
重要性这是端到端流程的主要开始事件。分析从此活动到合同执行的时长，对于衡量整体合同生命周期至关重要。获取途径此事件根据合同工作空间项目对象的创建日期记录，是合同抬头或项目数据中可获取的基础时间戳。采集使用合同工作空间对象的创建时间戳。事件类型 explicit
	合同已关闭	这是合同在系统中正式关闭的终止活动。合同到期、终止或所有义务均已履行后，都可能发生此活动。
重要性标志着合同生命周期结束。这是衡量完整生命周期时长、确保按规定完成收尾流程的关键结束事件。获取途径通常根据合同工作空间的“状态”字段变为“已关闭”“已终止”或“已过期”来推断。状态可能自动变更，也可能由用户手动更新。采集记录合同“状态”字段变为终止状态时的时间戳。事件类型 inferred
	合同已激活	表示已签署的合同开始生效、相关义务开始履行的时间点。通常在合同签署后通过状态变更触发，有时也会在指定生效日期触发。
重要性这标志着合同签署后的管理阶段开始，也是监控合同义务的触发点，对“义务履行率”KPI至关重要。获取途径通常根据合同工作空间中的“状态”字段变为“活跃”来推断。此状态可能在合同签署后自动变更，也可能由用户手动更新。采集记录合同“状态”字段变为“活跃”时的时间戳。事件类型 inferred
	合同已签署	合同正式签署，表示已取得所有必需的签名。此时，合同从处理中转变为具有法律约束力的协议。
重要性这是签署前流程的主要成功终点，也是计算“合同端到端周期时间”和“合同平均审批周期时间”的基础。获取途径此事件取自Ariba工作流中最终签名任务的完成状态，尤其是在与电子签名工具集成时。合同工作空间的状态也会变为“已签署”。采集使用最终签名任务的完成时间戳，或状态变为“已签署”的时间戳。事件类型 explicit
	完成内部审批	表示合同所需的所有内部审批任务均已成功完成，合同已准备好签署，尚待交易对手同意。
重要性这是合同执行前的重要里程碑。此事件与最终执行之间的时长，可以揭示获取外部签名或完成文件定稿时的延误。获取途径此事件根据Ariba工作流中最后一项审批任务的完成时间戳记录。整个审批流程成功结束时，系统会记录相应时间。采集使用整体审批流程任务组的完成时间戳。事件类型 explicit
	开始法务审核	表示合同已正式提交法务部门审核。这通常是整体审批工作流中一个独立且必需的任务。
重要性法务审核往往是主要瓶颈。衡量其时长对于“法务审核平均周期时间”KPI和优化法务资源分配至关重要。获取途径此事件根据Ariba工作流中特定“法务审核”任务的开始时间记录。系统会记录任务分配或启动时的时间戳。采集确定专门分配给法务团队或角色的任务开始时间戳。事件类型 explicit
	与交易对手谈判	表示将合同发送给外部方进行谈判和修订的阶段。此活动可能通过在工作空间中手动更改状态来记录。
重要性此活动可帮助了解难以预测的外部谈判周期。衡量该阶段有助于计算“平均谈判轮次”并识别复杂谈判。获取途径通常可根据工作空间状态被手动更改为“谈判中”或“与供应商协商”等状态来推断此事件。也可以根据文件发送给外部联系人的时间推断。采集跟踪合同工作空间状态字段的变化，识别表示外部审核的状态值。事件类型 inferred
	修订合同	创建或上传新的主合同文件版本时，会发生此活动。通常是对内部审核、法务审核或交易对手谈判意见的回应。
重要性修订频率可直接反映返工情况。跟踪此活动对于计算“合同返工率”并发现统一合同用语或流程的机会至关重要。获取途径此事件可根据合同工作空间中的文档管理系统推断。每次保存主协议文件的新版本时，系统都会生成时间戳。采集使用版本号大于1的文件版本创建时间戳。事件类型 inferred
	修订已发起	此活动标志着对有效合同进行正式修订的开始。通常需要创建新版本，或在原合同工作空间下创建子项目。
重要性修订的频率和时间有助于了解合同稳定性和业务需求变化，也是“修订与终止趋势”仪表板的关键指标。获取途径用户在现有合同中发起“修订”流程时，系统会记录这一明确操作。采集获取合同修订工作空间或任务的创建事件。事件类型 explicit
	合同已续签	表示有效合同已成功续签。此流程通常会创建一个新的合同工作空间，接续原合同。
重要性有助于分析合同留存情况和续签效率。续签是合同生命周期中的关键结果，表明双方业务关系得以延续。获取途径创建新合同时，如果该合同与即将到期的合同存在关联（例如“续签自”），即可记录此事件。这通常由用户明确发起。采集识别与现有合同关联、作为其续签合同创建的新合同。事件类型 explicit
	合规任务已完成	表示已完成一项计划内的合同签署后任务，例如合规审查或义务检查。这些任务旨在确保持续治理。
重要性跟踪这些任务的完成情况，对于衡量“义务履行率”并确保组织履行合同承诺至关重要。获取途径从合同工作空间中特定后续任务或合同义务相关任务的完成时间戳获取。采集使用工作空间中配置的合同签署后任务的完成时间戳。事件类型 explicit
	开始内部审核	此活动表示合同初稿的内部审核和审批工作流启动。文件会发送给财务或运营等相关人员征求意见。
重要性这标志着潜在瓶颈阶段的开始。分析该阶段的时长，是发现内部审核流程延误并支持“内部审核SLA达标率”KPI的关键。获取途径通常在SAP Ariba工作流引擎创建并分配审核任务时记录此事件。任务状态会变为“进行中”或类似状态。采集记录合同审批工作流中审核任务启动时的时间戳。事件类型 explicit
	收到交易对手批准	表示外部方已正式同意合同条款。通常通过集成的电子签名解决方案记录此事件，也可以在收到签署文件后手动更新。
重要性此活动用于确认双方达成一致，是合同正式签署前的最后一步，也是完成协议的关键节点。获取途径这可以是电子签名工具（如DocuSign）记录的明确事件，例如状态变为“已完成”；也可以根据状态手动更改为“对方已签署”来推断。采集从集成的电子签名服务商日志中获取完成事件。事件类型 explicit
	起草合同	表示在工作空间中首次创建或上传主要合同文件。这通常是工作空间设置完成后的首个重要内容操作。
重要性跟踪此活动有助于了解初稿的准备时间。此阶段的延误可能显著影响整体周期时间。获取途径可根据合同工作空间文档文件夹中主协议文件首个版本的创建时间戳推断此事件。采集确定上传至工作空间的首个文件版本的时间戳。事件类型 inferred

建议填写选填

数据提取指南

如何从SAP Ariba Contracts获取数据

步骤

访问分析报告：登录SAP Ariba系统。点击主菜单进入报告部分，然后选择Analytical Reports，或通过类似Manage > Analytical Reports的路径进入。
创建新报告：点击创建按钮并选择New Report。选择创建包含多个事实表的报告。
选择主要事实表：在报告生成器中，将Contract Workspace (Projects)选为主要数据事实表。该事实表包含每个合同案例的核心信息。
关联其他事实表：要收集所需的全部活动和属性，请将以下事实表关联到Contract Workspace (Projects)事实表。使用通用字段Project Id或Contract Id作为关联条件：
- Approval History：获取审批任务详情，包括提交、批准和拒绝记录。
- Task：获取所有工作流任务的信息，包括开始和结束日期及受分派人。
- 文档：跟踪文档版本，这对于识别Contract Drafted和Contract Revised活动至关重要。
定义报告字段（透视逻辑）：目标是为每项业务活动单独创建一行。由于Ariba界面通常按每份合同生成一行，您必须手动定义计算字段，或导出宽表后再进行转换。建议为每个可能的事件时间戳添加一列，例如：
- 从Contract Workspace (Projects)事实表获取Workspace Creation Date。
- 从Document事实表获取Main Document Create Date（筛选主协议和第一个版本）。
- 从Task事实表获取Legal Review Start Date（筛选特定的法务审核任务）。
- 从Contract Workspace (Projects)事实表获取Execution Date。
- 继续为所需的14项活动分别添加时间戳列。
选择属性字段：将所有必需和建议的属性字段添加到报告中，例如Contract Id、Project Owner（对应UserName）、部门、金额（对应ContractAmount）和Contract Type。
应用筛选器：进入筛选器选项卡。为Contract Workspace (Projects)事实表设置Time Created筛选条件，将数据提取范围限定在适当的时间段，例如最近6至12个月。还可以添加Project Type等其他相关筛选条件，仅纳入合同工作空间。
运行并导出数据：运行报告。输出结果将是宽表，每份合同占一行，并包含多个不同日期事件的列。将报告导出为CSV或Microsoft Excel文件。
转换数据：导出的文件不是事件日志，必须进行转换。使用Microsoft Excel Power Query、Python或专用ETL工具对数据进行逆透视。对于导出文件中的每一行，根据第5步创建的每个日期列，在新文件中生成一行。这样即可将宽表转换为ProcessMind所需的长格式事件日志。
整理事件日志格式：在转换后的文件中，确保列名与要求完全一致，例如ContractId、ActivityName、EventTime、EventEndTime、UserName等。将时间戳列统一设置为YYYY-MM-DD HH:MI:SS等格式，并将最终文件保存为CSV。
上传到ProcessMind：生成的CSV文件现在可以上传到您的流程挖掘工具。

配置

需包含的事实表：报告必须关联多个数据事实表。先选择Contract Workspace (Projects)，再关联Approval History、Task和文档事实表，以获取完整历史记录。
日期范围：初步分析时，为Contract Workspace (Projects)事实表的Time Created字段设置筛选条件，选择最近6至12个月。数据量较大时，可考虑按季度或月份分批导出。
关键筛选条件：必须按Project Type筛选，确保只提取合同工作空间，而不包含寻源项目等其他项目类型。您也可以按部门或Commodity筛选，聚焦特定分析范围。
数据粒度：选择能提供具体事件时间戳的字段，例如任务激活日期、审批日期和文档创建日期。不要只使用最后修改日期，因为它无法体现具体事件。
前提条件：您的SAP Ariba用户账户需要具备创建和运行分析报告的权限。此权限通常分配给Analysis User或Reporting Administrator等角色。
性能注意事项：关联多个事实表，并在较长日期范围内导出大量字段，可能导致报告运行缓慢或超时。请耐心等待，并考虑在业务低峰时段运行报告，或分批处理。

查询示例 sql

-- This is a logical representation of the report configuration in the SAP Ariba Analytical Reporting UI.
-- The tool does not use a direct query language; you build this logic by selecting facts, fields, and filters.
-- The final step requires transforming the wide export file into this long format.

-- FACT: Contract Workspace (Projects) as c
-- JOIN: Approval History as a ON c."Project Id" = a."Project Id"
-- JOIN: Task as t ON c."Project Id" = t."Project Id"
-- JOIN: Document as d ON c."Project Id" = d."Project Id"

-- Each of the following SELECT blocks represents a set of rows for a specific activity.

SELECT c."Contract Id" AS ContractId, 'Contract Workspace Created' AS ActivityName, c."Time Created" AS EventTime, NULL AS EventEndTime, c."Project Owner" AS UserName, c.Department, c.Amount AS ContractAmount, c."Contract Type Name" AS ContractType, c."Legal Contact" AS LegalCounsel FROM "Contract Workspace (Projects)" AS c
UNION ALL
SELECT c."Contract Id" AS ContractId, 'Contract Drafted' AS ActivityName, d."Time Created" AS EventTime, NULL AS EventEndTime, d."Created By" AS UserName, c.Department, c.Amount AS ContractAmount, c."Contract Type Name" AS ContractType, c."Legal Contact" AS LegalCounsel FROM "Contract Workspace (Projects)" AS c JOIN "Document" AS d ON c."Project Id" = d."Project Id" WHERE d."Is Main Agreement" = TRUE AND d.Version = 1
UNION ALL
SELECT c."Contract Id" AS ContractId, 'Internal Review Started' AS ActivityName, t."Activated Date" AS EventTime, t."Completed Date" AS EventEndTime, t.Assignee AS UserName, c.Department, c.Amount AS ContractAmount, c."Contract Type Name" AS ContractType, c."Legal Contact" AS LegalCounsel FROM "Contract Workspace (Projects)" AS c JOIN "Task" AS t ON c."Project Id" = t."Project Id" WHERE t."Task Name" LIKE '%Internal Review%'
UNION ALL
SELECT c."Contract Id" AS ContractId, 'Legal Review Started' AS ActivityName, t."Activated Date" AS EventTime, t."Completed Date" AS EventEndTime, t.Assignee AS UserName, c.Department, c.Amount AS ContractAmount, c."Contract Type Name" AS ContractType, c."Legal Contact" AS LegalCounsel FROM "Contract Workspace (Projects)" AS c JOIN "Task" AS t ON c."Project Id" = t."Project Id" WHERE t."Task Name" LIKE '%Legal Review%'
UNION ALL
SELECT c."Contract Id" AS ContractId, 'Contract Revised' AS ActivityName, d."Time Created" AS EventTime, NULL AS EventEndTime, d."Created By" AS UserName, c.Department, c.Amount AS ContractAmount, c."Contract Type Name" AS ContractType, c."Legal Contact" AS LegalCounsel FROM "Contract Workspace (Projects)" AS c JOIN "Document" AS d ON c."Project Id" = d."Project Id" WHERE d."Is Main Agreement" = TRUE AND d.Version > 1
UNION ALL
SELECT c."Contract Id" AS ContractId, 'Negotiation With Counterparty' AS ActivityName, t."Activated Date" AS EventTime, t."Completed Date" AS EventEndTime, t.Assignee AS UserName, c.Department, c.Amount AS ContractAmount, c."Contract Type Name" AS ContractType, c."Legal Contact" AS LegalCounsel FROM "Contract Workspace (Projects)" AS c JOIN "Task" AS t ON c."Project Id" = t."Project Id" WHERE t."Task Name" LIKE '%Negotiation%'
UNION ALL
SELECT c."Contract Id" AS ContractId, 'Internal Approval Completed' AS ActivityName, a."Time Completed" AS EventTime, NULL AS EventEndTime, a."Approver" AS UserName, c.Department, c.Amount AS ContractAmount, c."Contract Type Name" AS ContractType, c."Legal Contact" AS LegalCounsel FROM "Contract Workspace (Projects)" AS c JOIN "Approval History" AS a ON c."Project Id" = a."Project Id" WHERE a."Approval Task Name" LIKE '%Internal Approval Flow%' AND a.Status = 'Approved' AND a."Is Last Approver" = TRUE
UNION ALL
SELECT c."Contract Id" AS ContractId, 'Counterparty Approval Received' AS ActivityName, t."Completed Date" AS EventTime, NULL AS EventEndTime, t.Assignee AS UserName, c.Department, c.Amount AS ContractAmount, c."Contract Type Name" AS ContractType, c."Legal Contact" AS LegalCounsel FROM "Contract Workspace (Projects)" AS c JOIN "Task" AS t ON c."Project Id" = t."Project Id" WHERE t."Task Name" LIKE '%Counterparty Signature%'
UNION ALL
SELECT c."Contract Id" AS ContractId, 'Contract Executed' AS ActivityName, c."Executed Date" AS EventTime, NULL AS EventEndTime, c."Project Owner" AS UserName, c.Department, c.Amount AS ContractAmount, c."Contract Type Name" AS ContractType, c."Legal Contact" AS LegalCounsel FROM "Contract Workspace (Projects)" AS c WHERE c."Executed Date" IS NOT NULL
UNION ALL
SELECT c."Contract Id" AS ContractId, 'Contract Activated' AS ActivityName, c."Activated Date" AS EventTime, NULL AS EventEndTime, c."Project Owner" AS UserName, c.Department, c.Amount AS ContractAmount, c."Contract Type Name" AS ContractType, c."Legal Contact" AS LegalCounsel FROM "Contract Workspace (Projects)" AS c WHERE c."Activated Date" IS NOT NULL
UNION ALL
SELECT c."Contract Id" AS ContractId, 'Compliance Task Completed' AS ActivityName, t."Completed Date" AS EventTime, NULL AS EventEndTime, t.Assignee AS UserName, c.Department, c.Amount AS ContractAmount, c."Contract Type Name" AS ContractType, c."Legal Contact" AS LegalCounsel FROM "Contract Workspace (Projects)" AS c JOIN "Task" AS t ON c."Project Id" = t."Project Id" WHERE t."Task Name" LIKE '%Compliance%'
UNION ALL
SELECT c."Contract Id" AS ContractId, 'Amendment Initiated' AS ActivityName, c."Time Created" AS EventTime, NULL AS EventEndTime, c."Project Owner" AS UserName, c.Department, c.Amount AS ContractAmount, c."Contract Type Name" AS ContractType, c."Legal Contact" AS LegalCounsel FROM "Contract Workspace (Projects)" AS c WHERE c."Is Amendment" = TRUE
UNION ALL
SELECT c."Contract Id" AS ContractId, 'Contract Renewed' AS ActivityName, c."Time Created" AS EventTime, NULL AS EventEndTime, c."Project Owner" AS UserName, c.Department, c.Amount AS ContractAmount, c."Contract Type Name" AS ContractType, c."Legal Contact" AS LegalCounsel FROM "Contract Workspace (Projects)" AS c WHERE c."Is Renewal" = TRUE
UNION ALL
SELECT c."Contract Id" AS ContractId, 'Contract Closed' AS ActivityName, c."Completed Date" AS EventTime, NULL AS EventEndTime, c."Project Owner" AS UserName, c.Department, c.Amount AS ContractAmount, c."Contract Type Name" AS ContractType, c."Legal Contact" AS LegalCounsel FROM "Contract Workspace (Projects)" AS c WHERE c.Status = 'Completed'

步骤

前提条件：在SAP Ariba Developer Portal注册应用程序。提取数据前，您必须在SAP Ariba Developer Portal注册新应用程序。注册后，您将获得Application Key、OAuth Client ID和OAuth Client Secret。请确保为应用程序授予访问Contract Workspaces API所需的权限。
设置Python环境。在计算机上安装Python 3，然后安装用于发送API请求和处理数据的必要库。打开终端或命令提示符并运行：pip install requests pandas。
配置Python脚本。将提供的Python脚本复制到文件中，例如ariba_extraction.py。打开文件，更新顶部配置部分中的占位值。您需要填写Ariba Realm、API Key、OAuth Client ID和Client Secret，并设置所需的数据提取日期范围。
了解身份验证流程。脚本首先使用您的凭据调用SAP Ariba API身份验证端点，以获取临时访问令牌。后续所有数据请求都需要此令牌，脚本会自动将其添加到API调用的标头中。
运行脚本获取合同工作空间。在终端中运行脚本：python ariba_extraction.py。脚本将先获取指定日期范围内更新的所有合同工作空间列表，并自动处理分页，以检索所有相关记录。
获取工作空间详细数据。对于上一步识别出的每个合同工作空间，脚本都会调用详细信息API。该调用会获取相关对象，例如任务、文档、团队成员以及工作空间历史状态变更，这些信息对于构建事件日志至关重要。
将API响应转换为事件。脚本的核心逻辑会遍历每份合同的详细JSON响应，并将工作空间创建日期、任务状态变更、文档版本上传记录和合同状态字段（contractStatus）等数据映射到事件日志所需的具体活动名称。
整理并补充事件日志。识别出的事件会添加到pandas DataFrame中。脚本从API数据中提取相关值，填充必需列（ContractId、ActivityName、EventTime）和建议列（UserName、ContractAmount、ContractType等）。
导出最终事件日志。处理完所有合同工作空间后，脚本会将完整事件日志保存为同一目录下的CSV文件ariba_contract_management_event_log.csv。该文件已完成格式整理，可上传到ProcessMind。

配置

API凭据：您必须从SAP Ariba Developer Portal获取以下信息：
- API_KEY：为已注册应用程序生成的应用程序密钥。
- CLIENT_ID：经过Base64编码的OAuth客户端ID。
- CLIENT_SECRET：OAuth客户端密钥。
Realm：贵公司专用的SAP Ariba Realm名称，例如'mycompany-T'。API调用会根据该名称发送到相应的数据中心。
日期范围筛选条件：必须设置UPDATED_DATE_FROM和UPDATED_DATE_TO参数，以限定数据提取范围。建议先提取最近3至6个月的数据，以控制数据量和脚本运行时间。
工作空间筛选条件：您可以修改fetch_workspaces函数中的API调用，添加其他筛选条件。可按contractStatus（例如'Active'、'Executed'）或projectType等字段筛选，提取特定合同类型。
前提条件：您需要订阅有效的SAP Ariba Contracts服务，并启用API功能。此外，您的用户账户必须具备在开发者门户注册应用程序和查看合同工作空间数据的相应权限。

查询示例 python

import requests
import pandas as pd
import base64
from datetime import datetime, timedelta

class=class="hl-string">"hl-comment"># --- CONFIGURATION --- #
class=class="hl-string">"hl-comment"># Replace with your SAP Ariba realm and API credentials
REALM = class="hl-string">'[Your Ariba Realm]'
API_KEY = class="hl-string">'[Your Application Key]'
class=class="hl-string">"hl-comment"># The OAUTH_CLIENT_ID is your Application Key and a hyphen, base64 encoded.
class=class="hl-string">"hl-comment"># Example: class="hl-string">'yourappkey:' -> class="hl-string">'eW91cmFwcGtleTo='
OAUTH_CLIENT_ID = class="hl-string">'[Your Base64 Encoded OAuth Client ID]'
OAUTH_CLIENT_SECRET = class="hl-string">'[Your OAuth Client Secret]'

class=class="hl-string">"hl-comment"># --- FILTERS --- #
class=class="hl-string">"hl-comment"># Set the date range for contracts to extract (based on last modified date)
UPDATED_DATE_TO = datetime.now().strftime(class="hl-string">'%Y-%m-%dT%H:%M:%SZ')
UPDATED_DATE_FROM = (datetime.now() - timedelta(days=180)).strftime(class="hl-string">'%Y-%m-%dT%H:%M:%SZ')

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

class=class="hl-string">"hl-comment"># --- AUTHENTICATION --- #
def get_access_token():
    class="hl-string">"""Authenticates with Ariba API to get an access token."""
    auth_header = {class="hl-string">'Authorization': fclass="hl-string">'Basic {OAUTH_CLIENT_ID}'}
    payload = {
        class="hl-string">'grant_type': class="hl-string">'client_credentials',
        class="hl-string">'client_secret': OAUTH_CLIENT_SECRET
    }
    try:
        response = requests.post(AUTH_URL, headers=auth_header, data=payload)
        response.raise_for_status()
        return response.json().get(class="hl-string">'access_token')
    except requests.exceptions.RequestException as e:
        print(fclass="hl-string">"Error getting access token: {e}")
        return None

class=class="hl-string">"hl-comment"># --- DATA FETCHING --- #
def fetch_paginated_data(url, headers, params):
    class="hl-string">"""Fetches data from a paginated Ariba API endpoint."""
    all_records = []
    page = 0
    while True:
        params[class="hl-string">'page'] = page
        response = requests.get(url, headers=headers, params=params)
        response.raise_for_status()
        data = response.json()
        all_records.extend(data)
        if len(data) == 0: class=class="hl-string">"hl-comment"># Assuming empty list means last page
            break
        page += 1
    return all_records

class=class="hl-string">"hl-comment"># --- EVENT DERIVATION LOGIC --- #
def derive_events_from_workspace(workspace_details):
    class="hl-string">"""Derives multiple event log rows from a single workspace's detailed data."""
    events = []
    case_id = workspace_details.get(class="hl-string">'contractId')
    if not case_id:
        return []

    class=class="hl-string">"hl-comment"># Helper function to create a standard event dictionary
    def create_event(activity, timestamp, user=class="hl-string">'System'):
        return {
            class="hl-string">'ContractId': case_id,
            class="hl-string">'ActivityName': activity,
            class="hl-string">'EventTime': timestamp,
            class="hl-string">'EventEndTime': None, class=class="hl-string">"hl-comment"># Populate if available
            class="hl-string">'UserName': user,
            class="hl-string">'Department': workspace_details.get(class="hl-string">'custom', {}).get(class="hl-string">'Department', None),
            class="hl-string">'ContractAmount': workspace_details.get(class="hl-string">'amount', {}).get(class="hl-string">'amount', None),
            class="hl-string">'ContractType': workspace_details.get(class="hl-string">'contractType', {}).get(class="hl-string">'name', None),
            class="hl-string">'LegalCounsel': next((member.get(class="hl-string">'name') for member in workspace_details.get(class="hl-string">'team', []) if member.get(class="hl-string">'role') == class="hl-string">'Legal Counsel'), None)
        }

    class=class="hl-string">"hl-comment"># 1. Contract Workspace Created
    if workspace_details.get(class="hl-string">'createDate'):
        events.append(create_event(class="hl-string">'Contract Workspace Created', workspace_details[class="hl-string">'createDate']))

    class=class="hl-string">"hl-comment"># 2. Contract Drafted & 5. Contract Revised
    if workspace_details.get(class="hl-string">'documents'):
        main_doc_versions = sorted([v for doc in workspace_details[class="hl-string">'documents'] if doc.get(class="hl-string">'isMainAgreement') for v in doc.get(class="hl-string">'versions', [])], key=lambda x: x[class="hl-string">'createDate'])
        if main_doc_versions:
            events.append(create_event(class="hl-string">'Contract Drafted', main_doc_versions[0][class="hl-string">'createDate'], main_doc_versions[0].get(class="hl-string">'createdBy')))
            for version in main_doc_versions[1:]:
                events.append(create_event(class="hl-string">'Contract Revised', version[class="hl-string">'createDate'], version.get(class="hl-string">'createdBy')))

    class=class="hl-string">"hl-comment"># 3, 4, 7, 11. Task-based activities
    if workspace_details.get(class="hl-string">'tasks'):
        for task in workspace_details[class="hl-string">'tasks']:
            task_name = task.get(class="hl-string">'name', class="hl-string">'').lower()
            if class="hl-string">'internal review' in task_name and task.get(class="hl-string">'startDate'):
                events.append(create_event(class="hl-string">'Internal Review Started', task[class="hl-string">'startDate'], task.get(class="hl-string">'owner')))
            if class="hl-string">'legal review' in task_name and task.get(class="hl-string">'startDate'):
                events.append(create_event(class="hl-string">'Legal Review Started', task[class="hl-string">'startDate'], task.get(class="hl-string">'owner')))
            if class="hl-string">'internal approval' in task_name and task.get(class="hl-string">'completionDate'):
                events.append(create_event(class="hl-string">'Internal Approval Completed', task[class="hl-string">'completionDate'], task.get(class="hl-string">'owner')))
            if class="hl-string">'compliance' in task_name and task.get(class="hl-string">'completionDate'):
                events.append(create_event(class="hl-string">'Compliance Task Completed', task[class="hl-string">'completionDate'], task.get(class="hl-string">'owner')))

    class=class="hl-string">"hl-comment"># 6, 8. Status-based manual activities
    class=class="hl-string">"hl-comment"># This requires interpreting status history, which can be complex. Simplified here.
    if workspace_details.get(class="hl-string">'statusHistory'):
        for status_change in workspace_details.get(class="hl-string">'statusHistory'):
            status = status_change.get(class="hl-string">'status', class="hl-string">'').lower()
            if class="hl-string">'negotiation' in status:
                events.append(create_event(class="hl-string">'Negotiation With Counterparty', status_change[class="hl-string">'date'], status_change.get(class="hl-string">'user')))
            if class="hl-string">'counterparty approval' in status:
                events.append(create_event(class="hl-string">'Counterparty Approval Received', status_change[class="hl-string">'date'], status_change.get(class="hl-string">'user')))

    class=class="hl-string">"hl-comment"># 9. Contract Executed
    if workspace_details.get(class="hl-string">'executionDate'):
        events.append(create_event(class="hl-string">'Contract Executed', workspace_details[class="hl-string">'executionDate']))

    class=class="hl-string">"hl-comment"># 10. Contract Activated
    if workspace_details.get(class="hl-string">'effectiveDate'):
        events.append(create_event(class="hl-string">'Contract Activated', workspace_details[class="hl-string">'effectiveDate']))

    class=class="hl-string">"hl-comment"># 12. Amendment Initiated
    if workspace_details.get(class="hl-string">'isAmendment'):
        events.append(create_event(class="hl-string">'Amendment Initiated', workspace_details[class="hl-string">'createDate']))

    class=class="hl-string">"hl-comment"># 13. Contract Renewed
    if workspace_details.get(class="hl-string">'renewalOfWorkspaceId'):
         events.append(create_event(class="hl-string">'Contract Renewed', workspace_details[class="hl-string">'createDate']))

    class=class="hl-string">"hl-comment"># 14. Contract Closed
    if workspace_details.get(class="hl-string">'closeDate'):
        events.append(create_event(class="hl-string">'Contract Closed', workspace_details[class="hl-string">'closeDate']))

    return events

class=class="hl-string">"hl-comment"># --- MAIN EXECUTION --- #
def main():
    class="hl-string">"""Main function to orchestrate the extraction process."""
    print(class="hl-string">"Attempting to get access token...")
    access_token = get_access_token()
    if not access_token:
        print(class="hl-string">"Failed to get access token. Exiting.")
        return

    print(class="hl-string">"Successfully obtained access token.")
    headers = {
        class="hl-string">'Authorization': fclass="hl-string">'Bearer {access_token}',
        class="hl-string">'apiKey': API_KEY
    }

    print(fclass="hl-string">"Fetching contract workspaces updated from {UPDATED_DATE_FROM} to {UPDATED_DATE_TO}...")
    workspace_params = {
        class="hl-string">'filters': fclass="hl-string">'updatedDateFrom={UPDATED_DATE_FROM}&updatedDateTo={UPDATED_DATE_TO}'
    }
    try:
        workspaces = fetch_paginated_data(BASE_API_URL, headers, workspace_params)
        print(fclass="hl-string">"Found {len(workspaces)} workspaces.")

        all_events = []
        for i, ws_summary in enumerate(workspaces):
            ws_id = ws_summary.get(class="hl-string">'contractId')
            print(fclass="hl-string">"Processing workspace {i+1}/{len(workspaces)}: {ws_id}")
            detail_url = fclass="hl-string">"{BASE_API_URL}/{ws_id}"
            class=class="hl-string">"hl-comment"># Add parameters to get full details
            detail_params = {class="hl-string">'include': class="hl-string">'tasks,documents,team,statusHistory'}
            try:
                ws_details_response = requests.get(detail_url, headers=headers, params=detail_params)
                ws_details_response.raise_for_status()
                ws_details = ws_details_response.json()
                
                events = derive_events_from_workspace(ws_details)
                all_events.extend(events)
            except requests.exceptions.RequestException as e:
                print(fclass="hl-string">"Could not fetch details for workspace {ws_id}: {e}")

        if not all_events:
            print(class="hl-string">"No events were generated. Check API responses and derivation logic.")
            return

        class=class="hl-string">"hl-comment"># Convert to DataFrame and save to CSV
        event_log_df = pd.DataFrame(all_events)
        event_log_df[class="hl-string">'EventTime'] = pd.to_datetime(event_log_df[class="hl-string">'EventTime'])
        event_log_df = event_log_df.sort_values(by=[class="hl-string">'ContractId', class="hl-string">'EventTime'])
        
        output_filename = class="hl-string">'ariba_contract_management_event_log.csv'
        event_log_df.to_csv(output_filename, index=False, date_format=class="hl-string">'%Y-%m-%d %H:%M:%S')
        print(fclass="hl-string">"Successfully created event log: {output_filename}")

    except requests.exceptions.RequestException as e:
        print(fclass="hl-string">"An error occurred during API request: {e}")

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

准备好开始了吗？

使用此模板准备数据，有把握地开始发现合同管理流程中的有价值洞察。简化数据收集，加快流程优化进程。

返回改进指南

下载模板

提升合同管理效率，现在开始试用

将合同周期时间缩短30%，简化SAP Ariba流程。

开始免费试用

无需信用卡，快速设置。

您的合同管理数据模板

您的合同管理数据模板

合同管理属性

合同管理活动

数据提取指南

SAP Ariba分析报告界面数据导出

步骤

配置

查询示例 sql

使用Ariba合同管理API的Python脚本

步骤

配置

查询示例 python

准备好开始了吗？

提升合同管理效率，现在开始试用