您的合同管理数据模板

Agiloft

← 返回改进指南

合同管理属性(21) 合同管理活动(16) 数据提取指南(1)

您的合同管理数据模板

此模板列出了全面分析合同管理流程所需采集的核心数据属性和跟踪的关键活动，并提供从系统中提取这些信息的实用指南。使用此模板准备数据，开展流程挖掘分析。

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

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

下载模板

合同管理属性

以下是建议纳入事件日志的数据字段，可用于全面分析并发现合同管理流程中不易察觉的问题。

5 必填 8 建议填写 8 选填

	名称	说明
	合同ID ContractId	系统中每份合同的唯一标识符。此ID将合同整个生命周期内相关的所有活动和事件关联起来。
说明合同ID是确定案例的唯一标识符，可将与特定合同相关的所有事件和活动关联起来。事件日志中的每条记录都对应一项合同操作，此ID用于将这些操作归为一组。在流程挖掘分析中，此属性是还原每份合同端到端历程的基础。它支持流程顺序流可视化、计算从请求到签署的周期时间，并根据单份合同的特征细分分析。重要性这是跟踪合同完整历程所必需的关键字段。没有它，就无法分析端到端流程或计算案例级KPI。获取途径这通常是 Agiloft 主合同表的主键。示例 CTR-2023-00123MSA-2024-00045NDA-2023-00789
	上次数据更新 LastDataUpdate	表示数据上次从源系统刷新或提取时间的时间戳。
说明此属性提供最近一次数据提取的时间戳，有助于了解所分析数据的新鲜度并管理数据刷新计划。用户可通过此时间戳确认查看的是最新信息，并了解分析涵盖的时间范围。它是可靠数据分析的重要元数据。重要性让用户了解数据的时效性，这对于及时、准确地制定业务决策至关重要。获取途径此时间戳在数据提取、转换和加载（ETL）过程中生成并添加。示例 2024-05-20T08:00:00Z
	开始时间 EventTime	表示特定活动或事件开始时间的时间戳。
说明此属性提供合同历史记录中每项活动的日期和时间，确定事件的先后顺序，这对流程发现和分析至关重要。开始时间用于计算活动间隔时长、识别瓶颈和衡量周期时间。几乎所有基于时间的KPI都以此为基础，例如“平均合同周期时间”和“平均审批阶段时长”。重要性此时间戳对于排列事件、计算时长和分析流程随时间的表现至关重要。没有它就无法进行流程挖掘。获取途径对应于 Agiloft 合同历史记录或审计跟踪表中所记录操作的时间戳。示例 2023-10-26T10:00:00Z2023-10-27T14:35:10Z2023-11-05T09:15:00Z
	活动名称 ActivityName	合同生命周期某一时点发生的具体业务活动或事件名称。
说明此属性描述流程中执行的步骤，例如“合同已起草”“已进行法律审查”或“合同已执行/签署”。这些活动构成流程图的基本要素。分析活动的顺序和频率，有助于识别主要流程、发现偏差或返工环节，并找出最常见或最耗时的步骤。这对于构建“合同生命周期总览”和“合同起草流程变体”等仪表板至关重要。重要性活动定义了流程图中的各个步骤。此属性是可视化流程顺序流、了解实际工作内容的必要条件。获取途径根据 Agiloft 合同历史记录或审计跟踪表中记录的操作或状态变更推导。示例完成合同起草完成法务审核发送签署合同已签署
	源系统 SourceSystem	提取数据的记录系统。
说明此属性标识合同管理数据的来源。对于此流程，该值始终为“Agiloft”。在整合多个系统数据的企业级分析中，此字段对于追踪数据来源和确保分析范围准确至关重要，也能提供数据背景和可追溯性。重要性标识数据来源，对于数据治理、故障排查和整合多个来源的数据至关重要。获取途径这是一个静态值，应在数据提取和转换过程中添加。示例 Agiloft
	交易对方名称 CounterpartyName	参与合同的外部方、客户、供应商或合作伙伴的名称。
说明此属性标识签署合同的另一方组织或个人。交易对方会显著影响谈判流程、时间安排和协议条款。按交易对方分析流程表现，是“合同周期时间差异因素”和“谈判修订频率”仪表板的重要目标。此分析有助于识别哪些合作方会导致谈判时间更长或修订更多，从而制定有针对性的谈判策略并改善合作关系管理。重要性帮助识别不同外部合作方对合同谈判时间和复杂程度的影响，从而改进预测和策略。获取途径这是 Agiloft 主合同表中的标准字段，也可从关联的公司/账户表获取。示例 Acme CorporationGlobal Tech Inc.Innovate Solutions LLC
	到期日期 ExpirationDate	合同未续签或终止时的预定到期日期。
说明到期日期是关键日期字段，决定合同有效期限的结束时间。它对于管理续签和终止、避免合同意外失效或自动续签至关重要。此属性是“即将到期的合同与状态”仪表板及“合同按时处理率”KPI的核心。企业可据此主动管理合同生命周期结束相关事项，确保及时办理续签或终止，避免错过期限。重要性对于主动管理合同至关重要，可帮助企业避免错过续签或终止期限。获取途径这是 Agiloft 主合同表中的标准日期字段。示例 2024-12-31T00:00:00Z2025-06-30T00:00:00Z2026-01-15T00:00:00Z
	合同状态 ContractStatus	合同在生命周期中的当前状态。
说明此属性表示合同当前所处阶段，例如“起草中”“审查中”“已执行”“已到期”或“已终止”，可反映合同在任一时点的状态。在流程挖掘中，状态随时间的变化通常用于定义活动。作为案例级属性，它可用于筛选分析范围，例如只查看有效、已执行或已到期的合同。它直接支持“即将到期的合同与状态”仪表板。重要性快速呈现合同当前阶段，支持筛选和细分分析，以区分处理中与已完成的案例。获取途径这是 Agiloft 主合同表中的标准字段。示例草稿等待批准已执行已到期
	合同类型 ContractType	合同的分类，例如主服务协议（MSA）、保密协议（NDA）或工作说明书（SOW）。
说明合同类型是关键分类字段，用于确定协议的性质和所用模板。不同类型的合同通常对应不同的流程变体，复杂程度和参与方也各不相同。此属性对于比较分析至关重要，也是“合同周期时间差异因素”和“谈判修订频率”仪表板的重要分析维度。按合同类型细分流程，分析人员可以发现某些类型的合同为何耗时更长、需要更多修订，或更常偏离标准流程。重要性有助于解释流程复杂度、时长和风险的显著差异，是有效细分流程的基础属性。获取途径这是 Agiloft 主合同表中的标准字段。示例主服务协议保密协议工作说明书软件许可协议
	合同金额 ContractValue	合同的总金额。
说明此属性表示合同的总财务价值，可以是收入、成本或承诺金额。该金额通常会影响审查力度和审批流程的复杂程度。合同金额对于“已执行合同金额与数量趋势”仪表板至关重要，可用于分析流程表现的财务影响。还可将合同金额与周期时间关联分析，了解高金额合同是否需要更长处理时间，从而优先处理高金额合同并优化相关工作流。重要性为流程分析提供财务背景，支持按价值分析和确定优先级，并帮助了解延误对业务的影响。获取途径这是 Agiloft 主合同表中的标准字段。示例 50000.00250000.0010000.00
	用户名 UserName	执行活动的用户或资源名称。
说明此属性标识负责完成某个流程步骤的人员，例如起草合同的人或进行法律审查的律师。通常从系统审计跟踪中与操作关联的用户信息获取。按用户分析对于“合同资源工作量分析”仪表板至关重要，有助于识别工作量分布、个人表现差异和培训机会，也能追溯具体操作的责任归属。重要性支持工作量分析、绩效比较，并帮助识别特定资源相关的瓶颈或最佳实践。获取途径通常可在合同历史记录或审计跟踪表中找到，并关联到执行变更的用户。示例 Alice SmithBob JohnsonCharlie Brown
	用户部门 UserDepartment	用户或合同所有者所属的业务部门。
说明此属性提供合同相关的部门背景，例如“销售”“法律”“采购”或“财务”。该信息可关联到合同所有者或执行特定活动的用户。此维度对于“合同周期时间差异因素”仪表板至关重要。它支持按部门筛选和比较流程表现，从而发现某些部门的周期时间是否更长、返工是否更多，或流程路径是否不同。例如，您可以分析销售部门发起的合同是否比采购部门发起的合同需要更长时间才能完成法律审查。重要性支持跨业务单元比较表现，帮助识别部门特有的流程问题或最佳实践。获取途径此信息可从用户资料表关联获取，也可能直接存储在 Agiloft 合同记录中。示例销售法律采购财务
	结束时间 EventEndTime	表示特定活动或事件完成时间的时间戳。
说明开始时间表示活动何时开始，结束时间则标记活动完成的时刻。两者之差即为该活动的处理时间。在流程挖掘中，同时具备开始时间和结束时间，可以更细致地分析资源利用情况，以及等待时间与实际工作时间的差异。例如，可以区分法律审查实际处理的时间和在队列中等待的时间，为“法律审查处理时间”KPI提供依据。重要性用于计算活动的实际处理时间，将实际工作时间与等待时间区分开来，从而更准确地分析瓶颈。获取途径某些系统可直接提供此字段；很多情况下，可将其推断为案例中下一项活动的开始时间。在 Agiloft 中，可能需要根据审计跟踪记录推导。示例 2023-10-26T18:30:00Z2023-10-27T15:05:45Z2023-11-05T11:00:00Z
	修订次数 RevisionCount	合同生命周期内修订或添加修订标记的次数。
说明此属性跟踪合同经历的迭代次数，尤其是在起草和谈判阶段。修订次数较多通常意味着模板存在问题、谈判复杂，或初始需求不明确。此指标直接支持“谈判修订频率”仪表板和“合同修订频率”KPI。分析修订次数有助于识别哪些合同类型或交易对方导致反复修改，从而为简化起草和谈判流程提供依据。重要性量化返工情况和谈判复杂度，帮助发现提升模板质量和改进谈判策略的机会。获取途径通常通过统计事件日志中每个合同ID对应的“合同已标记修订/已修订”活动次数得出。示例 1350
	合同模板名称 ContractTemplateName	用于生成合同初稿的模板名称。
说明此属性指定起草合同的起点是否使用了标准模板，以及使用了哪个模板。统一使用模板是提高起草效率的关键。分析此属性有助于衡量“合同起草返工率”和“首次内部审批通过率”KPI。比较使用不同模板或未使用模板的合同表现，组织可以识别哪些模板最有效，以及哪些环节最需要推进标准化。重要性有助于评估标准模板的效果并推动标准化，从而显著减少起草时间和返工。获取途径这可能是Agiloft合同记录中的一个字段，在根据模板创建合同时自动填充。示例标准MSA v2.1NDA - 双向保密SOW - 固定价格 v1.3自定义
	审批阶段时长 ApprovalPhaseDuration	从首次发起审批到获得审批结果所用的计算时长。
说明此指标衡量合同完成所有必要的内部和法务审批所需的时间。通常从首次审核活动开始时计时（例如“已提交内部审核”），到获得最后一项必要审批时结束。此属性是“平均审批阶段时长”KPI的计算依据，也是“审核与审批瓶颈分析”仪表板的重要组成部分。它将合同生命周期中的关键阶段单独呈现，帮助您重点分析审核和审批延迟的原因。重要性单独衡量审批阶段所用时间，帮助您找出并解决这一关键阶段的瓶颈。获取途径从事件日志中逐份合同计算首次审批活动开始与最后一项审批活动结束之间的时间差。示例 5天2小时12天6小时2天1小时
	审查SLA截止日期 ReviewSlaDueDate	合同审查步骤（如法律审查或内部审查）必须完成的目标日期。
说明此属性定义特定审查活动的服务级别协议（SLA）截止日期，明确规定周转时间预期，并用于衡量实际表现是否达到内部目标。此日期对于“合同审查SLA达标情况”仪表板及相关的“审查SLA达标率”KPI至关重要。通过比较审查活动的实际完成时间与截止日期，系统可以判断流程是否达到服务级别目标，并指出SLA经常未达标的环节。重要性支持衡量实际表现是否达到内部期限，对于落实SLA要求和缩短审查周转时间至关重要。获取途径此字段可能由 Agiloft 根据合同提交日期和预设SLA规则计算得出，也可能是手动设置的日期字段。示例 2023-10-29T17:00:00Z2023-11-01T17:00:00Z2023-11-10T17:00:00Z
	是否满足审核SLA IsReviewSlaMet	一个计算得出的布尔标记，用于指示合同审核是否在规定的服务级别协议（SLA）期限内完成。
说明此属性通过比较审核活动（例如“已完成内部审核”）的实际完成时间戳与“ReviewSlaDueDate”得出。审核按时完成时值为“true”，逾期时值为“false”。此标记直接用于“合同审核SLA达成情况”仪表板，便于直观查看合规率。只需统计true和false的数量，即可简化“审核SLA达成率”KPI的计算。重要性以明确的二元结果呈现SLA达成情况，便于衡量、可视化并报告内部期限的合规情况。获取途径逐份合同比较审核完成活动的“EventTime”与“ReviewSlaDueDate”计算得出。示例 truefalse
	是否自动执行 IsAutomated	一个布尔标记，用于指示活动是由系统自动执行，还是由用户手动完成。
说明此属性用于区分人工执行的活动和系统执行的活动，例如自动更新状态、发送通知或由系统触发的工作流。在分析中，这有助于了解合同管理流程的自动化程度、衡量自动化举措的影响、发现进一步自动化的机会，并确保自动化步骤按预期运行且不会造成瓶颈。重要性帮助衡量流程的自动化程度，并识别哪些步骤由系统执行、哪些由人工完成。获取途径可通过活动历史记录中的特定系统用户账户（如“System”“Admin”）识别，也可通过标记特定自动化活动类型推导。示例 truefalse
	法律审查人 LegalReviewer	法律部门中负责审查合同的具体人员或团队名称。
说明此属性标识负责执行“已进行法律审查”活动的具体法律人员。与可能包含多种角色的通用“用户”字段相比，它能更细致地呈现工作量。此属性有助于通过“合同资源工作量分析”仪表板重点分析法律团队的工作能力和表现，了解团队内部的工作量是否均衡，以及特定审查人员是否对应更长的审查时间，并支持“平均法律审查处理时间”KPI。重要性支持针对法律审查职能开展详细的工作量和绩效分析，帮助有效管理法律团队资源。获取途径这可以是合同中指定法律顾问的专用字段，也可以根据与法律审查活动关联的用户名推导。示例 Jane Doe法律团队AJohn Smith
	谈判阶段时长 NegotiationPhaseDuration	计算得出的合同相对方谈判阶段时长。
说明此指标衡量与外部合作方开始谈判（例如“已开始与合同相对方谈判”）到达成最终协议并获得对方批准所需的时间。这是“谈判阶段周期时间”仪表板和“平均谈判阶段时长”KPI的核心指标。分析这一时长有助于了解谈判流程的效率，识别导致谈判时间过长的合同类型或合作方，并发现简化沟通的机会。重要性衡量谈判阶段的效率，为缩短与外部合作方沟通所需的时间提供参考。获取途径从事件日志中计算“已开始与合同相对方谈判”到“已收到合同相对方批准”等结束活动之间的时间。示例 7天15天3天

必填建议填写选填

合同管理活动

以下是建议记录在事件日志中的关键流程步骤和里程碑，可用于准确发现流程并识别瓶颈。

7 建议填写 9 选填

	活动	说明
	发起合同申请	这是合同生命周期中的首个事件，表示正式提出新合同申请。在Agiloft中，通常记录为合同表中新建一条记录，并明确保存在系统历史记录或审计日志中。
重要性此活动标志着流程开始，是计算合同整体周期时间的关键。分析这一起点有助于了解组织内合同需求的数量和来源。获取途径此事件取自Agiloft中合同记录的创建时间戳。通常可在特定合同ID对应的历史记录选项卡或系统日志中找到。采集使用主合同表中的记录创建时间戳。事件类型 explicit
	取得内部审批	此里程碑表示所有必需的内部相关人员均已批准合同最终版本。通常可根据合同状态变更为“全部批准”或“待签署”等最终审批状态推断。
重要性这是一个关键里程碑，标志着内部审核结束，合同已可进入签署阶段。它也是衡量合同发送签署前内部总处理时间的重要节点。获取途径可根据状态变更为“已批准”“待签署”或类似最终审批状态时的时间戳推断，也可根据最后一条必需审批记录的完成时间戳得出。采集查找合同状态变更为签署前已批准状态时的时间戳。事件类型 inferred
	合同已到期	此事件表示合同已到期，且未续签或提前终止。通常通过比较合同到期日期与当前日期来计算。
重要性这是合同生命周期的主要终点之一。分析合同到期情况，对于避免意外自动续签或确保及时办理续签至关重要。获取途径这是一个计算得出的事件。当当前日期晚于合同的“到期日期”或“合同结束日期”字段，且合同未续签或终止时，即发生此事件。采集使用“到期日期”字段的值推导此事件。事件类型 calculated
	合同已签署	这是一个重要里程碑，表示各方已签署合同，合同由此具有法律约束力。通常通过与电子签名平台集成明确记录此事件，也可以由用户手动将状态更新为“已执行”。
重要性此事件标志着授予前阶段顺利结束，也是计算合同总周期时间的终点，同时开启授予后管理阶段。获取途径可从电子签名集成 webhook 提供的完成时间戳获取，也可使用在 Agiloft 中手动将状态改为“已执行”或“已签署”的时间戳。采集使用“签署日期”字段、执行日期，或状态改为“已执行”时的时间戳。事件类型 explicit
	合同已终止	表示有效合同在计划到期日之前提前终止。这是一个明确记录的事件，通常通过将合同状态改为“已终止”并填写原因来记录。
重要性终止分析有助于了解合同解除的原因，例如未履约或业务策略变化。它对于风险管理和了解交易对方关系至关重要。获取途径可根据合同记录历史中状态字段变为“已终止”的记录推断。终止日期通常记录在专用字段中。采集使用状态变为“已终止”时的时间戳，或“终止日期”字段的值。事件类型 inferred
	合同已续签	表示合同期限届满后成功续签。这是重要的业务成果，通常通过用户明确更新合同状态，或为续签期限创建新合同版本来记录。
重要性续签是许多企业衡量成功的关键指标，代表合作关系得以延续。跟踪续签对于收入预测和合同留存表现分析至关重要。获取途径可根据状态明确变为“已续签”的记录获取，也可根据新建且标记为续签的关联合同记录获取。Agiloft 工作流可以自动完成此操作。采集使用状态变为“已续签”时的时间戳，或后续合同的创建日期。事件类型 explicit
	完成法务审核	表示法务部门已完成合同审核。通常在法务团队更新合同状态（例如改为“法务已批准”）或完成特定审批任务时记录。
重要性法务审核是关键且通常耗时较长的步骤。准确了解此活动的耗时，有助于发现法务团队内部的瓶颈，并支持SLA达成情况监控。获取途径可根据状态变更推断（例如从“法务审核中”变为“法务已批准”），也可从Agiloft中分配给法务组的关联审批记录完成时间获取。采集使用状态变更为“法务已批准”时的时间戳，或特定法务审批任务标记为完成时的时间戳。事件类型 inferred
	修订合同并添加红线	表示合同在谈判或内部审核期间经过修订或添加红线。通常在新版本合同文件上传至Agiloft时明确记录。
重要性此活动对于识别返工循环至关重要。频繁修订可能表明条款不清、模板不佳或谈判存在争议，这些情况都会延长合同周期时间。获取途径可从Agiloft中“附件文件”或与合同记录关联的专用版本历史表中新文档版本的创建时间戳获取。采集使用合同文档版本历史中每条新记录的创建时间戳。事件类型 explicit
	发送签署	此活动标志着已将最终批准的合同发送给各方签署。在Agiloft这类集成电子签名功能的系统中，通常会明确记录触发签署流程的操作。
重要性此事件提供了最终签署阶段的明确起始时间。分析从此时到“合同已签署”的耗时，有助于发现签署流程本身的延误。获取途径可从合同历史记录中的明确用户操作获取，也可通过调用Agiloft集成的DocuSign或Adobe Sign等电子签名服务的API记录。采集使用与“发送签署”操作或集成调用相关的历史记录时间戳。事件类型 explicit
	合同已取消	表示合同请求或处理中合同在执行前被主动取消。这是一个明确的终止状态，通常由用户将状态改为“已取消”或“已撤回”来记录。
重要性这表示流程失败或终止。分析合同取消原因，有助于发现资格评估或谈判阶段的问题，减少无效投入。获取途径可根据合同历史记录中状态字段变为“已取消”“作废”或“已撤回”等非成功终止值时的时间戳推断。采集查找状态变为“已取消”时的时间戳。事件类型 inferred
	合同已激活	表示合同已生效并可执行，通常发生在执行日期当天或之后。在 Agiloft 中，这通常记录为状态从“已执行”变为“活跃”或“生效”。
重要性此活动正式开启授予后生命周期，并触发义务履行、监控和合规任务。它为跟踪有效合同的履行情况和管理工作提供了明确起点。获取途径可根据合同历史记录中状态变为“活跃”的记录推断，也可依据“合同开始日期”字段计算。采集使用状态变为“活跃”时的时间戳，或“生效日期”字段的值。事件类型 inferred
	完成合同起草	表示合同初稿已完成。通常在合同文件的首个版本上传并关联至合同记录时记录，也可能在合同状态变更为“起草完成”时记录。
重要性跟踪此活动有助于衡量起草阶段的效率。这也是分析返工的前提，因为此后多次修订可能表明模板或初始要求存在问题。获取途径可根据状态字段变更推断（例如从“新建”变为“起草中”），也可从Agiloft“附件文件”关联表中首个文档版本附件的时间戳获取。采集查找状态首次变更为“起草中”或“审核”的时间戳，或首条关联文档记录的创建日期。事件类型 inferred
	已启动合同修订	此事件标志着对现有有效合同正式启动修订流程。在 Agiloft 中，通常通过创建与原合同关联的新“修订”记录来记录。
重要性合同修订会显著影响合同生命周期。分析修订频率及其执行流程，有助于了解业务需求的变化，或发现合同初始内容是否清晰。获取途径此事件可从专用“修订”表中新记录的创建时间戳获取，该记录需关联到父级合同ID。采集使用“修订”表中的记录创建时间戳。事件类型 explicit
	已完成合规审查	表示已完成对有效合同进行的定期或临时合规审查。通常在用户完成合规相关任务或更新审查字段时，明确记录此事件。
重要性跟踪合规审查对治理和风险管理至关重要。此活动有助于组织确保合同在整个生命周期内符合监管要求和内部政策。获取途径可从关联合规审查任务记录的完成时间戳获取，也可使用“上次合规审查日期”等日期字段的填写时间。采集使用专门合规任务的完成日期，或审查完成后更新的特定日期字段。事件类型 explicit
	开始与合同对方谈判	此活动表示合同已发送给外部合同对方进行审核和谈判。在Agiloft中，可根据状态变更为“谈判中”或“外部审核”推断。
重要性此活动标志着谈判阶段开始。谈判阶段的时长可能差异很大，难以预测。跟踪此活动有助于衡量和分析谈判周期时间，并找出延长该阶段的因素。获取途径可根据合同记录历史中状态字段更新为“谈判中”“由合同对方处理”或“外部审核”时的时间戳推断。采集查找首次表明已与外部沟通或开始谈判的状态变更时间戳。事件类型 inferred
	提交内部审核	此活动标志着合同草案正式提交给内部相关人员审核。在Agiloft中，通常通过工作流状态变更记录，例如从“草稿”变为“内部审核”。
重要性此事件启动审核阶段，而审核阶段往往容易形成瓶颈。分析此事件与后续审核活动之间的耗时，是了解并缩短审核周期时间的关键。获取途径可根据主合同记录中状态字段变更为“审核中”“等待内部审核”或“已提交审核”等值的时间戳推断。采集在合同历史记录中查找状态变更为“内部审核”的记录。事件类型 inferred

建议填写选填

数据提取指南

如何从Agiloft提取数据

步骤

准备Python环境：确保已安装Python 3.6或更新版本。使用pip安装所需库：pip install requests pandas。
获取Agiloft凭据：登录Agiloft实例。您需要API基础URL（例如https://[your_domain].agiloft.com/gui2/rest）、有效的用户名和密码，以及API密钥。请联系Agiloft管理员获取API密钥，并确认您的用户角色拥有API访问权限。
确认知识库名称：在Agiloft中打开合同管理知识库，确认其准确的API名称。该名称通常与显示名称不同，管理员可以提供相关信息。本指南假设名称为contract。
配置Python脚本：在编辑器中打开提供的Python脚本，将BASE_URL、USERNAME、PASSWORD、API_KEY和KB_NAME的占位值替换为您的Agiloft信息。
设置数据提取日期范围：在脚本的配置部分调整SEARCH_FILTER变量，设定提取日期范围。此筛选条件通常针对“创建日期”或“最后修改日期”字段，以控制数据量。
运行脚本：在终端中使用命令python your_script_name.py运行脚本。脚本将通过Agiloft API进行身份验证，分页获取合同记录，并处理每份合同的历史数据。
处理历史数据：脚本会遍历每份合同的历史记录，并将状态变更、记录创建等特定历史事件映射为事件日志所需的标准ActivityName值。
处理计算得出的事件：脚本包含推导“合同已过期”活动的逻辑，会根据脚本运行时的当前日期，检查活跃合同的到期日期。
转换并整理数据：脚本使用pandas库将提取的事件整理为表格格式，并确保包含所有必需和建议的列。
生成事件日志文件：脚本成功运行后，会在同一目录下生成名为agiloft_contract_event_log.csv的CSV文件。该文件可直接上传至ProcessMind。

配置

API凭据：必须提供具有足够权限、可通过REST API读取合同数据的用户账户的USERNAME、PASSWORD和API_KEY。
基础URL：BASE_URL必须指向您Agiloft实例的REST端点。
知识库名称：KB_NAME变量必须设置为Agiloft中合同表对应的准确API名称。
日期范围筛选：应配置脚本中的SEARCH_FILTER，将提取范围限制在相关时间段内（例如过去6至12个月），以控制性能。通常按date_created或last_modified_date筛选。
分页：PAGE_SIZE变量用于控制每次API调用获取的记录数。通常设置为100至500，可兼顾性能和内存使用。
字段映射：脚本包含将Agiloft字段名映射到事件日志所需属性名称的部分。您必须检查并调整这些映射（例如id、contract_type、contract_value），使其符合Agiloft配置。

查询示例 python

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

class=class="hl-string">"hl-comment"># --- CONFIGURATION --- #
class=class="hl-string">"hl-comment"># Replace with your Agiloft instance details
BASE_URL = class="hl-string">"https://[your_domain].agiloft.com/gui2/rest"
USERNAME = class="hl-string">"[your_api_user]"
PASSWORD = class="hl-string">"[your_api_password]"
API_KEY = class="hl-string">"[your_api_key]"
KB_NAME = class="hl-string">"contract"  class=class="hl-string">"hl-comment"># The API name of your contracts knowledgebase
PAGE_SIZE = 200

class=class="hl-string">"hl-comment"># Filter for contracts created in a specific range (adjust as needed)
class=class="hl-string">"hl-comment"># Format for Agiloft API dates is class="hl-string">'YYYY-MM-DD HH:MM:SS'
SEARCH_FILTER = {
    class="hl-string">"search_stype": class="hl-string">"field_based",
    class="hl-string">"searches": [
        {class="hl-string">"field": class="hl-string">"date_created", class="hl-string">"op": class="hl-string">"ge", class="hl-string">"val": class="hl-string">"2023-01-01 00:00:00"}
    ]
}

class=class="hl-string">"hl-comment"># --- SCRIPT --- #

def get_agiloft_session(base_url, username, password, api_key):
    class="hl-string">"""Authenticates with Agiloft and returns a session token."""
    login_url = fclass="hl-string">"{base_url}/login"
    headers = {class="hl-string">"Content-Type": class="hl-string">"application/json", class="hl-string">"API-Key": api_key}
    payload = {class="hl-string">"username": username, class="hl-string">"password": password}
    try:
        response = requests.post(login_url, headers=headers, json=payload, timeout=60)
        response.raise_for_status()
        return response.cookies
    except requests.exceptions.RequestException as e:
        print(fclass="hl-string">"Error: Authentication failed. {e}")
        return None

def fetch_all_records(session, base_url, kb_name, page_size, search_filter):
    class="hl-string">"""Fetches all records from a knowledgebase with pagination."""
    records = []
    page_num = 0
    while True:
        url = fclass="hl-string">"{base_url}/kb/{kb_name}"
        params = {
            class="hl-string">"page_size": page_size,
            class="hl-string">"page_num": page_num,
            class="hl-string">"view_name": class="hl-string">"Default",
            class="hl-string">"search": json.dumps(search_filter),
            class="hl-string">"fields": class="hl-string">"id,history,contract_status,contract_type,contract_value,created_by,owner_group,counterparty,expiration_date"
        }
        try:
            response = requests.get(url, cookies=session, params=params, timeout=120)
            response.raise_for_status()
            data = response.json()
            records.extend(data.get(class="hl-string">'records', []))
            if len(data.get(class="hl-string">'records', [])) < page_size:
                break
            page_num += 1
        except requests.exceptions.RequestException as e:
            print(fclass="hl-string">"Error fetching page {page_num}: {e}")
            break
    return records

def map_history_to_activity(entry_text):
    class="hl-string">"""Maps a history log entry to a defined activity name."""
    entry_lower = entry_text.lower()
    if class="hl-string">"record created by" in entry_lower:
        return class="hl-string">"Contract Request Initiated"
    if class="hl-string">"status changed from" in entry_lower:
        if class="hl-string">"draft" in entry_lower and class="hl-string">"internal review" in entry_lower:
            return class="hl-string">"Internal Review Submitted"
        if class="hl-string">"internal review" in entry_lower and class="hl-string">"legal approved" in entry_lower:
            return class="hl-string">"Legal Review Conducted"
        if class="hl-string">"drafting" in entry_lower and class="hl-string">"in negotiation" in entry_lower:
            return class="hl-string">"Counterparty Negotiation Started"
        if class="hl-string">"negotiation" in entry_lower and class="hl-string">"fully approved" in entry_lower:
            return class="hl-string">"Internal Approvals Obtained"
        if class="hl-string">"approved" in entry_lower and class="hl-string">"sent for signature" in entry_lower:
            return class="hl-string">"Sent For Signature"
        if class="hl-string">"signature" in entry_lower and class="hl-string">"executed" in entry_lower:
            return class="hl-string">"Contract Executed/Signed"
        if class="hl-string">"executed" in entry_lower and class="hl-string">"active" in entry_lower:
            return class="hl-string">"Contract Activated"
        if class="hl-string">"active" in entry_lower and class="hl-string">"renewed" in entry_lower:
            return class="hl-string">"Contract Renewed"
        if class="hl-string">"active" in entry_lower and class="hl-string">"terminated" in entry_lower:
            return class="hl-string">"Contract Terminated"
        if class="hl-string">"canceled" in entry_lower or class="hl-string">"withdrawn" in entry_lower:
            return class="hl-string">"Contract Canceled"
        if class="hl-string">"active" in entry_lower and class="hl-string">"amending" in entry_lower:
            return class="hl-string">"Amendment Initiated"
        if class="hl-string">"active" in entry_lower and class="hl-string">"compliance review" in entry_lower:
            return class="hl-string">"Compliance Review Performed"
    if class="hl-string">"a new file was attached" in entry_lower:
        return class="hl-string">"Contract Redlined/Revised"
    if class="hl-string">"status changed to 'drafting complete'" in entry_lower:
        return class="hl-string">"Contract Drafted"
    return None


def main():
    print(class="hl-string">"Starting Agiloft data extraction...")
    session = get_agiloft_session(BASE_URL, USERNAME, PASSWORD, API_KEY)
    if not session:
        return

    print(fclass="hl-string">"Fetching records from '{KB_NAME}' knowledgebase...")
    contracts = fetch_all_records(session, BASE_URL, KB_NAME, PAGE_SIZE, SEARCH_FILTER)
    print(fclass="hl-string">"Found {len(contracts)} contract records.")

    if not contracts:
        print(class="hl-string">"No contracts found for the specified criteria.")
        return

    event_log_rows = []
    last_data_update = datetime.now().strftime(class="hl-string">'%Y-%m-%d %H:%M:%S')

    for contract in contracts:
        contract_id = contract.get(class="hl-string">'id')
        history_raw = contract.get(class="hl-string">'history', class="hl-string">'')

        class=class="hl-string">"hl-comment"># Process history entries
        if history_raw:
            history_entries = history_raw.split(class="hl-string">'\n')
            for entry in history_entries:
                if not entry.strip():
                    continue
                
                activity_name = map_history_to_activity(entry)
                if activity_name:
                    try:
                        class=class="hl-string">"hl-comment"># Agiloft history format: class="hl-string">'YYYY-MM-DD HH:MM:SS [User Name]: Event Description'
                        timestamp_str = entry.split(class="hl-string">' [')[0]
                        event_time = datetime.strptime(timestamp_str, class="hl-string">'%Y-%m-%d %H:%M:%S').isoformat() + class="hl-string">'Z'
                        user_name = entry.split(class="hl-string">'[')[1].split(class="hl-string">']')[0]
                    except (IndexError, ValueError):
                        event_time = None
                        user_name = class="hl-string">'System'

                    event_log_rows.append({
                        class="hl-string">"ContractId": contract_id,
                        class="hl-string">"ActivityName": activity_name,
                        class="hl-string">"EventTime": event_time,
                        class="hl-string">"UserName": user_name,
                        class="hl-string">"UserDepartment": contract.get(class="hl-string">'owner_group'),
                        class="hl-string">"ContractType": contract.get(class="hl-string">'contract_type'),
                        class="hl-string">"ContractValue": contract.get(class="hl-string">'contract_value'),
                        class="hl-string">"ContractStatus": contract.get(class="hl-string">'contract_status'),
                        class="hl-string">"CounterpartyName": contract.get(class="hl-string">'counterparty'),
                        class="hl-string">"ExpirationDate": contract.get(class="hl-string">'expiration_date'),
                        class="hl-string">"EventEndTime": None,  class=class="hl-string">"hl-comment"># Populate if available
                        class="hl-string">"SourceSystem": class="hl-string">"Agiloft",
                        class="hl-string">"LastDataUpdate": last_data_update
                    })

        class=class="hl-string">"hl-comment"># Handle calculated class="hl-string">'Contract Expired' event
        exp_date_str = contract.get(class="hl-string">'expiration_date')
        current_status = contract.get(class="hl-string">'contract_status', class="hl-string">'').lower()
        if exp_date_str and current_status not in [class="hl-string">'terminated', class="hl-string">'canceled', class="hl-string">'expired']:
            try:
                exp_date = datetime.strptime(exp_date_str, class="hl-string">'%Y-%m-%d %H:%M:%S')
                if exp_date < datetime.now():
                    event_log_rows.append({
                        class="hl-string">"ContractId": contract_id,
                        class="hl-string">"ActivityName": class="hl-string">"Contract Expired",
                        class="hl-string">"EventTime": exp_date.isoformat() + class="hl-string">'Z',
                        class="hl-string">"UserName": class="hl-string">"System",
                        class="hl-string">"UserDepartment": contract.get(class="hl-string">'owner_group'),
                        class="hl-string">"ContractType": contract.get(class="hl-string">'contract_type'),
                        class="hl-string">"ContractValue": contract.get(class="hl-string">'contract_value'),
                        class="hl-string">"ContractStatus": class="hl-string">"Expired",
                        class="hl-string">"CounterpartyName": contract.get(class="hl-string">'counterparty'),
                        class="hl-string">"ExpirationDate": contract.get(class="hl-string">'expiration_date'),
                        class="hl-string">"EventEndTime": None,
                        class="hl-string">"SourceSystem": class="hl-string">"Agiloft",
                        class="hl-string">"LastDataUpdate": last_data_update
                    })
            except ValueError:
                pass class=class="hl-string">"hl-comment"># Ignore invalid date formats

    if not event_log_rows:
        print(class="hl-string">"No process events could be generated from the contract histories.")
        return

    df = pd.DataFrame(event_log_rows)
    df = df.sort_values(by=[class="hl-string">'ContractId', class="hl-string">'EventTime']).reset_index(drop=True)
    
    class=class="hl-string">"hl-comment"># Reorder columns for clarity
    column_order = [
        class="hl-string">'ContractId', class="hl-string">'ActivityName', class="hl-string">'EventTime', class="hl-string">'EventEndTime', class="hl-string">'UserName',
        class="hl-string">'UserDepartment', class="hl-string">'ContractType', class="hl-string">'ContractValue', class="hl-string">'ContractStatus',
        class="hl-string">'CounterpartyName', class="hl-string">'ExpirationDate', class="hl-string">'SourceSystem', class="hl-string">'LastDataUpdate'
    ]
    df = df[column_order]

    output_filename = class="hl-string">'agiloft_contract_event_log.csv'
    df.to_csv(output_filename, index=False)
    print(fclass="hl-string">"Extraction complete. Event log saved to {output_filename}")

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

准备好开始了吗？

迈出优化合同生命周期的第一步。使用此模板准备数据，立即发现提升效率和合规水平的机会。

返回改进指南

下载模板

优化Agiloft合同管理，立即缩短周期时间

找出低效环节，将合同周期时间缩短30%。

开始免费试用

无需信用卡。立即开始免费试用。

您的合同管理数据模板

您的合同管理数据模板

合同管理属性

合同管理活动

数据提取指南

通过Agiloft REST API使用Python脚本提取数据

步骤

配置

查询示例 python

准备好开始了吗？

优化Agiloft合同管理，立即缩短周期时间