您的合同管理数据模板

Agiloft

← 返回改进指南

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

您的合同管理数据模板

此模板概述了为全面分析合同管理流程而需收集的核心数据属性以及需跟踪的关键活动，并提供了从系统中提取这些信息的实用指南。使用此模板准备数据，以获得强大的流程挖掘洞察。

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

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

下载模板

合同管理属性

建议在事件日志中包含这些数据字段，以便进行全面分析并挖掘合同管理流程中隐藏的见解。

5 必填 8 推荐 9 可选

	名称	描述
	合同 ID ContractId	系统中管理的每个合同的唯一标识符。此 ID 将整个合同生命周期中所有相关的活动和事件关联起来。
描述合同 ID 是核心的个案标识符 (Case Identifier)，将与特定合同相关的所有事件和活动唯一地关联起来。事件日志中的每条记录都对应于合同的一个动作，该 ID 将这些动作归组在一起。在流程挖掘分析中，此属性对于还原每份合同的端到端路径至关重要。它支持流程可视化、计算从请求到执行的周期时间，并允许根据合同特征进行细分分析。为何重要这是跟踪合同完整旅程的必备键值。没有它，就无法分析端到端流程图或计算个案级 KPI。获取方式这通常是 Agiloft 中主合同表的主键。示例 CTR-2023-00123MSA-2024-00045NDA-2023-00789
	最后数据更新 LastDataUpdate	指示 data 上次刷新或从 source system 提取的时间的 timestamp。
描述此属性提供最近一次数据提取的时间戳。它对于了解分析数据的时效性以及管理数据刷新计划至关重要。用户依靠此时间戳来确认查看的是最新信息，并了解分析涵盖的时间范围。它是任何可靠数据驱动分析的关键元数据。为何重要确保用户了解数据的新鲜度，这对于做出及时、准确的业务决策至关重要。获取方式此时间戳在数据提取、转换与加载（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	提取 data 的记录系统。
描述此属性标识合同管理数据的来源。在此流程中，该值将固定为“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	合同在其生命周期中的当前状态。
描述此属性指示合同的当前阶段，例如“起草中”、“审核中”、“已执行”、“已到期”或“已终止”。它提供了合同在任何给定时间的快照。在流程挖掘中，状态随时间的变化通常定义了活动本身。作为个案级属性，它对于过滤分析以仅关注活跃、已执行或已到期的合同非常有用，并直接支持“即将到来的合同截止日期与状态”仪表板。为何重要提供合同当前阶段的快速概览，支持对进行中与已完成 case 进行筛选和细分分析。获取方式这是 Agiloft 主合同表中的标准字段。示例草稿等待审批已执行已过期
	合同类型 ContractType	合同分类，例如主服务协议 (MSA)、保密协议 (NDA) 或工作说明书 (SOW)。
描述合同类型是一个关键的分类字段，定义了协议的性质和模板。不同的合同类型通常遵循不同的流程变体，其复杂程度和涉及的利益相关者也各不相同。此属性对于对比分析至关重要，是“合同周期时间波动因素”和“谈判修订频率”仪表板的核心。通过按合同类型细分流程，分析人员可以发现为什么某些类型耗时更长、需要更多修订或更频繁地偏离标准流程。为何重要解释了流程复杂程度、时长和风险方面的重大差异。它是进行有意义流程细分的基础属性。获取方式这是 Agiloft 主合同表中的标准字段。示例主服务协议 (MSA)保密协议 (NDA)工作说明书软件许可协议
	合同金额 ContractValue	合同的总金额。
描述此属性代表合同的总财务价值，包括收入、成本或承诺金额。该价值通常是影响审查力度和审批复杂程度的关键因素。 “合同价值”对于“已执行合同价值与数量趋势”仪表板至关重要，支持对流程绩效进行财务影响分析。它还可用于将合同价值与周期时间关联，揭示高价值合同是否需要更长的处理时间，从而帮助优先处理高价值合同并优化其工作流。为何重要为流程提供财务背景，支持基于价值的分析、优先级排序，并了解延误对业务的影响。获取方式这是 Agiloft 主合同表中的标准字段。示例 50000.00250000.0010000.00
	用户名称 UserName	执行该活动的用户或资源的名称。
描述此属性标识负责完成特定流程步骤的个人，例如起草合同的人或进行法律审核的律师。它通常源自系统审计追踪中与动作关联的用户信息。按用户分析对于“合同资源工作负载分析”仪表板至关重要，因为它有助于了解工作负载分布、个人绩效差异以及培训需求，同时有助于追溯特定动作的责任。为何重要支持工作负载分析、绩效对比，并识别特定资源的瓶颈或最佳实践。获取方式通常在合同历史或审计追踪表中可以找到，并关联到执行更改的用户。示例 Alice SmithBob JohnsonCharlie Brown
	用户部门 UserDepartment	用户或合同负责人所属的业务部门。
描述此属性提供合同的部门背景，例如“销售”、“法务”、“采购”或“财务”。此信息可以与合同负责人或执行特定活动的用户关联。此维度对于“合同周期时间波动因素”仪表板至关重要。它允许在不同部门之间过滤和对比流程绩效，揭示某些部门是否具有更长的周期时间、更多的返工或不同的流程路径。例如，您可以分析源自销售部的合同是否比采购部的合同需要更长时间才能通过法律审核。为何重要支持跨业务部门的绩效对比，有助于识别特定部门的流程问题或最佳实践。获取方式此信息可以从用户个人资料表关联，也可以直接存储在 Agiloft 的合同记录中。示例销售法务采购财务
	结束时间 EventEndTime	指示特定活动或事件完成时间的精确时间戳。
描述 “开始时间”指示活动何时开始，“结束时间”则标记其完成。两者之差即代表该活动的“处理时间”。在流程挖掘中，同时具备开始和结束时间可以更详细地分析资源利用率，以及等待时间与主动工作时间的占比。例如，它可以区分法律审核被主动处理的时间与在队列中等待的时间。这直接支持了“法律审核处理时间”KPI。为何重要支持计算活动的真实处理时间，将实际工作时间与等待时间区分开，从而进行更精准的瓶颈分析。获取方式在某些系统中，这可以直接获取。通常，它被推导为 case 中下一个活动的开始时间。对于 Agiloft，可能需要从审计追踪中推导。示例 2023-10-26T18:30:00Z2023-10-27T15:05:45Z2023-11-05T11:00:00Z
	修订次数 RevisionCount	计算合同在其生命周期中被修订或留痕修改的次数。
描述此属性跟踪合同经历的迭代次数，特别是在起草和谈判阶段。修订次数高通常表示模板存在问题、谈判复杂或初始需求不明确。此指标直接支持“谈判修订频率”仪表板和“合同修订频率”KPI。分析修订次数有助于识别哪些合同类型或对方导致了最多的反复沟通，为简化起草和谈判流程提供参考。为何重要量化返工和谈判复杂度，有助于识别提高模板质量和优化谈判策略的机会。获取方式这通常是通过统计事件日志中每个合同 ID 的“合同已修订”活动的出现次数得出的。示例 1350
	合同模板名称 ContractTemplateName	用于生成初始合同草案的模板名称。
描述此属性指明使用哪个标准模板（如果有）作为合同的起点。模板使用的一致性是高效起草流程的关键。分析此属性有助于支持“合同起草返工率”和“内部审核首检合格率”KPI。通过对比不同模板（或不使用模板）创建的合同绩效，组织可以识别哪些模板最有效，以及哪些地方最需要推行标准化。为何重要有助于评估标准模板的有效性并促进标准化，从而显著减少草拟时间和返工。获取方式这可能是合同记录上的一个字段，当从模板创建合同时在 Agiloft 中自动填充。示例标准 MSA v2.1保密协议 (NDA) - 双方SOW - 固定价格 v1.3自定义
	周期时间 CycleTime	从发起合同请求到合同最终执行的总时长。
描述此属性是一个计算指标，代表合同走完核心生命周期的总耗时，通常从“发起合同请求”到“合同已执行/签署”。这是流程绩效的核心 KPI，直接衡量整体效率。它是“整体合同生命周期概览”仪表板和“平均合同周期时间”KPI 的主要指标。分析周期时间有助于识别耗时较长的案例并调查延迟的根本原因。为何重要这是一个衡量合同管理流程端到端效率的关键绩效指标 (KPI)。获取方式通过计算每个合同 ID 的“合同签署/执行”活动 timestamp 与“合同申请发起”活动 timestamp 之间的差值得出。示例 25天4小时10天8小时45天2小时
	审批阶段时长 ApprovalPhaseDuration	计算得出的审批阶段时长，即从首次寻求审批到最终获得审批的时长。
描述该指标衡量合同通过所有必要的内部和法律审批所需的时间。它通常从第一个审核活动（如“提交内部审核”）开始，到收到最后所需的审批结束。此属性是“平均审批阶段时长”KPI 的基础，也是“审批瓶颈分析”仪表板的关键组件。它隔离了合同生命周期的核心阶段，支持重点分析审核和审批延迟的原因。为何重要分离并量化在审批阶段花费的时间，有助于精准定位并解决这一关键阶段的瓶颈。获取方式通过事件日志计算每份合同从第一个审批活动开始到最后一个审批活动结束之间的时间差。示例 5天2小时12天6小时2天1小时
	是否已自动化 IsAutomated	一个布尔标志，指示活动是由系统自动执行还是由人工执行。
描述此属性区分了人工驱动的活动和系统驱动的活动（如自动状态更新、通知或系统触发的工作流）。在分析中，这有助于了解合同管理流程的自动化水平。它可以用于衡量自动化举措的影响，识别进一步自动化的机会，并确保自动化步骤按预期运行而不产生瓶颈。为何重要有助于测量流程的自动化程度，并识别哪些步骤是由系统执行，哪些是由人工执行。获取方式通过在活动历史中识别特定的系统用户账户（如 'System'、'Admin'）或标记特定的自动化活动类型来推导。示例 truefalse
	是否满足评审 SLA IsReviewSlaMet	一个计算出的布尔标志，指示合同评审是否在定义的 Service Level Agreement (SLA) 内完成。
描述此属性通过将审核活动（如“已执行内部审核”）的实际完成时间戳与其“ReviewSlaDueDate”进行对比得出。如果审核准时，则为“true”，如果逾期，则为“false”。此标识直接支持“合同审核 SLA 执行情况”仪表板，实现合规率的可视化。它通过简单的 true/false 计数，简化了“审核 SLA 达成率”KPI 的计算。为何重要为 SLA 遵守情况提供明确的二元结果，使内部期限的合规情况测量、可视化和报告变得简单。获取方式通过对比每份合同的“评审完成”活动时间 (EventTime) 与“评审 SLA 截止日期” (ReviewSlaDueDate) 得出。示例 truefalse
	法务评审人 LegalReviewer	法务部门分配负责审核合同的具体人员或团队名称。
描述此属性标识负责“已进行法律审核”活动的具体法律资源。这提供了比通用“用户”字段更细致的工作负载视图。这对于“合同资源工作负载分析”仪表板非常有价值，可以针对法律团队的容量和绩效进行重点分析。它有助于回答法律团队内部工作负载平衡的问题，以及特定审核员是否与较长的审核时间相关，从而支持“平均法律审核处理时间”KPI。为何重要支持针对法务评审功能的详细工作负载和绩效分析，有助于有效管理法务团队资源。获取方式这可能是合同上分配法律顾问的特定字段，也可能源自与法律审核活动关联的用户姓名。示例 Jane Doe法务 A 组约翰·史密斯
	评审 SLA 截止日期 ReviewSlaDueDate	合同审核步骤（如法律审核或内部审核）必须完成的目标日期。
描述此属性定义了特定审核活动的 Service Level Agreement (SLA) 截止日期。它设定了对处理时间的明确预期，并用于衡量相对于内部目标的绩效。此日期对于支持“合同审核 SLA 达成情况”仪表板和相关的“审核 SLA 达成率”KPI 至关重要。通过将审核活动的实际完成时间与此截止日期进行比较，系统可以确定流程是否达到了其服务级别目标，并突出显示经常违反 SLA 的领域。为何重要支持根据内部期限测量绩效，这对于强制执行 SLA 和缩短评审周转时间至关重要。获取方式这可能是 Agiloft 中基于合同提交日期和预定义 SLA 规则的计算字段，也可能是手动设置的日期字段。示例 2023-10-29T17:00:00Z2023-11-01T17:00:00Z2023-11-10T17:00:00Z
	谈判阶段时长 NegotiationPhaseDuration	计算得出的对方谈判阶段时长。
描述该指标衡量从与外部对方开始谈判（如“开始对方谈判”）到达成最终协议并获得对方批准的时间。这是“谈判阶段周期时间”仪表板和“平均谈判阶段时间”KPI 的核心指标。分析此时长有助于了解谈判流程的效率，识别哪些合同类型或对方导致了谈判延长，并寻找简化互动的机会。为何重要测量谈判阶段的效率，提供见解以帮助缩短与外部方互动所需的时间。获取方式通过事件日志测量“交易方谈判开始”活动与“收到交易方批准”等结论性活动之间的时间。示例 7天15 天3天

必填推荐可选

合同管理活动

这些是您事件日志中需要捕获的关键流程步骤和里程碑，以便准确进行流程发现和瓶颈识别。

7 推荐 9 可选

	活动	描述
	合同已执行/签署	这是一个重大里程碑，所有各方均已签署合同，使其具有法律约束力。这通常通过与电子签名平台的集成明确捕获，或者由用户手动将状态更新为“已执行”。
为何重要此事件标志着授予前阶段的成功结束，是计算整体合同周期时间的终点，并触发授予后管理阶段的开始。获取方式从电子签名集成 Webhook 提供的完成 timestamp 捕获，或从 Agiloft 中手动更改状态为“已执行”或“已签署”的 timestamp 捕获。捕获使用“签署日期”字段、执行日期或状态更改为“已执行”的时间戳。事件类型 explicit
	合同已终止	表示活跃合同在原定过期日期前提前终止。这是一个明确的事件，通常通过更改合同状态为“已终止”并提供原因来记录。
为何重要终止是一个关键的终点，分析终止原因有助于了解合同解除的背景（如未履行义务或业务策略变更），这对于风险管理和理解交易方关系至关重要。获取方式从合同记录历史中状态字段更改为“已终止”中推导。终止日期通常记录在专门的字段中。捕获使用状态更改为“已终止”的时间戳或“终止日期”字段中的值。事件类型 inferred
	合同已续约	表示合同在期限结束后成功续约。这是一个关键的业务成果，通常由用户更新合同状态或为续约期创建新合同版本的明确操作来捕获。
为何重要此活动是许多企业的关键成功指标，标志着伙伴关系的延续。跟踪续约对于收入预测和分析合同留存绩效至0重要。获取方式从状态明确更改为“已续约”或从创建被指定为续约的新关联合同记录中捕获。Agiloft workflow 可以实现此自动化。捕获使用状态更改为“已续约”的时间戳或后续合同的创建日期。事件类型 explicit
	合同已过期	此事件表示合同已达到截止日期，且未续约或提前终止。该事件通常通过将合同到期日期与当前日期对比计算得出。
为何重要这是合同生命周期的主要终点。分析到期合同对于防止不必要的自动续约或确保不遗漏必要的续约至关重要。获取方式这是一个计算得出的事件。当当前日期超过合同的“到期日期”或“合同结束日期”，且该合同未续约或终止时，即发生此事件。捕获通过使用“过期日期”字段的值来推导此事件。事件类型 calculated
	合同申请已发起	这是合同生命周期中的第一个事件，代表正式的合同新请求。在 Agiloft 中，这通常捕获为合同表中新记录的创建，是系统历史记录或审计日志中记录的明确事件。
为何重要此活动标志着流程的开始，对于计算整体合同周期时间至关重要。分析这一起点有助于了解组织内合同需求的规模和来源。获取方式此事件捕获自 Agiloft 中合同记录的创建时间戳。通常可以在特定合同 ID 的“历史”选项卡或系统日志中找到。捕获使用主合同表中的记录创建时间戳。事件类型 explicit
	已执行法务评审	表示法务部门已完成对合同的评审。此事件通常在法务团队更新合同状态（例如更新为“法务已批准”）或完成特定审批任务时捕获。
为何重要法律审核是一个关键且通常耗时较长的步骤。精准定位此项活动的时长有助于识别法律团队内部的瓶颈，并支持 SLA 达成情况的监控。获取方式从状态更改中推导（例如从“法务评审中”变为“法务已批准”），或从 Agiloft 中分配给法务组的关联审批记录的完成情况中捕获。捕获使用状态更改为“法务获批”或特定法律审批任务标记为完成时的时间戳。事件类型 inferred
	已获得内部审批	此里程碑表示所有必需的内部利益相关者已批准合同的最终版本。通常根据合同状态进入最终审批状态（如“完全获批”或“待签署”）来推断。
为何重要这是一个关键里程碑，标志着内部审核的结束和执行准备就绪。这是衡量合同发送签署前总内部处理时间的关键点。获取方式从状态更改为“已批准”、“待签署”或类似的最终审批状态的 timestamp 中推导。也可以从最后一条必经审批记录的完成 timestamp 中得出。捕获识别合同状态转入签署前审批通过状态的 timestamp。事件类型 inferred
	交易方谈判已开始	此活动标志着合同发送给外部对方进行审核和谈判的时刻。在 Agiloft 中，这可以从状态更改为“谈判中”或“外部审核”中推断出来。
为何重要这标志着谈判阶段的开始，该阶段往往具有高度的可变性和不可预测性。跟踪此阶段有助于衡量和分析谈判周期，并识别延长该阶段的因素。获取方式从合同记录历史中合同状态字段更新为“谈判中”、“在交易方处”或“外部评审”的 timestamp 中推导。捕获识别指示外部沟通或谈判的状态更改的第一个 timestamp。事件类型 inferred
	内部评审已提交	此活动标志着起草的合同正式提交给内部利益相关者审核。这通常由 Agiloft 工作流中的状态更改（例如从“草案”变为“内部审核”）来记录。
为何重要此事件开启了审核阶段，而审核阶段往往是瓶颈的来源。分析此事件与后续审核活动之间的时间，是理解和改善审核周期的关键。获取方式从主合同记录中状态字段更改为“评审中”、“待内部评审”或“已提交评审”等值的 timestamp 中推导。捕获在合同历史日志中查找状态向“内部评审”变更的记录。事件类型 inferred
	合同已修订/留痕修改	表示在谈判或内部评审期间合同文档被修订或留痕修改。这通常在新的合同文档版本 upload 到 Agiloft 时明确捕获。
为何重要此活动对于识别返工循环至关重要。修订频率高可能表明条款不明确、模板质量差或谈判存在争议，所有这些都会延长合同周期。获取方式从 Agiloft 中“附件”或与合同记录关联的专门版本历史表中新文档版本的创建 timestamp 捕获。捕获使用合同文档版本历史中每个新记录的创建时间戳。事件类型 explicit
	合同已取消	表示合同申请或进行中的合同在执行前被有意取消。这是一个明确的终结状态，通常由用户将状态更改为“已取消”或“已撤回”来捕获。
为何重要这代表流程中的失败或终止路径。分析合同取消的原因可以揭示资格审核或谈判阶段的问题，有助于减少无效劳动。获取方式从合同历史中状态字段更改为“已取消”、“作废”或“已撤回”等非成功终结值的 timestamp 中推导。捕获查找状态更改为“已取消”的 timestamp。事件类型 inferred
	合同已激活	表示合同开始生效并具有执行力，通常发生在执行日期或之后。这在 Agiloft 中通常记录为状态从“已执行”变为“活跃”或“生效中”。
为何重要此活动正式开启了授予后的生命周期，触发义务、监控和合规任务。它为跟踪活跃合同的绩效和管理提供了一个明确的起点。获取方式从合同历史日志中状态更改为“活跃”中推导，或基于“合同开始日期”字段计算。捕获使用状态更改为“活跃”的时间戳或“生效日期”字段的值。事件类型 inferred
	合同已草拟	表示合同初稿起草完成。这通常在第一个合同文档版本被 upload 并关联至合同记录时，或者合同状态更改为“草拟完成”时捕获。
为何重要跟踪此活动有助于衡量起草阶段的效率。它是分析返工的前提，因为在此之后的多次修订可能表明模板或初始需求存在问题。获取方式从状态字段更改中推导（例如从“新建”变为“草拟中”），或从 Agiloft “附件”关联表中第一个文档版本附件的 timestamp 中捕获。捕获识别状态首次更改为“草拟”或“评审”的 timestamp，或第一个相关文档记录的创建日期。事件类型 inferred
	已发起修订	此事件标志着现有活动合同正式修订流程的开始。在 Agiloft 中，这通常通过创建与原始合同链接的新“修订”记录来捕获。
为何重要修订代表了合同生命周期中的重大变更。分析修订的频率及其执行过程，可以洞察业务需求的变化或初始合同条款的清晰度。获取方式此事件捕获自专用“修订”表中新记录的创建时间戳，并链接回父级合同 ID。捕获使用修订表中的记录创建时间戳。事件类型 explicit
	已发送待签署	此活动标志着最终获批的合同已发送供各方执行。在像 Agiloft 这样集成了电子签名的系统中，这通常是一个触发签署流程的明确动作。
为何重要此事件为最终执行阶段的开始提供了清晰的时间戳。分析从该点到“合同已执行”的时间有助于识别签署流程本身的延迟。获取方式从合同历史记录中的明确用户操作捕获，或通过调用 Agiloft 集成的电子签名服务（如 DocuSign 或 Adobe Sign）的 API 捕获。捕获使用与“发送签署”动作或集成调用关联的历史日志中的时间戳。事件类型 explicit
	已执行合规评审	表示对活跃合同的定期或随机合规评审已完成。这通常是一个明确的事件，在用户完成合规相关任务或更新评审字段时捕获。
为何重要跟踪合规审核对于治理和风险管理至关重要。此活动有助于组织确保在整个合同生命周期中满足监管和内部政策要求。获取方式从关联的合规评审任务记录的完成 timestamp 捕获，或从填充的日期字段（如“上次合规评审日期”）捕获。捕获使用专用合规任务的完成日期或审核完成后更新的特定日期字段。事件类型 explicit

推荐可选

提取指南

如何从 Agiloft 获取数据

步骤

准备 Python 环境：确保已安装 Python 3.6 或更高版本。使用 pip 安装必要的库：pip install requests pandas。
获取 Agiloft 凭证：登录您的 Agiloft 实例。您需要 API 基础 URL（例如 https://[您的域名].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 文件。该文件格式已针对直接 upload 至 ProcessMind 进行了优化。

配置

API 凭证：必须提供 USERNAME、PASSWORD 和 API_KEY。对应用户账户需具备通过 REST API 读取合同数据 (data) 的充分权限。
Base 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 REST API 进行 Python 脚本提取

步骤

配置

a 查询示例 python

准备好开始了吗？

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

您的合同管理数据模板

您的合同管理数据模板

合同管理属性

合同管理活动

提取指南

通过 Agiloft REST API 进行 Python 脚本提取

步骤

配置

a 查询示例 python

我们重视您的隐私

准备好开始了吗？

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