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

アジロフト

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

このテンプレートは、契約管理プロセスの包括的な分析のために収集すべき必須データ属性と追跡すべき主要アクティビティを概説しています。また、システムからこの貴重な情報を抽出する方法に関する実用的なガイダンスも提供します。このテンプレートを使用してデータを準備し、強力なプロセスマイニングのインサイトに活用しましょう。

収集を推奨する項目
追跡すべき主要アクティビティ
抽出の手引き

イベントログについて初めての方へ：プロセスマイニングのイベントログ作成方法.

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

契約管理属性

これらは、包括的な分析を行い、契約管理プロセス内に隠されたインサイトを発見するために、イベントログに含めることを推奨するデータフィールドです。

5 必須 8 推奨 9 任意

	名前	説明
	契約ID ContractId	システム内で管理される各契約の一意の識別子。このIDは、契約のライフサイクル全体にわたるすべての関連アクティビティとイベントをリンクします。
説明契約IDは、特定の契約に関連するすべてのイベントとアクティビティを一意にリンクする、決定的なケース識別子として機能します。イベントログ内の各レコードは、契約に対して実行されたアクションに対応しており、このIDがそれらのアクションをグループ化します。プロセスマイニング分析において、この属性はあらゆる契約のエンドツーエンドのプロセスを再構築するための基盤となります。これにより、プロセスフローの可視化、要求から実行までのサイクルタイムの計算、個々の契約特性に基づく分析のセグメンテーションが可能になります。その重要性これは、契約の完全なプロセスを追跡するための不可欠な鍵です。これなしでは、エンドツーエンドのプロセスフローを分析したり、ケースレベルのKPIを計算したりすることはできません。取得元これは通常、Agiloftの主要な契約テーブルの主キーです。例 CTR-2023-00123MSA-2024-00045NDA-2023-00789
	アクティビティ名 ActivityName	契約ライフサイクルのある時点で発生した特定のビジネスアクティビティまたはイベントの名称。
説明この属性は、「契約書作成済み」、「法務審査実施済み」、「契約締結済み/署名済み」など、プロセスで実行されたステップを記述します。これらのアクティビティはプロセスマップの構成要素です。アクティビティの順序と頻度を分析することは、主要なプロセスフローを特定し、逸脱や手戻りループを発見し、どのステップが最も一般的で時間がかかるかを特定するのに役立ちます。これは、「契約ライフサイクル全体概要」や「契約書作成プロセスバリアント」のようなダッシュボードを構築するために不可欠です。その重要性アクティビティは、プロセスマップのステップを定義します。この属性は、プロセスフローを視覚化し、どのような作業が行われているかを理解するために必要です。取得元 Agiloftの契約履歴または監査証跡テーブルに記録されたアクションまたはステータス変更から導出されます。例契約書ドラフト作成済み法務レビュー実施済み署名依頼済み契約締結/署名済み
	ソースシステム SourceSystem	`データ`が抽出された記録システム。
説明この属性は、契約管理データの起源を識別します。このプロセスの場合、値は常に「Agiloft」となります。複数のシステムからのデータを組み合わせるより広範な企業分析において、このフィールドはデータリネージュにとって重要であり、分析が正しくスコープ設定されていることを保証します。これはデータのコンテキストとトレーサビリティを提供します。その重要性データの出所を特定します。これは、データガバナンス、トラブルシューティング、および複数のソースからのデータ統合にとって不可欠です。取得元これは、データ抽出および変換プロセス中に加えられるべき静的な値です。例アジロフト
	最終データ更新 LastDataUpdate	ソースシステムからの最終更新または抽出日時を示す timestamp。
説明この属性は、最新のデータ抽出のタイムスタンプを提供します。これは、分析されているデータの鮮度を理解し、データ更新スケジュールを管理するために不可欠です。ユーザーは、最新の情報を表示していることを確認し、分析がカバーする時間枠を理解するために、このタイムスタンプに依存します。これは、信頼できるデータ駆動型分析にとって重要なメタデータです。その重要性ユーザーがデータの鮮度を把握できるようにし、タイムリーで正確なビジネス意思決定を行う上で不可欠です。取得元この`タイムスタンプ`は、`データ`の抽出、変換、ロード（ETL）プロセス中に生成・追加されます。例 2024-05-20T08:00:00Z
	開始時刻 EventTime	特定のアクティビティまたはイベントが開始されたことを示すタイムスタンプです。
説明この属性は、契約履歴に記録された各アクティビティの日付と時刻を提供します。これはイベントの時系列順序を確立し、プロセスディスカバリと分析にとって不可欠です。開始時刻は、アクティビティ間の期間を計算し、ボトルネックを特定し、サイクルタイムを測定するために使用されます。これは、「平均契約サイクルタイム」や「平均承認フェーズ期間」など、事実上すべての時間ベースのKPIの基礎となります。その重要性このタイムスタンプは、イベントの順序付け、期間の計算、および時間の経過に伴うプロセスパフォーマンスの分析に不可欠です。これなしではプロセスマイニングは不可能です。取得元これは、Agiloftの契約履歴または監査証跡テーブルに記録されたアクションのタイムスタンプに対応します。例 2023-10-26T10:00:00Z2023-10-27T14:35:10Z2023-11-05T09:15:00Z
	`ユーザー部署` UserDepartment	ユーザーまたは契約所有者が所属する部署。
説明この属性は、「営業」、「法務」、「調達」、「財務」など、契約の部署のコンテキストを提供します。この情報は、契約所有者または特定のアクティビティを実行したユーザーに関連付けられます。このディメンションは、「契約サイクルタイム変動要因」ダッシュボードにとって重要です。これにより、異なる部署間でプロセスパフォーマンスをフィルタリングおよび比較し、特定の部署がより長いサイクルタイム、より多くの手戻り、または異なるプロセスパスを持っているかどうかを明らかにできます。例えば、営業部門発の契約が調達部門発の契約よりも法務審査に時間がかかるかどうかを分析できます。その重要性事業部門間のパフォーマンス比較を可能にし、部門固有のプロセス課題やベストプラクティスの特定に役立ちます。取得元この情報は、ユーザープロファイルテーブルから結合されるか、Agiloftの契約レコードに直接保存される場合があります。例営業法務調達財務
	ユーザー名 UserName	アクティビティを実行したユーザーまたはリソースの名称。
説明この属性は、契約書を作成した人や法務審査を実施した弁護士など、特定のプロセスステップの完了を担当した個人を識別します。これは通常、システム監査証跡内のアクションに関連付けられたユーザー情報から取得されます。ユーザー別の分析は、「契約リソースのワークロード分析」ダッシュボードに不可欠であり、ワークロードの配分、個人間のパフォーマンスのばらつき、トレーニングの機会を特定するのに役立ちます。また、特定のアクションに対する説明責任を追跡するのにも役立ちます。その重要性ワークロード分析、パフォーマンス比較、およびリソース固有のボトルネックやベストプラクティスの特定を可能にします。取得元通常、契約履歴または監査証跡テーブルにあり、変更を行ったユーザーにリンクされています。例 Alice SmithBob JohnsonCharlie Brown
	取引先名 CounterpartyName	契約に関与する外部関係者、顧客、ベンダー、またはパートナーの名称。
説明この属性は、契約に署名する相手方の組織または個人を識別します。相手方は、交渉プロセス、タイムライン、および合意条件に大きな影響を与える可能性があります。相手方ごとのプロセスパフォーマンス分析は、「契約サイクルタイム変動要因」および「交渉修正回数」ダッシュボードの主要な目標です。これにより、どのパートナーがより長い交渉やより多くの改訂につながるかを特定し、カスタマイズされた交渉戦略とより良い関係管理を可能にします。その重要性さまざまな外部パートナーが契約交渉の時間と複雑さにどのように影響するかを特定するのに役立ち、より良い予測と戦略を可能にします。取得元これはAgiloftの主要な契約テーブルまたは企業/アカウントテーブルからリンクされた標準フィールドです。例 Acme Corporation`Global Tech Inc.`Innovate Solutions LLC
	契約ステータス ContractStatus	契約ライフサイクルにおける現在のステータスまたは状態。
説明この属性は、「ドラフト中」、「審査中」、「締結済み」、「期限切れ」、「終了済み」など、契約の現在の段階を示します。これにより、契約が特定の時点でどこにあるかというスナップショットが提供されます。プロセスマイニングでは、時間の経過に伴うステータスの変化が、多くの場合アクティビティ自体を定義します。ケースレベル属性として、アクティブな契約、締結済みの契約、または期限切れの契約にのみ焦点を当てるための分析のフィルタリングに役立ちます。これは「今後の契約期限とステータス」ダッシュボードを直接サポートします。その重要性契約の現在の段階を素早く概観でき、進行中のケースと完了済みのケースの分析のためにフィルタリングとセグメンテーションを可能にします。取得元これはAgiloftの主要な契約テーブルにおける標準のフィールドです。例下書き承認待ち実行済み期限切れ
	契約価値 ContractValue	契約の総金銭的価値。
説明この属性は、契約の総金銭的価値（収益、コスト、またはコミットメントのいずれか）を表します。この価値は、審査レベルと承認プロセスの複雑さに影響を与える主要な要因となることがよくあります。契約価値は、「締結済み契約の価値と量トレンド」ダッシュボードにとって重要であり、プロセスパフォーマンスの財務的影響分析を可能にします。また、契約価値とサイクルタイムを関連付けることで、高価値契約の処理に著しく長い時間がかかるかどうかを明らかにすることもできます。これは、高価値契約の優先順位付けとワークフローの最適化に役立ちます。その重要性プロセスに財務的背景を提供し、価値ベースの分析、優先順位付け、および遅延がビジネスに与える影響の理解を可能にします。取得元これはAgiloftの主要な契約テーブルにおける標準のフィールドです。例 50000.00250000.0010000.00
	契約形態 ContractType	マスターサービス契約（MSA）、秘密保持契約（NDA）、業務委託契約書（SOW）など、契約の分類。
説明契約タイプは、合意の性質とテンプレートを定義する主要な分類フィールドです。異なる契約タイプは、しばしば異なるプロセスバリアントに従い、異なるレベルの複雑さを持ち、異なるステークホルダーが関与します。この属性は比較分析に不可欠であり、「契約サイクルタイム変動要因」および「交渉修正回数」ダッシュボードの主要な推進要因となります。契約タイプ別にプロセスをセグメント化することで、アナリストは特定のタイプがなぜより長い時間を要するのか、より多くの修正が必要なのか、あるいは標準プロセスからより頻繁に逸脱するのかを明らかにすることができます。その重要性プロセスの複雑さ、期間、リスクにおける大きなばらつきを説明します。これは意味のあるプロセスセグメンテーションのための基本的な属性です。取得元これはAgiloft内の主要な契約テーブルにおける標準フィールドです。例基本サービス契約秘密保持契約業務委託契約書ソフトウェアライセンス契約
	有効期限 ExpirationDate	更新または終了されない場合に契約が失効するように設定されている日付。
説明有効期限は、契約のアクティブ期間の終了を決定する重要な日付フィールドです。更新、終了の管理、および意図しない失効や自動更新の回避に不可欠です。この属性は、「今後の契約期限とステータス」ダッシュボードおよび「期限内契約対応率」KPIの基礎となります。これにより、企業は契約終了イベントを事前に管理し、更新や終了がタイムリーに処理され、期限の厳守が可能になります。その重要性プロアクティブな契約管理にとって極めて重要であり、更新または終了の期限切れをビジネスが回避できるようにします。取得元これはAgiloftの主要な契約テーブルにおける標準の日付フィールドです。例 2024-12-31T00:00:00Z2025-06-30T00:00:00Z2026-01-15T00:00:00Z
	終了日時 EventEndTime	特定のアクティビティ／イベントが完了したタイムスタンプ。
説明開始時刻はアクティビティがいつ開始されたかを示し、終了時刻はその完了を示します。両者の差は、その特定のアクティビティの処理時間を表します。プロセスマイニングでは、開始時刻と終了時刻の両方を持つことで、リソース利用と待機時間対実作業時間のより詳細な分析が可能になります。例えば、法務審査が実際に作業されていた時間と、キューで待機していた時間を区別できます。これは「法務審査処理時間」KPIをサポートします。その重要性アクティビティの実際の処理時間を計算し、より正確なボトルネック分析のために、アクティブな作業時間と待機時間を分離することを可能にします。取得元一部のシステムでは、これが直接利用可能です。多くの場合、ケースにおける次のアクティビティの開始時間として推測されます。Agiloftの場合、監査証跡から導出する必要があるかもしれません。例 2023-10-26T18:30:00Z2023-10-27T15:05:45Z2023-11-05T11:00:00Z
	サイクルタイム CycleTime	契約依頼が開始されてから契約が締結されるまでの総期間。
説明この属性は、「契約要求開始」から「契約締結済み/署名済み」まで、契約がそのコアライフサイクルを通過するのにかかる総経過時間を表す計算メトリクスです。これはプロセスパフォーマンスの主要なKPIであり、全体的な効率を直接測定します。これは「契約ライフサイクル全体概要」ダッシュボードおよび「平均契約サイクルタイム」KPIの主要なメトリクスです。サイクルタイムを分析することは、長期化しているケースを特定し、遅延の根本原因を調査するのに役立ちます。その重要性これは、契約管理プロセス全体の効率性を測定する主要な業績評価指標です。取得元各契約IDについて、「Contract Executed/Signed」アクティビティのタイムスタンプと「Contract Request Initiated」アクティビティのタイムスタンプの差を取ることで算出されます。例 25 days 4 hours10 days 8 hours45 days 2 hours
	レビューSLAは満たされていますか IsReviewSlaMet	契約レビューが定義されたサービスレベルアグリーメント（SLA）内で完了したかどうかを示す計算されたブール値フラグ。
説明この属性は、審査アクティビティ（例：「社内審査実施済み」）の実際の完了タイムスタンプを「ReviewSlaDueDate」と比較することで導出されます。審査が期限内であれば「true」、遅延していれば「false」となります。このフラグは、「契約審査のSLA遵守」ダッシュボードを直接動かし、コンプライアンス率の簡単な可視化を可能にします。trueとfalseの値を単純に数えることで、「審査のSLA遵守率」KPIの計算を簡素化します。その重要性 SLA遵守に対する明確な二者択一の結果を提供し、内部期限の遵守状況を測定、可視化、報告することを容易にします。取得元各契約のレビュー完了アクティビティの「EventTime」を「ReviewSlaDueDate」と比較して算出されます。例 truefalse
	レビューSLA期日 ReviewSlaDueDate	法務審査や社内審査など、契約審査ステップが完了しなければならない目標期日。
説明この属性は、特定の審査アクティビティに対するサービスレベル合意（SLA）の期限を定義します。これは処理時間の明確な期待を設定し、社内目標に対するパフォーマンスを測定するために使用されます。この日付は、「契約審査のSLA遵守」ダッシュボードおよび関連する「審査のSLA遵守率」KPIの基盤となります。審査アクティビティの実際の完了時刻とこの期日を比較することで、システムはプロセスがサービスレベル目標を満たしているかを判断し、SLAが頻繁に違反されている領域を浮き彫りにすることができます。その重要性内部期限に対するパフォーマンス測定を可能にし、SLAの履行とレビューのリードタイム改善にとって不可欠です。取得元これは、契約の提出日と事前に定義されたSLAルールに基づいてAgiloftで計算されるフィールドであるか、または手動で設定される日付フィールドである可能性があります。例 2023-10-29T17:00:00Z2023-11-01T17:00:00Z2023-11-10T17:00:00Z
	交渉フェーズ期間 NegotiationPhaseDuration	相手方との交渉フェーズの計算された期間。
説明このメトリクスは、外部の相手方との交渉が開始されてから（例：「相手方交渉開始」）、最終合意が相手方によって達し承認されるまでの時間を測定します。これは、「交渉フェーズサイクルタイム」ダッシュボードおよび「平均交渉フェーズ時間」KPIの主要メトリクスです。この期間を分析することは、交渉プロセスの効率性を理解し、どの契約タイプや相手方が交渉を長期化させるかを特定し、相互作用を効率化する機会を見つけるのに役立ちます。その重要性交渉段階の効率性を測定し、外部関係者とのやり取りに費やす時間を短縮するための洞察を提供します。取得元イベントログから、「Counterparty Negotiation Started」アクティビティと「Counterparty Approval Received」のような完了アクティビティの間の時間を測定して算出されます。例 7 days15日間3 days
	契約テンプレート名 ContractTemplateName	最初の契約書ドラフトを生成するために使用されたテンプレートの名称。
説明この属性は、契約の開始点としてどの標準テンプレートが使用されたかを指定します。テンプレート使用の一貫性は、効率的な作成プロセスにとって重要です。この属性を分析することは、「契約書作成の手戻り率」および「初回パス社内承認率」KPIをサポートするのに役立ちます。異なるテンプレートから作成された契約、またはテンプレートを使用せずに作成された契約のパフォーマンスを比較することで、組織はどのテンプレートが最も効果的であるか、そしてどこで標準化の取り組みが最も必要とされているかを特定できます。その重要性標準テンプレートの有効性を評価し、標準化を促進するのに役立ちます。これにより、作成時間と手戻りを大幅に削減できます。取得元これは、契約がテンプレートから作成されたときにAgiloftの契約レコードに入力されるフィールドである可能性があります。例標準MSA v2.1秘密保持契約（相互）SOW - 固定価格版v1.3カスタム
	承認フェーズ期間 ApprovalPhaseDuration	承認が最初に求められてから取得されるまでの承認フェーズの計算された期間。
説明このメトリクスは、契約が必要なすべての社内および法務承認を通過するのにかかる時間を測定します。これは通常、最初の審査アクティビティが開始されたとき（例：「社内審査提出済み」）に始まり、最終的に必要な承認が受領されたときに終了します。この属性は、「平均承認フェーズ期間」KPIの基礎であり、「審査および承認のボトルネック分析」ダッシュボードの主要コンポーネントです。これは契約ライフサイクルの重要な段階を分離し、審査と承認の遅延の原因に焦点を当てた分析を可能にします。その重要性承認段階で費やされた時間を分離し定量化することで、この重要なフェーズにおけるボトルネックを特定し、対処するのに役立ちます。取得元イベントログから、各契約の最初の承認アクティビティの開始から最後の承認アクティビティの終了までの時間差を特定して算出されます。例 5日2時間12 days 6 hours2 days 1 hour
	改訂回数 RevisionCount	契約のライフサイクル中に契約が改訂または朱書きされた回数を示すカウンター。
説明この属性は、特に作成および交渉フェーズ中に契約が経験するイテレーションの数を追跡します。高い改訂回数は、しばしばテンプレートの問題、複雑な交渉、または不明確な初期要件を示唆します。このメトリクスは、「交渉修正回数」ダッシュボードおよび「契約修正回数」KPIを直接サポートします。改訂回数を分析することは、どの契約タイプや相手方が最も多くのやり取りにつながるかを特定し、作成と交渉を効率化するためのインサイトを提供します。その重要性手戻りや交渉の複雑さを定量化し、テンプレートの品質と交渉戦略を改善する機会を特定するのに役立ちます。取得元これは通常、イベントログ内の各契約IDに対する「契約修正/改訂済み」アクティビティの発生回数を数えることによって導出されます。例 1350
	法務レビュアー LegalReviewer	契約の審査を担当する法務部門の特定の担当者またはチームの名称。
説明この属性は、「法務審査実施済み」アクティビティを担当する特定の法務リソースを識別します。これは、多様な役割を捕捉する可能性のある一般的な「ユーザー」フィールドよりも、ワークロードのより詳細なビューを提供します。これは、「契約リソースのワークロード分析」ダッシュボードにとって価値があり、法務チームの能力とパフォーマンスに焦点を当てた分析を可能にします。法務チーム内のワークロードバランスや、特定の審査担当者がより長い審査時間に関連しているかどうかについての質問に答えるのに役立ち、「平均法務審査処理時間」KPIをサポートします。その重要性法務レビュー機能に特化した詳細なワークロードとパフォーマンス分析を可能にし、法務チームのリソースを効果的に管理するのに役立ちます。取得元これは、契約上の特定の法務担当者フィールドであるか、法務審査アクティビティに関連付けられたユーザー名から派生することも可能です。例ジェーン・ドウ法務チームAJohn Smith
	自動化 IsAutomated	アクティビティが人間ではなくシステムによって自動的に実行されたかどうかを示すブール値フラグ。
説明この属性は、自動ステータス更新、通知、システムトリガー型ワークフローなどの人間主導のアクティビティとシステム主導のアクティビティを区別します。分析において、これは契約管理プロセスにおける自動化のレベルを理解するのに役立ちます。自動化イニシアチンの影響を測定し、さらなる自動化の機会を特定し、自動化されたステップがボトルネックを引き起こすことなく期待どおりに機能していることを確認するために使用できます。その重要性プロセスにおける自動化の度合いを測定し、どのステップがシステムによって、どのステップが人間によって実行されているかを特定するのに役立ちます。取得元アクティビティ履歴内の特定のシステムユーザーアカウント（例：「System」、「Admin」）を特定するか、特定の自動化されたアクティビティタイプをフラグ付けすることによって導出されます。例 truefalse

必須推奨任意

契約管理アクティビティ

正確なプロセス発見とボトルネック特定のため、イベントログに記録すべき主要ステップとマイルストーンは次のとおりです。

7 推奨 9 任意

	アクティビティ	説明
	内部承認取得済み	このマイルストーンは、必要なすべての社内関係者が契約の最終バージョンを承認したことを示します。これは通常、契約ステータスが「完全承認済み」や「署名準備完了」のような最終承認状態に移行したときに推測されます。
その重要性これは、社内審査の終了と実行への準備を示す重要なマイルストーンです。契約が署名のために送付される前の総社内処理時間を測定するための重要なポイントです。取得元「Approved」、「Ready for Signature」、または類似の最終承認ステータスへのステータス変更のタイムスタンプから推測されます。また、最後の必須承認レコードの完了タイムスタンプから導出することもできます。取得契約ステータスが署名前承認状態に移行したときのタイムスタンプを特定します。イベントタイプ inferred
	契約更新済み	契約が期間満了時に正常に更新されたことを表します。これは重要なビジネス成果であり、多くの場合、契約ステータスを更新したり、更新期間用の新しい契約バージョンを作成したりする明示的なユーザーアクションによって記録されます。
その重要性このアクティビティは、多くの企業にとって継続的なパートナーシップを示す主要な成功指標です。更新を追跡することは、収益予測と契約維持パフォーマンスの分析に不可欠です。取得元「Renewed」への明示的なステータス変更、または更新として指定された新しいリンクされた契約レコードの作成から取得されます。Agiloftのワークフローにより、これを自動化できます。取得ステータスが「更新済み」に変更されたタイムスタンプ、または後続の契約の作成日を使用します。イベントタイプ explicit
	契約期限切れ	このイベントは、契約が更新されず、または早期に終了されることなく、その終了日に達したことを示します。このイベントは通常、契約の有効期限と現在の日付を比較することによって計算されます。
その重要性これは契約ライフサイクルの主要な終点です。失効を分析することは、不要な自動更新を防ぎ、必要な更新が見逃されないようにするために不可欠です。取得元これは計算イベントです。契約が更新または終了されていない場合に、現在の日付が「有効期限」または「契約終了日」フィールドに保存されている日付を過ぎると発生します。取得「Expiration Date」フィールドの値を使用してこのイベントを導出します。イベントタイプ calculated
	契約終了済み	有効な契約が予定された有効期限日より前に早期終了したことを表します。これは明示的なイベントであり、通常は契約ステータスを「Terminated」に変更し、理由を提供することによって記録されます。
その重要性重要な終点として、契約終了分析は、不履行やビジネス戦略の変化など、契約解消の理由を理解するのに役立ちます。これはリスク管理と取引先との関係を理解する上で非常に重要です。取得元契約レコードの履歴で「Terminated」へのステータスフィールド変更から推測されます。終了日は専用のフィールドに記録されることがよくあります。取得ステータスが「終了済み」に変更されたタイムスタンプ、または「終了日」フィールドの値を使用します。イベントタイプ inferred
	契約締結/署名済み	これは、すべての当事者が契約に署名し、法的に拘束力を持つ主要なマイルストーンです。これは通常、電子署名プラットフォームとの統合を通じて明示的に捕捉されるか、ユーザーが手動でステータスを「締結済み」に更新したときに捕捉されます。
その重要性このイベントは、契約締結前フェーズの成功裏の完了を示し、全体の契約サイクルタイムを計算するための終点となります。これは、契約締結後の管理フェーズの開始をトリガーします。取得元電子署名統合のウェブフックによって提供される完了タイムスタンプ、またはAgiloftでの「Executed」または「Signed」への手動ステータス変更のタイムスタンプから取得されます。取得「署名日」フィールド、実行日、またはステータスが「締結済み」に変わったタイムスタンプを使用します。イベントタイプ explicit
	契約要求開始	これは契約ライフサイクルにおける最初のイベントであり、新規契約の正式な要求を表します。Agiloftでは、これは通常、契約テーブルにおける新規レコードの作成として捕捉され、システムの履歴または監査ログに明示的に記録されるイベントです。
その重要性このアクティビティはプロセスの開始を示し、全体の契約サイクルタイムを計算するために不可欠です。この開始点を分析することで、組織内の契約需要の量と発生源を理解するのに役立ちます。取得元このイベントはAgiloft内の契約レコードの作成タイムスタンプから捕捉されます。これは通常、特定の契約IDの履歴タブまたはシステムログで見つけることができます。取得主要契約テーブルからのレコード作成タイムスタンプを使用します。イベントタイプ explicit
	法務レビュー実施済み	法務部門が契約のレビューを完了したことを示します。このイベントは、法務チームが契約ステータスを「Legal Approved」などに更新したり、特定の承認タスクを完了したりしたときに記録されることが多いです。
その重要性法務審査は、重要かつしばしば長期間にわたるステップです。このアクティビティの期間を特定することは、法務チーム内のボトルネックを特定し、SLA遵守の監視を支援します。取得元ステータス変更（例：「In Legal Review」から「Legal Approved」へ）から推測されるか、Agiloftの法務グループに割り当てられたリンクされた承認レコードの完了から取得されます。取得ステータスが「法務承認済み」に変更されたタイムスタンプ、または特定の法務承認タスクが完了としてマークされたタイムスタンプを使用します。イベントタイプ inferred
	コンプライアンスレビュー実施済み	有効な契約に対するスケジュールされた、またはアドホックなコンプライアンスレビューの完了を示します。これは通常、ユーザーがコンプライアンス関連タスクを完了するか、レビューフィールドを更新したときに記録される明示的なイベントです。
その重要性コンプライアンス審査の追跡は、ガバナンスとリスク管理に不可欠です。このアクティビティは、組織が契約期間全体にわたって規制および社内ポリシーの要件を満たしていることを確認するのに役立ちます。取得元コンプライアンスレビューのためのリンクされたタスクレコードの完了タイムスタンプ、または「Last Compliance Review Date」のような日付フィールドが入力されたことから取得されます。取得専用のコンプライアンス関連タスクの完了日、または審査完了時に更新される特定の日付フィールドを使用します。イベントタイプ explicit
	内部レビュー提出済み	このアクティビティは、起草された契約が正式に社内関係者による審査のために送付される時点を示します。これは通常、Agiloftのワークフローにおけるステータス変更（例：「ドラフト」から「社内審査中」への移行）によって捕捉されます。
その重要性このイベントは審査フェーズを開始し、これはしばしばボトルネックの原因となります。このイベントとそれに続く審査アクティビティ間の時間を分析することは、審査サイクルタイムを理解し改善するために重要です。取得元メイン契約レコードで、「In Review」、「Pending Internal Review」、または「Submitted for Review」のような値へのステータスフィールド変更のタイムスタンプから推測されます。取得契約の履歴ログで「Internal Review」状態へのステータス変更を探します。イベントタイプ inferred
	取引先との交渉開始	このアクティビティは、契約が外部の相手方へ審査と交渉のために送付される瞬間を示します。Agiloftでは、これはステータスが「交渉中」または「外部審査中」に変更されたことから推測できます。
その重要性これは交渉フェーズの開始を示します。このフェーズは非常に変動しやすく予測不可能です。これを追跡することは、交渉サイクルタイムを測定および分析し、この段階を長期化させる要因を特定するのに役立ちます。取得元契約レコードの履歴で、契約のステータスフィールドが「In Negotiation」、「With Counterparty」、または「External Review」に更新されたときのタイムスタンプから推測されます。取得外部とのコミュニケーションまたは交渉を示すステータス変更の最初のタイムスタンプを特定します。イベントタイプ inferred
	契約が有効化されました	契約が有効かつ執行可能になることを表し、通常は実行日以降に発生します。これはしばしば、Agiloft内で「Executed」から「Active」または「Live」へのステータス変更として記録されます。
その重要性このアクティビティは、契約締結後のライフサイクルを正式に開始し、義務、監視、およびコンプライアンス関連のタスクをトリガーします。これは、有効な契約のパフォーマンスと管理を追跡するための明確な開始点となります。取得元契約の履歴ログで「Active」へのステータス変更から推測されるか、「Contract Start Date」フィールドに基づいて計算されます。取得ステータスが「アクティブ」に変更されたタイムスタンプ、または「有効開始日」フィールドの値を使用します。イベントタイプ inferred
	契約キャンセル済み	契約要求または処理中の契約が、実行前に意図的にキャンセルされたことを示します。これは明示的な最終ステータスであり、通常、ユーザーがステータスを「Canceled」または「Withdrawn」に変更することによって記録されます。
その重要性これは、プロセスの失敗または終了経路を表します。契約がキャンセルされる理由を分析することで、資格審査または交渉段階の問題を特定し、無駄な労力を削減するのに役立ちます。取得元契約履歴で「Canceled」、「Void」、「Withdrawn」のような最終的で非成功的な値へのステータスフィールド変更のタイムスタンプから推測されます。取得「Canceled」状態へのステータス変更のタイムスタンプを探します。イベントタイプ inferred
	契約変更開始	このイベントは、既存の有効な契約に対する正式な変更プロセスが開始されたことを示します。Agiloftでは、これは多くの場合、元の契約にリンクされた新しい「変更契約」レコードの作成によって捕捉されます。
その重要性契約変更は、契約ライフサイクルにおける重要な変化を表します。その頻度と実行プロセスを分析することで、変化するビジネスニーズや当初の契約の明確性に関する洞察が得られます。取得元このイベントは、専用の「修正」テーブルにおける新規レコードの作成タイムスタンプから捕捉され、親契約IDにリンクされます。取得変更契約テーブルからのレコード作成タイムスタンプを使用します。イベントタイプ explicit
	契約書ドラフト作成済み	最初の契約ドラフトの完了を表します。これは通常、契約書の最初のバージョンがアップロードされて契約レコードに関連付けられたとき、または契約ステータスが「Drafting Complete」に変更されたときに記録されます。
その重要性このアクティビティを追跡することは、作成フェーズの効率性を測定するのに役立ちます。この時点以降の複数の改訂は、テンプレートまたは初期要件の問題を示す可能性があるため、手戻りを分析するための前提条件となります。取得元ステータスフィールドの変更（例：「New」から「Drafting」へ）から推測されるか、Agiloftの「Attached Files」関連テーブルにおける最初のドキュメントバージョン添付のタイムスタンプから取得されます。取得「Drafting」または「Review」ステータスへの最初のステータス変更のタイムスタンプ、または最初の関連ドキュメントレコードの作成日を特定します。イベントタイプ inferred
	契約朱書き/改訂済み	交渉中または内部レビュー中に契約書が改訂または朱書きされたインスタンスを表します。これは通常、契約書の新しいバージョンがAgiloftにアップロードされたときに明示的に記録されます。
その重要性このアクティビティは、手戻りループを特定するために非常に重要です。頻繁な改訂は、不明確な条件、不適切なテンプレート、または意見の対立が多い交渉を示唆する可能性があり、これらすべてが契約サイクルタイムを延長します。取得元 Agiloftの「Attached Files」内の新しいドキュメントバージョンの作成タイムスタンプ、または契約レコードにリンクされた専用のバージョン履歴テーブルから取得されます。取得契約の文書バージョン履歴における各新規レコードの作成タイムスタンプを使用します。イベントタイプ explicit
	署名依頼済み	このアクティビティは、最終的に承認された契約がすべての当事者による締結のために発送されたことを示します。e署名統合を備えたAgiloftのようなシステムでは、これは署名プロセスをトリガーする明確なアクションとなることがよくあります。
その重要性このイベントは、最終実行フェーズの開始に関する明確なタイムスタンプを提供します。この時点から「契約締結済み」までの時間を分析することは、署名プロセス自体の遅延を特定するのに役立ちます。取得元契約履歴に記録された明示的なユーザーアクション、またはAgiloftが統合しているDocuSignやAdobe Signのような電子署名サービスへのAPIコールを介して取得されます。取得「署名依頼」アクションまたは統合呼び出しに関連付けられた履歴ログからのタイムスタンプを使用します。イベントタイプ explicit

推奨任意

抽出ガイド

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

ステップ

Python環境の準備: Python 3.6以降がインストールされていることを確認してください。必要なライブラリをpipでインストールします: pip install requests pandas。
Agiloft資格情報の取得: ご使用のアジロフトインスタンスにログインしてください。APIベースURL（例: https://[your_domain].agiloft.com/gui2/rest）、有効なユーザー名とパスワード、およびAPIキーが必要です。APIキーの取得と、ユーザーロールにAPIアクセス権限があることを確認するため、アジロフト管理者にご相談ください。
知識ベース名の特定: アジロフトの契約管理知識ベースに移動し、正確なAPI名を特定してください。これは表示名と異なる場合があります。管理者からこの情報を入手できます。このガイドでは、名前をcontractと仮定します。
Pythonスクリプトの設定: 提供されたPythonスクリプトをエディタで開いてください。BASE_URL、USERNAME、PASSWORD、API_KEY、KB_NAMEのプレースホルダー値を、ご使用のアジロフトの具体的な詳細情報に置き換えてください。
抽出日付範囲の設定: スクリプトの設定セクションで、抽出する日付範囲を定義するためにSEARCH_FILTER変数を調整してください。このフィルターは通常、データ量を制限するために「作成日」または「最終更新日」フィールドを対象とします。
スクリプトの実行: ターミナルからコマンドpython your_script_name.pyを使用してスクリプトを実行してください。スクリプトはアジロフトAPIで認証し、契約レコードをページごとに取得し、各契約の履歴を処理します。
履歴データの処理: スクリプトは各契約の履歴ログを繰り返し処理します。ステータス変更やレコード作成などの特定の履歴イベントを、イベントログに必要な標準のActivityName値にマッピングします。
計算イベントの処理: スクリプトには、「契約期限切れ」アクティビティを導出するロジックが含まれています。これは、実行時の現在日付と比較して、有効な契約の有効期限日を確認します。
データの変換と構造化: スクリプトはpandasライブラリを使用して、抽出されたイベントを表形式に構造化し、必要なすべての列と推奨される列が存在することを確認します。
イベントログファイルの生成: 正常に実行されると、スクリプトは同じディレクトリにagiloft_contract_event_log.csvという名前のCSVファイルを生成します。このファイルはProcessMindへの直接アップロード用にフォーマットされています。

設定

API認証情報: REST APIを介して契約データを読み取るのに十分な権限を持つユーザーアカウントのUSERNAME、PASSWORD、およびAPI_KEYを提供する必要があります。
ベースURL: BASE_URLは、お客様固有のAgiloftインスタンスのRESTエンドポイントを指している必要があります。
知識ベース名: KB_NAME変数は、Agiloftの契約テーブルの正確なAPI名に設定する必要があります。
日付範囲フィルター: スクリプト内のSEARCH_FILTERは、パフォーマンス管理のため、抽出を過去6～12ヶ月などの関連する期間に限定するように設定する必要があります。date_createdまたはlast_modified_dateによるフィルタリングが一般的です。
ページネーション: PAGE_SIZE変数は、各API呼び出しでフェッチされるレコード数を制御します。通常、100から500の間の値がパフォーマンスとメモリ使用量のバランスが取れています。
フィールドマッピング: スクリプトには、Agiloftフィールド名を必要なイベントログ属性名にマッピングするためのセクションが含まれています。これらのマッピング（例: id、contract_type、contract_value）がAgiloftの設定と一致することを確認し、調整する必要があります。

a クエリ例 python

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

class=class="hl-string">"hl-comment"># --- CONFIGURATION --- #
class=class="hl-string">"hl-comment"># Replace with your Agiloft instance details
BASE_URL = class="hl-string">"https://[your_domain].agiloft.com/gui2/rest"
USERNAME = class="hl-string">"[your_api_user]"
PASSWORD = class="hl-string">"[your_api_password]"
API_KEY = class="hl-string">"[your_api_key]"
KB_NAME = class="hl-string">"contract"  class=class="hl-string">"hl-comment"># The API name of your contracts knowledgebase
PAGE_SIZE = 200

class=class="hl-string">"hl-comment"># Filter for contracts created in a specific range (adjust as needed)
class=class="hl-string">"hl-comment"># Format for Agiloft API dates is class="hl-string">'YYYY-MM-DD HH:MM:SS'
SEARCH_FILTER = {
    class="hl-string">"search_stype": class="hl-string">"field_based",
    class="hl-string">"searches": [
        {class="hl-string">"field": class="hl-string">"date_created", class="hl-string">"op": class="hl-string">"ge", class="hl-string">"val": class="hl-string">"2023-01-01 00:00:00"}
    ]
}

class=class="hl-string">"hl-comment"># --- SCRIPT --- #

def get_agiloft_session(base_url, username, password, api_key):
    class="hl-string">"""Authenticates with Agiloft and returns a session token."""
    login_url = fclass="hl-string">"{base_url}/login"
    headers = {class="hl-string">"Content-Type": class="hl-string">"application/json", class="hl-string">"API-Key": api_key}
    payload = {class="hl-string">"username": username, class="hl-string">"password": password}
    try:
        response = requests.post(login_url, headers=headers, json=payload, timeout=60)
        response.raise_for_status()
        return response.cookies
    except requests.exceptions.RequestException as e:
        print(fclass="hl-string">"Error: Authentication failed. {e}")
        return None

def fetch_all_records(session, base_url, kb_name, page_size, search_filter):
    class="hl-string">"""Fetches all records from a knowledgebase with pagination."""
    records = []
    page_num = 0
    while True:
        url = fclass="hl-string">"{base_url}/kb/{kb_name}"
        params = {
            class="hl-string">"page_size": page_size,
            class="hl-string">"page_num": page_num,
            class="hl-string">"view_name": class="hl-string">"Default",
            class="hl-string">"search": json.dumps(search_filter),
            class="hl-string">"fields": class="hl-string">"id,history,contract_status,contract_type,contract_value,created_by,owner_group,counterparty,expiration_date"
        }
        try:
            response = requests.get(url, cookies=session, params=params, timeout=120)
            response.raise_for_status()
            data = response.json()
            records.extend(data.get(class="hl-string">'records', []))
            if len(data.get(class="hl-string">'records', [])) < page_size:
                break
            page_num += 1
        except requests.exceptions.RequestException as e:
            print(fclass="hl-string">"Error fetching page {page_num}: {e}")
            break
    return records

def map_history_to_activity(entry_text):
    class="hl-string">"""Maps a history log entry to a defined activity name."""
    entry_lower = entry_text.lower()
    if class="hl-string">"record created by" in entry_lower:
        return class="hl-string">"Contract Request Initiated"
    if class="hl-string">"status changed from" in entry_lower:
        if class="hl-string">"draft" in entry_lower and class="hl-string">"internal review" in entry_lower:
            return class="hl-string">"Internal Review Submitted"
        if class="hl-string">"internal review" in entry_lower and class="hl-string">"legal approved" in entry_lower:
            return class="hl-string">"Legal Review Conducted"
        if class="hl-string">"drafting" in entry_lower and class="hl-string">"in negotiation" in entry_lower:
            return class="hl-string">"Counterparty Negotiation Started"
        if class="hl-string">"negotiation" in entry_lower and class="hl-string">"fully approved" in entry_lower:
            return class="hl-string">"Internal Approvals Obtained"
        if class="hl-string">"approved" in entry_lower and class="hl-string">"sent for signature" in entry_lower:
            return class="hl-string">"Sent For Signature"
        if class="hl-string">"signature" in entry_lower and class="hl-string">"executed" in entry_lower:
            return class="hl-string">"Contract Executed/Signed"
        if class="hl-string">"executed" in entry_lower and class="hl-string">"active" in entry_lower:
            return class="hl-string">"Contract Activated"
        if class="hl-string">"active" in entry_lower and class="hl-string">"renewed" in entry_lower:
            return class="hl-string">"Contract Renewed"
        if class="hl-string">"active" in entry_lower and class="hl-string">"terminated" in entry_lower:
            return class="hl-string">"Contract Terminated"
        if class="hl-string">"canceled" in entry_lower or class="hl-string">"withdrawn" in entry_lower:
            return class="hl-string">"Contract Canceled"
        if class="hl-string">"active" in entry_lower and class="hl-string">"amending" in entry_lower:
            return class="hl-string">"Amendment Initiated"
        if class="hl-string">"active" in entry_lower and class="hl-string">"compliance review" in entry_lower:
            return class="hl-string">"Compliance Review Performed"
    if class="hl-string">"a new file was attached" in entry_lower:
        return class="hl-string">"Contract Redlined/Revised"
    if class="hl-string">"status changed to 'drafting complete'" in entry_lower:
        return class="hl-string">"Contract Drafted"
    return None


def main():
    print(class="hl-string">"Starting Agiloft data extraction...")
    session = get_agiloft_session(BASE_URL, USERNAME, PASSWORD, API_KEY)
    if not session:
        return

    print(fclass="hl-string">"Fetching records from '{KB_NAME}' knowledgebase...")
    contracts = fetch_all_records(session, BASE_URL, KB_NAME, PAGE_SIZE, SEARCH_FILTER)
    print(fclass="hl-string">"Found {len(contracts)} contract records.")

    if not contracts:
        print(class="hl-string">"No contracts found for the specified criteria.")
        return

    event_log_rows = []
    last_data_update = datetime.now().strftime(class="hl-string">'%Y-%m-%d %H:%M:%S')

    for contract in contracts:
        contract_id = contract.get(class="hl-string">'id')
        history_raw = contract.get(class="hl-string">'history', class="hl-string">'')

        class=class="hl-string">"hl-comment"># Process history entries
        if history_raw:
            history_entries = history_raw.split(class="hl-string">'\n')
            for entry in history_entries:
                if not entry.strip():
                    continue
                
                activity_name = map_history_to_activity(entry)
                if activity_name:
                    try:
                        class=class="hl-string">"hl-comment"># Agiloft history format: class="hl-string">'YYYY-MM-DD HH:MM:SS [User Name]: Event Description'
                        timestamp_str = entry.split(class="hl-string">' [')[0]
                        event_time = datetime.strptime(timestamp_str, class="hl-string">'%Y-%m-%d %H:%M:%S').isoformat() + class="hl-string">'Z'
                        user_name = entry.split(class="hl-string">'[')[1].split(class="hl-string">']')[0]
                    except (IndexError, ValueError):
                        event_time = None
                        user_name = class="hl-string">'System'

                    event_log_rows.append({
                        class="hl-string">"ContractId": contract_id,
                        class="hl-string">"ActivityName": activity_name,
                        class="hl-string">"EventTime": event_time,
                        class="hl-string">"UserName": user_name,
                        class="hl-string">"UserDepartment": contract.get(class="hl-string">'owner_group'),
                        class="hl-string">"ContractType": contract.get(class="hl-string">'contract_type'),
                        class="hl-string">"ContractValue": contract.get(class="hl-string">'contract_value'),
                        class="hl-string">"ContractStatus": contract.get(class="hl-string">'contract_status'),
                        class="hl-string">"CounterpartyName": contract.get(class="hl-string">'counterparty'),
                        class="hl-string">"ExpirationDate": contract.get(class="hl-string">'expiration_date'),
                        class="hl-string">"EventEndTime": None,  class=class="hl-string">"hl-comment"># Populate if available
                        class="hl-string">"SourceSystem": class="hl-string">"Agiloft",
                        class="hl-string">"LastDataUpdate": last_data_update
                    })

        class=class="hl-string">"hl-comment"># Handle calculated class="hl-string">'Contract Expired' event
        exp_date_str = contract.get(class="hl-string">'expiration_date')
        current_status = contract.get(class="hl-string">'contract_status', class="hl-string">'').lower()
        if exp_date_str and current_status not in [class="hl-string">'terminated', class="hl-string">'canceled', class="hl-string">'expired']:
            try:
                exp_date = datetime.strptime(exp_date_str, class="hl-string">'%Y-%m-%d %H:%M:%S')
                if exp_date < datetime.now():
                    event_log_rows.append({
                        class="hl-string">"ContractId": contract_id,
                        class="hl-string">"ActivityName": class="hl-string">"Contract Expired",
                        class="hl-string">"EventTime": exp_date.isoformat() + class="hl-string">'Z',
                        class="hl-string">"UserName": class="hl-string">"System",
                        class="hl-string">"UserDepartment": contract.get(class="hl-string">'owner_group'),
                        class="hl-string">"ContractType": contract.get(class="hl-string">'contract_type'),
                        class="hl-string">"ContractValue": contract.get(class="hl-string">'contract_value'),
                        class="hl-string">"ContractStatus": class="hl-string">"Expired",
                        class="hl-string">"CounterpartyName": contract.get(class="hl-string">'counterparty'),
                        class="hl-string">"ExpirationDate": contract.get(class="hl-string">'expiration_date'),
                        class="hl-string">"EventEndTime": None,
                        class="hl-string">"SourceSystem": class="hl-string">"Agiloft",
                        class="hl-string">"LastDataUpdate": last_data_update
                    })
            except ValueError:
                pass class=class="hl-string">"hl-comment"># Ignore invalid date formats

    if not event_log_rows:
        print(class="hl-string">"No process events could be generated from the contract histories.")
        return

    df = pd.DataFrame(event_log_rows)
    df = df.sort_values(by=[class="hl-string">'ContractId', class="hl-string">'EventTime']).reset_index(drop=True)
    
    class=class="hl-string">"hl-comment"># Reorder columns for clarity
    column_order = [
        class="hl-string">'ContractId', class="hl-string">'ActivityName', class="hl-string">'EventTime', class="hl-string">'EventEndTime', class="hl-string">'UserName',
        class="hl-string">'UserDepartment', class="hl-string">'ContractType', class="hl-string">'ContractValue', class="hl-string">'ContractStatus',
        class="hl-string">'CounterpartyName', class="hl-string">'ExpirationDate', class="hl-string">'SourceSystem', class="hl-string">'LastDataUpdate'
    ]
    df = df[column_order]

    output_filename = class="hl-string">'agiloft_contract_event_log.csv'
    df.to_csv(output_filename, index=False)
    print(fclass="hl-string">"Extraction complete. Event log saved to {output_filename}")

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

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

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

契約管理属性

契約管理アクティビティ

抽出ガイド

Agiloft REST API経由のPythonスクリプト抽出

ステップ

設定

a クエリ例 python

今すぐ始めますか？

Agiloft契約管理を最適化し、今すぐサイクルタイムを短縮

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

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

契約管理属性

契約管理アクティビティ

抽出ガイド

Agiloft REST API経由のPythonスクリプト抽出

ステップ

設定

a クエリ例 python

お客様のプライバシーを大切にしています

今すぐ始めますか？

Agiloft契約管理を最適化し、今すぐサイクルタイムを短縮