> 継続的なプロセス改善 > 契約管理 > DocuSign CLM > データテンプレート

契約管理データテンプレート

DocuSign CLM

契約管理の属性(19) 契約管理のアクティビティ(15) データ抽出ガイド(1)

契約管理データテンプレート

このテンプレートでは、契約管理プロセスの分析に必要なデータ項目を体系的にまとめています。収集する基本属性や追跡する主要なアクティビティに加え、データの抽出方法も説明しています。プロセスの詳細な把握と最適化に必要なデータを漏れなく収集するためにお役立てください。

収集を推奨する属性
追跡する主要なアクティビティ
データ抽出の手引き

イベントログを初めて作成する方はこちら：プロセスマイニング用イベントログの作成方法.

テンプレートをダウンロード

契約管理の属性

契約管理プロセスを詳しく分析するため、イベントログに含めることを推奨するデータ項目です。

5 必須 7 推奨 7 任意

	名前	説明
	アクティビティ ActivityName	契約ライフサイクルで発生した特定のタスクまたはイベントの名称。
説明この属性は、契約管理プロセスにおける「契約書の作成」「法務レビューの開始」「契約の締結」など、個々のステップやマイルストーンを表します。これらのアクティビティがプロセスマップを構成します。アクティビティの順序や発生頻度の分析は、プロセスマイニングの基本です。実際のプロセスの流れを把握し、標準手順からの逸脱を見つけ、時間がかかるアクティビティや繰り返し発生するアクティビティを特定できます。重要な理由プロセスの各ステップを定義し、契約ワークフローの可視化と分析を可能にします。ボトルネックやプロセスのばらつきも把握できます。入手先通常は、DocuSign CLMのイベントログまたは監査証跡データから取得します。これらには、契約書やワークフローに対して実行された操作が記録されています。例契約書案の作成社内レビューの開始取引先への送付契約の締結
	契約ID ContractId	システムで管理する各契約を一意に識別するID。
説明契約IDは確定的なケース識別子として機能し、契約の開始から完了までに関連するすべてのイベントとアクティビティを一意に結び付けます。DocuSign CLMでは、エンベロープIDまたは契約識別用に設定したカスタム項目に該当する場合があります。この属性は、個々の契約のエンドツーエンドの行程を再構成するため、プロセスマイニングに欠かせません。関連するすべてのアクティビティを1つの契約IDにまとめることで、分析担当者はプロセスの全体像を可視化し、サイクルタイムを測定し、契約ごとの違いを分析できます。重要な理由関連するすべてのプロセスイベントを結び付ける主キーです。1つの契約のライフサイクル全体を追跡し、分析できます。入手先通常、DocuSign CLMの契約またはエンベロープオブジェクトを識別する主なIDです。「エンベロープ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
	ソースシステム SourceSystem	データの抽出元となるシステムを示します。
説明この属性は、プロセスデータの取得元を示します。このビューでは通常、「DocuSign CLM」などの識別子が設定されます。単一システムの分析では不要に見える場合もありますが、この項目を含めることが推奨されます。CRMの契約データとDocuSignのワークフローデータなど、複数のシステムのデータを統合する際に、データの出所と追跡可能性を明確にできます。重要な理由データの追跡可能性を確保し、複数の基幹システムのデータを組み合わせる分析に欠かせません。入手先通常は、データの抽出・変換時にデータセットの取得元を示す固定値として追加されます。例 DocuSign CLMDocuSign CLM v24.1
	最終データ更新日時 LastDataUpdate	ソースシステムからデータを更新または抽出した最新の日時です。
説明この属性は、データセットが最後に更新された日時を示します。分析に使うデータの新しさや更新状況を把握できます。ダッシュボードやレポートでは、データガバナンスと利用者の信頼を支える情報です。リアルタイムの情報を見ているのか、特定時点のスナップショットを見ているのかを分析担当者が判断できるため、適切なタイミングで意思決定を行ううえで役立ちます。重要な理由データの更新状況を示し、プロセス分析がどの時点のデータに基づいているかを把握できます。入手先これはメタデータ属性です。通常、データ取り込み時にETL（抽出、変換、ロード）ツールまたはデータパイプラインによって生成・保存されます。例 2023-10-26T08:00:00Z2023-10-27T08:00:00Z
	契約ステータス ContractStatus	契約ライフサイクルにおける現在の状態またはステータスです。
説明この属性は、特定時点における契約全体のステータスを示します。たとえば、「下書き」「レビュー中」「署名待ち」「締結済み」などです。プロセスのどの段階にあるかを大まかに把握できます。プロセスマイニングでは、ステータスを分析してケースを絞り込んだり、各段階の契約件数を追跡するダッシュボードを作成したりできます。「契約ステータスのリアルタイム追跡」ダッシュボードでは、この属性を使って進行中の契約全体を可視化し、作業が滞留している箇所を特定します。重要な理由契約の進捗状況を把握でき、ステータスの追跡、業務量の管理、ボトルネックの特定に役立ちます。入手先通常、DocuSign CLMの契約オブジェクトまたはワークフローオブジェクトの主要な属性として確認できます。例下書き社内レビュー中署名待ち締結済み終了
	契約担当者 ContractOwner	契約のライフサイクル全体を管理するユーザーまたは従業員です。
説明契約担当者は、契約の進行を管理し、その責任を負う主な窓口です。通常、契約依頼を開始した人、または取引関係を担当する人が該当します。契約担当者ごとにパフォーマンスを分析すると、効率、手戻り率、サイクルタイムの傾向を把握できます。成果を上げている個人やチームだけでなく、追加の研修や支援が必要な人も特定できます。「契約サイクルタイム分析」などのダッシュボードでデータを分類する際にも重要な属性です。重要な理由個人やチームごとのパフォーマンスを分析し、担当者が行うアクティビティのベストプラクティスや改善点を特定できます。入手先通常は契約オブジェクトに関連付けられたユーザーフィールドで、ワークフローを作成または所有するユーザーの名前が設定されます。例 Alice SmithBob JohnsonCharlie Brown
	契約満了日 ExpirationDate	契約の満了予定日です。
説明この属性には契約上の満了日が保存されます。特に継続収益が発生する契約や長期サービス契約では、契約ポートフォリオを計画的に管理するための重要なメタデータです。この日付は、「契約更新・満了見通し」ダッシュボードの基礎となります。満了が近い契約を監視することで、組織は適切なタイミングで更新ワークフローを開始できます。また、「契約の適時更新率」重要業績評価指標（KPI）の算出にも使われ、収益の逸失やサービスの中断を防ぐのに役立ちます。重要な理由契約を計画的に管理し、適切なタイミングで更新することで、意図しない契約終了を防げます。入手先 DocuSign CLMで契約期間が定められている場合に記録する標準的なメタデータ項目です。例 2024-12-312025-06-302026-01-15
	契約相手方 Counterparty	契約に関与する顧客やベンダーなどの外部当事者です。
説明この属性は、契約に参加する相手方の組織を示します。相手方によって交渉の進め方、法的要件、応答時間が異なり、契約の進行に大きく影響する場合があります。契約相手方ごとにプロセスのパフォーマンスを分析すると、やり取りがスムーズな取引先と、遅延が繰り返し発生する取引先を特定できます。この情報は、関係管理の改善や今後の交渉に向けた現実的な見通しの設定に役立ちます。「契約の手戻りと改訂頻度」分析でも重要な属性です。重要な理由外部の取引先とのやり取りが、交渉期間、改訂回数、全体のサイクルタイムに与える影響を分析できます。入手先契約記録に含まれる基本情報で、通常は「契約相手方名」または「会社」専用のフィールドに保存されます。例 Acme CorporationGlobex Inc.Stark Industries
	契約種別 ContractType	NDA、MSA、SOWなど、契約の分類です。
説明この属性は、法的または業務上の目的に基づいて契約を分類します。契約種別によってワークフローや承認要件が異なり、複雑さにも差があります。契約種別ごとにプロセスを分析することは、パフォーマンスの違いを把握するうえで基本となります。契約の種類ごとにサイクルタイム、コンプライアンス率、交渉の傾向を比較できます。たとえば、NDAは複雑なマスターサービス契約よりもサイクルタイムが大幅に短いはずです。この属性があれば、その比較が可能になります。重要な理由契約の種類ごとに異なるワークフローや複雑さを踏まえ、プロセスのパフォーマンスを比較できます。入手先重要なメタデータ項目です。通常、DocuSign CLMで契約を作成する際に、ドロップダウンリストから選択します。例秘密保持契約（NDA）マスターサービス契約（MSA）作業範囲記述書（SOW）
	契約金額 ContractValue	契約の総額です。
説明この属性は契約の金銭的価値を表し、一括金額または継続的に発生する金額が設定されます。契約金額によって、必要な審査の厳しさや承認経路の複雑さが変わることがあります。契約金額に基づくプロセス分析は、高額案件の優先順位付けや、不必要な遅延の有無を確認するうえで重要です。コンプライアンスの確認にも使えます。たとえば、一定額を超える契約にCFOの承認があるかを検証できます。この属性により、金額面で影響の大きい契約に改善の取り組みを集中できます。重要な理由高額な契約ほど厳格な審査が必要となり、事業への影響も大きいため、優先順位付けやリスク評価に役立ちます。入手先通常、DocuSign CLMの契約メタデータに数値または通貨のフィールドとして設定されます。例 500002500001200000
	終了時刻 EndTime	特定のアクティビティまたはイベントが完了した日時を示すタイムスタンプです。
説明この属性には、アクティビティが完了した正確な日時が記録されます。開始時刻が始まりを示すのに対し、終了時刻は完了を示すため、個々のアクティビティの所要時間を正確に算出できます。終了時刻を分析すると、アクティビティに費やした実作業時間である処理時間を算出できます。これにより、作業時間と待ち時間を区別し、リソース効率や遅延による実際のコストを詳しく把握できます。たとえば、「法務レビュー」アクティビティの正確な所要時間を算出できます。重要な理由個々のアクティビティの所要時間を正確に算出し、実際の処理時間と待ち時間を区別できます。入手先 DocuSign CLMなどのシステムでは、監査証跡に明示的に記録される場合と、後続イベントの開始時刻から推定する場合があります。例 2023-04-15T17:30:00Z2023-05-21T10:00:15Z2023-06-01T11:55:00Z
	手戻りがあったかどうか IsRework	契約で大幅な改訂のやり取りが発生したかどうかを示す真偽値です。
説明この計算属性は、社内承認後に修正のため差し戻された契約など、手戻りが発生した契約を特定します。通常、望ましくない特定のアクティビティの順序を調べて算出します。このフラグを使うと、プロセスの非効率性を簡単に分析できます。「契約の手戻り率」重要業績評価指標（KPI）を直接算出でき、追加の作業が必要だった契約だけを絞り込んで分析できます。初期要件の不明確さや交渉上の難点など、手戻りの根本原因の特定にも役立ちます。重要な理由手戻りの頻度を定量化して分析し、プロセスの非効率性や見えにくいコストを把握できます。入手先プロセスマイニングツールで、手戻りのループを特定するルールを定義して算出します。たとえば、「社内承認を受領」した後に「契約書の修正」イベントが発生するケースを検出します。例 truefalse
	承認ステータス ApprovalStatus	「保留中」「承認済み」「却下」など、承認ステップのステータスです。
説明この属性は、契約ライフサイクルの承認段階に特化した詳細なステータスを示します。契約ステータスがケース全体の状態を示すのに対し、承認ステータスは個々の承認アクティビティの結果を追跡します。「契約承認のボトルネックレポート」と「契約ステータスのリアルタイム追跡」に欠かせない属性です。承認待ちの契約、却下されて手戻りが必要な契約、承認段階を通過した契約を明確に把握できます。ステータスの移行を分析すると、承認経路で問題や遅延が発生している箇所を特定できます。重要な理由承認段階を詳しく把握し、停滞している契約とその原因を特定できます。入手先 DocuSign CLMの承認タスクまたはワークフローステップの結果です。例法務承認待ち財務部門が承認営業担当副社長が却下
	承認段階の所要時間 ApprovalPhaseDuration	承認に関するすべてのアクティビティに費やした合計時間です。
説明この指標は、契約を最初の社内承認に回した時点から、必要な最終承認を得るまでに承認段階で費やした合計時間を算出します。承認関連アクティビティの所要時間を合計する方法と、最初の承認アクティビティの開始から最後の承認アクティビティの終了までの時間を測る方法があります。この属性は「承認段階の平均所要時間」重要業績評価指標（KPI）の中心となる指標です。契約書の作成や交渉ではなく、承認プロセスに起因する遅延を切り分けられます。所要時間を追跡することで、承認マトリクスの影響を把握し、効率化の機会を特定できます。重要な理由承認にかかった時間を切り分け、承認経路におけるボトルネックを特定して対処しやすくします。入手先プロセスマイニングツールで、「社内承認を送信」「社内承認を受領」など、承認に関するすべてのイベントを特定し、ケースごとに最初のイベントから最後のイベントまでの時間を測定して算出します。例 5日2時間10日1時間2日6時間
	文書バージョン DocumentVersion	契約書のバージョン番号です。
説明この属性は、改訂や修正を経る契約書の版を記録します。新しいバージョンをアップロードまたは保存するたびに、番号が増えていきます。文書のバージョンを追跡すると、手戻りの量や交渉の複雑さを直接測定できます。契約書のバージョン数が多い場合、当事者間で何度もやり取りが行われたことを示します。この属性は、「文書の平均改訂回数」重要業績評価指標（KPI）の算出や、「契約の手戻りと改訂頻度」ダッシュボードの分析に使われます。重要な理由文書の改訂回数を追跡し、手戻りの量や交渉にかかった労力を直接測定できます。入手先 DocuSign CLMには文書のバージョン管理機能が組み込まれています。この属性は文書のバージョン履歴から取得できます。例 1234
	法務担当者 LegalCounsel	契約のレビューを担当する法務の専門家またはチームメンバーです。
説明この属性は、契約のレビューと承認を担当する法務部門の具体的な担当者を示します。通常、事業部門側の担当者である契約担当者とは異なります。レビューを特定の法務担当者に割り当てると、法務レビューの工程を詳しく分析できます。「法務レビューのパフォーマンス」ダッシュボードを作成し、法務チームのメンバーごとに処理件数やサイクルタイムを測定・比較できます。その結果を、業務量の調整や法務部門の効率化の機会の特定に役立てられます。重要な理由法務レビューの工程を詳しく分析し、業務量の調整や法務チームのパフォーマンス測定に役立ちます。入手先 DocuSign CLMのワークフローにあるタスク割り当てデータから取得し、「法務レビュー」タスクの担当者を示します。例 Jennifer WaltersMatt MurdockHarvey Specter
	部門 Department	契約を所管する社内の事業部門または部門です。
説明この属性は、契約を開始した、または担当する社内の部門を示します。たとえば、営業、マーケティング、ITなどです。部門ごとにプロセスやニーズが異なるため、契約管理の進め方にも違いが生じます。部門ごとに分析を分類すると、事業の各部門が契約管理プロセスをどのように利用しているかを把握できます。「契約承認のボトルネックレポート」など、部門に合わせたレポートの作成にも役立ちます。遅延が特定の事業部門に集中しているかを確認し、部門のニーズに応じたプロセス改善につなげられます。重要な理由事業部門ごとのパフォーマンスを比較し、効率、コンプライアンス、業務量の違いを把握できます。入手先契約のメタデータ項目として設定される場合と、契約担当者の所属部門から取得する場合があります。例営業法務調達マーケティング
	電子署名済みかどうか IsESigned	契約が電子署名で締結されたかどうかを示す真偽値です。
説明この属性は、DocuSign eSignatureなどの連携済み電子署名ツールで契約が署名されたか、紙への署名とスキャンなどのオフライン方式で締結されたかを追跡します。この属性は「電子署名の導入率」重要業績評価指標（KPI）に直接関係します。電子署名された契約の割合を分析することで、デジタルトランスフォーメーションの取り組みの成果を測定できます。導入率が高いと、通常、締結までの時間短縮、事務コストの削減、コンプライアンスと文書追跡の改善につながります。重要な理由デジタルプロセスの導入状況を測定し、連携済み電子署名機能による効率化の効果を定量化できます。入手先「契約の締結」イベントが、連携済みのDocuSign eSignatureサービスから発生したかどうかを確認して判定できます。例 truefalse

必須推奨任意

契約管理のアクティビティ

契約管理プロセスを正確に把握するため、イベントログに記録する主要なプロセスステップとマイルストーンです。

6 推奨 9 任意

	アクティビティ	説明
	契約の終了	満了、解約、または双方の合意によって契約ライフサイクルが正式に終了したことを示します。多くの場合、システム上でステータスを手動で変更した時点で記録されます。
重要な理由プロセスのもう1つの終了イベントです。契約の終了や満了を追跡することは、契約ライフサイクル全体の把握や更新分析に欠かせません。入手先ユーザーが契約のステータスを「終了」「満了」または「解約」に変更した時点で記録されます。このステータス変更のタイムスタンプを使用します。記録契約の主要ステータスが終了状態に変わった時点から推定します。イベントタイプ inferred
	契約の締結	最後に必要な署名者が文書に署名し、契約が正常に完了したことを示します。DocuSign eSignatureプラットフォームに明示的に記録されます。
重要な理由契約作成プロセスにおける主な完了イベントです。「契約サイクルタイムの平均」の算出や、プロセス全体の処理量の測定に欠かせません。入手先電子署名ワークフローが完了した時点で、完了証明書と文書の監査ログにイベントのタイムスタンプが記録されます。記録最後の署名が行われた時点で、電子署名コンポーネントにより自動的に記録されます。イベントタイプ explicit
	契約依頼の開始	このアクティビティは、契約ライフサイクルの正式な開始を示します。通常、ユーザーが契約依頼フォームを送信するか、DocuSign CLMで新しい契約レコードを作成した時点で記録され、関連するワークフローが開始されます。
重要な理由これはプロセスの主な開始イベントです。このアクティビティを分析することで、契約の全体的な処理量とエンドツーエンドのサイクルタイムの起点を測定できます。入手先監査ログまたはワークフロー履歴から取得します。契約レコードの作成時刻、または受付フォームの送信時刻に対応します。記録契約開始フォームの送信、または新しい契約オブジェクトの作成時に記録されます。イベントタイプ explicit
	契約書を署名依頼として送信	最終承認済みの契約について、電子署名の手続きを開始したことを示します。DocuSignの主要機能の1つであり、ユーザーがDocuSign eSignatureのエンベロープを使って文書を送信した時点で記録されます。
重要な理由契約締結前の重要なマイルストーンです。この時点から締結までの時間を分析すると、署名の回収効率を把握でき、「電子署名の利用率」という重要業績評価指標の測定にも役立ちます。入手先文書の詳細な履歴または監査証跡に明示的に記録される主要イベントです。「エンベロープ履歴」と呼ばれることもあります。記録電子署名のエンベロープが作成され、送信された時点でシステムに直接記録されます。イベントタイプ explicit
	法務レビューの開始	契約を正式に法務部門へ提出し、レビューとフィードバックを依頼した時点を示します。ワークフローが「法務レビュー」段階に入った時点で記録される重要なステップです。
重要な理由法務レビューは契約管理でよく見られるボトルネックです。所要時間の測定は、「法務レビューのパフォーマンス」ダッシュボードの作成や、迅速化の機会の特定に役立ちます。入手先ワークフローの監査証跡から取得します。タスクが法務チームに割り当てられた時刻、または契約のステータスが「法務レビュー中」に変わった時刻が記録されます。記録契約が法務レビューのタスクまたはキューに割り当てられた時点で、ワークフローエンジンに記録されます。イベントタイプ explicit
	社内承認の完了	必要な社内承認者全員が契約を承認したことを示すマイルストーンです。最後の承認者がワークフローのタスクを完了した時点で記録されます。
重要な理由契約が社外との交渉または締結に進める状態になったことを示す重要なマイルストーンです。この時点までの遅れから、社内の合意形成に関する問題を把握できます。入手先承認タスクが最終的に「承認済み」の状態になった時点で、ワークフロー履歴に記録されます。記録順次承認または並行承認のワークフローで、最後の承認者が承認した時点で記録されます。イベントタイプ explicit
	取引先との交渉開始	取引先からフィードバックや修正履歴付きの契約書が返送されたことを示します。外部の相手が新しい文書バージョンをアップロードした場合や、ステータスが社内レビュー段階に戻った場合に推定されます。
重要な理由このアクティビティは、「契約ごとの交渉引き継ぎ回数」という重要業績評価指標の分析に欠かせません。社内チームと取引先の間でやり取りが頻繁に繰り返される場合、交渉が滞っている可能性があります。入手先外部から新しい文書バージョンを受け取った時点、または取引先からフィードバックを受け取ったことを示すためにユーザーが手動でステータスを変更した時点から推定します。記録契約を取引先に送付した後、ステータスが「社内レビュー」または「起草」に戻った時点から推定します。イベントタイプ inferred
	取引先への送付	取引先に契約文書を共有し、レビューと署名を依頼する操作を示します。DocuSign CLM内で「送信」または「共有」の操作を行った時点で記録されます。
重要な理由社外の相手に引き継いだことを示します。この段階ではプロセスを管理できる範囲が限られるため、取引先側での所要時間を把握することが、社外での遅延の特定に役立ちます。入手先監査証跡から取得します。CLMから文書をメールで送信した操作や、外部ポータルで共有した操作などが記録されます。記録プラットフォームの機能を使って、ユーザーが文書を社外と共有した操作を記録します。イベントタイプ explicit
	契約をリポジトリに保管	正式に締結された契約を中央の契約リポジトリに自動的に保管する、最後の事務処理です。通常、署名手続きの完了をきっかけに実行されます。
重要な理由適切な記録管理をもってプロセスを完了させます。締結前のライフサイクルの最終時点であり、締結後の段階の開始を示します。入手先署名済み文書をアーカイブする最終ステップの完了として、ワークフロー履歴から取得します。記録契約締結後の最後の自動ステップとして、ワークフローエンジンに記録されます。イベントタイプ explicit
	契約上の義務のモニタリング開始	締結後の管理を開始し、重要な日付や納品物を追跡するアクティビティです。契約上の義務をモニタリングするタスクまたはサブプロセスを開始した時点で記録されます。
重要な理由「締結後の契約義務遵守率」という重要業績評価指標の測定に欠かせないアクティビティです。署名後に契約上の義務が管理されているかを把握できます。入手先システムの分析が必要です。主契約に関連付けられた、義務追跡タスクまたはワークフローの作成時に記録されると考えられます。記録締結後の義務管理に関するタスクまたはワークフローの作成時に記録されます。イベントタイプ explicit
	契約更新の開始	既存契約の更新プロセスが始まったことを示します。通常、契約責任者が手動で開始するか、契約の満了日を基に自動的に開始されます。
重要な理由「期限内の契約更新率」という重要業績評価指標の追跡に欠かせないアクティビティです。組織が満了を迎える契約をどれだけ早くから管理しているかを把握できます。入手先「契約を更新」操作が行われた時点で記録されます。元の契約に関連付けた新しい契約レコードが作成される場合や、更新ワークフローが開始される場合があります。記録更新ワークフローを開始するユーザー操作または自動トリガーから記録されます。イベントタイプ explicit
	契約書への修正	交渉またはレビューの過程で契約文書に修正や変更が加えられたことを示します。文書の新しいバージョンがアップロードまたは保存されるたびに記録されます。
重要な理由修正の頻度を追跡することは、「契約の手戻り率」という重要業績評価指標の測定に欠かせません。修正回数が多い場合、条項が不明確である、交渉が非効率である、初稿の品質に問題があるといった可能性があります。入手先契約に関連付けられた文書のバージョン履歴から算出します。初稿の後に作成された各バージョンを「契約書への修正」イベントとして扱えます。記録 DocuSign CLMのリポジトリ内で新しい文書バージョンがアップロードまたは作成された時点で記録されます。イベントタイプ explicit
	契約書案の作成	契約文書の初稿を作成し、完成させたことを示します。文書の初版をアップロードまたは作成し、システムに保存した時点で記録できます。
重要な理由このアクティビティを追跡すると、レビュー開始前の起草や準備にかかった時間を把握できます。その後の修正頻度を測定するためのベースラインにもなります。入手先契約の文書履歴にある初版の作成時刻、またはステータスが「起草完了」に変わった時点から推定します。記録契約IDに関連付けられた初版の作成イベントを特定します。イベントタイプ inferred
	社内レビューの開始	作成した契約書案を、財務や業務部門など社内の関係者にレビュー依頼として提出したことを示します。ユーザーがワークフローで「社内レビュー」タスクを開始した時点で記録されます。
重要な理由レビュー段階の開始を示します。この段階はボトルネックになりやすいため、所要時間を分析すると、関係者からのフィードバックの遅れを特定できます。入手先契約のステータスが「社内レビュー」に変わった時点、または法務部門以外の社内ユーザーにレビュータスクが割り当てられた時点で、ワークフロー履歴に記録されます。記録ワークフローが社内業務レビュー用の状態またはタスクに移行した時点で記録されます。イベントタイプ explicit
	社内承認の依頼	レビューを終えた契約を、指定された社内の承認者に正式な承認依頼として送信した時点で発生します。承認ワークフローを開始した時点で記録されます。
重要な理由社内の最終承認段階の開始を示します。この段階の所要時間は、「承認段階の平均所要時間」という重要業績評価指標の主要な要素です。入手先ユーザーが契約を承認依頼として送信し、承認者への割り当てが開始されたときに、ワークフロー履歴に明示的に記録されます。記録「承認依頼を送信」または同様のワークフロー操作が実行された時点で記録されます。イベントタイプ explicit

推奨任意

データ抽出ガイド

DocuSign CLMからデータを取得する方法

ステップ

前提条件とAPIの設定：スクリプトを実行するには、APIアクセスが可能なDocuSign CLMアカウントが必要です。DocuSign Adminで、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。データ処理とCSV出力にはPandasを推奨します。
スクリプトに認証情報を追加：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から返された生のJSONデータを処理します。契約ごとにワークフロー履歴のステップと文書のバージョンを確認し、「法務審査」などのワークフローステップ名や、新しいバージョンのアップロードなどのイベント種別を、イベントログで使う標準のActivityNameに対応付けます（例：「法務審査開始」「契約書の修正」）。
属性の抽出：各アクティビティに必要な属性を抽出します。ContractIdは文書オブジェクトから、EventTimeはワークフローステップのタイムスタンプから取得します。ContractOwner、ContractType、ContractValueなどのメタデータは、文書の属性一覧から抽出します。
推定イベントの処理：明示的なワークフローステップではないイベントを作成するロジックもスクリプトに含めます。たとえば、「取引相手に送信」イベントの後に新しい文書バージョンがアップロードされた場合、「取引相手との交渉開始」を推定します。
CSV出力を作成して確認：すべての契約と履歴を処理したら、データを所定の形式にまとめ、Pandasライブラリでdocusign_clm_event_log.csvというCSVファイルに出力します。このファイルはProcessMindに直接アップロードできる形式です。

設定

API認証情報：JWT認証には、有効なIntegration Key、User ID（GUID）、RSA秘密鍵が必要です。これらをDocuSign Adminで設定し、通常は「signature」と「impersonation」の権限を付与します。
Account ID：DocuSignのAccount IDが必要です。すべてのAPI呼び出しでベースURLに使用します。
日付範囲：スクリプトではcreatedStartDateとcreatedEndDateのパラメーターで契約を絞り込みます。抽出時間を抑え、APIのレート制限を避けるため、まず過去3～6か月などの短い期間から始めることを強く推奨します。
ワークフローの命名規則：スクリプトのロジックでは、「法務審査」や「社内承認」など、ワークフローステップの名前を照合します。組織のDocuSign CLM設定で使われている正確なステップ名に合わせて、スクリプト内のACTIVITY_MAP辞書を変更してください。
APIのレート制限：DocuSignのAPIには、1時間あたりの呼び出し回数に制限があります。スクリプトには影響を抑えるための基本的なtime.sleep()が含まれていますが、大規模なデータセットでは、より高度なバックオフ処理が必要になる場合があります。
前提条件：User IDに紐づくユーザーアカウントには、抽出対象の契約、ワークフロー、文書を閲覧するための十分な権限が必要です。

クエリの例 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スクリプト

ステップ

設定

クエリの例 python

始める準備はできていますか？

遅延を解消：今すぐ契約管理を効率化