您的合同管理数据模板

Icertis

← 返回改进指南

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

您的合同管理数据模板

此模板全面介绍分析合同管理流程所需的关键数据，包括应收集的主要属性、应跟踪的关键活动，以及从源系统提取这些信息的实用指南。使用此资源，确保收集流程挖掘所需的全部数据。

建议收集的属性
应跟踪的关键活动
源系统数据提取指南

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

下载模板

合同管理属性

以下是构建可靠事件日志所需的关键数据字段，可用于全面分析您的合同管理流程。

3 必需 6 建议 11 可选

	名称	说明
	合同ID ContractId	Icertis平台中管理的每份合同的唯一标识符。
说明 Contract ID是每份合同的权威案例标识符，可将与特定合同相关的所有事件和活动唯一关联起来。这使您能够端到端分析每份合同从创建到结束的完整历程。在流程挖掘中，该属性是重建每份合同生命周期的基础。它可确保起草、审查、审批和执行等相关活动正确关联到相应合同，从而准确衡量周期时间并识别流程差异。为什么重要这是流程分析的主键，可跟踪合同完整历程并确保数据完整性。获取位置这是Icertis中Contract Agreement对象的核心属性。示例 CTR-2023-00123MSA-2024-589ANDA-FN-00451
	事件时间 EventTime	表示具体合同活动发生时间的时间戳。
说明此属性记录活动开始或完成的准确日期和时间，是流程挖掘的时间基础，为每个合同案例提供事件的时间顺序。 Event Time对于所有基于时间的分析都至关重要。它用于计算活动之间的周期时间、识别等待时段、衡量谈判或审批等具体阶段的持续时间，并定位合同长时间停滞的瓶颈。为什么重要此时间戳对于计算周期时间、持续时长等所有绩效指标，以及了解事件顺序都至关重要。获取位置这是Icertis审计轨迹或工作流历史日志中的标准字段，与每个记录的事件相关联。示例 2023-05-15T10:22:00Z2023-06-02T14:05:30Z2024-01-10T11:00:00Z
	活动名称 ActivityName	合同生命周期某一时点发生的具体事件或任务的名称。
说明活动名称描述合同管理流程中的具体步骤或里程碑。这些事件按照时间戳排序，为每份合同构建流程顺序流。分析此属性可以了解操作顺序、不同活动的频率以及流程的整体结构。它可用于识别常见流程路径、偏离标准过程的情况，以及导致返工或延迟的活动，例如多轮修订。为什么重要它定义流程中的步骤，是可视化流程图、分析顺序流和识别瓶颈的基础。获取位置这些信息通常来自Icertis中的事件日志或工作流历史表，用于记录合同状态变更和执行的任务。示例合同已起草法律审查已完成合同已执行修订已发起
	合同价值 ContractValue	合同的货币总价值。
说明此属性表示合同的财务价值，例如合同总金额或年化价值。它是用于确定合同优先级和了解财务影响的重要业务指标。在流程挖掘中，Contract Value可用于划分分析范围，重点关注高价值协议。例如，可以分析高价值合同是否需要更长时间才能完成审批或谈判。它还有助于风险评估，因为高价值合同的延迟可能对收入产生重大影响。为什么重要支持按优先级处理合同并开展基于价值的分析，将改进工作聚焦于财务影响最大的合同。获取位置这通常是Icertis中Contract Agreement对象的标准货币字段。示例 50000.001250000.002500.00
	合同状态 ContractStatus	合同在生命周期中的当前状态或阶段。
说明此属性表示合同案例的整体状态，例如“Draft”“In Review”“Awaiting Signature”或“Executed”。通常这是案例级属性，反映合同已达到的最后一个重要里程碑。它是“Contract Status And Throughput”等运营仪表板的重要数据。这些仪表板可以实时展示合同管道状态，帮助管理者了解各阶段的合同量，识别工作积压位置，从而主动管理合同组合。为什么重要提供合同管道的高层视图，是运营监控和吞吐量管理的重要依据。获取位置这是Icertis中Contract Agreement对象的主要状态字段。示例草稿内部审核中已签署已终止
	合同类型 ContractType	合同的分类，例如Master Services Agreement或Non-Disclosure Agreement。
说明 Contract Type根据协议的法律或业务目的对其进行分类。这是划分和比较合同生命周期的基础属性。不同合同类型通常遵循不同的流程路径，复杂程度和SLA也各不相同。按Contract Type分析流程，可以有针对性地改进，例如为高频、低风险的NDA创建优化工作流，同时为复杂、高价值的MSA采用不同方案。这是“Contract Variant Analysis”和“Policy Compliance Score”KPI的关键数据。为什么重要支持按流程分组，比较不同协议类型的生命周期和合规情况。获取位置这是Icertis中Contract Agreement对象的标准属性。示例主服务协议（MSA）保密协议（NDA）工作说明书（SOW）
	活动负责人 ActivityOwner	负责执行合同活动的用户或资源。
说明此属性用于识别执行特定活动的个人、团队或自动化用户。其值可以是具体用户名、员工ID或系统账户。分析活动负责人对于了解资源配置、工作负载分布和绩效至关重要。它可以帮助回答以下问题：哪些用户或团队形成瓶颈，哪些审核人员效率最高，以及工作如何分配。这直接支持“Reviewer Workload Distribution”仪表板。为什么重要支持按用户或团队分析绩效，帮助识别工作负载失衡和培训机会。获取位置此信息通常位于Icertis的工作流历史或审计轨迹数据中，并与每个事件关联。示例 John SmithLegal.Review.QueueSystem.AutoApproveSarah Chen
	结束时间 EndTime	表示特定合同活动完成时间的时间戳。
说明此属性记录活动的完成时间。StartTime标记开始时间，EndTime标记结束时间，两者共同定义活动的实际持续时间。同时记录开始和结束时间，对于准确计算每项活动的处理时间或持续时长至关重要。借此可以分析哪些步骤耗时最长，并区分实际处理时间与步骤之间的空闲等待时间。这也是“Approval Process Bottlenecks”和“Drafting And Revision Efficiency”等仪表板的关键数据。为什么重要支持精确计算活动持续时间，帮助区分处理时间和等待时间。获取位置与StartTime类似，此数据可在Icertis审计轨迹或工作流历史日志中找到。部分事件可能即时完成，此时StartTime等于EndTime。示例 2023-05-15T18:30:00Z2023-06-03T09:00:15Z2024-01-10T11:00:00Z
	负责人部门 OwnerDepartment	活动负责人所属的部门。
说明此属性指定执行活动的用户所属的业务部门，例如Legal、Sales或Procurement。它提供了资源参与流程情况的汇总视图。按部门分析对于了解跨部门协作和交接至关重要。它有助于识别部门之间的系统性延迟，例如销售提交后等待法务审核时间过长，这正是“Departmental Handoff Delays”仪表板关注的问题。为什么重要支持分析部门绩效和交接效率，突出跨职能瓶颈。获取位置可能需要以活动负责人为关键字段，与HR系统或用户目录关联，以补充此数据。相关信息也可能直接存储在Icertis用户档案中。示例法务销售采购财务
	SLA状态 SLAState	表示活动或案例是否符合其服务级别协议（SLA）的要求。
说明此属性通过将特定流程阶段的持续时间与预定义SLA目标进行比较得出。例如，如果法务审核超过标准48小时周转时间，系统可能将其标记为“Late”。 SLA Status对于合规监控和绩效管理至关重要。它支持创建“Contract Compliance Overview”等提醒和仪表板，及时突出显示违约情况，帮助团队优先处理逾期任务，并让管理者跟踪关键目标的达成情况。为什么重要即时展示服务级别目标的合规情况，帮助确定工作优先级并管理绩效。获取位置在流程挖掘工具中定义业务规则，将时间戳与预定义的SLA阈值进行比较，例如Legal Review duration > 2 days。示例按时存在风险延迟
	业务单元 BusinessUnit	与合同关联的内部业务单元。
说明此属性用于识别负责合同或提出合同需求的内部部门或业务单元，例如“Enterprise Sales North America”或“Global Procurement”。与Department类似，它支持从更高层级汇总流程数据，帮助比较组织不同部分的流程效率和合规情况，为高级管理层提供洞察，并支持战略资源配置决策。为什么重要支持在不同组织单元之间开展高层级流程绩效比较。获取位置这通常是合同协议中的关键元数据字段，用于将合同关联到组织架构。示例 BU-North America全球服务部产品开发部
	义务到期日 ObligationDueDate	必须履行特定合同义务的截止日期。
说明此属性跟踪合同执行后其中定义的关键义务、承诺和交付事项的到期日。一份合同可能包含多项义务，每项义务都有自己的到期日。跟踪这些日期对于执行后的合规和风险管理至关重要。此属性是“Obligation Adherence Rate”KPI的基础，可帮助组织监控承诺是否按时履行，并主动处理潜在违约。为什么重要支持监控合同执行后的合规情况，对于避免处罚和维护良好业务关系至关重要。获取位置 Icertis提供义务管理模块。此数据应来自与合同关联的义务记录。示例 2024-09-302025-01-152024-11-01
	修订次数 RevisionCount	合同经历的修订总次数。
说明此计算指标统计每个合同案例中“Contract Redlined Or Revised”等修订相关活动的次数，是衡量流程阻力的简单而有效的指标。修订次数较高，通常意味着起草或谈判阶段存在问题，例如需求不明确、初稿质量不佳或谈判困难。此指标直接用于计算“Contract Revision Rate”KPI，也用于在仪表板中识别返工过多的合同和流程变体。为什么重要量化合同生命周期中的返工情况，直接衡量起草和谈判阶段的效率。获取位置通过在事件日志中统计每个“ContractId”对应的特定修订活动发生次数计算得出。示例 1503
	最近数据更新时间 LastDataUpdate	流程数据最近一次刷新的时间戳。
说明此属性表示当前分析数据的新鲜度，记录从源系统最近一次提取数据的日期和时间。这些信息对于了解仪表板中洞察的时效性至关重要。它可以帮助您判断当前查看的是实时信息，还是数小时前或数日前的数据，为决策提供正确背景。为什么重要提供数据新鲜度背景，帮助用户了解流程分析反映的最新程度。获取位置此时间戳由数据管道或ETL工具在每次数据成功刷新周期结束时生成。示例 2024-07-27T08:00:00Z2024-07-26T23:59:59Z
	到期日 ExpirationDate	合同设定的到期日期。
说明此属性存储合同期限的结束日期。它是合同执行后管理生命周期的关键日期，可触发续签或终止活动。该日期对于监控合同生命周期结束管理的有效性至关重要。它是“On-Time Renewal/Termination Rate”KPI的基准，用于衡量续签或终止流程是否及时启动并完成，避免不必要的自动续签或服务中断。为什么重要对于管理合同续签和终止至关重要，确保生命周期结束流程得到主动处理。获取位置这是Icertis中Contract Agreement对象的标准日期字段。示例 2025-12-312026-06-302024-08-15
	区域 Region	与合同相关的地理区域。
说明此属性指定合同适用的地理区域，例如EMEA、APAC或North America。这对于流程存在区域差异的全球化组织尤为重要。按区域分析可以发现流程绩效、合规要求或谈判方式上的差异，这些差异可能源于当地法律和商业文化。借此可以开展区域基准比较，并识别可在全球推广的最佳实践。为什么重要帮助识别不同区域在流程绩效和合规方面的差异，这对全球化组织至关重要。获取位置这通常是Icertis合同对象中的元数据字段，往往属于标准配置的一部分。示例 EMEA北美APACLATAM
	文档版本 DocumentVersion	合同文档的版本号。
说明此属性跟踪合同文档在起草、修订标记和修改过程中的迭代次数。通常采用整数或主版本号.次版本号的形式。 Document Version可以直接反映返工情况。合同版本数量较高，通常意味着经历了多轮修改，可进一步调查其根本原因。它是计算“Contract Revision Rate”KPI以及分析“Drafting And Revision Efficiency”仪表板的重要输入。为什么重要直接衡量合同经历的返工和修订量，突出起草与谈判环节中的低效问题。获取位置 Icertis会维护所有合同文档的版本历史。此属性可从文档元数据或事件日志中提取。示例 1.02.34.00.5
	是否使用标准模板 IsStandardTemplate	用于标识合同是否基于公司标准模板创建的标志。
说明此布尔属性表示合同是否源自预先批准的标准模板，还是作为非标准定制协议创建。这是评估风险和合规情况的重要因素。基于标准模板的合同通常周期更短、风险更低。此属性是“Contract Template Adherence Rate”KPI的基础，也有助于分析使用非标准文档对流程的影响。它可以突出经常偏离标准的部门或合同类型，为改进模板使用提供依据。为什么重要衡量对公司标准的遵循程度，这与流程效率和风险降低直接相关。获取位置这可以是合同中的复选框字段，也可以根据Icertis中文档的来源或元数据推导得出。示例 truefalse
	源系统 SourceSystem	提取合同数据的系统。
说明此属性用于标识数据来源，本流程的数据来源为“Icertis”。在数据可能汇总自多个系统的环境中，它有助于数据治理和追溯。在分析中，您可以使用它筛选特定来源系统的数据；如适用，也可以比较不同系统中的流程。在当前视图中，它是所有事件的固定标识符。为什么重要确保数据血缘和可追溯性，这对于数据验证以及管理多来源数据十分重要。获取位置这通常是在数据提取和转换过程中添加的静态值，用于标记数据来源。示例 IcertisIcertisCLM
	相对方名称 CounterpartyName	合同中外部相对方的名称，例如客户或供应商。
说明此属性用于识别协议涉及的另一方，为分析互动和谈判提供必要背景。按相对方分析流程，可以发现谈判周期中的规律。例如，可以判断与某些供应商签订的合同是否始终需要更长谈判时间或更多轮修订。这些洞察有助于开展战略关系管理和制定针对性的谈判策略，并直接支持“Negotiation Cycle Time And Rework”仪表板。为什么重要支持分析与特定外部相对方的谈判模式和关系绩效。获取位置此信息作为合同元数据的一部分存储，通常链接到Icertis中的相对方或供应商主数据对象。示例 Acme CorporationGlobal Tech Inc.Innovate Solutions LLC

必需建议可选

合同管理活动

以下是应在事件日志中跟踪的关键流程步骤和里程碑，可用于准确发现和分析您的合同生命周期。

6 建议 8 可选

	活动	说明
	合同已执行	此活动标志着合同正式执行，即所有相关方均已签署。这是签署前流程的主要成功终点，通常通过与电子签名平台的集成记录。
为什么重要作为主要完成事件，这是“Average Contract Cycle Time”KPI的终点，表示合同正式生效并具有法律约束力。获取位置所有相关方完成签署后，电子签名平台会发送明确事件，Icertis随即记录该事件。采集来自电子签名平台集成的回调事件。事件类型 explicit
	合同已终止或到期	标志着合同生命周期结束，可能是主动终止，也可能是达到到期日。终止是明确事件，到期则根据合同元数据计算得出。
为什么重要这是合同生命周期的终止事件，对于分析续签率和衡量“On-Time Renewal/Termination Rate”KPI至关重要。获取位置用户执行终止操作时，系统会明确记录终止事件。到期则可通过当前日期与“Expiration Date”属性进行比较计算。采集通过比较系统日期与合同到期日计算，或根据手动终止事件确定。事件类型 calculated
	合同请求已发起	此活动标志着合同生命周期正式开始，即业务用户正式提出新合同请求。通常，当用户在Icertis平台中提交合同请求表单时，系统会记录这一明确事件。
为什么重要作为流程起点，此事件对于衡量整体合同周期时间至关重要。分析请求量和请求类型，有助于资源规划和需求管理。获取位置当Icertis中创建并提交“Contract Request”对象时，系统会记录这一明确事件。采集提交合同请求表单时记录的事件。事件类型 explicit
	已收到交易对方批准	此活动表示外部交易对方已同意条款并批准合同最终版本。该事件可以来自协作门户，也可以由合同负责人手动更新状态。
为什么重要此里程碑标志着谈判阶段结束，是计算“Average Negotiation Cycle Time”KPI的终点，也反映外部协作的效率。获取位置如果交易对方通过Icertis门户批准，系统可以记录这一明确事件；否则，可根据手动将状态变更为“Counterparty Approved”进行推断。采集由交易对方门户记录的事件，或由内部用户手动更新状态产生的事件。事件类型 explicit
	已获得内部审批	标志着所有必需的内部相关人员均已批准合同，合同可以进入外部谈判或签署阶段。通常根据审批工作流整体状态进入终止状态“Approved”进行推断。
为什么重要这是结束内部审查周期的关键里程碑，也是衡量“Average Approval Phase Duration”KPI的终点。获取位置根据工作流状态变为“Fully Approved”或类似状态进行推断，表示所有审批任务均已完成。采集最后一个内部审批任务完成的时间戳，或整体工作流状态变更的时间戳。事件类型 inferred
	法律审查已完成	表示法务部门已完成合同审查。通常，当法律审查人员在审批工作流中完成分配的任务时，系统会记录这一明确事件。
为什么重要此活动对于衡量法律审查周转时间、识别法务团队的潜在产能限制至关重要，并支持“Legal Review Wait Time”KPI。获取位置当Icertis工作流中的法律审查任务标记为“Complete”时，系统会明确记录该事件；也可以根据状态变为“Legal Approved”等情况进行推断。采集工作流引擎记录的事件，表示“Legal Review”任务已完成。事件类型 explicit
	义务监控已启用	此执行后活动表示系统已启用对合同义务和承诺的跟踪。通常，该事件会在合同执行后自动触发，也可以由合同经理手动触发。
为什么重要此事件启动执行后的管理计时，对于通过“Obligation Adherence Rate”KPI衡量并确保合规性至关重要。获取位置当合同状态变为“Active”或“Executed”时，Icertis义务管理模块会明确记录该事件。采集自动或手动启用与合同关联的义务记录。事件类型 explicit
	交易对方谈判已开始	表示合同已发送给外部交易对方进行审查和谈判。通常可根据合同状态变为“In Negotiation”，或审计日志中首次向外部发送文档的时间进行推断。
为什么重要此活动标志着谈判阶段开始，也是计算“Average Negotiation Cycle Time”KPI的起点。获取位置根据手动将状态变更为“In Negotiation”，或跟踪文档首次通过外部门户共享时的事件进行推断。采集状态变为“In Negotiation”或“Sent to Counterparty”的时间戳。事件类型 inferred
	修订已发起	表示正式修订有效合同的流程开始。当用户创建与原已执行协议关联的修订记录时，系统会记录此事件。
为什么重要修订通常意味着较大幅度的返工或范围变更。跟踪修订频率和周期时间，有助于了解合同稳定性和管理效率。获取位置创建“Amendment”对象或类似记录，并将其关联到现有合同时，系统会明确记录该事件。采集在Icertis系统中创建修订记录。事件类型 explicit
	内部审查已开始	此活动表示内部审查和审批工作流开始。当合同草稿正式提交给部门负责人、财务等内部相关人员审查时，系统会记录这一事件。
为什么重要这标志着审批阶段开始，而审批阶段往往是瓶颈的来源。分析从此事件开始的耗时，有助于识别内部协作启动延迟。获取位置当Icertis工作流触发“Submit for Review”操作时，系统会记录这一明确事件；也可以根据状态变为“In Internal Review”进行推断。采集用户启动内部审查工作流时记录的事件。事件类型 explicit
	合同已发送签署	表示最终合同已获批准，并已发送进行电子签署或纸质签署。通常通过与DocuSign或Adobe Sign等电子签名平台的集成记录这一明确事件。
为什么重要跟踪此事件有助于分析最终执行步骤的效率。审批完成到发送签署之间的延迟，可能暴露行政处理瓶颈。获取位置当Icertis内部启动签署流程时，通过与电子签名解决方案的API集成明确记录。采集签名请求发送后，由电子签名连接器记录的事件。事件类型 explicit
	合同已添加修订标记或完成修订	每当合同文档在内部审查或外部谈判期间被修改时，就会发生此活动。Icertis会跟踪文档版本，因此每个签入的新版本都可以记录为修订事件。
为什么重要按合同统计这些事件，可计算“Contract Revision Rate”KPI。修订次数过多，可能表明措辞含义不清、谈判效率低下或各方存在分歧。获取位置每当上传或签入合同文档的新版本时，Icertis文档管理模块都会明确记录该事件。采集每个新的文档版本号都会生成一个事件。事件类型 explicit
	合同已续签	表示现有合同已成功续签至下一个期限。这是系统中的明确操作，通常会创建新的合同记录或更新现有记录。
为什么重要此活动对于评估续签管理流程的有效性至关重要，并用于计算“On-Time Renewal/Termination Rate”KPI。获取位置用户在Icertis合同记录中执行“Renew”操作时，系统会生成这一明确事件。采集由用户发起的“Renew”交易记录的事件。事件类型 explicit
	合同已起草	表示初始合同文档的创建，可以基于模板，也可以创建新文件。通常可根据合同工作区中主合同文档的创建时间或首次上传时间推断这一事件。
为什么重要跟踪此活动有助于衡量初稿准备所需的时间，也是分析起草效率和模板使用遵循度的关键步骤。获取位置根据Icertis合同工作区或协议对象中主合同文档的创建时间推断。采集确定主合同文档第一个版本的创建时间。事件类型 inferred

建议可选

提取指南

如何从Icertis获取数据

步骤

访问Icertis Reporting Module：登录Icertis ICI平台。进入Analytics部分或Reporting Module，通常可在主应用菜单中找到。您必须拥有创建和运行报告所需的用户权限。
创建新报告：启动新报告创建流程。选择报告的主要业务对象。对于合同管理，通常选择“Contract Agreement”对象，或代表核心合同工作区的类似实体。
定义报告数据源：向报告中添加相关数据对象，以访问所有必要信息。包括“Agreement Documents”以获取版本信息、“Approval Workflow”以获取审查状态、“Audit History”以获取状态变更，以及“Obligations”以获取执行后的活动。
选择报告字段：配置报告列。这是最关键的一步，您需要将Icertis字段映射到所需的事件日志结构。您需要创建联合报告或复合报告，为每项关键活动生成单独一行。有关各项活动的详细字段映射，请参阅“query”部分中的配置。
配置活动和时间戳逻辑：为每项活动定义填充“ActivityName”和“EventTime”列的逻辑。例如，对于“Contract Executed”，“ActivityName”应为静态文本值，“EventTime”应映射到“Contract Agreement”对象中的“Execution Date”字段。对于由状态变更产生的活动，请使用记录该状态设置时间的对应日期字段。
应用报告筛选条件：设置筛选条件以定义提取范围。务必按日期范围筛选，例如选择最近6至12个月内的“Contract Creation Date”，以控制数据集规模。您还可以根据需要按“Contract Status”筛选，例如排除草稿，或按“Contract Type”筛选。
运行并预览报告：在Icertis界面中运行报告。预览前几百行，确认各列已按预期填充，并且同一Contract ID的不同活动显示为独立行。
导出报告：确认预览无误后，导出完整报告。请选择CSV格式，因为该格式便于流程挖掘工具读取。
合并并格式化数据（如有必要）：如果Icertis报告工具不支持在单个报告中创建全部事件，您可能需要为每种活动类型分别创建并导出报告。此时，可使用脚本语言或电子表格应用程序等外部工具，将各报告纵向合并，并确保所有文件的列名一致。最终输出必须是单个CSV文件。
准备上传：检查最终CSV文件。确保列标题符合所需属性：ContractId、ActivityName、EventTime、EndTime、ActivityOwner等。确认日期和时间值采用统一格式，例如ISO 8601。现在即可将文件上传到ProcessMind。

配置

前提条件：可访问Icertis ICI平台，并拥有针对Contract Agreements及相关对象创建和运行报告的用户角色与权限。
报告类型：能够从多个相关对象（Agreements、Documents、Workflows、Audit Trails）提取数据并整理为单个活动日志的复合报告或联合报告。如果无法实现，则需要创建多个独立报告。
主要数据对象：报告应基于“Contract Agreement”，并关联“Agreement Documents”、“Approval Workflow”、“Users”，必要时还应关联“Audit History”，以获取所有所需的事件时间戳和详细信息。
日期范围筛选：始终应用日期范围筛选，以控制导出规模并保障性能。建议先按最近6至12个月的“Contract Creation Date”或“Execution Date”进行筛选。
活动筛选：您可能需要根据状态字段（例如“Contract Status”和“Approval Status”）设置筛选条件，以准确识别特定活动发生的时间。数据范围应同时包含进行中和已完成的合同，从而完整呈现流程。
字段选择：明确选择必要字段。列数过多会降低报告生成和导出速度。请重点选择事件日志所需及推荐的属性。

a 示例查询 sql

/*
 This is a configuration guide for building the extraction report in the Icertis Reporting Module UI.
 Icertis reports are configured through a graphical interface, not a script.
 Create a single composite report that generates one row for each of the following activity blocks.
 The common fields should be mapped for every block.

 Common Field Mappings:
 - ContractId: Map to 'Contract Agreement'.'ID' or 'Contract Number'
 - OwnerDepartment: Map to 'Contract Agreement'.'Owning Department'
 - ContractType: Map to 'Contract Agreement'.'Agreement Type'
 - ContractStatus: Map to 'Contract Agreement'.'Status'
 - ContractValue: Map to 'Contract Agreement'.'Contract Value' or 'Total Value'
*/

// Block 1: Contract Request Initiated
{
  "ActivityName": "Contract Request Initiated",
  "EventTime": "'Contract Agreement'.'Request Date'",
  "ActivityOwner": "'Contract Agreement'.'Created By'"
}

// Block 2: Contract Drafted
{
  "ActivityName": "Contract Drafted",
  "EventTime": "'Primary Agreement Document'.'Created On'",
  "ActivityOwner": "'Primary Agreement Document'.'Created By'"
}

// Block 3: Internal Review Started
{
  "ActivityName": "Internal Review Started",
  "EventTime": "'Approval Workflow'.'Workflow Start Date'",
  "ActivityOwner": "'Contract Agreement'.'Owner'"
}

// Block 4: Legal Review Conducted
{
  "ActivityName": "Legal Review Conducted",
  "EventTime": "'Legal Review Task'.'Completion Date'",
  "ActivityOwner": "'Legal Review Task'.'Assigned To'"
}

// Block 5: Contract Redlined Or Revised
{
  "ActivityName": "Contract Redlined Or Revised",
  "EventTime": "'Agreement Document Version'.'Created On'",
  "ActivityOwner": "'Agreement Document Version'.'Created By'"
}

// Block 6: Internal Approvals Obtained
{
  "ActivityName": "Internal Approvals Obtained",
  "EventTime": "'Approval Workflow'.'Workflow End Date'",
  "ActivityOwner": "'Approval Workflow'.'Last Approver'",
  "FilterCondition": "'Approval Workflow'.'Status' = 'Approved'"
}

// Block 7: Counterparty Negotiation Started
{
  "ActivityName": "Counterparty Negotiation Started",
  "EventTime": "'Contract Agreement'.'Negotiation Start Date'",
  "ActivityOwner": "'Contract Agreement'.'Owner'"
}

// Block 8: Counterparty Approval Received
{
  "ActivityName": "Counterparty Approval Received",
  "EventTime": "'Contract Agreement'.'Counterparty Approval Date'",
  "ActivityOwner": "'Contract Agreement'.'Owner'"
}

// Block 9: Contract Sent For Signature
{
  "ActivityName": "Contract Sent For Signature",
  "EventTime": "'E-Signature Package'.'Sent Date'",
  "ActivityOwner": "'E-Signature Package'.'Sent By'"
}

// Block 10: Contract Executed
{
  "ActivityName": "Contract Executed",
  "EventTime": "'Contract Agreement'.'Execution Date'",
  "ActivityOwner": "'Contract Agreement'.'Owner'"
}

// Block 11: Obligations Monitoring Activated
{
  "ActivityName": "Obligations Monitoring Activated",
  "EventTime": "'Obligation'.'Activation Date'",
  "ActivityOwner": "'Obligation'.'Owner'"
}

// Block 12: Amendment Initiated
{
  "ActivityName": "Amendment Initiated",
  "EventTime": "'Amendment Agreement'.'Request Date'",
  "ActivityOwner": "'Amendment Agreement'.'Created By'"
}

// Block 13: Contract Renewed
{
  "ActivityName": "Contract Renewed",
  "EventTime": "'Contract Agreement'.'Renewal Date'",
  "ActivityOwner": "'Contract Agreement'.'Owner'"
}

// Block 14: Contract Terminated Or Expired
{
  "ActivityName": "Contract Terminated Or Expired",
  "EventTime": "COALESCE('Contract Agreement'.'Termination Date', 'Contract Agreement'.'Expiry Date')",
  "ActivityOwner": "'Contract Agreement'.'Owner'"
}

步骤

前提条件和设置：确保已安装Python 3.6或更高版本，以及pandas和requests库。从Icertis管理员处获取API凭据，包括Client ID、Client Secret和Icertis实例基础URL。这些凭据应属于拥有合同数据和审计日志数据读取权限的用户或服务账户。
初始化Python脚本：创建新的Python文件。导入所需库（requests、pandas、json、datetime），并在脚本顶部定义Icertis基础URL、API凭据以及所需提取日期范围的占位变量。
实现身份验证：创建用于处理Icertis API身份验证的函数。该函数使用您的Client ID和Secret向Icertis令牌端点发送POST请求，以获取bearer token。后续所有API请求都必须在请求头中包含此令牌。
获取合同列表：编写函数，获取指定日期范围内创建或修改的合同列表。该过程需要向主要合同API端点发送GET请求，例如/api/v1/contracts，并使用查询参数按日期筛选。
处理分页：对于返回对象列表的端点，Icertis API会对结果分页。脚本必须检查API响应中的“nextLink”或类似分页令牌，并循环访问所有页面，以收集完整的合同列表。
遍历并获取合同历史：针对上一步获取的每个Contract ID，分别调用提供详细历史记录或审计轨迹的端点，例如/api/v1/contracts/{id}/history。该端点包含流程挖掘所需的原始事件数据。
将事件映射为活动：这是核心转换步骤。遍历每份合同的历史记录项。使用条件逻辑（if/elif语句）将API中的原始事件描述映射为事件日志所需的标准化活动名称。例如，描述为“Status changed to Executed”的API事件应映射为ActivityName“Contract Executed”。
构建数据结构：处理每个相关事件时，创建包含所需属性的字典：ContractId、ActivityName和EventTime。同时，从合同主数据和事件数据中提取ActivityOwner和ContractType等推荐属性。
汇总并创建DataFrame：将每个事件字典追加到主列表中。处理完所有合同及其历史记录后，将字典列表转换为pandas DataFrame，为事件日志提供结构化的表格格式。
最终格式化和导出：清理DataFrame，确保所有列具有正确的数据类型，尤其是时间戳列。根据需要处理空值。最后使用to_csv方法将DataFrame导出为CSV文件，并设置index=False。该CSV文件即可上传到ProcessMind。

配置

API凭据：需要API用户或服务账户。该账户必须拥有读取合同对象、关联文档以及所有相关合同类型完整合同审计历史的权限。
日期范围：脚本包含START_DATE和END_DATE变量。建议先使用较小范围，例如3至6个月，以验证数据并控制性能。如需完整加载历史数据，可能需要分批运行脚本。
API端点配置：脚本使用/api/v1/contracts和/api/v1/contracts/{id}/history等占位API端点。您必须根据Icertis API文档确认正确的端点URL和版本。
活动映射逻辑：脚本中将原始事件描述映射为标准化活动名称的逻辑至关重要。您可能需要根据Icertis实例中配置的具体事件描述、自定义状态和工作流进行调整。
速率限制：请注意Icertis可能施加的API速率限制。脚本应针对HTTP 429（请求过多）响应加入基本错误处理；如果出现限流问题，还可以在请求之间增加等待间隔。

a 示例查询 python

import requests
import pandas as pd
import json
from datetime import datetime

class=class="hl-string">"hl-comment"># --- Configuration: Update these placeholders --- #
ICERTIS_BASE_URL = class="hl-string">"https://[your-instance].icertis.com"
API_CLIENT_ID = class="hl-string">"[Your_Client_ID]"
API_CLIENT_SECRET = class="hl-string">"[Your_Client_Secret]"
class=class="hl-string">"hl-comment"># Date range for extraction (YYYY-MM-DD)
START_DATE = class="hl-string">"2023-01-01"
END_DATE = class="hl-string">"2023-12-31"

class=class="hl-string">"hl-comment"># --- Main Extraction Logic --- #

def get_access_token():
    class="hl-string">"""Authenticates with Icertis and returns an access token."""
    class=class="hl-string">"hl-comment"># This is a representative authentication flow. Refer to Icertis documentation.
    auth_url = fclass="hl-string">"{ICERTIS_BASE_URL}/api/v1/oauth/client-credentials/token"
    payload = {
        class="hl-string">'grant_type': class="hl-string">'client_credentials',
        class="hl-string">'client_id': API_CLIENT_ID,
        class="hl-string">'client_secret': API_CLIENT_SECRET
    }
    try:
        response = requests.post(auth_url, 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 authenticating: {e}")
        return None

def extract_icertis_data():
    class="hl-string">"""Main function to extract, transform, and save contract data."""
    access_token = get_access_token()
    if not access_token:
        print(class="hl-string">"Could not retrieve access token. Exiting.")
        return

    headers = {class="hl-string">'Authorization': fclass="hl-string">'Bearer {access_token}'}
    event_log = []

    class=class="hl-string">"hl-comment"># 1. Fetch all contracts within the date range
    contracts_url = fclass="hl-string">"{ICERTIS_BASE_URL}/api/v1/contracts?search_created_date_from={START_DATE}&search_created_date_to={END_DATE}"
    all_contracts = []

    while contracts_url:
        try:
            response = requests.get(contracts_url, headers=headers)
            response.raise_for_status()
            data = response.json()
            all_contracts.extend(data.get(class="hl-string">'results', []))
            contracts_url = data.get(class="hl-string">'nextLink') class=class="hl-string">"hl-comment"># Handle pagination
        except requests.exceptions.RequestException as e:
            print(fclass="hl-string">"Error fetching contracts: {e}")
            break

    print(fclass="hl-string">"Found {len(all_contracts)} contracts to process.")

    class=class="hl-string">"hl-comment"># 2. For each contract, fetch its history
    for contract in all_contracts:
        contract_id = contract.get(class="hl-string">'id')
        contract_type = contract.get(class="hl-string">'contractType', {}).get(class="hl-string">'name')
        contract_status = contract.get(class="hl-string">'status', {}).get(class="hl-string">'name')
        contract_value = contract.get(class="hl-string">'monetaryValue')

        if not contract_id:
            continue

        history_url = fclass="hl-string">"{ICERTIS_BASE_URL}/api/v1/contracts/{contract_id}/history"
        try:
            history_response = requests.get(history_url, headers=headers)
            history_response.raise_for_status()
            history_items = history_response.json().get(class="hl-string">'results', [])
        except requests.exceptions.RequestException as e:
            print(fclass="hl-string">"Error fetching history for contract {contract_id}: {e}")
            continue

        class=class="hl-string">"hl-comment"># 3. Map history events to activities
        for event in history_items:
            activity_name = None
            event_time = event.get(class="hl-string">'timestamp')
            activity_owner = event.get(class="hl-string">'user', {}).get(class="hl-string">'name')
            owner_department = event.get(class="hl-string">'user', {}).get(class="hl-string">'department') class=class="hl-string">"hl-comment"># Placeholder field
            description = event.get(class="hl-string">'description', class="hl-string">'').lower()
            event_type = event.get(class="hl-string">'eventType', class="hl-string">'').lower()
            
            class=class="hl-string">"hl-comment"># --- Activity Mapping Logic --- #
            if class="hl-string">'request initiated' in description or class="hl-string">'created' in event_type:
                activity_name = class="hl-string">'Contract Request Initiated'
            elif (class="hl-string">'document uploaded' in description or class="hl-string">'draft created' in description) and event.get(class="hl-string">'version') == 1:
                 activity_name = class="hl-string">'Contract Drafted'
            elif class="hl-string">'status changed to' in description and class="hl-string">'internal review' in description:
                activity_name = class="hl-string">'Internal Review Started'
            elif class="hl-string">'task completed' in event_type and class="hl-string">'legal review' in description:
                activity_name = class="hl-string">'Legal Review Conducted'
            elif class="hl-string">'new version created' in description or class="hl-string">'document revised' in description:
                activity_name = class="hl-string">'Contract Redlined Or Revised'
            elif class="hl-string">'status changed to' in description and class="hl-string">'internally approved' in description:
                activity_name = class="hl-string">'Internal Approvals Obtained'
            elif class="hl-string">'status changed to' in description and class="hl-string">'in negotiation' in description:
                activity_name = class="hl-string">'Counterparty Negotiation Started'
            elif class="hl-string">'status changed to' in description and class="hl-string">'counterparty approved' in description:
                activity_name = class="hl-string">'Counterparty Approval Received'
            elif class="hl-string">'sent for signature' in description:
                activity_name = class="hl-string">'Contract Sent For Signature'
            elif class="hl-string">'status changed to' in description and class="hl-string">'executed' in description:
                activity_name = class="hl-string">'Contract Executed'
            elif class="hl-string">'obligations activated' in description:
                activity_name = class="hl-string">'Obligations Monitoring Activated'
            elif class="hl-string">'amendment initiated' in description or class="hl-string">'amendment created' in description:
                activity_name = class="hl-string">'Amendment Initiated'
            elif class="hl-string">'renewed' in event_type:
                activity_name = class="hl-string">'Contract Renewed'
            elif class="hl-string">'status changed to' in description and (class="hl-string">'terminated' in description or class="hl-string">'expired' in description):
                activity_name = class="hl-string">'Contract Terminated Or Expired'

            if activity_name:
                event_log.append({
                    class="hl-string">'ContractId': contract_id,
                    class="hl-string">'ActivityName': activity_name,
                    class="hl-string">'EventTime': event_time,
                    class="hl-string">'EndTime': event_time, class=class="hl-string">"hl-comment"># For point-in-time events, EndTime is the same as EventTime
                    class="hl-string">'ActivityOwner': activity_owner,
                    class="hl-string">'OwnerDepartment': owner_department,
                    class="hl-string">'ContractType': contract_type,
                    class="hl-string">'ContractStatus': contract_status,
                    class="hl-string">'ContractValue': contract_value
                })
    
    class=class="hl-string">"hl-comment"># 4. Create and save the event log
    if not event_log:
        print(class="hl-string">"No events were extracted. The output file will be empty.")
        return

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

    output_filename = class="hl-string">'icertis_contract_event_log.csv'
    df.to_csv(output_filename, index=False, date_format=class="hl-string">'%Y-%m-%dT%H:%M:%S.%f%z')
    print(fclass="hl-string">"Extraction complete. Event log saved to {output_filename}")

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

准备好开始了吗？

借助此模板，您已具备开始优化合同管理流程所需的一切。立即开始数据之旅，发掘有价值的洞察。

返回改进指南下载模板

优化您的Icertis合同：立即减少瓶颈

消除瓶颈，让合同周期缩短30%，治理水平进一步提升。

开始免费试用

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

您的合同管理数据模板

您的合同管理数据模板

合同管理属性

合同管理活动

提取指南

Icertis ICI平台Reporting Module导出

步骤

配置

a 示例查询 sql

使用Icertis REST API的Python脚本

步骤

配置

a 示例查询 python

准备好开始了吗？

优化您的Icertis合同：立即减少瓶颈

您的合同管理数据模板

您的合同管理数据模板

合同管理属性

合同管理活动

提取指南

Icertis ICI平台Reporting Module导出

步骤

配置

a 示例查询 sql

使用Icertis REST API的Python脚本

步骤

配置

a 示例查询 python

准备好开始了吗？

优化您的Icertis合同：立即减少瓶颈

我们重视您的隐私