您的合同管理数据模板

Icertis

← 返回改进指南

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

您的合同管理数据模板

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

建议采集的属性
需要跟踪的关键活动
从源系统提取数据的指南

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

下载模板

合同管理属性

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

3 必填 6 建议填写 11 选填

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

必填建议填写选填

合同管理活动

在事件日志中跟踪这些关键流程步骤和里程碑，以准确发现并分析合同生命周期。

6 建议填写 8 选填

	活动	说明
	发起合同申请	此活动标志着合同生命周期正式开始，业务用户在此提交新合同申请。通常，用户在Icertis平台提交合同申请表时，系统会记录这一明确事件。
重要性作为流程的起点，此事件对于衡量整体合同周期时间至关重要。分析申请数量和类型有助于规划资源并管理需求。获取途径在Icertis中创建并提交“合同申请”对象时，系统会记录这一明确事件。采集提交合同申请表时记录的事件。事件类型 explicit
	合同终止或到期	标志着合同生命周期结束，可能是主动启动终止流程，也可能是合同到期。终止是明确事件，到期则根据合同属性计算得出。
重要性这是合同生命周期的终止事件，对于分析续约率和衡量“按时续约或终止率”KPI至关重要。获取途径用户执行终止操作时，系统会明确记录终止事件。到期事件则可通过将当前日期与“到期日期”属性进行比较来计算。采集将系统日期与合同到期日期进行比较，或根据手动记录的终止事件计算。事件类型 calculated
	完成内部审批	标志着所有必需的内部相关人员均已批准合同，合同可以进入外部谈判或签署阶段。通常可根据审批工作流的整体状态进入最终“已批准”状态来推断。
重要性这是结束内部审查周期的关键节点，也是衡量“平均审批阶段时长”KPI的终点。获取途径可根据工作流状态变为“内部全部批准”或类似状态推断，表示所有审批任务均已完成。采集最后一项内部审批任务的完成时间戳，或工作流整体状态变更的时间戳。事件类型 inferred
	完成合同签署	此活动标志着合同正式签署，即所有各方均已签字。这是签署前流程的主要成功终点，可通过与电子签名平台集成进行记录。
重要性作为主要的完成事件，这是衡量“平均合同周期时间”KPI的终点，也标志着合同开始具有法律约束力并正式生效。获取途径所有各方完成签署后，电子签名平台会发送明确事件，并由Icertis记录。采集电子签名平台集成发送的回调事件。事件类型 explicit
	完成法律审查	表示法务部门已完成合同审查。通常，法务审查人员完成审批工作流中分配的任务时，系统会记录这一明确事件。
重要性此活动对于衡量法律审查周转时间、发现法务团队潜在的产能限制至关重要，也可用于支持“法律审查等待时间”KPI。获取途径在Icertis工作流中将法律审查任务标记为“已完成”时，系统会明确记录此事件；也可以根据状态变为“法务已批准”等情况推断。采集工作流引擎记录的事件，表示“法律审查”任务已完成。事件类型 explicit
	收到交易对方批准	此活动表示外部交易对方已同意合同条款并批准最终版本。协作门户可能会记录这一明确事件，也可能由合同负责人手动更新状态。
重要性此节点标志着谈判阶段结束，也是计算“平均谈判周期时间”KPI的终点，可用于评估外部协作效率。获取途径如果交易对方通过Icertis门户进行审批，系统可能会记录这一明确事件；否则，可根据状态被手动改为“交易对方已批准”推断。采集由交易对方门户记录的事件，或内部用户手动更新状态时记录的事件。事件类型 explicit
	修订或修改合同	在内部审查或外部谈判期间，每次修改合同文件都会发生此活动。Icertis会跟踪文件版本，因此每次签入新版本时都可以记录为一次修订事件。
重要性统计每份合同的此类事件，可计算“合同修订率”KPI。修订次数过多可能表明措辞含糊、谈判效率低下或各方意见不一致。获取途径每当合同文件的新版本上传或签入时，Icertis文档管理模块都会明确记录此事件。采集每创建一个新的文档版本号，系统都会生成一个事件。事件类型 explicit
	发起合同修订	表示正式启动对有效合同进行修订的流程。用户创建与原已签署协议关联的修订记录时，系统会记录此事件。
重要性合同修订通常意味着大量返工或范围变更。跟踪修订频率和周期时间，有助于了解合同稳定性和管理效率。获取途径创建“修订”对象或类似记录，并将其关联到现有合同时，系统会明确记录此事件。采集在Icertis系统中创建修订记录。事件类型 explicit
	发送合同以供签署	表示最终批准的合同已发送，等待电子签名或手写签名。通过与DocuSign或Adobe Sign等电子签名平台集成，可记录这一明确事件。
重要性跟踪此事件有助于分析最终签署环节的效率。审批完成后到发送签署之间的延误，可能表明存在行政流程瓶颈。获取途径从Icertis发起签署流程时，系统会通过电子签名解决方案的API集成明确记录此事件。采集电子签名连接器在发送签署请求时记录的事件。事件类型 explicit
	启用义务监控	此签署后活动表示合同义务和承诺已在系统中启用跟踪。通常，合同签署后系统会自动触发此事件，也可以由合同经理手动触发。
重要性此事件启动签署后的管理计时，对于通过“义务履行率”KPI衡量并确保义务履行至关重要。获取途径当合同状态变为“活跃”或“已签署”时，Icertis义务管理模块会明确记录此事件。采集自动或手动启用与合同关联的义务记录。事件类型 explicit
	开始与交易对方谈判	表示合同已发送给外部交易对方进行审查和谈判。通常可根据合同状态变为“谈判中”推断，也可以依据审计日志中首次向外部发送文件的记录推断。
重要性此活动标志着谈判阶段开始，也是计算“平均谈判周期时间”KPI的起点。获取途径可根据手动将状态改为“谈判中”推断，也可以跟踪文件首次通过外部门户共享时记录的事件。采集状态变为“谈判中”或“已发送给交易对方”时的时间戳。事件类型 inferred
	开始内部审查	此活动表示内部审查和审批工作流开始。合同草稿正式提交给部门负责人或财务等内部相关人员审查时，系统会记录此活动。
重要性这标志着审批阶段开始，而审批阶段往往容易出现瓶颈。分析从此事件开始的耗时，有助于发现内部协作启动延迟的问题。获取途径在Icertis工作流中触发“提交审查”操作时，系统会记录这一明确事件；也可以根据状态变为“内部审查中”推断。采集用户启动内部审查工作流时记录。事件类型 explicit
	续签合同	表示现有合同已成功续签至下一个期限。这是系统中的明确操作，通常会创建新的合同记录或更新现有记录。
重要性此活动是评估续约管理流程成效的关键，可用于计算“按时续约或终止率”KPI。获取途径用户在Icertis合同记录中执行“续约”操作时，系统会生成这一明确事件。采集用户发起“续约”交易时记录的事件。事件类型 explicit
	起草合同	表示初始合同文件的创建，可以基于模板生成，也可以作为新文件创建。通常可根据合同工作空间中关联的主要合同文件的创建或首次上传记录推断此事件。
重要性跟踪此活动有助于衡量准备初稿所需的时间，也是分析起草效率和模板使用情况的关键步骤。获取途径可根据Icertis合同工作空间或协议对象中主要合同文件的创建时间戳推断。采集确定主要合同文件首个版本的创建时间戳。事件类型 inferred

建议填写选填

数据提取指南

如何从Icertis获取数据

步骤

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

配置

前提条件：您需要能够访问Icertis ICI平台，并拥有针对合同协议及相关对象创建和运行报表的用户角色与权限。
报表类型：使用复合报表或联合报表，从多个相关对象（协议、文档、工作流、审计轨迹）提取数据，并整理为单一活动日志。如果无法实现，则需要分别创建多个报表。
主要数据对象：报表应以“合同协议”为基础，并关联“协议文档”、“审批工作流”、“用户”，必要时还需关联“审计历史”，以获取所需的事件时间戳和详细信息。
日期范围筛选：始终按日期范围筛选，以控制导出规模并保障性能。建议先筛选最近6至12个月的“合同创建日期”或“签署日期”。
活动筛选：您可能需要依据状态字段（例如“合同状态”、“审批状态”）筛选，以准确判断活动发生时间。数据范围应同时包含活跃和已完成的合同，才能全面了解流程。
字段选择：明确选择必要字段。列数过多可能拖慢报表生成和导出。请重点选择事件日志所需及建议采集的属性。

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凭据，包括客户端ID、客户端密钥和Icertis实例基础URL。凭据应属于有权读取合同数据和审计日志数据的用户或服务账户。
初始化Python脚本：新建Python文件，导入所需库（requests、pandas、json、datetime），并在脚本顶部为Icertis基础URL、API凭据和所需提取日期范围定义占位变量。
实现身份验证：创建一个用于处理Icertis API身份验证的函数。该函数使用客户端ID和密钥向Icertis令牌端点发送POST请求，以获取Bearer令牌。后续所有API请求都必须在请求头中包含此令牌。
获取合同列表：编写函数，获取指定日期范围内创建或修改的合同列表。该函数需向合同主API端点发送GET请求，例如/api/v1/contracts，并使用查询参数按日期筛选。
处理分页：对于返回对象列表的端点，Icertis API会对结果分页。脚本必须检查API响应中的nextLink或类似分页令牌，并循环读取所有页面，获取完整合同列表。
遍历并获取合同历史：针对上一步获取的每个合同ID，单独调用提供详细历史记录或审计轨迹的端点，例如/api/v1/contracts/{id}/history。该端点包含流程挖掘所需的原始事件数据。
将事件映射为活动：这是核心转换步骤。遍历每份合同的历史记录，根据条件逻辑（if/elif语句）将API返回的原始事件说明映射为事件日志所需的标准活动名称。例如，说明为“状态变更为已签署”的API事件应映射为ActivityName“合同已签署”。
整理数据结构：处理每个相关事件时，创建包含必需属性的字典：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平台报表模块导出

步骤

配置

a 查询示例 sql

使用Icertis REST API的Python脚本

步骤

配置

a 查询示例 python

准备好开始了吗？

优化Icertis合同流程，立即减少瓶颈

您的合同管理数据模板

您的合同管理数据模板

合同管理属性

合同管理活动

数据提取指南

Icertis ICI平台报表模块导出

步骤

配置

a 查询示例 sql

使用Icertis REST API的Python脚本

步骤

配置

a 查询示例 python

准备好开始了吗？

优化Icertis合同流程，立即减少瓶颈

我们重视您的隐私