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

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

Icertis

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

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

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

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

イベントログを初めて扱いますか。学ぶプロセスマイニングのイベントログを作成する方法.

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

契約管理の属性

契約管理プロセスを詳細に分析するために、信頼性の高いイベントログを構築するうえで必要なデータ項目です。

3 必須 6 推奨 11 任意

	名前	説明
	契約ID ContractId	Icertisプラットフォームで管理される各契約を一意に識別するIDです。
説明 Contract IDは、特定の契約に関連するすべてのイベントとアクティビティを一意に結び付ける、確定的なケース識別子です。契約の開始から完了までの経緯をエンドツーエンドで分析できます。プロセスマイニングでは、この属性がすべての契約ライフサイクルを再構成する基盤になります。作成、レビュー、承認、締結などの関連アクティビティを適切な契約に正しく関連付けられるため、サイクル時間を正確に測定し、プロセスのばらつきを特定できます。重要な理由プロセス分析の主キーです。契約の全行程を追跡し、データの整合性を確保できます。入手先 IcertisのContract Agreementオブジェクトにおける中核属性です。例 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、システムアカウントなどが該当します。アクティビティ担当者を分析すると、リソース配分、業務量の分散、パフォーマンスを把握できます。どのユーザーやチームがボトルネックになっているか、レビューの効率が高い担当者は誰か、業務がどのように分担されているかといった問いに答えられます。「Reviewer Workload Distribution」ダッシュボードにも直接役立ちます。重要な理由ユーザーまたはチーム単位でパフォーマンスを分析し、業務量の偏りやトレーニングの機会を特定できます。入手先通常、Icertis内のワークフロー履歴または監査証跡データで、各イベントに関連付けられて記録されています。例 John SmithLegal.Review.QueueSystem.AutoApproveSarah Chen
	契約ステータス ContractStatus	ライフサイクルにおける契約の現在の状態または段階です。
説明この属性は、契約案件全体のステータスを示します。たとえば、「Draft」、「In Review」、「Awaiting Signature」、「Executed」などです。通常は案件レベルの属性で、最後に到達した主要なマイルストーンを反映します。契約パイプラインをリアルタイムで把握する「Contract Status And Throughput」などの運用ダッシュボードに欠かせません。各段階にある契約数や業務が滞留している箇所を管理者が把握できるため、契約ポートフォリオを先回りして管理できます。重要な理由契約パイプラインを俯瞰でき、運用状況の監視と処理量の管理に役立ちます。入手先 IcertisのContract Agreementオブジェクトにある主要なステータス項目です。例草案社内レビュー中締結済み終了
	契約種別 ContractType	基本契約書や秘密保持契約書など、契約の分類です。
説明契約種別は、法的または業務上の目的に基づいて契約を分類します。契約ライフサイクルを分類し、比較するための基本的な属性です。契約種別によって、プロセスの経路や複雑さ、SLAが異なることがあります。契約種別ごとに分析すると、取引量が多くリスクの低い秘密保持契約書には最適化したワークフローを適用し、複雑で金額の大きい基本契約書には別の対応を行うといった改善が可能です。「Contract Variant Analysis」や「Policy Compliance Score」KPIにも欠かせません。重要な理由プロセスを分けて分析し、契約の種類ごとにライフサイクルとコンプライアンスを比較できます。入手先 IcertisのContract Agreementオブジェクトに設定される標準属性です。例基本サービス契約（MSA）秘密保持契約（NDA）作業範囲記述書（SOW）
	契約金額 ContractValue	契約の総額です。
説明この属性は、契約の金銭的価値を示します。契約総額や年換算額などが該当します。契約の優先順位付けや財務的な影響の把握に欠かせない業務指標です。プロセスマイニングでは、契約金額によって分析を分け、高額な契約に焦点を当てます。たとえば、高額な契約ほど承認や交渉に時間がかかるかを分析できます。また、高額契約の遅延が収益に大きく影響する場合があるため、リスク評価にも役立ちます。重要な理由優先順位付けと金額に基づく分析が可能になり、財務的な影響が大きい契約に改善の取り組みを集中できます。入手先通常、IcertisのContract Agreementオブジェクトにある標準の通貨項目です。例 50000.001250000.002500.00
	担当者の所属部門 OwnerDepartment	アクティビティ担当者が所属する部門です。
説明この属性は、アクティビティを実行したユーザーに関連する法務、営業、調達などの業務部門を示します。プロセスに関与するリソースを部門単位で集約して把握できます。部門別に分析すると、部門間の連携や引き継ぎを把握できます。営業から申請された後、法務レビューまで長時間待たされるといった、部門間に生じる構造的な遅延を特定できます。「Departmental Handoff Delays」ダッシュボードの分析にも役立ちます。重要な理由部門ごとのパフォーマンスと引き継ぎの効率を分析し、部門横断のボトルネックを明らかにできます。入手先アクティビティ担当者をキーとして、人事システムやユーザーディレクトリと結合し、データを補完する必要がある場合があります。Icertisのユーザープロファイルに直接保存されている場合もあります。例法務営業調達財務
	終了時刻 EndTime	特定の契約アクティビティが完了した時刻を示すタイムスタンプです。
説明この属性は、アクティビティの完了時刻を記録します。StartTimeが開始を示すのに対し、EndTimeは終了を示し、アクティビティの明確な所要時間を定義します。各アクティビティの処理時間や所要時間を正確に計算するには、開始時刻と終了時刻の両方が欠かせません。これにより、どのステップに最も時間がかかっているかを分析し、実際の処理時間とステップ間の待機時間を区別できます。「Approval Process Bottlenecks」や「Drafting And Revision Efficiency」などのダッシュボードにも役立ちます。重要な理由アクティビティの所要時間を正確に計算し、処理時間と待機時間を区別できます。入手先 StartTimeと同様に、Icertisの監査証跡またはワークフロー履歴ログに記録されています。StartTimeとEndTimeが同じで、瞬時に完了するイベントもあります。例 2023-05-15T18:30:00Z2023-06-03T09:00:15Z2024-01-10T11:00:00Z
	SLAステータス SLAState	アクティビティまたは案件がサービスレベル合意（SLA）の条件内にあるかどうかを示します。
説明この属性は、特定のプロセス段階の所要時間を、あらかじめ定めたSLA目標と比較して算出します。たとえば、法務レビューが標準の48時間を超えた場合に「Late」と表示できます。 SLAステータスは、コンプライアンスの監視とパフォーマンス管理に欠かせません。「Contract Compliance Overview」などのアラートやダッシュボードを作成し、違反をすぐに把握できます。チームは期限超過のタスクに優先的に対応でき、管理者は主要な目標に対するパフォーマンスを追跡できます。重要な理由サービスレベル目標への準拠状況をすぐに把握でき、業務の優先順位付けとパフォーマンス管理に役立ちます。入手先プロセスマイニングツールで、タイムスタンプとあらかじめ定めたSLAのしきい値（例：法務レビューの所要時間が2日を超える）を比較する業務ルールを定義して算出します。例期限内リスクあり遅延
	ソースシステム SourceSystem	契約データを抽出したシステムです。
説明この属性はデータの出所を示します。このプロセスでは「Icertis」です。複数のシステムからデータを集約する環境では、データガバナンスと追跡可能性の確保に役立ちます。分析では、特定のソースシステムにデータを絞り込んだり、可能な場合はシステム間でプロセスを比較したりするために使えます。このビューでは、すべてのイベントに共通する識別子として機能します。重要な理由データの系譜と追跡可能性を確保します。データの検証や複数のソースからのデータ管理に重要です。入手先通常、データの出所を示すために、データの抽出・変換処理で追加される固定値です。例 IcertisIcertisCLM
	事業部門 BusinessUnit	契約に関連する社内の事業部門です。
説明この属性は、契約を所管または申請した社内の部門や事業部門を示します。たとえば、「Enterprise Sales North America」や「Global Procurement」などです。部門と同様に、プロセスデータをより上位の単位で集約できます。組織内の各部門におけるプロセス効率とコンプライアンスを比較できるため、経営層の意思決定や戦略的なリソース配分に役立ちます。重要な理由組織内の各部門を横断して、プロセスパフォーマンスを比較できます。入手先契約を組織構造に関連付ける、主要なメタデータ項目として設定されることが多い項目です。例 BU-North Americaグローバルサービス製品開発
	修正回数 RevisionCount	契約が修正された合計回数です。
説明この計算指標は、各契約案件について「Contract Redlined Or Revised」など、修正に関するアクティビティの回数を示します。プロセス上の摩擦を把握する、シンプルで有効な指標です。修正回数が多い場合、要件が不明確、初稿の品質が低い、交渉が難航しているなど、作成または交渉段階に問題がある可能性があります。「Contract Revision Rate」KPIへの直接の入力値であり、手戻りが多い契約やプロセスのバリエーションをダッシュボードで特定する際に使われます。重要な理由契約ライフサイクルにおける手戻りを数値化し、作成と交渉の段階の効率を直接測定します。入手先イベントログで各「ContractId」に該当する特定の修正アクティビティの発生回数を数えて算出します。例 1503
	最終データ更新 LastDataUpdate	プロセスのデータが最後に更新された時刻を示すタイムスタンプです。
説明分析対象データの鮮度を示す属性です。ソースシステムから最後にデータを抽出した日付と時刻を記録します。この情報は、ダッシュボードに表示される分析結果の適時性を理解するうえで欠かせません。リアルタイムの情報を見ているのか、数時間前または数日前のデータを見ているのかを把握でき、意思決定に適切な前提を設定できます。重要な理由データの鮮度に関する前提を示し、プロセス分析がどの時点の情報に基づいているかを把握できるようにします。入手先このタイムスタンプは、データパイプラインまたはETLツールによって、データ更新が正常に完了するたびに生成されます。例 2024-07-27T08:00:00Z2024-07-26T23:59:59Z
	地域 Region	契約に関連する地理的な地域です。
説明この属性は、契約が適用される地域を示します。EMEA、APAC、北米などが該当します。地域によってプロセスが異なるグローバル組織では、特に重要です。地域別に分析すると、現地の法規制や商習慣によるプロセスパフォーマンス、コンプライアンス要件、交渉方法の違いを明らかにできます。地域ごとのベンチマークや、世界各地で共有できるベストプラクティスの特定にも役立ちます。重要な理由地域によるプロセスパフォーマンスとコンプライアンスの違いを特定できます。グローバル組織にとって欠かせない分析です。入手先通常、Icertisの契約オブジェクトにあるメタデータ項目で、標準設定の一部として用意されています。例 EMEA北米APACLATAM
	文書バージョン DocumentVersion	契約文書のバージョン番号です。
説明この属性は、契約文書の作成、赤入れ、修正の過程で更新回数を記録します。通常は整数、またはメジャー・マイナー形式のバージョン番号です。文書バージョンは、手戻りを直接示す指標です。契約のバージョン数が多い場合、何度も変更が行われたことを示すため、根本原因を調査できます。「Contract Revision Rate」KPIの計算に使う主要な入力値であり、「Drafting And Revision Efficiency」ダッシュボードにも利用されます。重要な理由契約で発生した手戻りや修正の量を直接測定し、作成や交渉における非効率を明らかにします。入手先 Icertisはすべての契約文書のバージョン履歴を保持します。この属性は、文書のメタデータまたはイベントログから抽出できます。例 1.02.34.00.5
	有効期限 ExpirationDate	契約が満了する日付です。
説明この属性は、契約期間の終了日を記録します。契約締結後のライフサイクル管理に欠かせない日付であり、更新または終了のアクティビティを開始する基準になります。契約終了時の管理状況を監視するうえで重要です。「On-Time Renewal/Termination Rate」KPIの基準日となり、更新または終了のプロセスが適切な時期に開始・完了しているかを測定できます。意図しない自動更新やサービスの失効を防ぐためにも役立ちます。重要な理由契約の更新と終了を管理し、契約終了時のプロセスを先回りして処理するために欠かせません。入手先 IcertisのContract Agreementオブジェクトにある標準の日付項目です。例 2025-12-312026-06-302024-08-15
	標準テンプレートの使用有無 IsStandardTemplate	会社の標準テンプレートから契約が作成されたかどうかを示すフラグです。
説明この真偽値属性は、契約が事前承認済みの標準テンプレートから作成されたか、標準外の個別契約として作成されたかを示します。リスクとコンプライアンスを評価するうえで重要な要素です。標準テンプレートに基づく契約は、通常、処理サイクルが短くリスクも低くなります。この属性は「Contract Template Adherence Rate」KPIの基礎となり、標準外の契約書を使うことがプロセスに与える影響を分析する際にも役立ちます。標準から外れることが多い部門や契約種別を明らかにし、テンプレート利用の改善につなげられます。重要な理由会社標準への準拠度を測定し、プロセス効率とリスク低減との関係を把握できます。入手先契約のチェックボックス項目として設定するか、Icertis内の文書の出所やメタデータに基づいて算出できます。例 truefalse
	相手方名 CounterpartyName	契約における顧客やベンダーなど、外部の相手方の名前です。
説明この属性は、契約に関与する相手方を識別します。やり取りや交渉を分析するための重要な背景情報になります。相手方別にプロセスを分析すると、交渉サイクルの傾向を把握できます。特定のベンダーとの契約だけ交渉に時間がかかる、修正回数が多いといった傾向を確認できます。戦略的な関係管理や交渉方針の調整に役立ち、「Negotiation Cycle Time And Rework」ダッシュボードにも直接つながります。重要な理由特定の外部相手方との交渉パターンや関係性のパフォーマンスを分析できます。入手先通常、契約のメタデータの一部として保存され、Icertisの相手方またはベンダーマスターデータオブジェクトにリンクされます。例 Acme CorporationGlobal Tech Inc.Innovate Solutions LLC
	義務履行期限 ObligationDueDate	特定の契約上の義務を履行しなければならない期限です。
説明この属性は、契約締結後に定められた主要な義務、約束、成果物の期限を記録します。1つの契約に複数の義務があり、それぞれに期限が設定される場合があります。これらの日付を追跡することは、契約締結後のコンプライアンスとリスク管理に欠かせません。「Obligation Adherence Rate」KPIの基盤となり、組織が約束を期限どおりに果たしているかを監視し、違反の可能性に先回りして対応できます。重要な理由契約締結後のコンプライアンスを監視し、違約金の発生を防ぎ、良好な取引関係を維持するために役立ちます。入手先 Icertisには義務管理のモジュールがあります。このデータは、契約に関連付けられた義務から取得します。例 2024-09-302025-01-152024-11-01

必須推奨任意

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

契約ライフサイクルを正確にディスカバリー・分析するために、イベントログで追跡すべき主要なプロセス手順とマイルストーンです。

6 推奨 8 任意

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

推奨任意

抽出ガイド

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

ステップ

Icertisレポートモジュールにアクセス：Icertis ICIプラットフォームにログインします。通常はメインアプリケーションメニューにある「Analytics」セクションまたはレポートモジュールに移動します。レポートを作成・実行するには、適切なユーザー権限が必要です。
新しいレポートを作成：新しいレポートの作成を開始します。レポートの主要なビジネスオブジェクトを選択します。契約管理では通常、「Contract Agreement」オブジェクト、または契約の中核となるワークスペースを表す同様のエンティティを選択します。
レポートのデータソースを定義：必要な情報にアクセスできるよう、関連するデータオブジェクトをレポートに追加します。バージョン情報には「Agreement Documents」、レビュー状況には「Approval Workflow」、ステータス変更には「Audit History」、契約実行後のアクティビティには「Obligations」などを含めます。
レポート項目を選択：レポートの列を設定します。ここでは、Icertisの項目を必要なイベントログ構造に対応付けます。主要なアクティビティごとに1行を生成する、ユニオンまたは複合レポートを作成する必要があります。各アクティビティの詳細な項目対応については、「query」セクションの設定を参照してください。
アクティビティとタイムスタンプのロジックを設定：各アクティビティについて、「ActivityName」列と「EventTime」列に値を設定するロジックを定義します。たとえば「Contract Executed」では、「ActivityName」に固定テキストを設定し、「EventTime」には「Contract Agreement」オブジェクトの「Execution Date」項目を対応付けます。ステータス変更から生成するアクティビティには、そのステータスが設定された日時を記録する対応する日付項目を使用します。
レポートフィルターを適用：抽出範囲を定義するフィルターを設定します。データ量を管理しやすくするため、たとえば過去6～12か月の「Contract Creation Date」など、日付範囲で絞り込むことが重要です。必要に応じて、「Contract Status」（例：Draftを除外）や「Contract Type」のフィルターも追加します。
レポートを実行してプレビュー：IcertisのUIでレポートを実行します。最初の数百行をプレビューし、列に想定どおり値が入り、同じContract IDに対して異なるアクティビティが別々の行として表示されていることを確認します。
レポートをエクスポート：プレビューを確認したら、レポート全体をエクスポートします。プロセスマイニングツールに取り込みやすいCSV形式を選択します。
データを結合・整形（必要な場合）：Icertisのレポート機能で全イベントを1つのレポートにまとめられない場合は、アクティビティ種別ごとに個別のレポートを作成してエクスポートします。その場合は、スクリプト言語や表計算アプリケーションなどの外部ツールを使ってレポートを縦方向に結合し、すべてのファイルで列名を統一します。最終的な出力は1つのCSVファイルにします。
アップロードの準備：最終的なCSVファイルを確認します。列見出しが必要な属性（ContractId、ActivityName、EventTime、EndTime、ActivityOwnerなど）と一致していることを確認します。日時がISO 8601などの一貫した形式になっていることも確認します。これでProcessMindにアップロードできます。

設定

前提条件：Contract Agreementおよび関連オブジェクトのレポートを作成・実行できるユーザーロールと権限を持ち、Icertis ICIプラットフォームにアクセスできること。
レポート種別：複数の関連オブジェクト（Agreements、Documents、Workflows、Audit Trails）からデータを取得し、1つのアクティビティログにまとめられる複合レポートまたはユニオンレポート。対応できない場合は、複数の個別レポートが必要です。
主要なデータオブジェクト：レポートは「Contract Agreement」を基盤とし、「Agreement Documents」、「Approval Workflow」、「Users」、必要に応じて「Audit History」を結合して、必要なイベントのタイムスタンプと詳細を取得します。
日付範囲のフィルタリング：エクスポートのサイズと処理性能を管理するため、必ず日付範囲フィルターを適用します。まずは過去6～12か月の「Contract Creation Date」または「Execution Date」で絞り込むことを推奨します。
アクティビティのフィルタリング：特定のアクティビティが発生した時点を正しく特定するため、「Contract Status」や「Approval Status」などのステータス項目に基づくフィルターが必要になる場合があります。プロセス全体を把握できるよう、対象範囲には進行中と完了済みの契約の両方を含めてください。
項目の選択：必要な項目だけを明示的に選択します。列を追加しすぎると、レポートの生成やエクスポートに時間がかかる場合があります。イベントログに必要な属性と推奨属性に絞り込んでください。

a サンプルクエリ 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'"
}

ステップ

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

設定

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

a サンプルクエリ 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プラットフォームのレポートモジュールからのエクスポート

ステップ

設定

a サンプルクエリ sql

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

ステップ

設定

a サンプルクエリ python

準備はできましたか？

Icertis契約を変革：今すぐボトルネックを削減

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

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

契約管理の属性

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

抽出ガイド

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

ステップ

設定

a サンプルクエリ sql

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

ステップ

設定

a サンプルクエリ python

準備はできましたか？

Icertis契約を変革：今すぐボトルネックを削減

プライバシーを大切にしています