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

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

Icertis

契約管理の属性(20) 契約管理のアクティビティ(14) データ抽出ガイド(2)

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

このテンプレートでは、契約管理プロセスの分析に必要なデータを収集する方法を説明します。収集すべき主な属性や追跡するアクティビティ、ソースシステムからデータを抽出する手順をまとめています。プロセスマイニングに必要なデータを漏れなく記録するためにご利用ください。

収集を推奨する属性
追跡する主なアクティビティ
ソースシステムからのデータ抽出手順

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

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

契約管理の属性

契約管理プロセスを詳しく分析するためのイベントログを作成する際に必要となる、基本的なデータ項目です。

3 必須 6 推奨 11 任意

	名前	説明
	契約ID ContractId	Icertisプラットフォームで管理される各契約を一意に識別するIDです。
説明契約IDはケースを特定するための一意な識別子であり、特定の契約に関するすべてのイベントとアクティビティを関連付けます。これにより、契約の開始から完了まで、全行程を分析できます。プロセスマイニングでは、この属性を使って各契約のライフサイクルを再構成します。ドラフト作成、審査、承認、締結など、関連するすべてのアクティビティを適切な契約に紐付けることで、サイクルタイムを正確に測定し、プロセスのばらつきを特定できます。重要な理由プロセス分析の主キーです。契約の全行程を追跡し、データの整合性を保つために使います。入手先 Icertisの契約オブジェクトに含まれる主要な属性です。例 CTR-2023-00123MSA-2024-589ANDA-FN-00451
	アクティビティ名 ActivityName	契約ライフサイクルのある時点で発生した、特定のイベントまたはタスクの名前です。
説明アクティビティ名は、契約管理プロセスにおける特定のステップや節目を示します。タイムスタンプ順に並べることで、契約ごとのプロセスの流れを構成できます。この属性を分析すると、作業の順序、各アクティビティの発生頻度、プロセス全体の構造がわかります。一般的なプロセスの経路、標準手順からの逸脱、複数回の改訂など、手戻りや遅延の原因となるアクティビティの特定に使います。重要な理由プロセスの各ステップを定義します。プロセスマップの可視化、プロセスの流れの分析、ボトルネックの特定に欠かせません。入手先通常、Icertisのイベントログまたはワークフロー履歴テーブルから取得します。これらには、契約のステータス変更や実行されたタスクが記録されています。例契約書のドラフト作成法務審査の完了契約の締結変更契約の開始
	イベント時刻 EventTime	特定の契約アクティビティが発生した日時を示すタイムスタンプです。
説明この属性には、アクティビティの開始または完了日時が正確に記録されます。プロセスマイニングの時間的な基盤となり、各契約のイベントを時系列に並べるために使います。イベント時刻は、時間に基づくあらゆる分析に欠かせません。アクティビティ間のサイクルタイムの算出、待ち時間の特定、交渉や承認など特定の段階にかかる時間の測定、契約が長期間滞留するボトルネックの特定に使います。重要な理由サイクルタイムや所要時間など、すべてのパフォーマンス指標の算出と、イベントの順序の把握に欠かせないタイムスタンプです。入手先 Icertisの監査証跡またはワークフロー履歴ログにある標準項目で、記録された各イベントに関連付けられています。例 2023-05-15T10:22:00Z2023-06-02T14:05:30Z2024-01-10T11:00:00Z
	アクティビティ担当者 ActivityOwner	契約アクティビティの実行を担当するユーザーまたはリソースです。
説明この属性は、アクティビティを実行した個人、チーム、または自動処理用ユーザーを特定します。ユーザー名、従業員ID、システムアカウントなどが該当します。アクティビティ担当者を分析すると、リソースの配置、業務量の分布、パフォーマンスを把握できます。どのユーザーやチームがボトルネックになっているか、レビューが最も効率的な担当者は誰か、業務がどのように分担されているかなどを確認できます。「レビュー担当者の業務量分布」ダッシュボードにも役立ちます。重要な理由ユーザーまたはチームごとのパフォーマンスを分析し、業務量の偏りやトレーニングの必要性を特定できます。入手先通常、Icertisのワークフロー履歴または監査証跡データで、各イベントに関連付けられています。例 John SmithLegal.Review.QueueSystem.AutoApproveSarah Chen
	契約ステータス ContractStatus	ライフサイクルにおける契約の現在の状態または段階です。
説明この属性は、契約案件全体のステータスを示します。たとえば、「下書き」「レビュー中」「署名待ち」「締結済み」などです。通常は案件単位の属性で、最後に到達した主要なマイルストーンを反映します。契約パイプラインの状況をリアルタイムで把握する「契約ステータスと処理量」などの業務ダッシュボードに欠かせません。各段階にある契約の件数や、業務が滞留している箇所を管理者が把握し、契約ポートフォリオを先回りして管理できます。重要な理由契約パイプラインの全体像を把握でき、業務のモニタリングや処理量の管理に役立ちます。入手先 IcertisのContract Agreementオブジェクトにある主要なステータス項目です。例下書き社内レビュー中締結済み終了
	契約種別 ContractType	基本サービス契約や秘密保持契約など、契約の分類です。
説明契約種別は、法的または事業上の目的に基づいて契約を分類する属性です。契約のライフサイクルを分類・比較するための基本情報です。契約種別によってプロセスの流れや複雑さ、SLAは異なります。契約種別ごとに分析すれば、件数が多くリスクの低い秘密保持契約には効率化したワークフローを適用し、複雑で金額の大きい基本サービス契約には別の対応を検討するなど、対象を絞った改善が可能です。「契約バリアント分析」や「ポリシーコンプライアンススコア」の重要な指標です。重要な理由契約の種類ごとにプロセスを分類し、ライフサイクルやコンプライアンスを比較できます。入手先 IcertisのContract Agreementオブジェクトに標準属性として設定されています。例基本サービス契約（MSA）秘密保持契約（NDA）作業範囲記述書（SOW）
	契約金額 ContractValue	契約の総額です。
説明この属性は、契約の総額や年換算額など、契約の金銭的価値を示します。契約の優先順位付けや財務への影響を把握するための重要な業務指標です。プロセスマイニングでは、契約金額に基づいて分析対象を分類し、高額契約に焦点を当てる際に使います。たとえば、高額契約の承認や交渉に時間がかかっているかを分析できます。また、高額契約の遅延が売上に大きく影響する場合のリスク評価にも役立ちます。重要な理由契約の金額に基づく優先順位付けと分析が可能になり、財務への影響が大きい契約に改善の取り組みを集中できます。入手先通常、IcertisのContract Agreementオブジェクトにある標準の通貨項目です。例 50000.001250000.002500.00
	担当者の所属部門 OwnerDepartment	アクティビティ担当者が所属する部門です。
説明この属性は、アクティビティを実行したユーザーが所属する法務、営業、調達などの部門を示します。プロセスに関与するリソースを集約して把握できます。部門別の分析は、部門間の連携や引き継ぎ状況を把握するうえで重要です。たとえば、営業からの申請後に法務レビューまで長く待たされるなど、部門間で生じる恒常的な遅延を特定できます。「部門間の引き継ぎ遅延」ダッシュボードで確認できます。重要な理由部門ごとのパフォーマンスや引き継ぎの効率を分析し、部門横断のボトルネックを特定できます。入手先アクティビティ担当者をキーとして、人事システムまたはユーザーディレクトリと結合し、データを補完する場合があります。Icertisのユーザープロフィールに直接保存されていることもあります。例法務営業調達財務
	終了時刻 EndTime	特定の契約アクティビティが完了した日時です。
説明この属性は、アクティビティの完了時刻を記録します。StartTimeが開始を示すのに対し、EndTimeは終了を示し、アクティビティの時間範囲を定義します。各アクティビティの処理時間や所要時間を正確に算出するには、開始時刻と終了時刻の両方が必要です。どのステップに最も時間がかかるかを分析し、実際の処理時間とステップ間の待ち時間を区別できます。「承認プロセスのボトルネック」や「起案・修正の効率」などのダッシュボードで重要な情報です。重要な理由アクティビティの所要時間を正確に算出し、処理時間と待ち時間を区別できます。入手先 StartTimeと同様に、Icertisの監査証跡またはワークフロー履歴ログから取得します。イベントによっては瞬時に完了するため、StartTimeとEndTimeが同じ場合があります。例 2023-05-15T18:30:00Z2023-06-03T09:00:15Z2024-01-10T11:00:00Z
	SLAステータス SLAState	アクティビティまたは案件がサービスレベル合意（SLA）の条件を満たしているかを示します。
説明この属性は、特定のプロセス段階の所要時間を、あらかじめ定めたSLA目標と比較して算出します。たとえば、法務レビューが標準の48時間を超えた場合、「遅延」と判定できます。 SLAステータスは、コンプライアンスの監視やパフォーマンス管理に欠かせません。「契約コンプライアンスの概要」などのアラートやダッシュボードを作成し、違反をすぐに把握できます。チームは期限超過のタスクに優先して対応でき、管理者は主要な目標に対するパフォーマンスを追跡できます。重要な理由サービスレベル目標の達成状況をすぐに把握でき、業務の優先順位付けやパフォーマンス管理に役立ちます。入手先プロセスマイニングツールでビジネスルールを定義し、タイムスタンプを事前設定したSLAのしきい値と比較して算出します（例：法務レビューの所要時間が2日を超える）。例期限内リスクあり遅延
	ソースシステム SourceSystem	契約データの抽出元となるシステムです。
説明この属性はデータの取得元を示します。このプロセスでは「Icertis」です。データガバナンスとトレーサビリティに役立ちます。特に、複数のシステムからデータを集約する環境で有用です。分析では、特定のソースシステムのデータに絞り込んだり、必要に応じてシステム間でプロセスを比較したりする際に利用できます。このビューでは、すべてのイベントに共通する識別子として機能します。重要な理由データの来歴とトレーサビリティを確保します。データの検証や複数のソースから取得したデータの管理に役立ちます。入手先通常は、データの取得元を示すために、データの抽出・変換処理で設定される固定値です。例 IcertisIcertisCLM
	事業部門 BusinessUnit	契約に関連する社内の事業部門です。
説明この属性は、契約を所管または申請した社内の部門や事業部門を示します。たとえば、「北米エンタープライズ営業」や「グローバル調達」などです。部門と同様に、プロセスデータをより上位の単位で集約できます。組織内の各部門におけるプロセス効率やコンプライアンスを比較でき、経営層の判断や戦略的なリソース配分に役立つインサイトが得られます。重要な理由組織内の事業部門間で、プロセスのパフォーマンスを上位レベルで比較できます。入手先契約を組織構造に関連付けるため、契約合意書の主要なメタデータ項目として設定されていることがよくあります。例 BU-North AmericaGlobal ServicesProduct Development
	修正回数 RevisionCount	契約の修正回数の合計です。
説明この計算指標は、契約案件ごとに「契約書の変更・修正」など、修正に関するアクティビティの回数を集計します。プロセス上の摩擦を把握するための、わかりやすい指標です。修正回数が多い場合、要件が不明確、初稿の品質が低い、交渉が難航しているなど、起案や交渉段階に問題がある可能性があります。この指標は「契約修正率」KPIの直接の入力値となり、手戻りが多い契約やプロセスバリアントをダッシュボードで特定する際に使われます。重要な理由契約のライフサイクルで発生する手戻りを数値化し、起案や交渉段階の効率を直接測定します。入手先イベントログで、各「ContractId」に対する特定の修正アクティビティの発生回数を数えて算出します。例 1503
	最終データ更新日時 LastDataUpdate	プロセスのデータが最後に更新された日時です。
説明この属性は、分析対象データの鮮度を示します。ソースシステムから最後にデータを抽出した日時を記録します。ダッシュボードに表示されるインサイトがどの時点の情報に基づいているかを把握するうえで重要です。リアルタイムの情報なのか、数時間または数日前のデータなのかを確認でき、意思決定に必要なコンテキストを得られます。重要な理由データの鮮度を把握し、プロセス分析がどの時点の情報に基づいているかを確認できます。入手先データパイプラインまたはETLツールが、データ更新サイクルの正常終了時にこのタイムスタンプを生成します。例 2024-07-27T08:00:00Z2024-07-26T23:59:59Z
	取引先名 CounterpartyName	契約における顧客やベンダーなど、社外の相手方の名前です。
説明この属性は、契約の相手方を特定します。やり取りや交渉を分析するための重要なコンテキストを提供します。取引先別にプロセスを分析すると、交渉サイクルの傾向がわかります。たとえば、特定のベンダーとの契約で交渉が常に長引く、または修正回数が多いといった状況を確認できます。このインサイトは、戦略的な取引先管理や交渉方針の調整に役立ち、「交渉サイクルタイムと手戻り」ダッシュボードを支えます。重要な理由特定の社外関係者との交渉パターンや取引関係のパフォーマンスを分析できます。入手先通常、契約のメタデータに保存され、Icertisの取引先またはベンダーのマスターデータオブジェクトに関連付けられています。例 Acme CorporationGlobal Tech Inc.Innovate Solutions LLC
	地域 Region	契約に関係する地理的な地域です。
説明この属性は、契約が適用される地域を示します。たとえば、EMEA、APAC、北米などです。地域ごとにプロセスが異なるグローバル組織では重要な情報です。地域別に分析すると、現地の法律や商習慣によるプロセスパフォーマンス、コンプライアンス要件、交渉方針の違いを明らかにできます。地域ごとのベンチマークを行い、世界各地で共有できるベストプラクティスを特定できます。重要な理由地域ごとのプロセスパフォーマンスやコンプライアンスの違いを特定でき、グローバル組織の分析に役立ちます。入手先通常、Icertisの契約オブジェクトにあるメタデータ項目で、標準設定に含まれていることがよくあります。例 EMEA北米APACLATAM
	契約上の義務の期限 ObligationDueDate	契約上の特定の義務を履行する期限です。
説明この属性は、契約締結後に契約で定められた主要な義務、約束事項、納品物の期限を追跡します。1つの契約に複数の義務が含まれる場合、それぞれに期限が設定されます。契約締結後のコンプライアンスとリスク管理には、期限の追跡が欠かせません。この属性は「義務遵守率」KPIの基礎となり、組織が約束を期限どおりに履行しているかを確認し、違反の可能性に先回りして対処できます。重要な理由契約締結後のコンプライアンスを監視し、違約金を避け、良好な取引関係を維持するのに役立ちます。入手先 Icertisには義務管理のモジュールがあります。このデータは契約に関連付けられた義務から取得できます。例 2024-09-302025-01-152024-11-01
	文書バージョン DocumentVersion	契約文書のバージョン番号です。
説明この属性は、契約文書の起案、変更履歴の記録、修正の過程での版を追跡します。通常は整数、またはメジャー・マイナー形式のバージョン番号です。文書バージョンは、手戻りを直接示す指標です。契約のバージョン数が多い場合、変更が何度も行われたことを示しており、原因を調査できます。「契約修正率」KPIの算出や、「起案・修正の効率」ダッシュボードに必要なデータです。重要な理由契約で発生した手戻りや修正の量を直接測定し、起案や交渉における非効率を明らかにします。入手先 Icertisはすべての契約文書のバージョン履歴を保持します。この属性は、文書のメタデータまたはイベントログから取得できます。例 1.02.34.00.5
	有効期限 ExpirationDate	契約の有効期限です。
説明この属性には、契約期間の終了日が保存されます。契約締結後のライフサイクル管理に欠かせない日付であり、更新または終了に関するアクティビティの開始に利用されます。契約終了時の管理状況を確認するうえで重要です。「期限内更新・終了率」KPIのベースラインとなり、更新または終了のプロセスが適切な時期に開始・完了しているかを測定します。意図しない自動更新やサービスの中断を防ぐのに役立ちます。重要な理由契約の更新や終了を管理し、契約期間終了時の手続きを先回りして進めるうえで重要です。入手先 IcertisのContract Agreementオブジェクトにある標準の日付項目です。例 2025-12-312026-06-302024-08-15
	標準テンプレートの使用有無 IsStandardTemplate	会社の標準テンプレートから契約を作成したかどうかを示すフラグです。
説明この真偽値属性は、事前承認済みの標準テンプレートを使って契約を作成したか、標準外の個別契約として作成したかを示します。リスクとコンプライアンスを評価するうえで重要な要素です。標準テンプレートを使った契約は、通常、サイクルタイムが短くリスクも低くなります。この属性は「契約テンプレート遵守率」KPIの基礎となり、標準外の契約書を使うことがプロセスに与える影響の分析にも役立ちます。標準から逸脱することの多い部門や契約種別を特定し、テンプレートの利用を促す取り組みにつなげられます。重要な理由社内基準への準拠状況を測定し、プロセス効率の向上とリスク低減につなげます。入手先 Icertisの契約にあるチェックボックス項目、または文書の取得元やメタデータに基づいて判定できます。例 truefalse

必須推奨任意

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

契約ライフサイクルを正確に把握、分析するためにイベントログで追跡する、主なプロセスの手順と節目です。

6 推奨 8 任意

	アクティビティ	説明
	取引先の承認を受領	社外の取引先が契約条件に合意し、最終版を承認したことを示します。コラボレーションポータルから明示的なイベントとして記録される場合と、契約担当者がステータスを手動で更新する場合があります。
重要な理由この節目で交渉段階が終了します。「平均交渉サイクルタイム」の重要業績評価指標（KPI）を算出する終点となり、社外とのやり取りの効率を把握できます。入手先取引先がIcertisポータルで承認した場合は、明示的なイベントとして記録できます。それ以外の場合は、ステータスが手動で「取引先承認済み」に変更されたことから推定します。記録取引先ポータルから記録されるイベント、または社内ユーザーによる手動のステータス更新です。イベントタイプ explicit
	契約の終了または満了	契約のライフサイクルの終了を示します。契約終了手続きによる場合と、満了日を迎える場合があります。終了は明示的なイベントですが、満了は契約のメタデータに基づいて算出されるイベントです。
重要な理由契約ライフサイクルの最終イベントです。更新率の分析や「期限内更新・終了率」の重要業績評価指標（KPI）の測定に欠かせません。入手先ユーザーが終了操作を行うと、終了イベントが明示的に記録されます。満了は、現在の日付と「満了日」属性を比較して算出できます。記録システムの日付と契約の満了日を比較するか、手動で記録された終了イベントに基づいて算出します。イベントタイプ calculated
	契約の締結	すべての当事者が署名し、契約が正式に締結されたことを示すアクティビティです。署名前のプロセスにおける主な完了地点であり、電子署名プラットフォームとの連携を通じて記録されます。
重要な理由主な完了イベントであり、「平均契約サイクルタイム」の重要業績評価指標（KPI）の終点です。契約が法的拘束力を持ち、有効になる時点を示します。入手先すべての当事者の署名手続きが完了すると、電子署名プラットフォームから明示的なイベントが送信され、Icertisに記録されます。記録電子署名プラットフォームとの連携から送信されるコールバックイベントです。イベントタイプ explicit
	契約依頼の開始	このアクティビティは、業務担当者が新しい契約を正式に依頼する、契約ライフサイクルの開始を示します。通常、Icertisプラットフォームで契約依頼フォームが送信された時点で、明示的なイベントとして記録されます。
重要な理由プロセスの開始を示すこのイベントは、契約サイクルタイム全体の測定に欠かせません。依頼の件数や種類を分析すると、リソース計画や需要管理に役立ちます。入手先 Icertisで「契約依頼」オブジェクトが作成され、送信されたときに記録される明示的なイベントです。記録契約依頼フォームの送信時に記録されるイベントです。イベントタイプ explicit
	法務審査の完了	法務部門が契約の審査を完了したことを示します。通常、法務審査担当者が承認ワークフローで割り当てられたタスクを完了した時点で、明示的なイベントとして記録されます。
重要な理由このアクティビティは、法務審査の所要時間を測定し、法務チームのキャパシティ不足の可能性を特定するうえで重要です。「法務審査の待ち時間」の重要業績評価指標（KPI）にも役立ちます。入手先 Icertisのワークフローで法務審査タスクが「完了」になったときに明示的に記録されます。「法務承認済み」などへのステータス変更から推定する場合もあります。記録ワークフローエンジンから記録される、「法務審査」タスクの完了イベントです。イベントタイプ explicit
	社内承認の取得	必要な社内関係者全員が契約を承認し、社外との交渉または署名に進める状態になったことを示す節目です。承認ワークフロー全体のステータスが最終状態の「承認済み」になったことから推定します。
重要な理由社内審査サイクルを締めくくる重要な節目です。「平均承認段階所要時間」の重要業績評価指標（KPI）の終点となります。入手先ワークフローのステータスが「完全承認済み」などに変わり、すべての承認タスクが完了したことを示す情報から推定します。記録最後の社内承認タスクが完了したタイムスタンプ、またはワークフロー全体のステータス変更時刻です。イベントタイプ inferred
	取引先との交渉開始	契約書を審査と交渉のために社外の取引先へ共有した時点を示します。契約ステータスが「交渉中」に変わったことや、文書を初めて社外に送信した監査ログから推定されることがよくあります。
重要な理由交渉段階の開始を示すアクティビティです。「平均交渉サイクルタイム」の重要業績評価指標（KPI）を算出する起点となります。入手先ステータスが手動で「交渉中」に変更されたこと、または文書が外部ポータルで初めて共有されたイベントから推定します。記録ステータスが「交渉中」または「取引先に送信済み」に変わったタイムスタンプです。イベントタイプ inferred
	変更契約の開始	有効な契約を変更する正式なプロセスの開始を示します。ユーザーが締結済みの元契約に関連付けて変更契約レコードを作成した時点で記録されます。
重要な理由変更契約は、大幅な手戻りや適用範囲の変更を示します。発生頻度とサイクルタイムを追跡すると、契約の安定性や管理効率に関するインサイトが得られます。入手先「変更契約」オブジェクトまたは同様のレコードが作成され、既存の契約に関連付けられたときに、明示的なイベントとして記録されます。記録 Icertisシステムで変更契約レコードが作成されたことを示します。イベントタイプ explicit
	契約の更新	既存の契約が次の契約期間に向けて更新されたことを示します。システム内で明示的に実行される操作であり、新しい契約レコードの作成や既存レコードの更新を伴うことがよくあります。
重要な理由このアクティビティは、契約更新プロセスの有効性を評価するうえで重要です。「期限内更新・終了率」の重要業績評価指標（KPI）の算出に使われます。入手先 Icertisの契約レコードでユーザーが「更新」アクションを実行したときに生成される明示的なイベントです。記録ユーザーが開始した「更新」処理から記録されるイベントです。イベントタイプ explicit
	契約書のドラフト作成	テンプレートまたは新規ファイルから、契約書の初稿を作成したことを示します。このイベントは、契約ワークスペースに関連付けられた主要な契約文書の作成時、または初回アップロード時の情報から推定されることがよくあります。
重要な理由このアクティビティを追跡すると、初稿の準備にかかった時間を測定できます。ドラフト作成の効率やテンプレートの使用状況を分析するうえで重要なステップです。入手先 Icertisの契約ワークスペースまたは契約オブジェクト内にある主要な契約文書の作成タイムスタンプから推定します。記録主要な契約文書の初版が作成されたタイムスタンプを特定します。イベントタイプ inferred
	契約書の修正・改訂	社内審査または社外との交渉中に契約文書が変更されるたびに発生するアクティビティです。Icertisでは文書のバージョンが追跡されるため、新しいバージョンが登録されるたびに改訂イベントとして記録できます。
重要な理由契約ごとにこれらのイベントを数えると、「契約改訂率」の重要業績評価指標（KPI）を算出できます。改訂回数が多い場合、表現の曖昧さ、非効率な交渉、認識のずれが考えられます。入手先 Icertisの文書管理モジュールで、契約文書の新しいバージョンがアップロードまたは登録されるたびに明示的に記録されます。記録文書の新しいバージョン番号ごとにイベントが作成されます。イベントタイプ explicit
	社内審査の開始	このアクティビティは、社内審査と承認ワークフローの開始を示します。契約書のドラフトが、部門長や財務部門などの社内関係者に正式に審査依頼された時点で記録されます。
重要な理由承認段階の開始を示します。この段階ではボトルネックが発生することがよくあります。このイベントからの経過時間を分析すると、社内連携の開始が遅れる原因を特定できます。入手先 Icertisのワークフローで「審査に提出」アクションが実行されたときに明示的なイベントとして記録するか、ステータスが「社内審査中」に変わったことから推定します。記録ユーザーが社内審査ワークフローを開始した時点で記録されます。イベントタイプ explicit
	署名のために契約書を送信	最終承認済みの契約書を電子署名または書面での署名に回したことを示します。DocuSignやAdobe Signなどの電子署名プラットフォームとの連携を通じて、明示的なイベントとして記録されます。
重要な理由このイベントを追跡すると、最終的な締結手順の効率を分析できます。承認から署名依頼の送信までに遅れがある場合、事務処理上のボトルネックが考えられます。入手先 Icertis内から署名手続きを開始したときに、電子署名ソリューションとのAPI連携を通じて明示的に記録されます。記録署名依頼の送信時に、電子署名コネクターから記録されるイベントです。イベントタイプ explicit
	義務のモニタリングを開始	契約締結後、契約上の義務や約束事項をシステムで追跡できる状態になったことを示すアクティビティです。通常、契約締結時に自動で、または契約管理者が手動で開始したときに明示的なイベントとして記録されます。
重要な理由このイベントを起点に、契約締結後の管理期間を測定します。「義務履行率」の重要業績評価指標（KPI）を通じて、コンプライアンスを測定し、確保するうえで重要です。入手先契約のステータスが「アクティブ」または「締結済み」になったときに、Icertisの義務管理モジュールで明示的なイベントとして記録されます。記録契約に関連付けられた義務レコードを自動または手動で有効化します。イベントタイプ explicit

推奨任意

データ抽出ガイド

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

ステップ

Icertisのレポートモジュールにアクセス：Icertis ICIプラットフォームにログインします。通常はメインメニューにある「分析」または「レポート」モジュールを開きます。レポートの作成と実行には、適切なユーザー権限が必要です。
新しいレポートを作成：新しいレポートの作成を開始し、対象となる主要なビジネスオブジェクトを選択します。契約管理の場合は通常、「契約合意」オブジェクト、または契約の中心となるワークスペースを表す同等のエンティティを選びます。
レポートのデータソースを指定：必要な情報をすべて取得できるよう、関連するデータオブジェクトを追加します。バージョン情報の「契約文書」、レビュー状況の「承認ワークフロー」、ステータス変更の「監査履歴」、契約実行後のアクティビティの「義務」などを含めます。
レポートの項目を選択：レポートの列を設定します。この手順では、Icertisの項目を必要なイベントログの構造に対応付けます。主なアクティビティごとに個別の行を作成するため、ユニオンレポートまたは複合レポートを作成する必要があります。各アクティビティの項目の対応付けについては、「クエリ」セクションの設定を参照してください。
アクティビティとタイムスタンプのロジックを設定：各アクティビティについて、「ActivityName」列と「EventTime」列に値を設定するロジックを定義します。たとえば、「契約締結」では「ActivityName」に固定のテキストを設定し、「EventTime」には「契約合意」オブジェクトの「締結日」項目を対応付けます。ステータス変更から導出するアクティビティには、そのステータスが設定された日時を記録する項目を使います。
レポートにフィルターを適用：抽出対象を絞り込むフィルターを設定します。データセットを運用しやすい規模に保つため、たとえば「契約作成日」を過去6～12か月に限定するなど、期間を指定してください。必要に応じて「契約ステータス」（例：下書きを除外）や「契約タイプ」でも絞り込めます。
レポートを実行してプレビュー：Icertisのユーザーインターフェースでレポートを実行します。最初の数百行をプレビューし、各列に想定どおり値が入り、同じ契約IDの異なるアクティビティが別々の行に表示されることを確認します。
レポートをエクスポート：プレビューを確認したら、レポート全体をエクスポートします。プロセスマイニングツールに取り込みやすいCSV形式を選択してください。
必要に応じてデータを結合、整形：Icertisのレポート機能で全イベントを1つのレポートにまとめられない場合は、アクティビティの種類ごとにレポートを作成してエクスポートします。その場合は、スクリプト言語や表計算ソフトなどを使ってレポートを縦方向に結合し、すべてのファイルで列名を統一してください。最終的な出力は1つのCSVファイルにします。
アップロードの準備：最終的なCSVファイルを確認します。列見出しが必要な属性（ContractId、ActivityName、EventTime、EndTime、ActivityOwnerなど）と一致していることを確認してください。日時の形式がISO 8601などに統一されていることも確認します。これでProcessMindにアップロードできます。

設定

前提条件：Icertis ICIプラットフォームにアクセスでき、契約合意や関連オブジェクトのレポートを作成、実行できるユーザーロールと権限が必要です。
レポートの種類：複数の関連オブジェクト（契約、文書、ワークフロー、監査履歴）からデータを取得し、1つのアクティビティログにまとめられる複合レポートまたはユニオンレポートを使用します。対応できない場合は、個別のレポートを複数作成する必要があります。
主なデータオブジェクト：レポートは「契約合意」を基に作成し、「契約文書」「承認ワークフロー」「ユーザー」、必要に応じて「監査履歴」を結合して、必要なイベントのタイムスタンプと詳細を取得します。
期間の絞り込み：エクスポートのサイズと処理性能を考慮し、必ず期間を指定してください。まずは「契約作成日」または「締結日」を基準に、過去6～12か月に絞ることをおすすめします。
アクティビティの絞り込み：特定のアクティビティが発生した時点を正しく特定するため、「契約ステータス」や「承認ステータス」などの項目で絞り込む必要がある場合があります。プロセス全体を把握できるよう、対象データには進行中と完了済みの契約を含めてください。
項目の選択：必要な項目だけを明確に選択してください。列を増やしすぎると、レポートの作成やエクスポートに時間がかかることがあります。イベントログに必要な属性と推奨属性を中心に選びます。

クエリの例 sql

/*
 This is a configuration guide for building the extraction report in the Icertis Reporting Module UI.
 Icertis reports are configured through a graphical interface, not a script.
 Create a single composite report that generates one row for each of the following activity blocks.
 The common fields should be mapped for every block.

 Common Field Mappings:
 - ContractId: Map to 'Contract Agreement'.'ID' or 'Contract Number'
 - OwnerDepartment: Map to 'Contract Agreement'.'Owning Department'
 - ContractType: Map to 'Contract Agreement'.'Agreement Type'
 - ContractStatus: Map to 'Contract Agreement'.'Status'
 - ContractValue: Map to 'Contract Agreement'.'Contract Value' or 'Total Value'
*/

// Block 1: Contract Request Initiated
{
  "ActivityName": "Contract Request Initiated",
  "EventTime": "'Contract Agreement'.'Request Date'",
  "ActivityOwner": "'Contract Agreement'.'Created By'"
}

// Block 2: Contract Drafted
{
  "ActivityName": "Contract Drafted",
  "EventTime": "'Primary Agreement Document'.'Created On'",
  "ActivityOwner": "'Primary Agreement Document'.'Created By'"
}

// Block 3: Internal Review Started
{
  "ActivityName": "Internal Review Started",
  "EventTime": "'Approval Workflow'.'Workflow Start Date'",
  "ActivityOwner": "'Contract Agreement'.'Owner'"
}

// Block 4: Legal Review Conducted
{
  "ActivityName": "Legal Review Conducted",
  "EventTime": "'Legal Review Task'.'Completion Date'",
  "ActivityOwner": "'Legal Review Task'.'Assigned To'"
}

// Block 5: Contract Redlined Or Revised
{
  "ActivityName": "Contract Redlined Or Revised",
  "EventTime": "'Agreement Document Version'.'Created On'",
  "ActivityOwner": "'Agreement Document Version'.'Created By'"
}

// Block 6: Internal Approvals Obtained
{
  "ActivityName": "Internal Approvals Obtained",
  "EventTime": "'Approval Workflow'.'Workflow End Date'",
  "ActivityOwner": "'Approval Workflow'.'Last Approver'",
  "FilterCondition": "'Approval Workflow'.'Status' = 'Approved'"
}

// Block 7: Counterparty Negotiation Started
{
  "ActivityName": "Counterparty Negotiation Started",
  "EventTime": "'Contract Agreement'.'Negotiation Start Date'",
  "ActivityOwner": "'Contract Agreement'.'Owner'"
}

// Block 8: Counterparty Approval Received
{
  "ActivityName": "Counterparty Approval Received",
  "EventTime": "'Contract Agreement'.'Counterparty Approval Date'",
  "ActivityOwner": "'Contract Agreement'.'Owner'"
}

// Block 9: Contract Sent For Signature
{
  "ActivityName": "Contract Sent For Signature",
  "EventTime": "'E-Signature Package'.'Sent Date'",
  "ActivityOwner": "'E-Signature Package'.'Sent By'"
}

// Block 10: Contract Executed
{
  "ActivityName": "Contract Executed",
  "EventTime": "'Contract Agreement'.'Execution Date'",
  "ActivityOwner": "'Contract Agreement'.'Owner'"
}

// Block 11: Obligations Monitoring Activated
{
  "ActivityName": "Obligations Monitoring Activated",
  "EventTime": "'Obligation'.'Activation Date'",
  "ActivityOwner": "'Obligation'.'Owner'"
}

// Block 12: Amendment Initiated
{
  "ActivityName": "Amendment Initiated",
  "EventTime": "'Amendment Agreement'.'Request Date'",
  "ActivityOwner": "'Amendment Agreement'.'Created By'"
}

// Block 13: Contract Renewed
{
  "ActivityName": "Contract Renewed",
  "EventTime": "'Contract Agreement'.'Renewal Date'",
  "ActivityOwner": "'Contract Agreement'.'Owner'"
}

// Block 14: Contract Terminated Or Expired
{
  "ActivityName": "Contract Terminated Or Expired",
  "EventTime": "COALESCE('Contract Agreement'.'Termination Date', 'Contract Agreement'.'Expiry Date')",
  "ActivityOwner": "'Contract Agreement'.'Owner'"
}

ステップ

前提条件とセットアップ：pandasとrequestsライブラリとともに、Python 3.6以降がインストールされていることを確認します。Icertisの管理者から、クライアントID、クライアントシークレット、IcertisインスタンスのベースURLなどのAPI認証情報を入手してください。これらの認証情報には、契約データと監査ログデータへの読み取り権限が必要です。
Pythonスクリプトを初期化：新しいPythonファイルを作成します。必要なライブラリ（requests、pandas、json、datetime）をインポートし、スクリプトの先頭でIcertisのベースURL、API認証情報、抽出対象期間を設定するプレースホルダー変数を定義します。
認証を実装：Icertis APIの認証を処理する関数を作成します。この関数でクライアントIDとシークレットを使ってIcertisのトークンエンドポイントにPOSTリクエストを送り、ベアラートークンを取得します。このトークンは、以降のすべてのAPIリクエストのヘッダーに含める必要があります。
契約一覧を取得：指定期間内に作成または変更された契約の一覧を取得する関数を作成します。たとえば、主要な契約APIエンドポイント/api/v1/contractsにGETリクエストを送信し、クエリパラメーターで期間を指定します。
ページネーションを処理：Icertis APIでは、オブジェクト一覧を返すエンドポイントの結果が複数ページに分かれます。APIレスポンスにnextLinkなどのページネーショントークンがあるか確認し、すべての契約を取得するまで各ページを順に処理するスクリプトを作成します。
契約履歴を順に取得：前の手順で取得した契約IDごとに、/api/v1/contracts/{id}/historyなど、詳細な履歴や監査履歴を返すエンドポイントを呼び出します。このエンドポイントには、プロセスマイニングに必要な生のイベントデータが含まれます。
イベントをアクティビティに対応付け：ここがデータ変換の中心となる手順です。各契約の履歴項目を順に処理し、条件分岐（if/elif文）を使って、APIの生のイベント説明をイベントログで必要な標準アクティビティ名に対応付けます。たとえば、説明が「ステータスが締結済みに変更」のAPIイベントは、ActivityNameの「契約締結」に対応付けます。
データを構成：関連するイベントを処理するたびに、必要な属性ContractId、ActivityName、EventTimeを含む辞書を作成します。また、契約マスターデータとイベントデータから取得したActivityOwnerやContractTypeなどの推奨属性も含めます。
データを集約してDataFrameを作成：イベントごとの辞書をすべてリストに追加します。すべての契約と履歴を処理したら、この辞書リストをpandasのDataFrameに変換します。これにより、イベントログを表形式で整理できます。
最終整形とエクスポート：DataFrameを整え、特にタイムスタンプを含む各列のデータ型が正しいことを確認します。必要に応じてNULL値を処理します。最後にto_csvメソッドでindex=Falseを指定し、DataFrameをCSVファイルにエクスポートします。このCSVファイルをProcessMindにアップロードできます。

設定

API認証情報：APIユーザーまたはサービスアカウントが必要です。対象となるすべての契約タイプについて、契約オブジェクト、関連文書、契約監査履歴全体への読み取り権限が必要です。
期間：スクリプトにはSTART_DATEとEND_DATEの変数が含まれます。データを検証し、処理性能を保つため、まずは3～6か月など短い期間から始めることをおすすめします。過去の全データを読み込む場合は、複数回に分けてスクリプトを実行する必要があります。
APIエンドポイントの設定：スクリプトでは/api/v1/contractsや/api/v1/contracts/{id}/historyなどのプレースホルダーエンドポイントを使用します。IcertisのAPI文書で、正しいエンドポイントURLとバージョンを確認してください。
アクティビティの対応付けロジック：スクリプト内で、生のイベント説明を標準アクティビティ名に対応付ける処理が重要です。Icertisインスタンスで設定されているイベント説明、カスタムステータス、ワークフローに応じて、この部分を調整する必要があります。
レート制限：IcertisによるAPIのレート制限にご注意ください。HTTP 429（リクエスト過多）への基本的なエラー処理をスクリプトに含めます。制限が問題になる場合は、リクエスト間に待機時間を設ける方法もあります。

クエリの例 python

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

class=class="hl-string">"hl-comment"># --- Configuration: Update these placeholders --- #
ICERTIS_BASE_URL = class="hl-string">"https://[your-instance].icertis.com"
API_CLIENT_ID = class="hl-string">"[Your_Client_ID]"
API_CLIENT_SECRET = class="hl-string">"[Your_Client_Secret]"
class=class="hl-string">"hl-comment"># Date range for extraction (YYYY-MM-DD)
START_DATE = class="hl-string">"2023-01-01"
END_DATE = class="hl-string">"2023-12-31"

class=class="hl-string">"hl-comment"># --- Main Extraction Logic --- #

def get_access_token():
    class="hl-string">"""Authenticates with Icertis and returns an access token."""
    class=class="hl-string">"hl-comment"># This is a representative authentication flow. Refer to Icertis documentation.
    auth_url = fclass="hl-string">"{ICERTIS_BASE_URL}/api/v1/oauth/client-credentials/token"
    payload = {
        class="hl-string">'grant_type': class="hl-string">'client_credentials',
        class="hl-string">'client_id': API_CLIENT_ID,
        class="hl-string">'client_secret': API_CLIENT_SECRET
    }
    try:
        response = requests.post(auth_url, data=payload)
        response.raise_for_status()
        return response.json().get(class="hl-string">'access_token')
    except requests.exceptions.RequestException as e:
        print(fclass="hl-string">"Error authenticating: {e}")
        return None

def extract_icertis_data():
    class="hl-string">"""Main function to extract, transform, and save contract data."""
    access_token = get_access_token()
    if not access_token:
        print(class="hl-string">"Could not retrieve access token. Exiting.")
        return

    headers = {class="hl-string">'Authorization': fclass="hl-string">'Bearer {access_token}'}
    event_log = []

    class=class="hl-string">"hl-comment"># 1. Fetch all contracts within the date range
    contracts_url = fclass="hl-string">"{ICERTIS_BASE_URL}/api/v1/contracts?search_created_date_from={START_DATE}&search_created_date_to={END_DATE}"
    all_contracts = []

    while contracts_url:
        try:
            response = requests.get(contracts_url, headers=headers)
            response.raise_for_status()
            data = response.json()
            all_contracts.extend(data.get(class="hl-string">'results', []))
            contracts_url = data.get(class="hl-string">'nextLink') class=class="hl-string">"hl-comment"># Handle pagination
        except requests.exceptions.RequestException as e:
            print(fclass="hl-string">"Error fetching contracts: {e}")
            break

    print(fclass="hl-string">"Found {len(all_contracts)} contracts to process.")

    class=class="hl-string">"hl-comment"># 2. For each contract, fetch its history
    for contract in all_contracts:
        contract_id = contract.get(class="hl-string">'id')
        contract_type = contract.get(class="hl-string">'contractType', {}).get(class="hl-string">'name')
        contract_status = contract.get(class="hl-string">'status', {}).get(class="hl-string">'name')
        contract_value = contract.get(class="hl-string">'monetaryValue')

        if not contract_id:
            continue

        history_url = fclass="hl-string">"{ICERTIS_BASE_URL}/api/v1/contracts/{contract_id}/history"
        try:
            history_response = requests.get(history_url, headers=headers)
            history_response.raise_for_status()
            history_items = history_response.json().get(class="hl-string">'results', [])
        except requests.exceptions.RequestException as e:
            print(fclass="hl-string">"Error fetching history for contract {contract_id}: {e}")
            continue

        class=class="hl-string">"hl-comment"># 3. Map history events to activities
        for event in history_items:
            activity_name = None
            event_time = event.get(class="hl-string">'timestamp')
            activity_owner = event.get(class="hl-string">'user', {}).get(class="hl-string">'name')
            owner_department = event.get(class="hl-string">'user', {}).get(class="hl-string">'department') class=class="hl-string">"hl-comment"># Placeholder field
            description = event.get(class="hl-string">'description', class="hl-string">'').lower()
            event_type = event.get(class="hl-string">'eventType', class="hl-string">'').lower()
            
            class=class="hl-string">"hl-comment"># --- Activity Mapping Logic --- #
            if class="hl-string">'request initiated' in description or class="hl-string">'created' in event_type:
                activity_name = class="hl-string">'Contract Request Initiated'
            elif (class="hl-string">'document uploaded' in description or class="hl-string">'draft created' in description) and event.get(class="hl-string">'version') == 1:
                 activity_name = class="hl-string">'Contract Drafted'
            elif class="hl-string">'status changed to' in description and class="hl-string">'internal review' in description:
                activity_name = class="hl-string">'Internal Review Started'
            elif class="hl-string">'task completed' in event_type and class="hl-string">'legal review' in description:
                activity_name = class="hl-string">'Legal Review Conducted'
            elif class="hl-string">'new version created' in description or class="hl-string">'document revised' in description:
                activity_name = class="hl-string">'Contract Redlined Or Revised'
            elif class="hl-string">'status changed to' in description and class="hl-string">'internally approved' in description:
                activity_name = class="hl-string">'Internal Approvals Obtained'
            elif class="hl-string">'status changed to' in description and class="hl-string">'in negotiation' in description:
                activity_name = class="hl-string">'Counterparty Negotiation Started'
            elif class="hl-string">'status changed to' in description and class="hl-string">'counterparty approved' in description:
                activity_name = class="hl-string">'Counterparty Approval Received'
            elif class="hl-string">'sent for signature' in description:
                activity_name = class="hl-string">'Contract Sent For Signature'
            elif class="hl-string">'status changed to' in description and class="hl-string">'executed' in description:
                activity_name = class="hl-string">'Contract Executed'
            elif class="hl-string">'obligations activated' in description:
                activity_name = class="hl-string">'Obligations Monitoring Activated'
            elif class="hl-string">'amendment initiated' in description or class="hl-string">'amendment created' in description:
                activity_name = class="hl-string">'Amendment Initiated'
            elif class="hl-string">'renewed' in event_type:
                activity_name = class="hl-string">'Contract Renewed'
            elif class="hl-string">'status changed to' in description and (class="hl-string">'terminated' in description or class="hl-string">'expired' in description):
                activity_name = class="hl-string">'Contract Terminated Or Expired'

            if activity_name:
                event_log.append({
                    class="hl-string">'ContractId': contract_id,
                    class="hl-string">'ActivityName': activity_name,
                    class="hl-string">'EventTime': event_time,
                    class="hl-string">'EndTime': event_time, class=class="hl-string">"hl-comment"># For point-in-time events, EndTime is the same as EventTime
                    class="hl-string">'ActivityOwner': activity_owner,
                    class="hl-string">'OwnerDepartment': owner_department,
                    class="hl-string">'ContractType': contract_type,
                    class="hl-string">'ContractStatus': contract_status,
                    class="hl-string">'ContractValue': contract_value
                })
    
    class=class="hl-string">"hl-comment"># 4. Create and save the event log
    if not event_log:
        print(class="hl-string">"No events were extracted. The output file will be empty.")
        return

    df = pd.DataFrame(event_log)
    df[class="hl-string">'EventTime'] = pd.to_datetime(df[class="hl-string">'EventTime'])
    df[class="hl-string">'EndTime'] = pd.to_datetime(df[class="hl-string">'EndTime'])
    df.sort_values(by=[class="hl-string">'ContractId', class="hl-string">'EventTime'], inplace=True)

    output_filename = class="hl-string">'icertis_contract_event_log.csv'
    df.to_csv(output_filename, index=False, date_format=class="hl-string">'%Y-%m-%dT%H:%M:%S.%f%z')
    print(fclass="hl-string">"Extraction complete. Event log saved to {output_filename}")

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

準備はできましたか？

このテンプレートを使えば、契約管理プロセスの改善に必要な準備を整えられます。今すぐデータの収集を始め、改善につながるインサイトを見つけましょう。

改善ガイドに戻る

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

Icertisの契約プロセスを改善：ボトルネックを今すぐ削減

ボトルネックを解消し、契約サイクルタイムを30％短縮して、ガバナンスを強化しましょう。

無料トライアルを開始しましょう

クレジットカードは不要です。数分で設定できます。

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

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

契約管理の属性

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

データ抽出ガイド

Icertis ICIプラットフォームのレポートモジュールからのエクスポート

ステップ

設定

クエリの例 sql

Icertis REST APIを使ったPythonスクリプト

ステップ

設定

クエリの例 python

準備はできましたか？

Icertisの契約プロセスを改善：ボトルネックを今すぐ削減