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

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

SAP Ariba Contracts

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

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

このテンプレートでは、契約管理プロセスを分析するために必要なデータの収集方法を詳しく説明します。収集すべき必須属性、追跡すべき主要アクティビティ、ソースシステムから情報を抽出するための手順をまとめています。この資料を使ってデータ準備を効率化し、プロセスマイニングを始めてください。

収集を推奨する属性
追跡すべき契約管理の主要アクティビティ
データ抽出の手順

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

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

契約管理の属性

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

3 必須 6 推奨 10 任意

	名前	説明
	アクティビティ ActivityName	発生した特定の業務プロセスのステップまたはイベントの名称です。
説明この属性は、特定の時点で完了したタスクまたはマイルストーンを示します。たとえば、「契約書のドラフト作成」や「法務レビューの開始」などです。これらのアクティビティの順序が、プロセスマップの基礎になります。アクティビティを分析することで、どの作業が行われているか、各ステップがどの程度の頻度で発生するか、どのような順序で進むかを把握できます。一般的なプロセス経路、逸脱、また「契約書の修正」の繰り返しのような手戻りループを特定できます。重要な理由プロセスの各ステップを定義し、プロセスフローの可視化とボトルネックおよび手戻りの特定を可能にします。入手先通常は、SAP Ariba Contractsモジュール内のタスクのステータス変更、監査ログ、またはイベントテーブルから取得します。例社内レビューを開始契約を締結契約変更の開始契約終了
	イベントタイムスタンプ EventTime	アクティビティまたはイベントが発生した正確な日時です。
説明このタイムスタンプは、契約管理プロセスにおける各アクティビティの開始時点を示します。サイクルタイム、所要時間、ステップ間の待ち時間など、時間に基づくすべての分析に欠かせません。このタイムスタンプに基づいてイベントを並べ替えることで、プロセスマイニングツールは契約ごとのアクティビティの順序を正確に再構成できます。これにより、時間の経過に伴うプロセスパフォーマンスを分析し、法務レビュー段階の遅延など、時間に関するボトルネックを特定できます。重要な理由サイクルタイムや待ち時間など、時間に基づくすべての指標を計算し、プロセスイベントを正しい順序に並べるための基本属性です。入手先 SAP Ariba Contractsでは、通常、アクティビティ情報とともにイベントログ、監査証跡、またはステータス変更履歴テーブルに記録されています。例 2023-04-15T10:22:05Z2023-05-01T14:00:12Z2023-05-20T09:30:00Z
	契約ID ContractId	各Contract Workspaceを一意に識別するIDであり、主要なケース識別子として機能します。
説明この属性は主要なケース識別子として機能し、契約ライフサイクル全体のすべてのアクティビティとイベントを関連付けます。契約ごとに、作成から終了までの一連の流れを再構成できます。プロセスマイニングでは、同じ契約IDを持つすべてのイベントが、同じプロセスインスタンスの一部とみなされます。これは、プロセスバリアントの分析、サイクルタイムの計算、個々の契約または契約タイプに固有のボトルネックの特定に欠かせません。重要な理由契約の全行程を追跡するための基本キーであり、ケース単位の分析とプロセスフローの可視化を可能にします。入手先 SAP Ariba Contractsの中核となる識別子で、通常は契約関連のすべてのテーブルとビューにContract Workspace IDとして存在します。例 CW2023-00123CW-MSA-45892CW2024-FIN-001CW19876
	イベント終了時刻 EventEndTime	アクティビティが完了した時刻を示すタイムスタンプです。
説明この属性は、アクティビティの完了時刻を取得します。StartTimeが開始を示すのに対し、EndTimeは終了を示すため、瞬時に完了しないアクティビティの所要時間を正確に測定できます。分析では、EndTimeとStartTimeの差からアクティビティの処理時間を算出します。これは、ボトルネックの詳細な分析に欠かせません。タスクに実際に取り組んでいた時間と、タスク間の待ち時間を区別できます。たとえば、「法務レビュー」アクティビティの所要時間を正確に測定できます。重要な理由アクティビティの処理時間を正確に計算できるため、ボトルネックの特定とリソース効率の測定に役立ちます。入手先 SAP Ariba Contractsのドキュメントを参照してください。監査ログまたはタスク完了記録に記載されている場合があります。例 2023-04-16T11:45:10Z2023-05-03T17:21:09Z2023-05-20T10:05:00Z
	ユーザー UserName	アクティビティを実行したユーザーの名前またはIDです。
説明この属性は、契約ライフサイクルにおける特定のタスクまたはアクティビティの完了責任者を識別します。契約担当者、法務レビュー担当者、承認者などが該当します。ユーザー単位で分析すると、作業負荷の分布や個人のパフォーマンスを把握し、対象を絞ったトレーニングの機会を特定できます。たとえば、「法務レビューの作業負荷」ダッシュボードでは、各法務担当者が処理している契約数と平均レビュー時間を確認できます。重要な理由作業負荷の分布とユーザーのパフォーマンスを可視化し、リソース管理と効率分析を可能にします。入手先 SAP Ariba Contractsの監査証跡またはイベントログテーブルに記録され、通常は「Changed By」または「User ID」フィールドに関連付けられています。例 john.doejane.smithlegal_team_member_1
	契約タイプ ContractType	MSA、NDA、SOWなど、契約の分類です。
説明この属性は、契約を法的または業務上の目的に基づいて分類します。一般的なタイプには、Master Service Agreement（MSA）、Non-Disclosure Agreement（NDA）、Statement of Work（SOW）があります。契約タイプ別にプロセスを分析することは、プロセスの違いを把握するために欠かせません。契約タイプによって、承認経路、SLA、複雑さが異なることがよくあります。たとえば、NDAは単純で迅速なプロセスになる一方、MSAでは複数段階の法務および財務レビューが必要になる場合があります。この属性は、契約カテゴリー間でサイクルタイムやコンプライアンス率を比較するダッシュボードの主要なフィルターです。重要な理由分析を分けて表示できるため、契約タイプの違いがプロセスフロー、複雑さ、所要時間に与える影響を明らかにできます。入手先 SAP Ariba Contractsの契約ワークスペース詳細に用意されている標準的な分類フィールドです。例基本サービス契約秘密保持契約作業範囲記述書販売契約
	契約金額 ContractAmount	契約の総額です。
説明この属性は、契約の金銭的価値を示します。各契約のビジネスへの影響とリスクを把握するための重要な指標です。分析では、契約金額を使って高額契約を優先的に監視したり、取引量の傾向を特定したりできます。「締結済み契約金額の推移」ダッシュボードでは、この属性を使って期間ごとに締結された契約金額を集計し、ビジネスパフォーマンスを把握します。また、高額契約が異なる、場合によっては遅いプロセスをたどっているかを確認する根本原因分析にも役立ちます。重要な理由契約による財務上の影響を数値化し、金額に基づく分析、優先順位付け、ビジネスパフォーマンスの追跡を可能にします。入手先 SAP Ariba Contractsのドキュメントを参照してください。契約ワークスペースの標準フィールドで、通常は「Amount」または「Contract Value」と表示されます。例 150000.0025000.501200000.00
	法務担当者 LegalCounsel	契約のレビューを担当する、割り当て済みの法務チームメンバーです。
説明この属性は、契約の法務レビュー・タスクを担当する弁護士または法務専門家を特定します。ほかのアクティビティを実行する一般ユーザーよりも、具体的な役割を示すことがよくあります。この属性は、「法務レビューの作業負荷と効率」ダッシュボードに欠かせません。担当者ごとの契約割り当て数、平均レビュー時間、法務部門全体の処理量を追跡できます。これにより、作業負荷のバランス調整、パフォーマンスの高い担当者や業務方法の特定、法務リソースの配分改善が可能になります。重要な理由法務レビュー段階を詳細に分析できるため、法務チームの作業負荷を管理し、ボトルネックを特定して効率を高められます。入手先 SAP Ariba Contractsのドキュメントを参照してください。タスクの割り当て詳細または承認フロー内の特定の役割として取得できる場合があります。例 s.jonesm.riverad.chen
	部門 Department	契約を開始した、または契約を所管する業務部門です。
説明この属性は、契約を担当する組織上の部門を示します。営業、IT、調達などが該当します。プロセスを分析するための重要な業務コンテキストを提供します。部門別にプロセスを分析すると、部門固有の行動、ボトルネック、コンプライアンス上の問題を特定できます。たとえば、営業部門の契約承認プロセスが他部門より大幅に遅いことが分かり、固有の業務慣行を詳しく調査できます。重要な理由業務領域別にプロセスを分けて分析できるため、部門固有のボトルネックやパフォーマンスの違いを特定できます。入手先通常は、SAP Ariba Contractsの契約ヘッダーまたはワークスペースの詳細に記録されています。契約担当者のユーザープロファイルに関連付けられている場合があります。例営業情報技術調達法務
	SLA遵守ステータス SlaAdherenceStatus	レビュー・アクティビティが定義されたSLA内に完了したかどうかを示します。
説明「レビューのSLA」に対する完了時間に基づき、レビュー・アクティビティを「達成」、「超過」、「該当なし」に分類する属性です。「ActivityProcessingTime」と目標SLA期間を比較して算出します。サービスレベル契約に対するパフォーマンスを明確かつ迅速に評価できます。「社内・法務レビューのSLA遵守」KPIとダッシュボードの中核指標です。このステータスを可視化すると、遵守できたレビューの割合をすぐに確認し、超過したケースを掘り下げて原因を把握できます。重要な理由サービス目標に対するパフォーマンスを直接測定し、SLA遵守状況の明確なモニタリングと超過の迅速な特定を可能にします。入手先データ変換時にActivityProcessingTimeとSlaForReviewを比較して算出する派生属性です。例達成違反該当なし
	ソースシステム SourceSystem	データの取得元となる記録システムです。
説明この属性は、イベントデータが生成されたソースシステムを識別します。このプロセスでは、常に「SAP Ariba Contracts」となります。この属性を含めることは、データガバナンスとトレーサビリティの観点から推奨される方法です。複数のシステムのデータを統合する場合に特に重要で、データの出所を明確にし、データ品質の問題を調査しやすくします。重要な理由データの出所に関する重要なコンテキストを提供し、トレーサビリティを確保するとともに、複数システムにまたがる分析を可能にします。入手先通常は、データの抽出および変換時に追加される固定値で、データセットの出所を示します。例 SAP Ariba Contracts
	レビューのSLA SlaForReview	レビュー・アクティビティを完了するための目標所要時間または期限です。
説明この属性は、「社内レビュー」や「法務レビュー」など、特定のレビュー・タスクに合意されたサービスレベル契約（SLA）を定義します。レビューを完了すべき目標時間を示します。この属性は、「社内・法務レビューのSLA遵守」ダッシュボードとKPIに欠かせません。実際のレビュー時間と目標を比較することで、組織は社内のサービスレベルを測定できます。恒常的な遅延の特定、チームへの説明責任の明確化、レビュー工程が大きなボトルネックになることの防止に役立ちます。重要な理由レビュー・アクティビティのパフォーマンス目標を設定し、SLA遵守状況の測定と遅延の特定を可能にします。入手先 SAP Ariba Contractsのドキュメントを参照してください。承認ワークフローのルールまたはテンプレート内で設定されている場合があります。例 P3DP5DP10D
	最終データ更新 LastDataUpdate	このイベントのデータが最後に更新または抽出された時刻を示すタイムスタンプです。
説明この属性は、ソースシステムから最後にデータを取得した日時を記録します。イベントが発生した時刻ではなく、レコードがプロセスマイニングプラットフォームに読み込まれた時刻を示します。この情報は、データガバナンスと分析データの鮮度を把握するために欠かせません。最新のデータを確認しているかどうかを判断でき、増分データロードの管理にも必要です。重要な理由データの新しさを把握できるため、正確かつタイムリーなプロセス分析とモニタリングに役立ちます。入手先このタイムスタンプは、プロセスマイニングツールへのデータ取り込み時に生成および追加されます。例 2024-05-21T02:00:00Z2024-05-22T02:00:00Z
	地域 Region	契約または相手方に関連付けられた地理的地域です。
説明この属性は、契約が適用される地理的地域を示します。北米、EMEA、APACなどが該当します。通常は、相手方の所在地または契約を所管する事業部門によって決まります。地域別にプロセスを分けると、パフォーマンス、コンプライアンス、プロセスの進み方における地域差を特定できます。たとえば、APAC地域の契約サイクルタイムが、特定の規制レビュー工程によって長くなっていることが分かる場合があります。この情報をもとに、地域のニーズに合わせてプロセス改善やリソース配分を調整できます。重要な理由地域別に分析できるため、プロセスパフォーマンス、サイクルタイム、コンプライアンスの違いを特定できます。入手先 SAP Ariba Contractsのドキュメントを参照してください。契約ワークスペースのフィールドである場合と、相手方の住所から導出される場合があります。例北米EMEAAPACLATAM
	契約ステータス ContractStatus	契約ライフサイクルにおける現在の全体的なステータスです。
説明この属性は、「Draft」、「In Review」、「Executed」、「Expired」、「Terminated」など、契約の現在の大まかな状態を示します。単一のイベントであるアクティビティとは異なり、ステータスは一定期間にわたる状態を表します。この属性は、「契約義務・更新ステータス」などのダッシュボードに欠かせず、現在の契約ポートフォリオを把握できます。停滞している契約の特定や、更新・満了などのライフサイクルイベントの管理にも役立ちます。ステータス間の遷移を分析すると、プロセスのボトルネックや非効率も明らかにできます。重要な理由契約の現在の状態を大まかに把握できるため、ポートフォリオ管理、ステータス追跡、ライフサイクル分析に役立ちます。入手先 SAP Ariba Contractsの契約ワークスペースヘッダーにある主要なステータスフィールドです。例草案承認中締結済み期限切れ
	契約の総サイクルタイム TotalContractCycleTime	契約ワークスペースの作成から最終的な契約締結までに経過した合計時間です。
説明この計算属性は、1件の契約にかかるエンドツーエンドの全期間を測定します。通常は、最初のアクティビティと最後のアクティビティ、たとえば「Contract Workspace Created」と「Contract Executed」の時間差として算出します。これは主要なKPIである「エンドツーエンドの契約サイクルタイム」です。契約管理プロセス全体の効率を大まかに測定できます。ダッシュボードで経時的なパフォーマンスを追跡したり、契約タイプ、部門、地域ごとにサイクルタイムを比較したりするために使われ、改善すべき主な領域の特定に役立ちます。重要な理由プロセスの速度と効率を総合的に測定し、契約ライフサイクル全体のパフォーマンスを1つの指標に集約します。入手先プロセスマイニングツール内またはデータ変換時に、ケース単位で算出する計算指標です。例 P35DP12DT5HP90D
	契約満了日 ContractExpirationDate	契約が満了するよう設定された日付です。
説明この属性は、締結済み契約の正式な満了日を保存します。契約締結後のライフサイクルを管理するための重要なデータです。この日付は、「契約義務・更新ステータス」ダッシュボードの基礎となります。更新や満了が近づいた契約のアラートに使われ、契約が意図せず失効することを防ぎます。このデータを分析すると、組織は契約ポートフォリオを先回りして管理し、契約満了に伴うリスクを抑え、更新機会を逃さずに済みます。重要な理由ライフサイクルを先回りして管理するために欠かせません。適切なタイミングでの更新、意図しない失効の防止、義務の管理を可能にします。入手先 SAP Ariba Contractsの契約ワークスペースにある標準フィールドで、通常はヘッダーまたは契約条件の詳細セクションに記録されています。例 2025-12-31T23:59:59Z2024-08-15T23:59:59Z2026-06-30T23:59:59Z
	手戻りかどうか IsRework	アクティビティが、前のステップの手戻りまたは繰り返しであるかを示すフラグです。
説明このブール型属性は、「契約書の修正」などのアクティビティが同じ契約ケース内で複数回発生した場合にtrueになります。プロセス内の手戻りループを明示的に特定し、数値化できます。このフラグは、「契約手戻り率」KPIの計算と、プロセスマップ上での手戻りの可視化に欠かせません。この属性でフィルターすると、大幅な修正が必要だった契約をすぐに抽出し、根本原因を調査して、手戻りが全体のサイクルタイムに与えた影響を測定できます。ドラフト作成と交渉の段階における非効率を明らかにします。重要な理由手戻りを数値化し、プロセスの非効率の測定、根本原因の分析、改善状況の経時的な追跡を容易にします。入手先同じケース内でアクティビティが繰り返されたことを検出し、データ変換時に算出する派生属性です。例 truefalse
	相手方名 CounterpartyName	契約の相手となる外部組織の名称です。サプライヤーや顧客などが該当します。
説明この属性は、契約に関与する相手方を識別します。ベンダー、顧客、パートナーなどが該当します。契約管理プロセスに重要な業務コンテキストを加えます。相手方別に分析すると、特定のパートナーに関する傾向を特定できます。たとえば、特定の相手方との交渉に一貫して時間がかかる場合、標準テンプレートや事前合意済みの条件が必要だと判断できます。契約ポートフォリオ全体で、関係性の健全性やサプライヤーのパフォーマンスを評価することも可能です。重要な理由外部の相手方に基づいてプロセスパフォーマンスを分析できるため、交渉上の難しさを特定し、サプライヤーとの関係を管理できます。入手先通常は、SAP Ariba Contractsの契約ワークスペースにあるサプライヤーまたは顧客情報のセクションに保存されます。例 Acme CorporationGlobal Tech Inc.Innovate Solutions LLC

必須推奨任意

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

契約管理プロセスを正確にディスカバリーするために、イベントログに記録すべき主要なプロセス手順と重要なマイルストーンです。

6 推奨 8 任意

	アクティビティ	説明
	契約ワークスペースを作成	このアクティビティは、契約管理プロセスの開始を示します。SAP Aribaで契約ワークスペースが作成され、特定の契約に関するすべての文書、タスク、コミュニケーションの一元管理場所になります。
重要な理由エンドツーエンドのプロセスにおける主要な開始イベントです。このアクティビティから締結までの時間を分析することで、契約ライフサイクル全体の所要時間を測定できます。入手先このイベントは、契約ワークスペースのプロジェクトオブジェクトの作成日時から取得します。契約ヘッダーまたはプロジェクトデータで利用できる基本的なタイムスタンプです。取得契約ワークスペースオブジェクトの作成タイムスタンプを使用します。イベントタイプ explicit
	契約を有効化	実行済みの契約が有効になり、契約上の義務が発効する時点を示します。通常は、契約締結後のステータス変更によって発生し、指定された発効日が設定されている場合は、その日付に発生します。
重要な理由契約締結後の管理フェーズの開始を示します。義務の履行状況を監視するトリガーとなり、「義務履行率」KPIに欠かせません。入手先通常は、Contract Workspaceの「Status」フィールドが「Active」に変更されたことから推定します。契約締結後に自動的に変更される場合と、手動で変更される場合があります。取得契約の「Status」フィールドが「Active」に変更された時刻を記録します。イベントタイプ inferred
	契約を締結	必要なすべての署名が取得され、契約が正式に締結された状態です。処理中の文書が法的拘束力のある契約に移行します。
重要な理由署名前プロセスにおける主要な成功到達点です。「エンドツーエンドの契約サイクルタイム」と「契約承認の平均サイクルタイム」を算出するための基本となります。入手先 Aribaワークフロー内の署名タスクの最終完了ステータスから取得します。電子署名ツールと連携している場合に特に有効です。契約ワークスペースのステータスも「締結済み」に変わります。取得最終署名タスクの完了タイムスタンプ、またはステータスが「締結済み」に変更された時点を使用します。イベントタイプ explicit
	契約終了	契約がシステム上で正式に終了する終端アクティビティです。契約期間の満了、解約、またはすべての義務の履行完了後に発生します。
重要な理由契約ライフサイクルの最終的な終了を示します。ライフサイクル全体の期間を測定し、適切な終了処理が行われたことを確認するための重要な終了イベントです。入手先 Contract Workspaceの「Status」フィールドが「Closed」、「Terminated」、または「Expired」に変更されたことから推定します。ステータスは自動または手動で変更されます。取得契約の「Status」フィールドが終端状態に変更された時刻を記録します。イベントタイプ inferred
	法務レビューを開始	契約書が正式に法務部門へ提出され、レビューが開始されたことを示します。通常、承認ワークフロー全体の中で独立した必須タスクとして扱われます。
重要な理由法務レビューは大きなボトルネックになることが多く、その所要時間の測定は「法務レビューの平均サイクルタイム」KPIの把握と、法務リソースの配分最適化に欠かせません。入手先 Aribaワークフロー内の特定の「法務レビュー」タスクの開始時点から取得します。システムは、タスクが割り当てられた時点または開始された時点のタイムスタンプを記録します。取得法務チームまたは法務の役割に割り当てられたタスクの開始タイムスタンプを特定します。イベントタイプ explicit
	社内承認を完了	契約に必要なすべての社内承認タスクが正常に完了したことを示します。取引先の合意を待つ状態で、契約書が最終署名に進める段階になったことを意味します。
重要な理由締結前の重要なマイルストーンです。このイベントから最終締結までの時間によって、外部署名の取得や文書の最終確定に伴う遅延を把握できます。入手先 Aribaワークフロー内の最終承認タスクの完了タイムスタンプから取得します。承認フロー全体が正常に完了した時点をシステムが記録します。取得承認フロー全体のタスクグループの完了タイムスタンプを使用します。イベントタイプ explicit
	コンプライアンス・タスク完了	コンプライアンスレビューや義務の確認など、契約締結後に予定されたタスクの完了を示します。これらのタスクは、継続的なガバナンスを確保するために設定されます。
重要な理由これらのタスクの完了状況を追跡することは、「義務履行率」の測定と、組織が契約上の責任を果たしていることの確認に欠かせません。入手先 Contract Workspace内の特定のフォローアップ・タスクまたは義務関連タスクの完了時刻から取得します。取得ワークスペースに設定された契約締結後のタスクの完了時刻を使用します。イベントタイプ explicit
	取引先と交渉	契約書を外部の取引先と共有し、交渉や修正履歴の確認を行う段階を示します。このアクティビティは、ワークスペース内で手動でステータスを変更した時点から取得できる場合があります。
重要な理由予測が難しい外部との交渉サイクルを可視化します。この段階を測定することで、「平均交渉サイクル数」を算出し、複雑な交渉を特定できます。入手先通常、ワークスペースのステータスが「交渉中」や「サプライヤー対応中」などに手動で変更された時点から推定します。または、文書が外部連絡先に送信された時点から推定することもできます。取得外部レビューを示す値への契約ワークスペースのステータス変更を追跡します。イベントタイプ inferred
	取引先の承認を取得	外部の取引先が契約条件に正式に合意したことを示します。通常は、電子署名ソリューションとの連携によって取得するか、署名済み文書を受領した時点で手動更新します。
重要な理由このアクティビティは双方の合意を確認するもので、契約が法的に締結されたとみなされる前の最終ステップです。合意を確定するための重要なマイルストーンです。入手先 DocuSignなどの電子署名ツールから、「完了」ステータスを記録する明示的なイベントとして取得できます。または、ステータスが「取引先署名済み」に手動で変更されたことから推定することもできます。取得連携している電子署名プロバイダーのログから完了イベントを取得します。イベントタイプ explicit
	契約変更の開始	このアクティビティは、有効な契約に対する正式な変更の開始を示します。通常は、元のContract Workspaceに関連付けられた新しいバージョンまたはサブプロジェクトを作成します。
重要な理由変更の頻度とタイミングから、契約の安定性や変化するビジネスニーズを把握できます。「変更・終了の傾向」ダッシュボードに欠かせない指標です。入手先既存の契約に対してユーザーが「Amendment」プロセスを開始する明示的な操作であり、その操作はシステムに記録されます。取得契約変更用のワークスペースまたはタスクの作成イベントを取得します。イベントタイプ explicit
	契約更新完了	有効な契約が正常に更新されたことを示します。このプロセスでは、元の契約を引き継ぐ新しいContract Workspaceが作成されることがよくあります。
重要な理由契約の維持状況と更新効率の分析に役立ちます。契約ライフサイクルにおける重要な結果であり、継続的な取引関係を示します。入手先期限を迎える契約との関係リンク（例：「renewal of」）を持つ新しい契約が作成された時点で取得できます。多くの場合、ユーザーが明示的に実行する操作です。取得既存の契約に更新契約として関連付けられた新しい契約の作成を特定します。イベントタイプ explicit
	契約書をドラフト	ワークスペースに契約書の主要文書を初めて作成またはアップロードしたことを示します。通常、ワークスペースの設定後に行われる最初の主要なコンテンツ関連アクションです。
重要な理由このアクティビティを追跡すると、初稿の準備にかかった時間を把握できます。この段階の遅延は、全体のサイクルタイムに大きく影響する可能性があります。入手先契約ワークスペースの文書フォルダーにある主要契約文書の初版の作成タイムスタンプから推定できます。取得ワークスペースにアップロードされた最初の文書バージョンのタイムスタンプを特定します。イベントタイプ inferred
	契約書を修正	契約書の主要文書の新しいバージョンが作成またはアップロードされたときに発生します。通常、社内レビュー、法務レビュー、または取引先との交渉で受けたフィードバックへの対応として行われます。
重要な理由修正の頻度は、手戻りを直接示す指標です。このアクティビティを追跡することで、「契約手戻り率」を算出し、文言やプロセスを標準化する機会を特定できます。入手先契約ワークスペース内の文書管理システムから推定します。主要契約文書の新しいバージョンが保存されるたびに、タイムスタンプが作成されます。取得 2つ目以降の文書バージョンの作成タイムスタンプを使用します。イベントタイプ inferred
	社内レビューを開始	契約書のドラフトに対する社内レビューおよび承認ワークフローの開始を示します。文書は、財務や業務部門など、関係する関係者に回付され、フィードバックを受けます。
重要な理由潜在的なボトルネックの始まりを示します。この段階の所要時間を分析することは、社内レビューの遅延を特定し、「社内レビューSLA遵守率」KPIを支援するうえで重要です。入手先通常、SAP Aribaのワークフローエンジン内でレビュータスクが作成され、担当者に割り当てられた時点で記録されます。タスクのステータスは「進行中」または同様の状態に変わります。取得契約の承認ワークフローでレビュータスクが開始された時点のタイムスタンプを取得します。イベントタイプ explicit

推奨任意

抽出ガイド

SAP Ariba Contractsからデータを取得する方法

ステップ

Analytical Reportingにアクセス：SAP Aribaシステムにログインします。メインメニューをクリックし、Analytical Reports、またはManage > Analytical Reportsなどのメニューからレポートセクションに移動します。
新しいレポートを作成：Createをクリックし、New Reportを選択します。複数のファクトを含むレポートを作成します。
主要ファクトを選択：レポートビルダーで、主要なデータファクトとしてContract Workspace (Projects)を選択します。このファクトには、各契約ケースの基本情報が含まれています。
追加ファクトを結合：必要なアクティビティと属性をすべて取得するため、次のファクトをContract Workspace (Projects)に結合します。結合条件には共通のProject IdまたはContract Idフィールドを使います。
- Approval History：申請、承認、却下など、承認タスクの詳細を取得します。
- Task：すべてのワークフロータスク、その開始日と終了日、担当者の情報を取得します。
- Document：文書のバージョンを追跡します。Contract DraftedとContract Revisedのアクティビティを特定するために必要です。
レポートフィールドを定義（ピボット処理）：目的は、業務アクティビティごとに個別の行を作成することです。AribaのUIでは通常、契約ごとに1行が作成されるため、計算フィールドを手動で定義するか、横持ちのテーブルをエクスポートして後から変換する必要があります。推奨される方法は、各イベント候補のタイムスタンプ用に列を追加することです。例：
- Contract Workspace (Projects)ファクトのWorkspace Creation Date。
- DocumentファクトのMain Document Create Date（主要契約書かつ初版に絞り込み）。
- TaskファクトのLegal Review Start Date（特定の法務レビュ―タスクに絞り込み）。
- Contract Workspace (Projects)ファクトのExecution Date。
- 必須14アクティビティそれぞれのタイムスタンプ用に専用列を追加します。
属性フィールドを選択：Contract Id、Project Owner（UserName用）、Department、Amount（ContractAmount用）、Contract Typeなど、必須および推奨の属性フィールドをすべて追加します。
フィルターを適用：Filtersタブに移動します。Contract Workspace (Projects)ファクトのTime Createdに期間フィルターを設定し、直近6～12か月など、抽出対象を扱いやすい範囲に限定します。Project Typeなど、必要に応じて他のフィルターも追加し、契約ワークスペースだけを含めます。
データを実行してエクスポート：レポートを実行します。出力は、契約ごとに1行、さまざまな日付イベント用の多数の列を持つ横持ちのテーブルになります。このレポートをCSVまたはMicrosoft Excelファイルにエクスポートします。
データを変換：エクスポートしたファイルはイベントログではありません。変換が必要です。Microsoft Excel Power Query、Python、専用のETLツールなどを使ってデータをアンピボットします。エクスポートファイルの各行について、手順5で作成した日付列ごとに新しい行を1行ずつ作成します。これにより、横持ち形式がProcessMindに必要な縦持ちのイベントログ形式に変換されます。
イベントログを整形：変換後のファイルでは、列名を必須の形式に正確に合わせます。ContractId、ActivityName、EventTime、EventEndTime、UserNameなどです。タイムスタンプ列はYYYY-MM-DD HH:MI:SSのような統一形式にします。最終ファイルをCSVとして保存します。
ProcessMindにアップロード：作成したCSVファイルをプロセスマイニングツールにアップロードできる状態になりました。

設定

含めるファクト：レポートでは、複数のデータファクトを結合する必要があります。まずContract Workspace (Projects)を起点にし、完全な履歴を取得するため、Approval History、Task、文書化の各ファクトを結合します。
Date Range：初期分析では、Contract Workspace (Projects)ファクトのTime Createdフィールドに、直近6～12か月のフィルターを設定します。データ量が多い場合は、四半期または月単位の小さなバッチに分けてエクスポートすることを検討します。
Key Filters：契約ワークスペースだけを抽出し、ソーシングプロジェクトなど他のプロジェクト種別を除外するため、Project Typeで絞り込むことが重要です。分析対象を限定するため、部門またはCommodityで絞り込むこともできます。
Data Granularity：タスクの有効化日、承認日、文書作成日など、特定のイベントのタイムスタンプを提供するフィールドを選択します。具体的なイベントのコンテキストが失われるため、最終更新日のみを使用することは避けてください。
Prerequisites：SAP Aribaのユーザーアカウントには、分析レポートを作成および実行する権限が必要です。通常、Analysis UserやReporting Administratorなどのロールに割り当てられています。
Performance Considerations：複数のファクトを結合し、長い日付範囲で多数のフィールドをエクスポートすると、レポートの実行が非常に遅くなったり、タイムアウトしたりする場合があります。時間に余裕を持ち、業務の繁忙時間帯を避けるか、小さなバッチに分けてレポートを実行してください。

a サンプルクエリ sql

-- This is a logical representation of the report configuration in the SAP Ariba Analytical Reporting UI.
-- The tool does not use a direct query language; you build this logic by selecting facts, fields, and filters.
-- The final step requires transforming the wide export file into this long format.

-- FACT: Contract Workspace (Projects) as c
-- JOIN: Approval History as a ON c."Project Id" = a."Project Id"
-- JOIN: Task as t ON c."Project Id" = t."Project Id"
-- JOIN: Document as d ON c."Project Id" = d."Project Id"

-- Each of the following SELECT blocks represents a set of rows for a specific activity.

SELECT c."Contract Id" AS ContractId, 'Contract Workspace Created' AS ActivityName, c."Time Created" AS EventTime, NULL AS EventEndTime, c."Project Owner" AS UserName, c.Department, c.Amount AS ContractAmount, c."Contract Type Name" AS ContractType, c."Legal Contact" AS LegalCounsel FROM "Contract Workspace (Projects)" AS c
UNION ALL
SELECT c."Contract Id" AS ContractId, 'Contract Drafted' AS ActivityName, d."Time Created" AS EventTime, NULL AS EventEndTime, d."Created By" AS UserName, c.Department, c.Amount AS ContractAmount, c."Contract Type Name" AS ContractType, c."Legal Contact" AS LegalCounsel FROM "Contract Workspace (Projects)" AS c JOIN "Document" AS d ON c."Project Id" = d."Project Id" WHERE d."Is Main Agreement" = TRUE AND d.Version = 1
UNION ALL
SELECT c."Contract Id" AS ContractId, 'Internal Review Started' AS ActivityName, t."Activated Date" AS EventTime, t."Completed Date" AS EventEndTime, t.Assignee AS UserName, c.Department, c.Amount AS ContractAmount, c."Contract Type Name" AS ContractType, c."Legal Contact" AS LegalCounsel FROM "Contract Workspace (Projects)" AS c JOIN "Task" AS t ON c."Project Id" = t."Project Id" WHERE t."Task Name" LIKE '%Internal Review%'
UNION ALL
SELECT c."Contract Id" AS ContractId, 'Legal Review Started' AS ActivityName, t."Activated Date" AS EventTime, t."Completed Date" AS EventEndTime, t.Assignee AS UserName, c.Department, c.Amount AS ContractAmount, c."Contract Type Name" AS ContractType, c."Legal Contact" AS LegalCounsel FROM "Contract Workspace (Projects)" AS c JOIN "Task" AS t ON c."Project Id" = t."Project Id" WHERE t."Task Name" LIKE '%Legal Review%'
UNION ALL
SELECT c."Contract Id" AS ContractId, 'Contract Revised' AS ActivityName, d."Time Created" AS EventTime, NULL AS EventEndTime, d."Created By" AS UserName, c.Department, c.Amount AS ContractAmount, c."Contract Type Name" AS ContractType, c."Legal Contact" AS LegalCounsel FROM "Contract Workspace (Projects)" AS c JOIN "Document" AS d ON c."Project Id" = d."Project Id" WHERE d."Is Main Agreement" = TRUE AND d.Version > 1
UNION ALL
SELECT c."Contract Id" AS ContractId, 'Negotiation With Counterparty' AS ActivityName, t."Activated Date" AS EventTime, t."Completed Date" AS EventEndTime, t.Assignee AS UserName, c.Department, c.Amount AS ContractAmount, c."Contract Type Name" AS ContractType, c."Legal Contact" AS LegalCounsel FROM "Contract Workspace (Projects)" AS c JOIN "Task" AS t ON c."Project Id" = t."Project Id" WHERE t."Task Name" LIKE '%Negotiation%'
UNION ALL
SELECT c."Contract Id" AS ContractId, 'Internal Approval Completed' AS ActivityName, a."Time Completed" AS EventTime, NULL AS EventEndTime, a."Approver" AS UserName, c.Department, c.Amount AS ContractAmount, c."Contract Type Name" AS ContractType, c."Legal Contact" AS LegalCounsel FROM "Contract Workspace (Projects)" AS c JOIN "Approval History" AS a ON c."Project Id" = a."Project Id" WHERE a."Approval Task Name" LIKE '%Internal Approval Flow%' AND a.Status = 'Approved' AND a."Is Last Approver" = TRUE
UNION ALL
SELECT c."Contract Id" AS ContractId, 'Counterparty Approval Received' AS ActivityName, t."Completed Date" AS EventTime, NULL AS EventEndTime, t.Assignee AS UserName, c.Department, c.Amount AS ContractAmount, c."Contract Type Name" AS ContractType, c."Legal Contact" AS LegalCounsel FROM "Contract Workspace (Projects)" AS c JOIN "Task" AS t ON c."Project Id" = t."Project Id" WHERE t."Task Name" LIKE '%Counterparty Signature%'
UNION ALL
SELECT c."Contract Id" AS ContractId, 'Contract Executed' AS ActivityName, c."Executed Date" AS EventTime, NULL AS EventEndTime, c."Project Owner" AS UserName, c.Department, c.Amount AS ContractAmount, c."Contract Type Name" AS ContractType, c."Legal Contact" AS LegalCounsel FROM "Contract Workspace (Projects)" AS c WHERE c."Executed Date" IS NOT NULL
UNION ALL
SELECT c."Contract Id" AS ContractId, 'Contract Activated' AS ActivityName, c."Activated Date" AS EventTime, NULL AS EventEndTime, c."Project Owner" AS UserName, c.Department, c.Amount AS ContractAmount, c."Contract Type Name" AS ContractType, c."Legal Contact" AS LegalCounsel FROM "Contract Workspace (Projects)" AS c WHERE c."Activated Date" IS NOT NULL
UNION ALL
SELECT c."Contract Id" AS ContractId, 'Compliance Task Completed' AS ActivityName, t."Completed Date" AS EventTime, NULL AS EventEndTime, t.Assignee AS UserName, c.Department, c.Amount AS ContractAmount, c."Contract Type Name" AS ContractType, c."Legal Contact" AS LegalCounsel FROM "Contract Workspace (Projects)" AS c JOIN "Task" AS t ON c."Project Id" = t."Project Id" WHERE t."Task Name" LIKE '%Compliance%'
UNION ALL
SELECT c."Contract Id" AS ContractId, 'Amendment Initiated' AS ActivityName, c."Time Created" AS EventTime, NULL AS EventEndTime, c."Project Owner" AS UserName, c.Department, c.Amount AS ContractAmount, c."Contract Type Name" AS ContractType, c."Legal Contact" AS LegalCounsel FROM "Contract Workspace (Projects)" AS c WHERE c."Is Amendment" = TRUE
UNION ALL
SELECT c."Contract Id" AS ContractId, 'Contract Renewed' AS ActivityName, c."Time Created" AS EventTime, NULL AS EventEndTime, c."Project Owner" AS UserName, c.Department, c.Amount AS ContractAmount, c."Contract Type Name" AS ContractType, c."Legal Contact" AS LegalCounsel FROM "Contract Workspace (Projects)" AS c WHERE c."Is Renewal" = TRUE
UNION ALL
SELECT c."Contract Id" AS ContractId, 'Contract Closed' AS ActivityName, c."Completed Date" AS EventTime, NULL AS EventEndTime, c."Project Owner" AS UserName, c.Department, c.Amount AS ContractAmount, c."Contract Type Name" AS ContractType, c."Legal Contact" AS LegalCounsel FROM "Contract Workspace (Projects)" AS c WHERE c.Status = 'Completed'

ステップ

前提条件：SAP Ariba Developer Portalでアプリケーションを登録。データを抽出する前に、SAP Ariba Developer Portalで新しいアプリケーションを登録する必要があります。この手続きで、Application Key、OAuth Client ID、OAuth Client Secretが発行されます。アプリケーションにContract Workspaces APIへの必要なアクセス権が付与されていることを確認してください。
Python環境を設定。マシンにPython 3をインストールします。次に、APIリクエストの送信とデータ処理に必要なライブラリをインストールします。ターミナルまたはコマンドプロンプトを開き、pip install requests pandasを実行します。
Pythonスクリプトを設定。提供されたPythonスクリプトを、たとえばariba_extraction.pyというファイルにコピーします。ファイルを開き、先頭の設定セクションにあるプレースホルダーを更新します。Ariba Realm、API Key、OAuth Client ID、Client Secretを指定します。抽出対象の期間も設定します。
認証フローを確認。スクリプトはまず、認証情報を使ってSAP Ariba APIの認証エンドポイントを呼び出し、一時アクセストークンを取得します。このトークンは以降のすべてのデータリクエストに必要で、スクリプトが送信するAPI呼び出しのヘッダーに自動的に含まれます。
スクリプトを実行して契約ワークスペースを取得。ターミナルからpython ariba_extraction.pyを実行します。指定した期間内に更新されたすべての契約ワークスペースの一覧を取得します。ページネーションは自動的に処理され、該当するレコードをすべて取得できます。
ワークスペースの詳細データを取得。前の手順で特定した各契約ワークスペースについて、詳細を取得するAPI呼び出しを行います。イベントログの作成に必要なタスク、文書、チームメンバー、ワークスペースのステータス変更履歴など、関連オブジェクトを取得します。
APIレスポンスをイベントに変換。スクリプトの中心的な処理では、各契約の詳細なJSONレスポンスを反復処理します。ワークスペースの作成日、タスクのステータス変更、文書バージョンのアップロード、契約ステータスフィールド（contractStatus）などのデータを、イベントログに必要なアクティビティ名へ適切にマッピングします。
イベントログを構成・補完。イベントを特定すると、pandas DataFrameに追加します。APIデータから関連する値を抽出し、必須列（ContractId、ActivityName、EventTime）と推奨列（UserName、ContractAmount、ContractTypeなど）を設定します。
最終イベントログをエクスポート。すべての契約ワークスペースの処理が完了すると、完全なイベントログをariba_contract_management_event_log.csvというCSVファイルとして同じディレクトリに保存します。このファイルは整形済みで、ProcessMindにアップロードできます。

設定

API認証情報：SAP Ariba Developer Portalから次の情報を取得する必要があります。
- API_KEY：登録したアプリケーション用に生成されたアプリケーションキーです。
- CLIENT_ID：Base64でエンコードされたOAuthクライアントIDです。
- CLIENT_SECRET：OAuthクライアントシークレットです。
Realm：自社固有のSAP Ariba Realm名（例：'mycompany-T'）です。API呼び出しを正しいデータセンターに送信するために使います。
期間フィルター：抽出範囲を限定するため、UPDATED_DATE_FROMとUPDATED_DATE_TOパラメーターを設定することが重要です。まずは直近3～6か月を指定すると、データ量とスクリプトの実行時間を管理しやすくなります。
ワークスペースフィルター：fetch_workspaces関数のAPI呼び出しに追加のフィルターを設定できます。contractStatus（例：'Active'、'Executed'）やprojectTypeなどのフィールドで絞り込み、特定の契約タイプを対象にできます。
前提条件：SAP Ariba Contractsの有効なサブスクリプションと、API機能へのアクセス権が必要です。また、Developer Portalでアプリケーションを登録し、契約ワークスペースのデータを閲覧できる十分な権限を持つユーザーアカウントも必要です。

a サンプルクエリ python

import requests
import pandas as pd
import base64
from datetime import datetime, timedelta

class=class="hl-string">"hl-comment"># --- CONFIGURATION --- #
class=class="hl-string">"hl-comment"># Replace with your SAP Ariba realm and API credentials
REALM = class="hl-string">'[Your Ariba Realm]'
API_KEY = class="hl-string">'[Your Application Key]'
class=class="hl-string">"hl-comment"># The OAUTH_CLIENT_ID is your Application Key and a hyphen, base64 encoded.
class=class="hl-string">"hl-comment"># Example: class="hl-string">'yourappkey:' -> class="hl-string">'eW91cmFwcGtleTo='
OAUTH_CLIENT_ID = class="hl-string">'[Your Base64 Encoded OAuth Client ID]'
OAUTH_CLIENT_SECRET = class="hl-string">'[Your OAuth Client Secret]'

class=class="hl-string">"hl-comment"># --- FILTERS --- #
class=class="hl-string">"hl-comment"># Set the date range for contracts to extract (based on last modified date)
UPDATED_DATE_TO = datetime.now().strftime(class="hl-string">'%Y-%m-%dT%H:%M:%SZ')
UPDATED_DATE_FROM = (datetime.now() - timedelta(days=180)).strftime(class="hl-string">'%Y-%m-%dT%H:%M:%SZ')

class=class="hl-string">"hl-comment"># API Endpoints
AUTH_URL = fclass="hl-string">'https://api.ariba.com/v2/oauth/token'
BASE_API_URL = fclass="hl-string">'https://{REALM}.api.ariba.com/api/contracts/v1/workspaces'

class=class="hl-string">"hl-comment"># --- AUTHENTICATION --- #
def get_access_token():
    class="hl-string">"""Authenticates with Ariba API to get an access token."""
    auth_header = {class="hl-string">'Authorization': fclass="hl-string">'Basic {OAUTH_CLIENT_ID}'}
    payload = {
        class="hl-string">'grant_type': class="hl-string">'client_credentials',
        class="hl-string">'client_secret': OAUTH_CLIENT_SECRET
    }
    try:
        response = requests.post(AUTH_URL, headers=auth_header, 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 getting access token: {e}")
        return None

class=class="hl-string">"hl-comment"># --- DATA FETCHING --- #
def fetch_paginated_data(url, headers, params):
    class="hl-string">"""Fetches data from a paginated Ariba API endpoint."""
    all_records = []
    page = 0
    while True:
        params[class="hl-string">'page'] = page
        response = requests.get(url, headers=headers, params=params)
        response.raise_for_status()
        data = response.json()
        all_records.extend(data)
        if len(data) == 0: class=class="hl-string">"hl-comment"># Assuming empty list means last page
            break
        page += 1
    return all_records

class=class="hl-string">"hl-comment"># --- EVENT DERIVATION LOGIC --- #
def derive_events_from_workspace(workspace_details):
    class="hl-string">"""Derives multiple event log rows from a single workspace's detailed data."""
    events = []
    case_id = workspace_details.get(class="hl-string">'contractId')
    if not case_id:
        return []

    class=class="hl-string">"hl-comment"># Helper function to create a standard event dictionary
    def create_event(activity, timestamp, user=class="hl-string">'System'):
        return {
            class="hl-string">'ContractId': case_id,
            class="hl-string">'ActivityName': activity,
            class="hl-string">'EventTime': timestamp,
            class="hl-string">'EventEndTime': None, class=class="hl-string">"hl-comment"># Populate if available
            class="hl-string">'UserName': user,
            class="hl-string">'Department': workspace_details.get(class="hl-string">'custom', {}).get(class="hl-string">'Department', None),
            class="hl-string">'ContractAmount': workspace_details.get(class="hl-string">'amount', {}).get(class="hl-string">'amount', None),
            class="hl-string">'ContractType': workspace_details.get(class="hl-string">'contractType', {}).get(class="hl-string">'name', None),
            class="hl-string">'LegalCounsel': next((member.get(class="hl-string">'name') for member in workspace_details.get(class="hl-string">'team', []) if member.get(class="hl-string">'role') == class="hl-string">'Legal Counsel'), None)
        }

    class=class="hl-string">"hl-comment"># 1. Contract Workspace Created
    if workspace_details.get(class="hl-string">'createDate'):
        events.append(create_event(class="hl-string">'Contract Workspace Created', workspace_details[class="hl-string">'createDate']))

    class=class="hl-string">"hl-comment"># 2. Contract Drafted & 5. Contract Revised
    if workspace_details.get(class="hl-string">'documents'):
        main_doc_versions = sorted([v for doc in workspace_details[class="hl-string">'documents'] if doc.get(class="hl-string">'isMainAgreement') for v in doc.get(class="hl-string">'versions', [])], key=lambda x: x[class="hl-string">'createDate'])
        if main_doc_versions:
            events.append(create_event(class="hl-string">'Contract Drafted', main_doc_versions[0][class="hl-string">'createDate'], main_doc_versions[0].get(class="hl-string">'createdBy')))
            for version in main_doc_versions[1:]:
                events.append(create_event(class="hl-string">'Contract Revised', version[class="hl-string">'createDate'], version.get(class="hl-string">'createdBy')))

    class=class="hl-string">"hl-comment"># 3, 4, 7, 11. Task-based activities
    if workspace_details.get(class="hl-string">'tasks'):
        for task in workspace_details[class="hl-string">'tasks']:
            task_name = task.get(class="hl-string">'name', class="hl-string">'').lower()
            if class="hl-string">'internal review' in task_name and task.get(class="hl-string">'startDate'):
                events.append(create_event(class="hl-string">'Internal Review Started', task[class="hl-string">'startDate'], task.get(class="hl-string">'owner')))
            if class="hl-string">'legal review' in task_name and task.get(class="hl-string">'startDate'):
                events.append(create_event(class="hl-string">'Legal Review Started', task[class="hl-string">'startDate'], task.get(class="hl-string">'owner')))
            if class="hl-string">'internal approval' in task_name and task.get(class="hl-string">'completionDate'):
                events.append(create_event(class="hl-string">'Internal Approval Completed', task[class="hl-string">'completionDate'], task.get(class="hl-string">'owner')))
            if class="hl-string">'compliance' in task_name and task.get(class="hl-string">'completionDate'):
                events.append(create_event(class="hl-string">'Compliance Task Completed', task[class="hl-string">'completionDate'], task.get(class="hl-string">'owner')))

    class=class="hl-string">"hl-comment"># 6, 8. Status-based manual activities
    class=class="hl-string">"hl-comment"># This requires interpreting status history, which can be complex. Simplified here.
    if workspace_details.get(class="hl-string">'statusHistory'):
        for status_change in workspace_details.get(class="hl-string">'statusHistory'):
            status = status_change.get(class="hl-string">'status', class="hl-string">'').lower()
            if class="hl-string">'negotiation' in status:
                events.append(create_event(class="hl-string">'Negotiation With Counterparty', status_change[class="hl-string">'date'], status_change.get(class="hl-string">'user')))
            if class="hl-string">'counterparty approval' in status:
                events.append(create_event(class="hl-string">'Counterparty Approval Received', status_change[class="hl-string">'date'], status_change.get(class="hl-string">'user')))

    class=class="hl-string">"hl-comment"># 9. Contract Executed
    if workspace_details.get(class="hl-string">'executionDate'):
        events.append(create_event(class="hl-string">'Contract Executed', workspace_details[class="hl-string">'executionDate']))

    class=class="hl-string">"hl-comment"># 10. Contract Activated
    if workspace_details.get(class="hl-string">'effectiveDate'):
        events.append(create_event(class="hl-string">'Contract Activated', workspace_details[class="hl-string">'effectiveDate']))

    class=class="hl-string">"hl-comment"># 12. Amendment Initiated
    if workspace_details.get(class="hl-string">'isAmendment'):
        events.append(create_event(class="hl-string">'Amendment Initiated', workspace_details[class="hl-string">'createDate']))

    class=class="hl-string">"hl-comment"># 13. Contract Renewed
    if workspace_details.get(class="hl-string">'renewalOfWorkspaceId'):
         events.append(create_event(class="hl-string">'Contract Renewed', workspace_details[class="hl-string">'createDate']))

    class=class="hl-string">"hl-comment"># 14. Contract Closed
    if workspace_details.get(class="hl-string">'closeDate'):
        events.append(create_event(class="hl-string">'Contract Closed', workspace_details[class="hl-string">'closeDate']))

    return events

class=class="hl-string">"hl-comment"># --- MAIN EXECUTION --- #
def main():
    class="hl-string">"""Main function to orchestrate the extraction process."""
    print(class="hl-string">"Attempting to get access token...")
    access_token = get_access_token()
    if not access_token:
        print(class="hl-string">"Failed to get access token. Exiting.")
        return

    print(class="hl-string">"Successfully obtained access token.")
    headers = {
        class="hl-string">'Authorization': fclass="hl-string">'Bearer {access_token}',
        class="hl-string">'apiKey': API_KEY
    }

    print(fclass="hl-string">"Fetching contract workspaces updated from {UPDATED_DATE_FROM} to {UPDATED_DATE_TO}...")
    workspace_params = {
        class="hl-string">'filters': fclass="hl-string">'updatedDateFrom={UPDATED_DATE_FROM}&updatedDateTo={UPDATED_DATE_TO}'
    }
    try:
        workspaces = fetch_paginated_data(BASE_API_URL, headers, workspace_params)
        print(fclass="hl-string">"Found {len(workspaces)} workspaces.")

        all_events = []
        for i, ws_summary in enumerate(workspaces):
            ws_id = ws_summary.get(class="hl-string">'contractId')
            print(fclass="hl-string">"Processing workspace {i+1}/{len(workspaces)}: {ws_id}")
            detail_url = fclass="hl-string">"{BASE_API_URL}/{ws_id}"
            class=class="hl-string">"hl-comment"># Add parameters to get full details
            detail_params = {class="hl-string">'include': class="hl-string">'tasks,documents,team,statusHistory'}
            try:
                ws_details_response = requests.get(detail_url, headers=headers, params=detail_params)
                ws_details_response.raise_for_status()
                ws_details = ws_details_response.json()
                
                events = derive_events_from_workspace(ws_details)
                all_events.extend(events)
            except requests.exceptions.RequestException as e:
                print(fclass="hl-string">"Could not fetch details for workspace {ws_id}: {e}")

        if not all_events:
            print(class="hl-string">"No events were generated. Check API responses and derivation logic.")
            return

        class=class="hl-string">"hl-comment"># Convert to DataFrame and save to CSV
        event_log_df = pd.DataFrame(all_events)
        event_log_df[class="hl-string">'EventTime'] = pd.to_datetime(event_log_df[class="hl-string">'EventTime'])
        event_log_df = event_log_df.sort_values(by=[class="hl-string">'ContractId', class="hl-string">'EventTime'])
        
        output_filename = class="hl-string">'ariba_contract_management_event_log.csv'
        event_log_df.to_csv(output_filename, index=False, date_format=class="hl-string">'%Y-%m-%d %H:%M:%S')
        print(fclass="hl-string">"Successfully created event log: {output_filename}")

    except requests.exceptions.RequestException as e:
        print(fclass="hl-string">"An error occurred during API request: {e}")

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

準備はできましたか？

このテンプレートを使って自信を持ってデータを準備し、契約管理プロセスに潜む価値ある情報を見つけ出してください。データ収集を効率化し、プロセス改善への取り組みを加速できます。

改善ガイドに戻るテンプレートをダウンロード

契約管理を効率化し、今すぐトライアルを開始

契約サイクル時間を30％短縮し、SAP Aribaのプロセスを効率化します。

無料トライアルを開始

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

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

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

契約管理の属性

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

抽出ガイド

SAP Ariba Analytical Reporting UIからのデータエクスポート

ステップ

設定

a サンプルクエリ sql

Ariba Contract Management APIを使ったPythonスクリプト

ステップ

設定

a サンプルクエリ python

準備はできましたか？

契約管理を効率化し、今すぐトライアルを開始

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

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

契約管理の属性

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

抽出ガイド

SAP Ariba Analytical Reporting UIからのデータエクスポート

ステップ

設定

a サンプルクエリ sql

Ariba Contract Management APIを使ったPythonスクリプト

ステップ

設定

a サンプルクエリ python

準備はできましたか？

契約管理を効率化し、今すぐトライアルを開始

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