您的合同管理数据模板

Agiloft

← 返回改进指南

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

您的合同管理数据模板

该模板列出了全面分析合同管理流程所需收集的核心数据属性和跟踪的关键活动，并提供了从系统中提取这些重要信息的实用指导。使用此模板准备数据，获取流程挖掘带来的深度洞察。

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

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

下载模板

合同管理属性

以下是建议纳入事件日志的数据字段，用于全面分析合同管理流程并发现隐藏洞察。

5 必需 8 建议 8 可选

	名称	说明
	合同ID ContractId	系统中管理的每份合同的唯一标识符。此ID将合同生命周期中的所有相关活动和事件关联起来。
说明合同ID是确定案例身份的关键字段，可唯一关联特定合同的所有事件和活动。事件日志中的每条记录都对应合同上的一项操作，而合同ID会将这些操作归入同一合同。在流程挖掘分析中，该属性是重建每份合同端到端旅程的基础。它可以帮助可视化流程、计算从请求到执行的周期时间，并根据单份合同的特征细分分析结果。为什么重要这是跟踪合同完整旅程所必需的关键字段。没有它，您无法分析端到端流程或计算案例级KPI。获取位置通常是Agiloft主Contracts表的主键。示例 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主合同表中的标准字段，也可能从Companies/Accounts表关联而来。示例 Acme CorporationGlobal Tech Inc.Innovate Solutions LLC
	到期日 ExpirationDate	如果合同未续签或终止，合同计划到期的日期。
说明到期日是决定合同有效期限结束时间的关键日期字段，对于管理续签、终止以及避免意外失效或自动续签至关重要。该属性是“即将到期合同与状态”仪表板和“按时完成合同操作率”KPI的基础。它支持业务主动管理合同生命周期结束事件，确保及时处理续签或终止，避免错过截止日期。为什么重要对于主动管理合同至关重要，可帮助业务避免错过续签或终止截止日期。获取位置这是Agiloft主合同表中的标准日期字段。示例 2024-12-31T00:00:00Z2025-06-30T00:00:00Z2026-01-15T00:00:00Z
	合同价值 ContractValue	合同的货币总价值。
说明该属性表示合同的总财务价值，包括收入、成本或承诺金额。该数值通常会影响审查程度和审批流程的复杂度。合同价值是“已执行合同价值与数量趋势”仪表板的关键指标，可用于分析流程绩效的财务影响。您还可以将合同价值与周期时间关联，判断高价值合同是否需要明显更长的处理时间，从而优先处理高价值合同并优化其工作流。为什么重要为流程提供财务背景，支持基于价值的分析和优先级排序，并帮助了解延误对业务的影响。获取位置这是Agiloft主合同表中的标准字段。示例 50000.00250000.0010000.00
	合同状态 ContractStatus	合同在生命周期中的当前状态。
说明该属性表示合同当前所处阶段，例如“起草中”“审核中”“已执行”“已过期”或“已终止”，用于随时了解合同所处的位置。在流程挖掘中，状态随时间的变化通常正是活动的定义依据。作为案例级属性，它可用于筛选分析范围，仅关注有效、已执行或已过期的合同，并直接支持“即将到期合同与状态”仪表板。为什么重要快速概览合同当前阶段，支持筛选和分段，以分析进行中的案例与已完成案例。获取位置这是Agiloft主合同表中的标准字段。示例草稿等待审批已签署已过期
	合同类型 ContractType	合同分类，例如主服务协议（MSA）、保密协议（NDA）或工作说明书（SOW）。
说明合同类型是用于定义协议性质和模板的关键分类字段。不同合同类型通常对应不同的流程变体，复杂程度和涉及的利益相关方也各不相同。该属性对于比较分析至关重要，也是“合同周期时间差异因素”和“谈判修订频率”仪表板的重要驱动因素。按合同类型划分流程后，分析人员可以发现某些类型处理时间更长、需要更多修订，或更频繁偏离标准流程的原因。为什么重要用于解释流程复杂度、持续时间和风险方面的显著差异，是进行有效流程分段的基础属性。获取位置这是Agiloft主合同表中的标准字段。示例主服务协议保密协议工作说明书软件许可协议
	用户名 UserName	执行活动的用户或资源名称。
说明此属性标识负责完成某个流程步骤的人员，例如起草合同的人员或执行法务审核的律师。通常取自系统审计轨迹中与某项操作关联的用户信息。按用户分析是“合同资源工作负载分析”仪表板的基础，有助于识别工作负载分布、比较个人绩效差异并发现培训机会。同时，它也有助于追溯具体操作的责任归属。为什么重要支持工作负载分析、绩效比较，以及识别特定资源的瓶颈或最佳实践。获取位置通常可以在合同历史记录或审计轨迹表中找到，并与执行变更的用户关联。示例 Alice SmithBob JohnsonCharlie Brown
	用户部门 UserDepartment	用户或合同所有者所属的业务部门。
说明此属性提供合同所属部门的上下文，例如“Sales”“Legal”“Procurement”或“Finance”。该信息可以与合同所有者或执行特定活动的用户关联。此维度对于“合同周期时间差异因素”仪表板至关重要。它支持按部门筛选和比较流程绩效，揭示某些部门是否存在更长的周期时间、更多返工或不同流程路径。例如，您可以分析来自Sales的合同是否比来自Procurement的合同需要更长时间才能完成法务审核。为什么重要支持跨业务部门比较绩效，帮助识别部门特有的流程问题或最佳实践。获取位置此信息可以从用户配置文件表关联获取，也可能直接存储在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中，通常表现为Contract表中新记录的创建，并作为明确事件记录在系统历史记录或审计日志中。
为什么重要此活动标志着流程的开始，是计算合同总体周期时间的基础。分析这一开始节点，有助于了解组织内合同需求的数量及其来源。获取位置此事件取自Agiloft中合同记录的创建时间戳。对于特定Contract ID，通常可以在History选项卡或系统日志中找到。采集使用主合同表中的记录创建时间戳。事件类型 explicit
	合同到期	此事件表示合同已达到结束日期，且未续约或提前终止。通常通过比较合同到期日期与当前日期来计算。
为什么重要这是合同生命周期的主要结束节点。分析到期情况对于防止不必要的自动续约或避免遗漏必要续约至关重要。获取位置这是一个计算得出的事件。当合同未续约或终止，且当前日期超过合同“Expiration Date”或“Contract End Date”字段中的日期时，该事件发生。采集使用“Expiration Date”字段中的值推导此事件。事件类型 calculated
	合同执行或签署完成	这是一个重要里程碑，表示所有相关方均已签署合同，合同由此具有法律约束力。通常通过电子签名平台集成明确记录，或由用户手动将状态更新为“Executed”。
为什么重要此事件标志着授予前阶段顺利结束，也是计算合同总体周期时间的终点。它会触发授予后管理阶段的开始。获取位置取自电子签名集成Webhook提供的完成时间戳，或Agiloft中手动将状态变更为“Executed”或“Signed”时的时间戳。采集使用“Date Signed”字段、执行日期，或状态变更为“Executed”时的时间戳。事件类型 explicit
	合同终止	表示有效合同在计划到期日之前提前终止。这是明确事件，通常通过将合同状态变更为“Terminated”并填写原因来记录。
为什么重要作为关键结束节点，终止分析有助于了解合同解除的原因，例如未履约或业务战略变化。这对于风险管理和了解合同相对方关系至关重要。获取位置可根据合同记录历史中状态字段变更为“Terminated”的记录推断。终止日期通常记录在专用字段中。采集使用状态变更为“Terminated”时的时间戳，或“Termination Date”字段中的值。事件类型 inferred
	合同续约	表示合同期限结束后成功续约。这是重要的业务成果，通常通过明确的用户操作记录，例如更新合同状态，或为续约期限创建新的合同版本。
为什么重要此活动是许多企业衡量成功的重要指标，代表合作关系得以延续。跟踪续约对于收入预测和分析合同留存绩效至关重要。获取位置取自状态明确变更为“Renewed”的记录，或取自创建标记为续约的新关联合同记录。Agiloft工作流可以自动完成此操作。采集使用状态变更为“Renewed”时的时间戳，或后续合同的创建日期。事件类型 explicit
	完成法务审核	表示法务部门已完成合同审核。通常在法务团队更新合同状态，例如变更为“Legal Approved”，或完成特定审批任务时记录。
为什么重要法务审核是关键且通常耗时较长的步骤。明确该活动的持续时间，有助于识别法务团队内部的瓶颈，并支持SLA遵循情况监控。获取位置可根据状态变更推断，例如从“In Legal Review”变为“Legal Approved”；也可以取自Agiloft中分配给Legal组的关联Approval记录的完成时间戳。采集使用状态变更为“Legal Approved”时的时间戳，或特定法务审批任务标记为完成时的时间戳。事件类型 inferred
	获得内部审批	此里程碑表示所有必需的内部相关方都已批准合同最终版本。通常可根据合同状态变更为“Fully Approved”或“Ready for Signature”等最终审批状态来推断。
为什么重要这是一个关键里程碑，表示内部审核结束，合同已准备执行。它是衡量合同发送签署前内部处理总时长的重要节点。获取位置可根据状态变更为“Approved”“Ready for Signature”或类似最终审批状态时的时间戳推断，也可以取最后一条必需Approval记录的完成时间戳。采集识别合同状态变更为签署前已批准状态时的时间戳。事件类型 inferred
	发起合同修订	此事件标志着针对现有有效合同正式修订流程的开始。在Agiloft中，通常表现为创建一条与原合同关联的新“Amendment”记录。
为什么重要修订是合同生命周期中的重大变化。分析修订频率及其执行流程，有助于发现业务需求变化或初始合同清晰度方面的问题。获取位置此事件取自专用“Amendments”表中新记录的创建时间戳，该记录与父级Contract ID关联。采集使用Amendments表中的记录创建时间戳。事件类型 explicit
	发送签署	此活动标志着将最终批准的合同发送给所有相关方执行。在Agiloft等集成电子签名功能的系统中，这通常是触发签署流程的明确操作。
为什么重要此事件为最终执行阶段的开始提供明确时间戳。分析从该节点到“Contract Executed”的时间，有助于识别签署流程本身的延迟。获取位置取自合同历史中记录的明确用户操作，或取自对DocuSign、Adobe Sign等电子签名服务的API调用。Agiloft支持与这些服务集成。采集使用与“Send for Signature”操作或集成调用关联的历史日志时间戳。事件类型 explicit
	合同修订或标注修改	表示合同文档在谈判或内部审核期间被修订或添加修订标记。通常在新版本合同文档上传至Agiloft时明确记录。
为什么重要此活动对于识别返工循环至关重要。高频修订可能表明条款不清晰、模板不完善或谈判分歧较大，这些因素都会延长合同周期时间。获取位置取自Agiloft中“Attached Files”或与合同记录关联的专用版本历史表中新文档版本的创建时间戳。采集使用合同文档版本历史中每条新记录的创建时间戳。事件类型 explicit
	合同取消	表示合同申请或处理中的合同在执行前被主动取消。这是明确的结束状态，通常由用户将状态变更为“Canceled”或“Withdrawn”来记录。
为什么重要这代表流程中的失败或终止路径。分析合同被取消的原因，可以发现资格评估或谈判阶段的问题，从而减少无效投入。获取位置可根据合同历史中状态字段变更为“Canceled”“Void”或“Withdrawn”等最终非成功状态时的时间戳推断。采集查找状态变更为“Canceled”时的时间戳。事件类型 inferred
	合同生效	表示合同开始生效并具有可执行性，通常发生在执行日期当天或之后。在Agiloft中，通常表现为状态从“Executed”变更为“Active”或“Live”。
为什么重要此活动正式启动授予后生命周期，并触发义务履行、监控和合规任务。它为跟踪有效合同的履行情况和管理情况提供明确起点。获取位置可根据合同历史日志中状态变更为“Active”的记录推断，或根据“Contract Start Date”字段计算。采集使用状态变更为“Active”时的时间戳，或“Effective Date”字段的值。事件类型 inferred
	完成合同起草	表示初始合同草案已经完成。通常在合同文档的第一个版本上传并与合同记录关联时记录，或在合同状态变更为“Drafting Complete”时记录。
为什么重要跟踪此活动有助于衡量起草阶段的效率。它也是分析返工的前提，因为此后的多次修订可能表明模板或初始需求存在问题。获取位置可根据状态字段变化推断，例如从“New”变为“Drafting”；也可以取自Agiloft“Attached Files”关联表中第一个文档版本附件的时间戳。采集识别首次变更为“Drafting”或“Review”状态的时间戳，或第一个关联文档记录的创建日期。事件类型 inferred
	完成合规审核	表示已完成针对有效合同安排的定期或临时合规审核。通常在用户完成合规相关任务或更新审核字段时作为明确事件记录。
为什么重要跟踪合规审核对于治理和风险管理至关重要。此活动有助于组织确保在合同整个生命周期内满足监管要求和内部政策要求。获取位置取自合规审核关联任务记录的完成时间戳，或取自“Last Compliance Review Date”等日期字段被填充时的记录。采集使用专用合规任务的完成日期，或审核完成后更新的特定日期字段。事件类型 explicit
	开始与合同相对方谈判	此活动表示合同发送给外部合同相对方进行审核和谈判的时点。在Agiloft中，可以根据状态变更为“In Negotiation”或“External Review”来推断。
为什么重要这标志着谈判阶段的开始。谈判阶段可能变化很大且难以预测。跟踪此活动有助于衡量和分析谈判周期，并识别导致该阶段延长的因素。获取位置可根据合同记录历史中状态字段更新为“In Negotiation”“With Counterparty”或“External Review”时的时间戳推断。采集识别表示外部沟通或谈判的状态变更首次发生时的时间戳。事件类型 inferred
	提交内部审核	此活动标志着合同草案正式发送给内部相关方审核。通常通过Agiloft工作流中的状态变更记录，例如从“Draft”变为“Internal Review”。
为什么重要此事件启动审核阶段，而审核阶段往往是瓶颈的来源。分析该事件与后续审核活动之间的时间，对于了解和缩短审核周期至关重要。获取位置可根据主合同记录中状态字段变更为“In Review”“Pending Internal Review”或“Submitted for Review”等值时的时间戳推断。采集在合同历史日志中查找变更为“Internal Review”状态的记录。事件类型 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中进入Contract Management知识库，确认其准确的API名称。该名称通常与显示名称不同。管理员可以提供相关信息。本指南假设名称为contract。
配置Python脚本：在编辑器中打开提供的Python脚本。将BASE_URL、USERNAME、PASSWORD、API_KEY和KB_NAME的占位值替换为您的Agiloft信息。
设置提取日期范围：在脚本配置部分调整SEARCH_FILTER变量，定义提取日期范围。该筛选器通常针对'Date Created'或'Last Modified'字段，以限制数据量。
执行脚本：在终端中使用以下命令运行脚本：python your_script_name.py。脚本将通过Agiloft API完成身份验证，分页获取合同记录，并处理每份合同的历史记录。
处理历史数据：脚本遍历每份合同的历史日志，将状态变更或记录创建等特定历史事件映射为事件日志所需的标准ActivityName值。
处理计算事件：脚本包含生成'Contract Expired'活动的逻辑。执行时，它会将有效合同的到期日期与当前日期进行比较。
转换并整理数据：脚本使用pandas库将提取的事件整理为表格格式，确保包含所有必需和推荐的列。
生成事件日志文件：脚本成功执行后，会在同一目录下生成名为agiloft_contract_event_log.csv的CSV文件。该文件已按格式整理，可直接上传到ProcessMind。

配置

API凭据：USERNAME、PASSWORD和API_KEY必须对应一个拥有足够权限、可通过REST API读取合同数据的用户账户。
基础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配置。

a 示例查询 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脚本提取

步骤

配置

a 示例查询 python

准备好开始了吗？

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

我们重视您的隐私