> 継続的なプロセス改善 > 契約管理 > 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	各契約ワークスペースを識別する一意の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など、契約の分類です。
説明この属性は、法的または業務上の目的に基づいて契約を分類します。一般的な契約タイプには、基本サービス契約（MSA）、秘密保持契約（NDA）、作業範囲記述書（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を遵守したレビューの割合を確認し、超過したケースをドリルダウンして原因を調べられます。重要な理由サービス目標に対するパフォーマンスを直接測定し、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
	契約サイクルタイムの合計 TotalContractCycleTime	契約ワークスペースの作成から最終的な締結までにかかった合計時間。
説明この計算属性は、1件の契約にかかる一連の期間を測定します。通常、「契約ワークスペースの作成」から「契約の締結」までの最初と最後のアクティビティの時間差として算出します。主要な重要業績評価指標（KPI）である「契約のエンドツーエンドサイクルタイム」です。契約管理プロセス全体の効率を大局的に把握できます。ダッシュボードで経時的なパフォーマンスを追跡したり、契約の種類、部門、地域ごとにサイクルタイムを比較したりすることで、改善すべき主な領域を特定できます。重要な理由プロセス全体のパフォーマンスを1つの指標にまとめ、プロセスの速度と効率を測定します。入手先プロセスマイニングツール内、またはデータ変換時に、ケース単位で算出する指標です。例 P35DP12DT5HP90D
	契約ステータス ContractStatus	契約ライフサイクルにおける現在の全体的な状態です。
説明この属性は、「Draft」、「In Review」、「Executed」、「Expired」、「Terminated」など、契約の現在の大まかな状態を示します。単一のイベントを表すアクティビティとは異なり、ステータスは一定期間にわたる状態を表します。「契約上の義務・更新状況」などのダッシュボードで、契約ポートフォリオの現状を把握するために欠かせません。停滞している契約の特定や、更新・期限切れなどのライフサイクルイベントの管理に役立ちます。ステータス間の遷移を分析すると、プロセスのボトルネックや非効率な点も見つけられます。重要な理由契約の現在の状態を大まかに把握できるため、ポートフォリオ管理、ステータスの追跡、ライフサイクル分析に役立ちます。入手先 SAP Ariba Contractsの契約ワークスペースのヘッダーにある主要なステータスフィールドです。例下書き承認中締結済み期限切れ
	契約満了日 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
	契約終了	システム上で契約を正式に終了する最終アクティビティです。契約期間の満了、解約、またはすべての義務の履行後に発生します。
重要な理由契約ライフサイクルの最終的な終了を示します。ライフサイクル全体の期間を測定し、適切な終了手続きが行われたことを確認するための重要な終了イベントです。入手先 Contract Workspaceの「Status」フィールドが「Closed」、「Terminated」、または「Expired」に変わったことから推定します。ステータス変更は自動または手動で行われます。記録契約の「Status」フィールドが終了状態に変わった時刻を記録します。イベントタイプ inferred
	契約締結	必要な署名がすべてそろい、契約が正式に締結された状態です。処理中の文書から、法的拘束力のある合意へと移行します。
重要な理由署名前のプロセスにおける主要な完了地点です。「契約のエンドツーエンドサイクルタイム」と「契約承認サイクルタイムの平均」の算出に欠かせません。入手先このイベントは、Aribaのワークフローで署名タスクが最終的に完了したステータスから取得します。特に電子署名ツールと連携している場合に該当します。Contract Workspaceのステータスも「Executed」に変わります。記録署名タスクの最終完了時刻、または「Executed」へのステータス変更を使用します。イベントタイプ explicit
	法務審査の開始	契約が法務部門に正式に提出され、審査が始まったことを示します。通常、承認ワークフロー全体の中で、独立した必須タスクとして設定されています。
重要な理由法務審査は大きなボトルネックになることが少なくありません。所要時間の測定は、「法務審査の平均サイクルタイム」重要業績評価指標（KPI）の確認や、法務リソースの配分見直しに欠かせません。入手先 Aribaのワークフローにある「法務審査」タスクの開始時点から取得します。タスクが割り当てられた時点、または開始された時点のタイムスタンプが記録されます。記録法務チームまたは法務担当の役割に割り当てられたタスクの開始タイムスタンプを特定します。イベントタイプ explicit
	社内承認の完了	契約に必要なすべての社内承認タスクが正常に完了したことを示します。相手方との合意を待つ段階で、契約が最終署名に進める状態になったことを表します。
重要な理由契約締結前の重要なマイルストーンです。このイベントから最終締結までの時間を確認すると、外部の署名取得や文書の最終確定に伴う遅延を把握できます。入手先 Aribaのワークフローで最後の承認タスクが完了した時点のタイムスタンプから取得します。承認フロー全体が正常に完了した時点がシステムに記録されます。記録承認フロー全体のタスクグループが完了した時点のタイムスタンプを使用します。イベントタイプ explicit
	コンプライアンスタスク完了	コンプライアンスレビューや義務の確認など、締結後に予定されているタスクの完了を示します。継続的なガバナンスを確保するために設定されるタスクです。
重要な理由これらのタスクの完了状況を追跡することは、「義務遵守率」の測定と、組織が契約上の責任を果たしていることの確認に欠かせません。入手先 Contract Workspace内の特定のフォローアップタスクや義務関連タスクの完了時刻から取得します。記録ワークスペースに設定された締結後タスクの完了時刻を使用します。イベントタイプ explicit
	契約変更の開始	有効な契約に対する正式な変更手続きの開始を示します。通常は、元の契約ワークスペースに関連付けた新しいバージョンまたはサブプロジェクトを作成します。
重要な理由変更の頻度や時期から、契約の安定性や変化するビジネスニーズを把握できます。「契約変更・終了の傾向」ダッシュボードの重要な指標です。入手先既存の契約に対してユーザーが「Amendment」プロセスを開始する明示的な操作で、システムに記録されます。記録契約変更用ワークスペースまたはタスクの作成イベントを取得します。イベントタイプ explicit
	契約更新	有効な契約が正常に更新されたことを示します。多くの場合、元の契約を引き継ぐ新しい契約ワークスペースが作成されます。
重要な理由契約の継続率や更新の効率を分析できます。取引関係の継続を示す、契約ライフサイクル上の重要な成果です。入手先期限が近い契約に「renewal of」などの関係リンクを設定して新しい契約を作成したときに取得できます。ユーザーが明示的に操作する場合が多くあります。記録既存の契約の更新として関連付けられた新しい契約の作成を特定します。イベントタイプ explicit
	契約書の初稿作成	契約ワークスペースに、主要な契約文書の初版を作成またはアップロードすることを示します。通常、ワークスペースの設定後に行われる、最初の主要な文書関連アクティビティです。
重要な理由このアクティビティを追跡すると、初稿の作成にかかった時間を把握できます。この段階での遅延は、全体のサイクルタイムに大きく影響する可能性があります。入手先契約ワークスペースの文書フォルダーにある、主要な契約文書の初版の作成タイムスタンプから推定できます。記録ワークスペースに最初にアップロードされた文書のタイムスタンプを特定します。イベントタイプ inferred
	契約書の改訂	主要な契約文書の新しいバージョンが作成またはアップロードされたときに発生するアクティビティです。通常、社内審査、法務審査、または相手方との交渉で受けた意見を反映する際に行われます。
重要な理由改訂の頻度は、手戻りを直接示す指標です。このアクティビティを追跡すると、「契約の手戻り率」の算出や、文言・プロセスの標準化に向けた改善機会の特定に役立ちます。入手先契約ワークスペース内の文書管理システムから推定します。主要な契約文書の新しいバージョンを保存するたびに、タイムスタンプが作成されます。記録バージョン番号が1を超える文書の作成タイムスタンプを使用します。イベントタイプ inferred
	相手方との交渉	契約書を外部の相手方と共有し、交渉や修正を行う段階を示します。このアクティビティは、ワークスペースのステータスを手動で変更することで記録される場合があります。
重要な理由予測しにくい外部との交渉サイクルを把握できます。この段階を測定すると、「平均交渉サイクル数」を算出し、複雑な交渉を特定するのに役立ちます。入手先ワークスペースのステータスが「交渉中」や「サプライヤー対応中」などに手動で変更された時点から推定できます。または、文書が外部の連絡先に送信された時点から推定することもできます。記録外部審査を示す値への契約ワークスペースのステータス変更を追跡します。イベントタイプ inferred
	相手方の承認を取得	外部の相手方が契約条件に正式に合意したことを示します。通常、電子署名ソリューションとの連携によって記録するか、署名済み文書を受領した時点で手動更新します。
重要な理由このアクティビティでは、双方の合意を確認します。契約が法的に締結されたとみなされる前の最終ステップであり、合意を確定する重要な節目です。入手先 DocuSignなどの電子署名ツールが記録する「Completed」ステータスのように、明示的なイベントとして記録される場合があります。または、「Signed by Counterparty」への手動のステータス変更から推定することもできます。記録連携している電子署名サービスのログから、完了イベントを取得します。イベントタイプ explicit
	社内審査の開始	このアクティビティは、契約書の初稿に対する社内審査・承認ワークフローの開始を示します。文書は、財務部門や業務部門など、意見を求める関係者に回付されます。
重要な理由ボトルネックが発生する可能性のある段階の始まりを示します。この段階にかかる時間を分析すると、社内審査の遅延を特定し、「社内審査のSLA遵守率」重要業績評価指標（KPI）の確認に役立ちます。入手先通常、SAP Aribaのワークフローエンジンで審査タスクが作成され、担当者に割り当てられた時点で記録されます。タスクのステータスは「進行中」などに変わります。記録契約の承認ワークフローで審査タスクが開始された時点のタイムスタンプを記録します。イベントタイプ explicit

推奨任意

データ抽出ガイド

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

ステップ

分析レポートにアクセス：SAP Aribaにログインします。メインメニューを開き、「分析レポート」を選択します。「管理」＞「分析レポート」などのメニューからアクセスする場合もあります。
新しいレポートを作成：「作成」をクリックし、「新しいレポート」を選択します。複数のファクトを含むレポートを作成します。
主要ファクトを選択：レポート作成画面で、主要なデータファクトとして「契約ワークスペース（プロジェクト）」を選択します。このファクトには、各契約ケースの基本情報が含まれています。
追加ファクトを結合：必要なアクティビティと属性をすべて取得するため、次のファクトを「契約ワークスペース（プロジェクト）」に結合します。結合条件には、共通する「プロジェクトID」または「契約ID」フィールドを使います。
- 「承認履歴」：申請、承認、却下など、承認タスクの詳細を取得します。
- Task：すべてのワークフロータスク、開始日と終了日、担当者の情報を取得します。
- 「文書化」：文書のバージョンを追跡します。「契約書の作成」と「契約書の改訂」アクティビティを特定するうえで重要です。
レポートのフィールドを定義（ピボット処理）：業務上のアクティビティごとに行を作成します。Aribaの画面では通常、契約ごとに1行が作成されるため、計算フィールドを手動で定義するか、横持ちのテーブルをエクスポートして後から変換する必要があります。推奨される方法は、イベントのタイムスタンプごとに列を追加することです。例：
- 「契約ワークスペース（プロジェクト）」ファクトの「ワークスペース作成日」。
- 「文書化」ファクトの「主要文書の作成日」（主要契約書の初版に絞り込み）。
- Taskファクトの「法務レビュー開始日」（該当する法務レビュータスクに絞り込み）。
- 「契約ワークスペース（プロジェクト）」ファクトの「締結日」。
- 必要な14のアクティビティそれぞれについて、タイムスタンプ専用の列を追加します。
属性フィールドを選択：「契約ID」、「プロジェクト所有者」（ユーザー名用）、「部門」、「金額」（契約金額用）、「契約種別」など、必要な属性フィールドと推奨属性フィールドをすべてレポートに追加します。
フィルターを適用：「フィルター」タブを開きます。「契約ワークスペース（プロジェクト）」ファクトの「作成時刻」にフィルターを設定し、直近6～12か月など、対象期間を絞ります。「プロジェクト種別」などのフィルターを追加し、契約ワークスペースだけを含めることもできます。
レポートを実行してデータをエクスポート：レポートを実行します。出力は契約ごとに1行あり、日付イベントごとに複数の列が並ぶ横持ちのテーブルです。CSVまたはMicrosoft Excelファイルにエクスポートします。
データを変換：エクスポートしたファイルはイベントログではないため、変換が必要です。Microsoft Excel Power Query、Python、専用のETLツールなどを使ってデータをピボット解除します。エクスポートファイルの各行について、手順5で作成した日付列ごとに新しいファイルの行を作成します。こうして横持ちのデータを、ProcessMindで必要な縦持ちのイベントログに変換します。
イベントログを整形：変換後のファイルで、列名が「ContractId」、「ActivityName」、「EventTime」、「EventEndTime」、「UserName」など、指定どおりになっていることを確認します。タイムスタンプ列は「YYYY-MM-DD HH:MI:SS」などの統一した形式にし、最終ファイルをCSVで保存します。
ProcessMindにアップロード：作成したCSVファイルをプロセスマイニングツールにアップロードできます。

設定

含めるファクト：レポートでは複数のデータファクトを結合する必要があります。「契約ワークスペース（プロジェクト）」から始め、「承認履歴」、「Task」、「文書化」のファクトを結合して、履歴全体を取得します。
期間：初回の分析では、「契約ワークスペース（プロジェクト）」ファクトの「作成時刻」フィールドに、直近6～12か月のフィルターを設定します。データ量が多い場合は、四半期または月ごとに分けてエクスポートします。
主なフィルター：契約ワークスペースだけを抽出し、ソーシングプロジェクトなど他のプロジェクト種別を除外するため、「プロジェクト種別」で絞り込むことが重要です。分析対象を限定する場合は、「部門」や「商品分類」でも絞り込めます。
データの粒度：タスクの有効化日、承認日、文書の作成日など、個別のイベントのタイムスタンプを含むフィールドを選択します。最終更新日だけではイベントの具体的な内容が分からないため、使用は避けてください。
前提条件：SAP Aribaのユーザーアカウントに、分析レポートを作成・実行する権限が必要です。通常、「分析ユーザー」や「レポート管理者」などのロールに割り当てられます。
パフォーマンスに関する注意点：複数のファクトを結合し、長期間にわたる多数のフィールドをエクスポートすると、レポートの実行に時間がかかったり、タイムアウトしたりすることがあります。処理には時間がかかる場合があります。業務の少ない時間帯に実行するか、対象を小分けにしてください。

クエリの例 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で新しいアプリケーションを登録する必要があります。登録すると、アプリケーションキー、OAuthクライアントID、OAuthクライアントシークレットが発行されます。Contract Workspaces APIへのアクセスに必要な権限をアプリケーションに付与してください。
Python環境を設定。使用するマシンにPython 3をインストールします。次に、APIリクエストとデータ処理に必要なライブラリをインストールします。ターミナルまたはコマンドプロンプトを開き、pip install requests pandasを実行します。
Pythonスクリプトを設定。提供されたPythonスクリプトを、たとえばariba_extraction.pyというファイルにコピーします。ファイルを開き、先頭にある設定セクションのプレースホルダーを更新します。Ariba Realm、APIキー、OAuthクライアントID、クライアントシークレットを入力し、抽出する期間も指定します。
認証の流れを確認。スクリプトはまず、入力した認証情報を使って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という名前で保存します。このファイルは整形済みのため、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などのフィールドで絞り込み、特定の契約種別を対象にできます。
前提条件：API機能が有効なSAP Ariba Contractsの有効なサブスクリプションが必要です。また、Developer Portalでアプリケーションを登録し、契約ワークスペースのデータを閲覧できる十分な権限を持つユーザーアカウントも必要です。

クエリの例 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の分析レポート画面からのデータエクスポート

ステップ

設定

クエリの例 sql

Ariba契約管理APIを使ったPythonスクリプト

ステップ

設定

クエリの例 python

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

契約管理の効率を高める。今すぐトライアルを開始