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

您的合同管理数据模板

SAP Ariba Contracts

← 返回改进指南

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

您的合同管理数据模板

此模板为收集分析合同管理流程所需的 data 提供了全面指南。它概述了要收集的基本属性、要追踪的关键活动，以及从源系统中提取这些信息的实用指导。利用此资源简化您的 data 准备工作，开启您的 Process Mining 之旅。

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

不熟悉事件日志？了解如何创建流程挖掘事件日志.

下载模板

合同管理属性

这些是为您的事件日志推荐的基本 data 字段，以确保对合同管理流程进行全面分析。

3 必填 6 推荐 11 可选

	名称	描述
	事件timestamp EventTime	活动或 event 发生的精确日期和时间。
描述此 timestamp 标记了合同管理流程中每个活动的开始。它是所有基于时间的分析（包括计算周期时间、时长和步骤间的等待时间）的关键组成部分。通过基于此 timestamp 对 event 进行排序，Process Mining 工具可以准确重构每份合同的活动序列。从而能够分析随时间变化的流程绩效，并识别与时间相关的瓶颈，例如法务审核阶段的延迟。为何重要此属性是计算所有基于时间的指标（如周期时间和等待时间）以及正确排列流程 event 的基础。获取方式存在于 SAP Ariba Contracts 的事件日志、审计轨迹或状态变更历史表中，与活动信息并列。示例 2023-04-15T10:22:05Z2023-05-01T14:00:12Z2023-05-20T09:30:00Z
	合同 ID ContractId	每个合同工作区的唯一标识符，作为主要的 case 标识符。
描述此属性作为主要的 case 标识符，将整个合同生命周期中的所有活动和 event 联系起来。它支持重构每份合同从创建到关闭的端到端历程。在 Process Mining 中，具有相同合同 ID 的每个 event 都被视为同一个流程实例的一部分。这对于分析流程变体、计算周期时间以及识别特定于单个合同或合同类型的瓶颈至关重要。为何重要这是追踪合同完整周期的核心，支持所有 case 维度的分析以及流程可视化的呈现。获取方式这是 SAP Ariba Contracts 中的核心标识符，通常在所有合同相关的表和视图中作为“合同工作区 ID”出现。示例 CW2023-00123CW-MSA-45892CW2024-FIN-001CW19876
	活动 ActivityName	发生的特定业务流程步骤或 event 的名称。
描述此属性描述了在特定时间点完成的任务或里程碑，例如“合同已起草”或“开始法务审核”。这些活动的顺序构成了流程图的基础。分析活动对于了解正在进行的工作、不同步骤发生的频率以及顺序至关重要。它支持识别常见的流程路径、偏差和返工循环，例如重复出现的“修改合同”活动。为何重要它定义了流程中的步骤，支持流程流向的可视化，并能识别瓶颈和返工。获取方式通常源自 SAP Ariba Contracts 模块内的任务状态更改、审计日志或 event 表。示例内部评审已开始合同已执行变更已发起合同已关闭
	事件结束时间 EventEndTime	指示活动完成时的时间戳。
描述此属性记录活动的完成时间。StartTime 标记开始，EndTime 标记结束，从而能够精确测量非瞬时活动的持续时间。在分析中，EndTime 与 StartTime 之差即为活动的处理时间。这对于详细的瓶颈分析至关重要，有助于区分实际处理任务的时间与任务之间的等待时间。例如，它可以精确测量“法务审核”活动的耗时。为何重要它能精确计算活动处理时间，这对于识别瓶颈和衡量资源效率至关重要。获取方式请参考 SAP Ariba Contracts 文档。这可能存在于审计日志或任务完成记录中。示例 2023-04-16T11:45:10Z2023-05-03T17:21:09Z2023-05-20T10:05:00Z
	合同价值 ContractAmount	合同的总金额。
描述此属性代表合同协议的财务价值。它是了解每份合同相关的业务影响和风险的关键指标。在分析中，合同价值可用于优先处理高价值合同以进行更密切的监控，或识别业务量趋势。“已执行合同价值趋势”仪表板利用此属性汇总随时间推移签署的合同价值，从而洞察业务绩效。它对于根本原因分析也很有价值，可以查看高价值合同是否遵循了不同（可能更慢）的流程。为何重要它量化了合同的财务影响，支持基于价值的分析、优先级排序和业务绩效追踪。获取方式请参考 SAP Ariba Contracts 文档。这是合同工作区上的标准字段，通常标记为“金额”或“合同价值”。示例 150000.0025000.501200000.00
	合同类型 ContractType	合同的分类，例如 MSA、NDA 或 SOW。
描述此属性根据法律或业务目的对合同进行分类。常见类型包括主服务协议 (MSA)、保密协议 (NDA) 或工作说明书 (SOW)。按合同类型分析流程对于理解流程变体至关重要。不同类型的合同通常具有不同的审批路径、SLA 和复杂程度。例如，NDA 的流程可能非常简单且快速，而 MSA 可能需要多层级的法务和财务审核。此属性是仪表板的关键筛选器，用于比较不同合同类别的周期时间和合规率。为何重要它支持细化分析，揭示不同类型的合同如何影响流程流向、复杂性和持续时间。获取方式这是 SAP Ariba Contracts 合同工作区详情中可用的标准分类字段。示例主服务协议 (MSA)保密协议 (NDA)工作说明书 (SOW)销售协议
	法律顾问 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 合规性的清晰监控，并能快速识别违规情况。获取方式这是一个派生属性，在 data 转换期间通过比较 ActivityProcessingTime 与 SlaForReview 计算得出。示例已达成已超期不适用
	交易对方名称 CounterpartyName	合同外部方的名称，例如供应商或客户。
描述此属性标识合同中涉及的另一方。它可以是供应商、客户或合作伙伴。这些信息为合同管理流程增加了关键的业务上下文。按合作方分析有助于识别与特定合作伙伴相关的模式。例如，与某些合作方的谈判可能总是耗时较长，这表明需要标准模板或预先谈判的条款。它还可以用于评估整个合同组合中的关系健康状况和供应商绩效。为何重要它支持基于外部方的流程性能分析，有助于识别谈判难点并管理供应商关系。获取方式此类信息通常存储在 SAP Ariba Contracts 合同工作区的供应商或客户信息部分。示例 Acme CorporationGlobal Tech Inc.Innovate Solutions LLC
	最后数据更新 LastDataUpdate	指示此 event 的 data 上次刷新或提取时间的 timestamp。
描述此属性记录从源系统最后一次提取 data 的日期和时间。它不是 event 发生的时间，而是记录加载到流程挖掘平台的时间。这些信息对于 data 治理和了解分析的时效性至关重要。它有助于用户了解所看到的 data 是否为最新，并对于管理增量 data 加载必不可少。为何重要它确保用户了解 data 的时效性，这对于准确、及时的流程分析和监控至关重要。获取方式此 timestamp 是在将 data 摄入到 Process Mining 工具的过程中生成并添加的。示例 2024-05-21T02:00:00Z2024-05-22T02:00:00Z
	区域 Region	与合同或合作方关联的地理区域。
描述此属性定义了合同适用的地理区域，如北美、欧洲中东和非洲 (EMEA) 或亚太地区 (APAC)。这通常由合作方所在地或拥有合同的业务单元决定。按区域细分流程可以识别绩效、合规性和流程行为方面的区域差异。例如，分析可能显示亚太地区的合同周期时间较长，原因是特定的监管审核步骤。这种见解有助于根据区域需求量身定制流程改进方案和资源分配。为何重要它支持地域分析，以识别流程性能、周期和合规性方面的区域差异。获取方式请参考 SAP Ariba Contracts 文档。这可能是合同工作区的一个字段，也可能衍生自交易对方的地址。示例北美欧洲、中东和非洲亚太拉美地区
	合同到期日 ContractExpirationDate	合同设定的到期日期。
描述此属性存储已签署合同的正式到期日期。它是管理签署后合同生命周期的关键 data。此日期是“合同义务和续约状态”仪表板的基础。它用于触发即将到来的续约或到期警报，确保合同不会无意中失效。分析这些 data 有助于组织主动管理其合同组合，降低与过期协议相关的风险，并抓住续约机会。为何重要它对于主动的生命周期管理至关重要，能实现及时的续约，防止意外失效，并有效管理各项义务。获取方式这是合同工作区中的一个标准字段，通常位于 SAP Ariba Contracts 的抬头或条款详情部分。示例 2025-12-31T23:59:59Z2024-08-15T23:59:59Z2026-06-30T23:59:59Z
	合同总周期时间 TotalContractCycleTime	从创建合同工作区到最终执行所经过的总时间。
描述此计算属性测量单个合同的完整端到端时长。通常计算为第一个活动（通常是“创建合同工作区”）与最后一个活动（通常是“执行合同”）之间的时间差。这是一个主要的绩效指标，即“端到端合同周期时间”。它提供了合同管理流程整体效率的高水平衡量标准。它用于仪表板中追踪随时间推移的绩效表现，并比较不同合同类型、部门或区域的周期时间，从而帮助识别主要的改进领域。为何重要它提供了衡量流程速度和效率的最终标准，通过单一指标总结了整个合同生命周期的绩效表现。获取方式这是一个在 Process Mining 工具内或 data 转换期间，在 case 级别计算出的指标。示例 P35DP12DT5HP90D
	合同状态 ContractStatus	合同在其生命周期中的当前总体状态。
描述此属性指示合同当前的高级状态，如“草案”、“审核中”、“已执行”、“已过期”或“已终止”。这与活动不同，活动是单个 event，而状态代表一段时间内的状况。此属性对于“合同义务和续约状态”等仪表板至关重要，它能提供当前合同组合的快照。它有助于识别停滞的合同，并管理续约和到期等生命周期 event。分析状态之间的转换还可以揭示流程中的瓶颈或低效环节。为何重要它提供了合同当前状态的高级视图，对于组合管理、状态追踪和生命周期分析至关重要。获取方式这是 SAP Ariba Contracts 合同工作区抬头上的一个主要状态字段。示例草稿审批中已执行已到期
	审核 SLA SlaForReview	完成审核活动的目标耗时或截止日期。
描述此属性定义了特定审核任务（如“内部审核”或“法务审核”）约定的服务级别协议 (SLA)。它代表了审核应完成的目标时间。此属性对于“内部和法务审核 SLA 达成率”仪表板和 KPI 至关重要。通过将审核中的实际耗时与此目标进行比较，组织可以衡量内部服务级别的合规性。这有助于识别系统性延迟、落实团队责任，并确保审核流程不会成为主要的瓶颈。为何重要它为审核活动设定了绩效目标，支持测量 SLA 合规性并识别延迟。获取方式请参考 SAP Ariba Contracts 文档。这可能在审批工作流规则或模板中进行配置。示例 P3DP5DP10D
	是否返工 IsRework	用于指示某项活动是否为返工或对前一步骤的重复。
描述如果诸如“合同修订”之类的活动在同一个合同 case 中出现多次，则此布尔属性设置为 true。它有助于明确识别并量化流程中的返工循环。此标志对于计算“合同返工率”KPI 以及在流程图中可视化返工情况至关重要。通过筛选此属性，分析师可以快速隔离需要重大修订的合同，调查根本原因，并测量返工对整体周期时间的影响。它突显了起草和谈判阶段的低效之处。为何重要它将返工量化，从而可以轻松衡量流程中的低效环节，分析其根本原因，并持续追踪改进效果。获取方式这是一个派生属性，在 data 转换期间通过检测同一 case 内重复的活动计算得出。示例 truefalse
	活动时长 ActivityProcessingTime	在某项活动上花费的时长，根据其开始和结束时间计算得出。
描述此属性测量在特定活动上花费的实际时间，计算方式为 EventEndTime 与 EventTime 之差。它代表任务的实际处理时间。这是绩效分析的基础指标。它用于瓶颈分析仪表板，以精准定位哪些步骤消耗的时间最长（例如漫长的法务审核或谈判）。它还用于计算“平均法务审核周期时间”等 KPI，并有助于区分处理时间与等待时间，从而更准确地反映流程效率。为何重要它能精准测量每个流程步骤的耗时，这对于识别瓶颈和分析资源效率至关重要。获取方式这是一个计算属性，在 data 转换期间通过 EventEndTime 减去 EventTime 得出。示例 P1DT2H23M5SP3DT1H36MPT45M
	源系统 SourceSystem	data 来源的记录系统。
描述此属性标识生成 event data 的源系统。对于此流程，它始终为“SAP Ariba Contracts”。包含此属性是 data 治理和可追溯性的最佳实践。当合并来自多个系统的 data 时，它变得尤为重要，能确保 data 来源清晰并有助于排查 data 质量问题。为何重要它提供了有关 data 来源的关键上下文，确保了可追溯性并支持多系统分析。获取方式这通常是在 data 提取和 transformation 过程中添加的静态值，用于标记 dataset 的来源。示例 SAP Ariba Contracts

必填推荐可选

合同管理活动

这些是事件日志中需要捕获的核心流程步骤和关键里程碑，用于实现精准的合同管理流程发现。

6 推荐 8 可选

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

推荐可选

提取指南

如何从 SAP Ariba Contracts 获取数据

步骤

访问分析报告：登录您的 SAP Ariba 系统。点击主菜单并选择 Analytical Reports 或类似路径（如 Manage > Analytical Reports）进入报告板块。
创建新报告：点击 Create 按钮并选择 New Report。选择创建包含多个事实表 (multiple facts) 的报告。
选择主事实表：在报告生成器中，选择 Contract Workspace (Projects) 作为主事实数据。该事实表包含每个合同案例的核心信息。
关联其他事实表：为了获取所有必要的活动和属性，请将以下事实表关联到 Contract Workspace (Projects)。使用共同的 Project Id 或 Contract Id 字段作为关联条件：
- Approval History：获取审批任务的详细信息，包括提交、批准和驳回。
- Task：获取所有 workflow 任务的信息、起止日期及负责人。
- Document：跟踪文档版本，这对于识别 Contract Drafted 和 Contract Revised 活动至关重要。
定义报告字段（透视逻辑）：目标是为每个业务活动创建单独的一行。由于 Ariba 界面通常每份合同仅生成一行，您需要手动定义计算字段或导出宽表后再进行转换。建议为每个潜在事件的 timestamp 添加列，例如：
- 来自 Contract Workspace (Projects) 事实表的 Workspace Creation Date。
- 来自 Document 事实表的 Main Document Create Date（筛选主协议和首个版本）。
- 来自 Task 事实表的 Legal Review Start Date（筛选特定的法律评审任务）。
- 来自 Contract Workspace (Projects) 事实表的 Execution Date。
- 依此类推，为 14 个必需活动中的每一个 timestamp 添加专用列。
选择属性字段：向报告中添加所有必需和推荐的属性字段，例如 Contract Id、Project Owner（对应 UserName）、Department、Amount（对应 ContractAmount）以及 Contract Type。
应用筛选器：进入 Filters 选项卡。为 Contract Workspace (Projects) 事实表设置 Time Created 筛选器，将数据提取限制在可管理的范围内（如过去 6-12 个月）。添加 Project Type 等筛选条件，确保仅包含合同工作区。
运行并导出 data：运行报告。输出将是一个宽表，每行代表一份合同，并包含多个代表不同日期事件的列。将此报告导出为 CSV 或 Microsoft Excel 文件。
转换 data：导出的文件还不是事件日志，必须进行转换。使用 Microsoft Excel Power Query、Python 或专用 ETL 工具对 data 进行逆透视 (unpivot)。对于导出文件中的每一行，在转换后的新文件中根据步骤 5 创建的日期列生成多行。此过程将宽格式转换为 ProcessMind 所需的长格式事件日志。
格式化事件日志：在转换后的文件中，确保列名完全符合要求：ContractId、ActivityName、EventTime、EventEndTime、UserName 等。将 timestamp 列格式化为统一格式，如 YYYY-MM-DD HH:MI:SS。将最终文件另存为 CSV。
上传至 ProcessMind：生成的 CSV 文件现在可以上传到您的 Process Mining 工具中。

配置

要包含的事实数据：该报告需要关联多个事实表。请从 Contract Workspace (Projects) 开始，并关联 Approval History、Task 和 Document 事实表，以收集完整的历史记录。
时间范围：对于初步分析，请在 Contract Workspace (Projects) 事实表的 Time Created 字段上设置过去 6 到 12 个月的过滤条件。如果数据量巨大，请考虑按季度或按月分批导出。
关键筛选器：务必按 Project Type 进行筛选，确保仅提取合同工作区，而非寻源项目等其他项目类型。您还可以按“部门”或“品类”进行筛选以缩小分析范围。
数据粒度：选择能提供特定事件 timestamp 的字段，如任务激活日期、审批日期和文档创建日期。避免仅使用“最后修改日期”，因为它缺乏具体的事件背景。
前提条件：您的 SAP Ariba 用户账号需要具备创建和运行分析报告的权限。通常需要分配“分析用户”或“报告管理员”等角色。
性能考量：跨较长时间范围关联多个事实表并导出大量字段可能会导致报告运行缓慢或超时。请耐心等待，或考虑在非高峰时段运行报告，亦或采用分小批次导出的方式。

a 查询示例 config

-- 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 开发者门户中注册应用。在提取 data 之前，您必须在 SAP Ariba 开发者门户中注册一个新应用。完成后您将获得 Application Key、OAuth Client ID 和 OAuth Client Secret。请确保该应用已被授予访问 Contract Workspaces API 的必要权限。
搭建 Python 环境。在您的机器上安装 Python 3。然后安装用于 API 请求和 data 处理的必要库。打开终端或命令提示符并运行：pip install requests pandas。
配置 Python 脚本。将提供的 Python 脚本复制到文件中（例如 ariba_extraction.py）。打开文件并更新顶部配置部分中的占位符。您需要输入 Ariba Realm、API Key、OAuth Client ID 和 Client Secret，并设置提取所需的时间范围。
了解身份验证流程。脚本会首先使用您的凭证调用 SAP Ariba API 身份验证端点，获取临时访问令牌。此令牌是后续所有 data 请求的必需项，脚本会自动将其包含在 API 调用的请求头中。
执行脚本获取合同工作区。在终端中运行脚本：python ariba_extraction.py。脚本将开始获取在指定时间范围内更新的所有合同工作区列表，并自动处理分页以检索所有相关记录。
获取详细的工作区数据。针对上一步识别出的每个合同工作区，脚本会发起详细的后续 API 调用。这将检索相关的任务、文档、团队成员以及工作区的历史状态变更，这些对于构建事件日志至关重要。
将 API 响应转换为事件。脚本的核心逻辑会遍历每个合同的详细 JSON 响应。它会智能地将不同的数据点（如工作区创建日期、任务状态变更、文档版本上传和合同状态字段 contractStatus）映射到事件日志所需的特定活动名称。
构建并丰富事件日志。识别出事件后，脚本会将其添加到 pandas DataFrame 中。通过从 API data 中提取相关值，脚本会填充必需列（ContractId、ActivityName、EventTime）和推荐列（UserName、ContractAmount、ContractType 等）。
导出最终事件日志。处理完所有合同工作区后，脚本会在同一目录下将完整的事件日志保存为名为 ariba_contract_management_event_log.csv 的 CSV 文件。该文件格式正确，可直接上传至 ProcessMind。

配置

API 凭证：您需要从 SAP Ariba 开发者门户获取以下信息：
- API_KEY：为您的注册应用生成的 API 密钥。
- CLIENT_ID：OAuth 客户端 ID，通常为 base64 编码字符串。
- CLIENT_SECRET：OAuth 客户端密钥。
Realm：您公司特定的 SAP Ariba 域名称（例如 'mycompany-T'），这能将 API 调用指向正确的数中心。
时间范围筛选：设置 UPDATED_DATE_FROM 和 UPDATED_DATE_TO 参数至关重要，以限制数据提取的范围。建议初始范围设为过去 3-6 个月，以确保数据量适中并控制脚本运行时间。
Workspace 筛选：可以在 fetch_workspaces 函数的 API 调用中添加额外筛选条件。您可以根据 contractStatus（如 'Active'、'Executed'）或 projectType 等字段进行过滤，以针对特定的合同类型。
前提条件：访问权限需要有效的 SAP Ariba Contracts 订阅并启用 API 功能。您还需要一个拥有足够权限的用户账号，以便在开发者门户上注册应用并查看合同工作区数据。

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

您的合同管理数据模板

您的合同管理数据模板

合同管理属性

合同管理活动

提取指南

SAP Ariba 分析报告界面 data 导出

步骤

配置

a 查询示例 config

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

步骤

配置

a 查询示例 python

准备好开始了吗？

解锁合同管理效率，立即开始试用

您的合同管理数据模板

您的合同管理数据模板

合同管理属性

合同管理活动

提取指南

SAP Ariba 分析报告界面 data 导出

步骤

配置

a 查询示例 config

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

步骤

配置

a 查询示例 python

我们重视您的隐私

准备好开始了吗？

解锁合同管理效率，立即开始试用