您的合同管理数据模板

DocuSign CLM

← 返回改进指南

合同管理属性 (19) 合同管理活动 (15) 提取指南 (1)

您的合同管理数据模板

此模板以结构化方式概述分析合同管理流程所需的关键数据点，包括应收集的核心属性、应跟踪的关键活动，以及提取这些信息的实用指南。使用此模板可确保您收集完整数据，全面发现并优化流程。

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

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

下载模板

合同管理属性

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

5 必需 7 建议 7 可选

	名称	说明
	合同ID ContractId	系统中管理的每份合同的唯一标识符。
说明 Contract ID是确定的case identifier，用于唯一关联从合同创建到结束的所有相关事件和活动。在DocuSign CLM中，它可能对应Envelope ID或自定义合同标识符字段。该属性对于流程挖掘至关重要，因为它支持重建每份合同的端到端流转过程。将所有相关活动归入同一Contract ID后，分析人员可以可视化完整流程，衡量周期时间，并分析不同合同之间的差异。为什么重要它是连接所有相关流程事件的主键，使您能够追踪和分析单份合同的完整生命周期。获取位置通常，这是DocuSign CLM中合同或信封对象的主要标识符，可能标记为Envelope ID，也可能是为合同识别配置的自定义字段。示例 CON-2023-03-112MSA-4815162342NDA-CORP-9981
	开始时间 EventTime	表示特定活动或事件开始时间的时间戳。
说明此属性记录活动发生的准确日期和时间，是流程挖掘进行时间维度分析的基础。按照开始时间排列事件后，可以为每个案例创建按时间顺序排列的日志。这样便可计算活动之间的周期时间、每个步骤的持续时间以及端到端流程的总时长。这对于识别瓶颈、衡量等待时间，以及根据SLA评估流程效率至关重要。为什么重要此时间戳对于按时间顺序排列事件，以及计算周期时间和持续时间等所有基于时间的指标至关重要。获取位置这是DocuSign CLM中任何事件日志或审计跟踪的标准组成部分，与每项记录的操作相关联。示例 2023-04-15T09:00:00Z2023-05-20T14:35:10Z2023-06-01T11:21:05Z
	活动 ActivityName	合同生命周期中发生的具体任务或事件名称。
说明此属性描述合同管理流程中的单个步骤或里程碑，例如“合同起草完成”“法律审核开始”或“合同执行完成”。这些活动构成流程图的基本单元。分析这些活动的顺序和频率是流程挖掘的基础。通过分析，可以识别实际流程、发现与标准流程的偏差，并找出耗时最长或重复最频繁的活动。为什么重要它定义流程中的各个步骤，用于可视化和分析合同工作流、瓶颈及流程差异。获取位置通常来自DocuSign CLM中的事件日志或审计跟踪数据，用于记录对合同文档或工作流执行的操作。示例合同草案已创建内部审查已开始已发送给交易对手合同已执行
	最近数据更新时间 LastDataUpdate	源系统最近一次刷新或提取数据的时间戳。
说明此属性表示数据集最近一次更新的时间，为分析结果的新鲜度和时效性提供背景信息，帮助用户了解数据的当前状态。在仪表板和报告中，这项信息对于数据治理和建立用户信任至关重要。它可以帮助分析人员判断当前查看的是实时数据，还是某个时间点的快照，这对于及时作出有依据的决策十分重要。为什么重要为数据的新鲜度提供重要背景，确保用户了解流程分析所使用数据的时效性。获取位置这是一个元数据属性，通常由ETL（提取、转换、加载）工具或数据管道在数据摄取过程中生成并存储。示例 2023-10-26T08:00:00Z2023-10-27T08:00:00Z
	源系统 SourceSystem	标识数据提取自哪个系统。
说明此属性用于指定流程数据的来源。在此视图中，其值通常为“DocuSign CLM”或类似标识符。在单系统分析中，这一字段看似多余，但保留该字段是最佳实践。当合并多个系统的数据时，例如将CRM中的合同数据与DocuSign中的工作流数据结合，该字段对于确保数据来源清晰、可追溯至关重要。为什么重要确保数据可追溯，对于整合多个企业系统数据的分析至关重要。获取位置通常是在数据提取和转换过程中添加的静态值，用于标识数据集的来源。示例 DocuSign CLMDocuSign CLM v24.1
	到期日 ExpirationDate	合同设定的到期日期。
说明此属性存储合同到期日期，是主动管理合同组合的重要元数据，尤其适用于经常性收入或长期服务协议。该日期是“合同续签与到期展望”仪表板的主要依据。通过监控即将到期的合同，组织可以及时触发续签工作流。它也是计算“按时续签率”KPI的重要输入，有助于避免收入流失和服务中断。为什么重要对于主动管理合同至关重要，有助于及时续签并避免合同意外失效。获取位置这是标准元数据字段，DocuSign CLM中任何具有明确期限的合同都应记录该字段。示例 2024-12-312025-06-302026-01-15
	合同对方 Counterparty	参与合同的外部一方，例如客户或供应商。
说明此属性用于标识参与协议的另一家组织。不同合同对方的谈判方式、法律要求和响应时间可能不同，并显著影响合同生命周期。按合同对方分析流程绩效，有助于识别哪些合作伙伴易于协作，哪些合作伙伴经常造成延迟。这些信息可用于改善关系管理，并为未来谈判设定合理预期。它是“合同返工与修订频率”分析的关键维度。为什么重要帮助分析与不同外部方的互动如何影响谈判时间、修订次数和整体周期时间。获取位置这是合同记录的基本组成部分，通常存储在专用的“合同对方名称”或“公司”字段中。示例 Acme CorporationGlobex Inc.Stark Industries
	合同状态 ContractStatus	合同在其生命周期中的当前状态。
说明此属性表示合同在特定时间点的总体状态，例如“草稿”“审核中”“等待签署”或“已执行”。它概括了合同当前所处的流程阶段。在流程挖掘中，分析合同状态有助于筛选案例，并构建跟踪不同阶段合同数量的仪表板。“实时合同状态跟踪器”仪表板直接依赖此属性，以展示当前合同组合的状态，并识别工作积压的位置。为什么重要提供合同进度的快照，对于状态跟踪、工作负载管理和识别瓶颈至关重要。获取位置通常可作为DocuSign CLM中合同对象或工作流对象的主要属性获取。示例草稿内部审查中等待签署已签署已终止
	合同类型 ContractType	合同的分类，例如NDA、MSA或SOW。
说明此属性根据合同的法律或业务用途对合同进行分类。不同合同类型通常遵循不同的工作流，审批要求和复杂程度也各不相同。按合同类型细分流程分析，是理解绩效差异的基础。分析人员可以比较不同协议类型的周期时间、合规率和谈判模式。例如，NDA的周期时间通常应明显短于复杂的Master Services Agreement，而此属性使这种比较成为可能。为什么重要支持比较不同合同类别的流程绩效，因为这些类别通常具有独特的工作流和不同的复杂程度。获取位置这是关键的元数据字段，通常在DocuSign CLM中创建合同时从下拉列表中选择。示例保密协议（NDA）主服务协议（MSA）工作说明书（SOW）
	合同负责人 ContractOwner	负责在合同生命周期内管理合同的用户或员工。
说明合同负责人是合同推进过程中的主要联系人和责任人，通常是发起合同请求或负责业务关系的人员。按合同负责人分析绩效，可以发现效率、返工率和周期时间方面的规律。这有助于识别表现优秀的个人或团队，以及可能需要额外培训或支持的人员。它也是“合同周期时间分析”等仪表板进行数据细分的关键维度。为什么重要支持按个人或团队分析绩效，帮助识别用户驱动活动中的最佳实践和改进方向。获取位置通常是与合同对象关联的用户字段，往往填入创建或负责该工作流的用户姓名。示例 Alice SmithBob JohnsonCharlie Brown
	合同金额 ContractValue	合同的货币总价值。
说明此属性表示协议的财务价值，可以是一次性金额，也可以是周期性金额。合同金额通常决定所需的审查级别和审批路径的复杂程度。根据合同金额分析流程，对于确定高价值交易的优先级并识别不必要的延迟至关重要。它还可用于检查合规性，例如验证超过特定金额阈值的合同是否已获得CFO审批。此属性有助于将优化工作集中在财务影响最大的合同上。为什么重要支持确定优先级和评估风险，因为高价值合同通常需要更严格的审查，并会产生更大的业务影响。获取位置通常是DocuSign CLM合同元数据中的数值或货币字段。示例 500002500001200000
	结束时间 EndTime	表示特定活动或事件完成时间的时间戳。
说明此属性记录活动完成的准确日期和时间。开始时间标记活动的起点，结束时间标记其完成时间，因此可以精确计算单项活动的持续时间。分析结束时间对于计算活动处理时间至关重要，即完成任务所实际投入的工作时间。这有助于区分实际工作时间和等待时间，更深入地了解资源效率以及延迟造成的真实成本。例如，可以据此计算“法律审核”活动的准确时长。为什么重要支持精确计算单项活动的持续时间，帮助区分实际处理时间和空闲等待时间。获取位置在DocuSign CLM等系统中，该时间可能会明确记录在审计跟踪中，也可能需要根据后续事件的开始时间推断。示例 2023-04-15T17:30:00Z2023-05-21T10:00:15Z2023-06-01T11:55:00Z
	审批状态 ApprovalStatus	审批步骤的状态，例如“待处理”“已批准”或“已拒绝”。
说明此属性提供合同生命周期中审批阶段的细分状态。合同状态表示案例的总体状态，而审批状态则跟踪单项审批活动的结果。它是“合同审批瓶颈报告”和“实时合同状态跟踪器”的重要基础。通过该属性，可以清晰了解哪些合同正在等待审批，哪些合同被拒绝并需要返工，以及哪些合同已成功通过审批阶段。分析这些状态之间的转换，有助于定位审批链中的具体故障点或延迟环节。为什么重要深入展示审批阶段的详细情况，帮助识别哪些合同陷入停滞以及原因。获取位置这是DocuSign CLM中审批任务或工作流步骤的结果。示例等待法务审批财务已批准销售副总裁已拒绝
	审批阶段持续时间 ApprovalPhaseDuration	所有审批相关活动所耗费的总时间。
说明此指标计算合同在审批阶段所耗费的总时长，从首次提交内部审批开始，直到获得最后一项必需审批为止。可以将所有审批相关活动的持续时间相加，也可以计算首次审批活动开始时间与最后一项审批活动结束时间之间的时长。此属性是“平均审批阶段持续时间”KPI的核心指标。它有助于区分审批流程造成的延迟与起草或谈判造成的延迟。跟踪该时长后，组织可以更好地了解审批矩阵的影响，并发现简化审批流程的机会。为什么重要单独衡量审批环节耗时，便于专门识别和解决审批链中的瓶颈。获取位置在流程挖掘工具中，通过识别所有审批相关事件，例如“发送内部审批”和“收到内部审批”，并计算每个案例中首个与最后一个此类事件之间的时间来得出。示例 5天2小时10天1小时2天6小时
	文档版本 DocumentVersion	合同文档的版本号。
说明此属性跟踪合同文档在修订和红线修改过程中的迭代情况。每次上传或保存新版本时，该编号都应递增。跟踪文档版本是衡量返工量和谈判复杂程度的直接方法。合同版本数较高，通常表示双方进行了大量反复修改。此属性是计算“平均文档修订次数”KPI以及分析“合同返工与修订频率”仪表板的主要输入。为什么重要通过跟踪文档的修订次数，直接衡量返工量和谈判投入。获取位置 DocuSign CLM内置文档版本控制功能。此属性可从文档版本历史中提取。示例 1234
	是否已电子签署 IsESigned	用于表示合同是否通过电子签名执行的布尔标记。
说明此属性跟踪合同是否通过DocuSign eSignature等集成电子签名工具签署，或通过线下方式执行，例如手写签名后扫描。此属性直接支持“电子签名采用率”KPI。通过分析电子签署合同的比例，企业可以衡量数字化转型举措的成效。更高的采用率通常意味着更快的执行速度、更低的管理成本，以及更好的合规性和文档跟踪能力。为什么重要衡量数字化流程的采用情况，并帮助量化使用集成电子签名功能带来的效率提升。获取位置可以通过检查“合同执行完成”事件是否源自集成的DocuSign eSignature服务来确定。示例 truefalse
	是否返工 IsRework	用于表示合同是否经历过重大修订循环的布尔标记。
说明此计算属性用于识别经历过返工的合同，例如内部审批完成后又被退回进行红线修改的合同。通常通过查找特定的不良活动序列来推导。该标记简化了流程低效分析。它支持直接计算“合同返工率”KPI，也便于筛选和分析需要额外投入的合同，从而定位返工的根本原因，例如初始需求不明确或谈判难度较高。为什么重要帮助量化和分析返工频率，这是衡量流程低效和隐性成本的关键指标。获取位置在流程挖掘工具中，通过定义识别返工循环的规则计算该属性，例如“合同完成红线修改”事件发生在“收到内部审批”事件之后。示例 truefalse
	法律顾问 LegalCounsel	负责审核合同的法律专业人员或团队成员。
说明此属性用于标识法律部门中负责审核和批准合同的具体人员。该角色不同于合同负责人，后者通常来自业务部门。将审核任务分配给具体法律顾问后，可以详细分析法律审核环节的绩效。这有助于构建“法律审核绩效”仪表板，衡量并比较不同法律团队成员的处理量和周期时间，从而为工作负载平衡提供依据，并发现法律部门内部的效率提升机会。为什么重要支持详细分析法律审核阶段，帮助平衡工作负载并衡量法律团队的绩效。获取位置该信息来自DocuSign CLM工作流中的任务分配数据，用于标识“法律审核”任务的负责人。示例 Jennifer WaltersMatt MurdockHarvey Specter
	部门 Department	负责合同的内部业务单元或部门。
说明此属性用于指定发起合同或负责合同的内部部门，例如销售、市场或IT。不同部门的流程和需求可能存在差异，从而形成不同的合同管理模式。按部门细分分析，对于了解企业不同部门如何使用合同管理流程至关重要。它有助于创建有针对性的报告，例如“合同审批瓶颈报告”，以识别延迟是否集中在特定业务单元，并根据部门需求制定流程改进方案。为什么重要支持比较不同业务单元的绩效，突出效率、合规和工作负载方面的差异。获取位置可以是合同上的元数据字段，也可以根据合同负责人的所属部门推导得出。示例销售法务采购市场营销

必需建议可选

合同管理活动

以下是建议记录在事件日志中的关键流程步骤和里程碑，用于准确发现合同管理流程。

6 建议 9 可选

	活动	说明
	内部审批已完成	此里程碑表示所有必需的内部审批人均已批准合同。当最后一位必需审批人在工作流中完成任务时，系统会记录此活动。
为什么重要这是表明合同已准备好进行外部谈判或执行的关键里程碑。到达此节点前的延误反映了内部协同问题。获取位置当审批任务进入最终“Approved”状态时，工作流历史会记录此事件。采集在串行或并行审批工作流中，最后一位审批人完成审批时记录。事件类型 explicit
	合同已发送待签署	此活动标志着最终批准合同的电子签名流程启动。这是DocuSign的核心功能，当用户通过DocuSign eSignature信封发送文档时，系统会记录此活动。
为什么重要这是执行前的关键里程碑。分析从此节点到执行完成的时间，有助于了解签名收集效率，并支持“E-Signature Adoption Rate”KPI。获取位置这是文档详细历史或审计轨迹中记录的明确核心事件，通常称为“Envelope History”。采集创建并发送eSignature信封时由系统直接记录。事件类型 explicit
	合同已执行	表示合同成功完成，即最后一位必需签署人签署文档时发生。DocuSign eSignature平台会明确记录此事件。
为什么重要这是合同创建流程的主要成功结束点，对于计算“Average Contract Cycle Time”和衡量整体流程处理量至关重要。获取位置 eSignature工作流完全完成时，完成证书和文档审计日志会记录此事件的时间戳。采集最后一个签名完成后，由eSignature组件自动记录。事件类型 explicit
	合同已终止	此活动表示合同生命周期正式结束，原因可能是到期、取消或双方协商一致。通常通过系统中的手动状态变更记录。
为什么重要这是流程的替代结束点。跟踪终止和到期情况，对于了解完整合同生命周期和开展续签分析至关重要。获取位置用户将合同状态字段更新为“Terminated”“Expired”或“Cancelled”时，系统会记录此事件，并使用状态变更的时间戳。采集根据合同主状态字段变更为终止状态推断得出。事件类型 inferred
	合同请求已发起	此活动标志着合同生命周期正式开始。通常，当用户提交合同请求表单或在DocuSign CLM中创建新的合同记录并触发相关工作流时，系统会记录此活动。
为什么重要这是流程的主要开始事件。分析此活动对于衡量整体合同处理量和端到端周期时间起点至关重要。获取位置此事件取自审计日志或工作流历史，对应合同记录的创建时间戳或信息收集表单的提交时间戳。采集记录于合同发起表单提交或新合同对象创建时。事件类型 explicit
	法律审查已开始	标志着合同正式提交法务部门进行审查和反馈。这是关键步骤，当合同进入工作流的“Legal Review”阶段时，系统会记录此活动。
为什么重要法律审查是合同管理中的常见瓶颈。衡量其持续时间对于“Legal Review Performance”仪表板以及识别加速机会至关重要。获取位置此事件取自工作流审计轨迹，其中记录了任务分配给法务团队，或合同状态变更为“In Legal Review”的时间戳。采集当合同被分配至法律审查任务或队列时，由工作流引擎记录。事件类型 explicit
	义务监控已开始	此活动表示执行后管理开始，期间会跟踪关键日期和交付事项。当用于监控合同义务的任务或子流程启动时，系统会记录此活动。
为什么重要此活动对于“Post-Execution Obligation Adherence Rate”KPI至关重要，可帮助了解签署后合同承诺是否得到管理。获取位置需要进行系统分析。通常可能通过创建与主合同关联的具体义务跟踪任务或工作流来记录。采集创建执行后义务管理相关任务或工作流时记录。事件类型 explicit
	交易对手谈判已开始	表示交易对手已作出回应，通常包括提供反馈或合同修订版本。当外部方上传新文档版本，或状态退回内部审查阶段时，可以推断出此活动。
为什么重要该活动对于分析“每份合同的谈判交接次数”KPI至关重要。内部团队与合作方之间频繁双向导入导出，表明谈判存在摩擦。获取位置根据收到外部来源的新文档版本，或用户手动变更状态以表示已收到交易对手反馈推断得出。采集合同交由交易对手处理后，状态变回“Internal Review”或“Drafting”时推断得出。事件类型 inferred
	内部审批已发起	当合同完成审查并提交指定内部负责人正式审批时，会发生此活动。审批工作流启动时，系统会记录此活动。
为什么重要这标志着最终内部签批阶段开始。其持续时间是“Average Approval Phase Duration”KPI的重要组成部分。获取位置用户发送合同进行审批并触发审批人分配时，工作流历史会记录这一明确操作。采集执行“Send for Approval”或类似工作流操作时记录。事件类型 explicit
	内部审查已开始	此活动表示合同草案已提交给内部业务利益相关方审查，例如财务或运营部门。通常，当用户在工作流中发起“Internal Review”任务时，系统会记录此活动。
为什么重要这标志着审查阶段开始，而审查阶段往往是瓶颈来源。分析其持续时间有助于识别利益相关方反馈延迟。获取位置当合同转为“Internal Review”状态，或审查任务分配给非法律部门的内部用户时，工作流历史会记录此活动。采集当工作流转入内部业务审查对应的状态或任务时记录。事件类型 explicit
	合同已修订	此活动表示合同在谈判或审查周期中发生了修订或变更。每当文档新版本上传或保存时，系统都会记录此活动。
为什么重要跟踪修订标记的频率对于“Contract Rework Rate”KPI至关重要。大量修订可能表明条款不清晰、谈判效率低下或初始草案质量不佳。获取位置根据与合同关联的文档版本历史得出。初始草案之后创建的每个新版本都可以视为一次“Contract Redlined”事件。采集当DocuSign CLM资料库中上传或生成新文档版本时记录。事件类型 explicit
	合同已存入资料库	这是最终管理步骤，已完全执行的合同会自动归档至中央合同资料库。此事件通常由签署流程完成触发。
为什么重要确保流程以规范的记录保存结束。它标志着执行前生命周期的最后时刻，以及执行后阶段的开始。获取位置最终步骤完成并归档已签署文档时，由工作流历史记录。采集成功执行后，工作流引擎将其记录为最后一个自动化步骤。事件类型 explicit
	合同续签已发起	标志着现有合同续签流程开始。通常由合同负责人手动触发，或根据合同到期日期自动触发。
为什么重要此活动对于跟踪“Timely Contract Renewal Rate”KPI至关重要，可帮助了解组织管理即将到期合同的主动程度。获取位置执行具体的“Renew Contract”操作时记录。该操作可能创建与原合同关联的新合同记录，或启动续签工作流。采集执行启动续签工作流的特定用户操作或自动触发器时记录。事件类型 explicit
	合同草案已创建	表示合同文档初始草案的创建和完成。通常，当文档首个版本在系统中上传或生成并保存时，系统会记录此活动。
为什么重要跟踪此活动有助于了解审查开始前用于撰写和准备合同的时间，并为衡量后续修改频率提供基准。获取位置根据合同文档历史中首个文档版本的创建时间戳，或状态变更为“Drafting Complete”推断得出。采集识别与合同ID关联的首个文档版本创建事件。事件类型 inferred
	已发送给交易对手	表示将合同文档分享给外部交易对手，供其审查和签署。通常通过DocuSign CLM中的“send”或“share”操作记录。
为什么重要此活动标志着流程交接给外部方，此后流程控制能力有限。了解交易对手环节耗时，有助于识别外部延误。获取位置取自审计轨迹，其中记录了从CLM发送文档邮件，或通过外部门户分享文档等操作。采集用户通过平台功能向外部分享文档时，由具体用户操作记录。事件类型 explicit

建议可选

提取指南

如何从DocuSign CLM获取数据

步骤

前提条件和API设置：运行脚本前，您必须拥有具备API访问权限的DocuSign CLM账户。在DocuSign管理面板中创建配置为JWT Grant身份验证的Integration Key（App ID）。生成RSA密钥对，并将公钥提供给DocuSign。记录User ID（API用户名GUID）、Integration Key和Account ID。
配置Python环境：设置本地Python环境。运行以下命令安装API请求和JWT身份验证所需的库：pip install requests PyJWT pandas。建议使用Pandas，以便处理数据和导出CSV。
将凭据添加到脚本：打开Python脚本，填写顶部的占位变量，包括INTEGRATION_KEY、USER_ID、ACCOUNT_ID、OAUTH_BASE_PATH（例如，演示账户使用account-d.docusign.com），以及private.key文件路径。
设置提取参数：在脚本主体中定义START_DATE和END_DATE，指定合同提取的时间范围。脚本将按合同创建日期筛选，以控制数据量。
执行Python脚本：在终端中运行python your_script_name.py。脚本首先向DocuSign API进行身份验证，以获取访问令牌。
获取API数据：脚本随后发起一系列API调用。首先搜索指定日期范围内的所有文档（合同），然后针对每份合同调用API，获取详细的工作流历史和文档版本历史。
数据转换和映射：脚本处理API返回的原始JSON数据，遍历每份合同的工作流历史步骤和文档版本，将“Legal Review”等工作流步骤名称，以及新版本上传等事件类型，映射为事件日志所需的标准ActivityName，例如“Legal Review Started”和“Contract Redlined”。
提取属性：脚本为每项活动提取所需属性。ContractId取自文档对象，EventTime取自工作流步骤时间戳，ContractOwner、ContractType和ContractValue等其他元数据取自文档属性列表。
处理推断事件：脚本包含创建非显式工作流步骤事件的逻辑。例如，在“Sent to Counterparty”事件发生后上传新文档版本时，推断“Counterparty Negotiation Started”事件。
生成并检查CSV输出：处理完所有合同及其历史记录后，脚本将数据整理为结构化格式，并使用pandas库导出名为docusign_clm_event_log.csv的CSV文件。该文件可直接上传到ProcessMind。

配置

API凭据：JWT身份验证必须使用有效的Integration Key、User ID（GUID）和RSA私钥。这些信息必须在DocuSign管理后台配置，并授予适当权限，通常包括“signature”和“impersonation”。
Account ID：必须使用具体的DocuSign Account ID，并将其用于所有API调用的基础URL。
日期范围：脚本使用createdStartDate和createdEndDate参数筛选合同。强烈建议先选择有限范围，例如最近3至6个月，以控制提取时间并避免触发API速率限制。
工作流命名约定：脚本逻辑依赖匹配工作流步骤名称，例如“Legal Review”和“Internal Approval”。您必须自定义脚本中的ACTIVITY_MAP字典，使其与组织DocuSign CLM配置中使用的确切步骤名称一致。
API速率限制：请注意DocuSign的API速率限制，该限制会约束每小时的调用次数。脚本包含基础的time.sleep()以降低影响，但对于超大数据集，可能需要更完善的退避策略。
前提条件：与User ID关联的用户账户必须拥有查看待提取合同、工作流和文档的足够权限。

a 示例查询 python

import requests
import jwt
import time
import datetime
import csv
import json

class=class="hl-string">"hl-comment"># --- Configuration --- 
class=class="hl-string">"hl-comment"># Replace with your DocuSign account details
INTEGRATION_KEY = class="hl-string">"[Your Integration Key]"
USER_ID = class="hl-string">"[Your User ID GUID]"
ACCOUNT_ID = class="hl-string">"[Your Account ID]"
OAUTH_BASE_PATH = class="hl-string">"account-d.docusign.com" class=class="hl-string">"hl-comment"># Use account.docusign.com for demo, account.docusign.com for production

class=class="hl-string">"hl-comment"># --- Constants ---
SOURCE_SYSTEM = class="hl-string">"DocuSign CLM"
LAST_DATA_UPDATE = datetime.datetime.utcnow().isoformat() + class="hl-string">'Z'

class=class="hl-string">"hl-comment"># --- Functions ---
def get_access_token(private_key_path):
    class="hl-string">"""Generates a JWT and exchanges it for an access token."""
    try:
        with open(private_key_path, class="hl-string">'r') as key_file:
            private_key = key_file.read()

        payload = {
            class="hl-string">"iss": INTEGRATION_KEY,
            class="hl-string">"sub": USER_ID,
            class="hl-string">"iat": int(time.time()),
            class="hl-string">"exp": int(time.time()) + 3600,
            class="hl-string">"aud": OAUTH_BASE_PATH,
            class="hl-string">"scope": class="hl-string">"signature impersonation"
        }

        token = jwt.encode(payload, private_key, algorithm=class="hl-string">'RS256')
        
        headers = {class="hl-string">'Content-Type': class="hl-string">'application/x-www-form-urlencoded'}
        data = {
            class="hl-string">'grant_type': class="hl-string">'urn:ietf:params:oauth:grant-type:jwt-bearer',
            class="hl-string">'assertion': token
        }
        
        response = requests.post(fclass="hl-string">"https протокол://{OAUTH_BASE_PATH}/oauth/token", headers=headers, data=data)
        response.raise_for_status()
        return response.json()[class="hl-string">'access_token']

    except Exception as e:
        print(fclass="hl-string">"Error getting access token: {e}")
        return None

def get_document_attribute(doc_attributes, attribute_name):
    class="hl-string">"""Helper function to safely get a value from the document's attribute list."""
    for attr in doc_attributes:
        if attr.get(class="hl-string">'name') == attribute_name:
            return attr.get(class="hl-string">'value')
    return None

def extract_event_log(access_token, start_date_str, end_date_str):
    class="hl-string">"""Main function to extract, process, and save the event log."""
    
    event_log = []
    api_base_url = fclass="hl-string">"https протокол://{OAUTH_BASE_PATH.replace('account', 'api')}/api/v2/accounts/{ACCOUNT_ID}"
    headers = {class="hl-string">'Authorization': fclass="hl-string">'Bearer {access_token}', class="hl-string">'Content-Type': class="hl-string">'application/json'}
    
    class=class="hl-string">"hl-comment"># Activity mapping: Customize keys to match your workflow step names
    ACTIVITY_MAP = {
        class="hl-string">'Start': class="hl-string">'Contract Request Initiated',
        class="hl-string">'Drafting': class="hl-string">'Contract Drafted',
        class="hl-string">'Internal Review': class="hl-string">'Internal Review Started',
        class="hl-string">'Legal Review': class="hl-string">'Legal Review Started',
        class="hl-string">'Send for Internal Approval': class="hl-string">'Internal Approval Sent',
        class="hl-string">'Internal Approval': class="hl-string">'Internal Approval Received',
        class="hl-string">'Send to Counterparty': class="hl-string">'Sent to Counterparty',
        class="hl-string">'Send for Signature': class="hl-string">'Contract Sent for Signature',
        class="hl-string">'Executed': class="hl-string">'Contract Executed',
        class="hl-string">'Archive': class="hl-string">'Contract Stored in Repository',
        class="hl-string">'Start Obligation Monitoring': class="hl-string">'Obligation Monitoring Started',
        class="hl-string">'Initiate Renewal': class="hl-string">'Contract Renewal Initiated',
        class="hl-string">'Terminate': class="hl-string">'Contract Terminated'
    }
    
    class=class="hl-string">"hl-comment"># 1. Search for documents (contracts)
    search_url = fclass="hl-string">"{api_base_url}/search"
    search_params = {
        class="hl-string">'q': fclass="hl-string">'IsLatestVersion:true AND CreatedDate:[{start_date_str} TO {end_date_str}]',
        class="hl-string">'limit': 100, class=class="hl-string">"hl-comment"># Max limit per page
        class="hl-string">'offset': 0
    }
    
    while True:
        print(fclass="hl-string">"Searching for documents with offset {search_params['offset']}...")
        response = requests.get(search_url, headers=headers, params=search_params)
        if response.status_code != 200:
            print(fclass="hl-string">"Error searching documents: {response.text}")
            break
        
        data = response.json()
        documents = data.get(class="hl-string">'value', [])
        
        if not documents:
            print(class="hl-string">"No more documents found.")
            break

        for doc in documents:
            contract_id = doc.get(class="hl-string">'id')
            doc_attributes = doc.get(class="hl-string">'attributes', [])
            
            base_event_data = {
                class="hl-string">'ContractId': contract_id,
                class="hl-string">'ContractStatus': get_document_attribute(doc_attributes, class="hl-string">'Contract Status'),
                class="hl-string">'ContractOwner': get_document_attribute(doc_attributes, class="hl-string">'Contract Owner'),
                class="hl-string">'ContractType': doc.get(class="hl-string">'documentTypeName'),
                class="hl-string">'ContractValue': get_document_attribute(doc_attributes, class="hl-string">'Contract Value'),
                class="hl-string">'Counterparty': get_document_attribute(doc_attributes, class="hl-string">'Counterparty Name'),
                class="hl-string">'ExpirationDate': get_document_attribute(doc_attributes, class="hl-string">'Expiration Date'),
                class="hl-string">'SourceSystem': SOURCE_SYSTEM,
                class="hl-string">'LastDataUpdate': LAST_DATA_UPDATE,
                class="hl-string">'EndTime': None, class=class="hl-string">"hl-comment"># Can be populated if logic is added
                class="hl-string">'CycleTime': None class=class="hl-string">"hl-comment"># Requires post-processing
            }
            
            class=class="hl-string">"hl-comment"># 2. Get workflow history for each document
            workflow_url = fclass="hl-string">"{api_base_url}/documents/{contract_id}/workflow"
            workflow_response = requests.get(workflow_url, headers=headers)
            
            if workflow_response.status_code == 200:
                workflow_data = workflow_response.json()
                
                class=class="hl-string">"hl-comment"># Process workflow steps
                for step in workflow_data.get(class="hl-string">'workflow', {}).get(class="hl-string">'steps', []):
                    step_name = step.get(class="hl-string">'stepName')
                    if step_name in ACTIVITY_MAP:
                        event = base_event_data.copy()
                        event[class="hl-string">'ActivityName'] = ACTIVITY_MAP[step_name]
                        event[class="hl-string">'EventTime'] = step.get(class="hl-string">'started')
                        event[class="hl-string">'EndTime'] = step.get(class="hl-string">'completed')
                        event_log.append(event)
                        
                        class=class="hl-string">"hl-comment"># Special case for final approval
                        if step_name == class="hl-string">'Internal Approval' and step.get(class="hl-string">'completed'):
                            event_approval = base_event_data.copy()
                            event_approval[class="hl-string">'ActivityName'] = class="hl-string">'Internal Approval Received'
                            event_approval[class="hl-string">'EventTime'] = step.get(class="hl-string">'completed')
                            event_log.append(event_approval)
                            
            class=class="hl-string">"hl-comment"># 3. Get document version history for class="hl-string">'Contract Redlined' events
            versions_url = fclass="hl-string">"{api_base_url}/documents/{contract_id}/versions"
            versions_response = requests.get(versions_url, headers=headers)
            if versions_response.status_code == 200:
                versions_data = versions_response.json()
                for version in versions_data.get(class="hl-string">'value', []):
                    if version.get(class="hl-string">'versionNumber', 0) > 1: class=class="hl-string">"hl-comment"># Version 1 is the initial draft
                        event = base_event_data.copy()
                        event[class="hl-string">'ActivityName'] = class="hl-string">'Contract Redlined'
                        event[class="hl-string">'EventTime'] = version.get(class="hl-string">'createdDate')
                        event_log.append(event)
        
        class=class="hl-string">"hl-comment"># Handle pagination
        search_params[class="hl-string">'offset'] += len(documents)
        if len(documents) < 100:
            break class=class="hl-string">"hl-comment"># Last page

        time.sleep(1) class=class="hl-string">"hl-comment"># Simple rate limit mitigation
        
    class=class="hl-string">"hl-comment"># 4. Save to CSV
    if not event_log:
        print(class="hl-string">"No events were extracted.")
        return

    class=class="hl-string">"hl-comment"># Sort events by contract and time for logical order
    event_log.sort(key=lambda x: (x[class="hl-string">'ContractId'], x[class="hl-string">'EventTime'] or class="hl-string">''))

    fieldnames = [
        class="hl-string">'ContractId', class="hl-string">'ActivityName', class="hl-string">'EventTime', class="hl-string">'EndTime', class="hl-string">'ContractStatus',
        class="hl-string">'ContractOwner', class="hl-string">'ContractType', class="hl-string">'ContractValue', class="hl-string">'Counterparty',
        class="hl-string">'ExpirationDate', class="hl-string">'CycleTime', class="hl-string">'SourceSystem', class="hl-string">'LastDataUpdate'
    ]
    
    with open(class="hl-string">'docusign_clm_event_log.csv', class="hl-string">'w', newline=class="hl-string">'', encoding=class="hl-string">'utf-8') as csvfile:
        writer = csv.DictWriter(csvfile, fieldnames=fieldnames)
        writer.writeheader()
        writer.writerows(event_log)
        
    print(fclass="hl-string">"Successfully extracted {len(event_log)} events to docusign_clm_event_log.csv")

if __name__ == class="hl-string">"__main__":
    class=class="hl-string">"hl-comment"># --- Execution --- 
    PRIVATE_KEY_PATH = class="hl-string">"./private.key" class=class="hl-string">"hl-comment"># Path to your RSA private key file
    START_DATE = class="hl-string">"2023-01-01T00:00:00Z"
    END_DATE = class="hl-string">"2023-12-31T23:59:59Z"
    
    access_token = get_access_token(PRIVATE_KEY_PATH)
    if access_token:
        extract_event_log(access_token, START_DATE, END_DATE)

准备好开始了吗？

利用此数据模板开启您的流程挖掘之旅，发掘合同管理工作流中的新效率。

返回改进指南下载模板

告别延误：立即优化合同管理

定位低效环节，将周期时间缩短30%，提升合规水平。

开始免费试用

无需信用卡•几分钟即可开始

您的合同管理数据模板

您的合同管理数据模板

合同管理属性

合同管理活动

提取指南

使用DocuSign CLM REST API的Python脚本

步骤

配置

a 示例查询 python

准备好开始了吗？

告别延误：立即优化合同管理

我们重视您的隐私