> 継続的なプロセス改善 > リードから入金まで > Oracle CX Sales > データテンプレート

リードから入金までのデータテンプレート

Oracle CX Sales

リードから入金までの属性(20) リードから入金までのアクティビティ(14) データ抽出ガイド(2)

リードから入金までのデータテンプレート

このテンプレートでは、プロセスマイニングに向けてリードから入金までのデータを準備する手順を説明します。収集する属性や追跡する主なアクティビティに加え、Oracle CX Salesからデータを抽出する方法もご案内します。テンプレートに沿って準備することで、プロセスを詳細かつ正確に分析できます。

リードから入金までの分析に推奨される属性
営業から入金までのサイクルで追跡する主なアクティビティ
Oracle CX Salesからデータを抽出する詳しい手順

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

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

リードから入金までの属性

リードから入金までのプロセスを詳しく分析するために、イベントログに含めることを推奨するデータ項目です。

5 必須 5 推奨 10 任意

	名前	説明
	アクティビティ名 ActivityName	営業案件について、特定の時点で発生した業務アクティビティまたはイベントの名前です。
説明リードから入金までのプロセスにおける特定のステップや節目を示す属性です。「リードを営業案件に転換」「見積書を作成」「入金確認」などが該当します。これらのアクティビティがプロセスマップの基本要素になります。アクティビティの順序や発生頻度を分析すると、プロセスの流れや一般的な経路、別の経路を可視化し、逸脱やボトルネックを検出できます。また、ステップ間の所要時間を測定し、実際の業務の進め方を把握するための基礎にもなります。重要な理由プロセスマップの作成と、営業プロセスにおけるイベントの順序の把握に欠かせない属性です。入手先通常は、Opportunity、Quote、Orderオブジェクトに関連するステータス変更、イベントログ、または特定のタスク完了記録から取得します。例商談の選別完了見積書の顧客への送付受注履行の完了入金確認
	イベント時刻 EventTime	特定のアクティビティまたはイベントが発生した日時を示すタイムスタンプです。
説明イベント時刻は、アクティビティが記録された日時です。イベントを時系列に並べ、プロセスの各ステップにかかった時間を計算するために必要です。サイクルタイムの計算、待ち時間の測定によるボトルネックの特定、サービスレベル合意に対するパフォーマンスの確認など、時間に基づく分析の基礎となります。信頼できるプロセスマイニング分析には、正確なタイムスタンプが欠かせません。重要な理由イベントの時系列を把握できるため、サイクルタイムや所要時間など、パフォーマンス指標の計算に欠かせません。入手先ステータス変更のタイムスタンプなど、特定のアクティビティに関連するレコードの作成日時または最終更新日時に該当します。例 2023-04-15T10:00:00Z2023-05-01T14:30:00Z2023-05-20T09:15:00Z
	営業案件 SalesOpportunity	営業案件を一意に識別するIDです。リードから入金までのプロセスでは、ケースIDとして使用します。
説明営業案件は、リードとして登録された段階から、受注または失注として最終決定するまで、売上につながる可能性のある商談を追跡する中心的なオブジェクトです。評価、見積もり、注文、入金など、関連するすべてのアクティビティを結び付けます。プロセスマイニング分析では、このIDを使って各商談の一連の流れを再構成します。プロセス全体を分析できるため、ステージ間のサイクルタイムや転換率を測定し、受注につながる経路と失注につながる経路を特定できます。重要な理由すべてのプロセスイベントを結び付ける重要なケースIDです。商談ごとの営業プロセス全体を、漏れなく正確に把握できます。入手先 Oracle CX SalesのOpportunityオブジェクトで使用される主要な識別子です。例 OPP-0012345OPP-0023456OPP-0034567
	ソースシステム SourceSystem	データの抽出元となるシステムです。
説明この属性は、プロセスデータの取得元を示します。この場合はOracle CX Salesです。複数のシステムを利用する環境では、データソースを区別するために使います。複数のシステムのデータを組み合わせる場合や、システム固有の動作を把握する場合に、データの取得元を確認できます。データガバナンスと追跡可能性を確保するための標準的なフィールドです。重要な理由データの取得元を把握し、追跡可能性を確保できます。複数のシステムが連携する環境で、データを管理する際にも役立ちます。入手先通常は、データ抽出時にデータソースを示す値を固定で追加します。例 Oracle CX Sales
	最終データ更新日時 LastDataUpdate	ソースシステムからデータを最後に更新または抽出した日時を示すタイムスタンプです。
説明この属性は、分析対象データの鮮度を示します。Oracle CX Salesから最後にデータを取得した日時を確認できます。ダッシュボードやレポートでは、表示中のデータがいつ時点のものかを利用者に伝えるために重要です。直近のアクティビティが分析に含まれているかどうかを判断する目安になります。重要な理由データの更新時点を利用者に伝え、ダッシュボードの解釈や適切な判断に役立ちます。入手先このタイムスタンプは、データの抽出、変換、読み込み（ETL）の処理中に生成して追加します。例 2024-06-10T02:00:00Z
	営業ステージ SalesStage	営業パイプラインにおける営業案件の現在のステージです。
説明営業ステージは、定義された営業プロセスの中で営業案件がどこまで進んでいるかを示します。「評価」「ソリューション提案」「交渉」などの値が使われます。任意の時点で営業案件の状況を把握するための重要な属性です。営業ファネルの可視化や「停滞した営業案件のステージ分析」ダッシュボードの作成に欠かせません。各ステージの滞留時間を分析すると、商談が停滞している箇所を特定し、パイプラインの進行を妨げる要因への対応に注力できます。重要な理由営業ファネルの分析や、営業案件が停滞または失注しやすいボトルネックの特定に欠かせません。入手先 Oracle CX SalesのOpportunityオブジェクトにある標準フィールドです。「SalesStage」または「StageName」という名前が一般的です。例 01 - 評価03 - 提案05 - 交渉受注確定
	営業案件の担当者 OpportunityOwner	営業案件を主に担当する営業担当者です。
説明営業案件の担当者は、商談の管理と成約を担うユーザーです。この属性を使って、個人またはチーム単位でパフォーマンスを分析できます。営業案件の担当者で絞り込むと、業務の進め方やパフォーマンスの基準、標準的な営業プロセスへの適合状況の違いが分かります。営業マネージャーは、コーチングの機会を見つけ、成果を上げている担当者が営業サイクルをどのように進めているかを把握できます。重要な理由営業担当者やチームごとのパフォーマンスを分析し、優れた取り組みやコーチングが必要な領域を特定できます。入手先 Oracle CX SalesのOpportunityオブジェクトにある標準フィールド「Owner」または「AssignedTo」から取得できます。例 John SmithJane DoePeter Jones
	営業案件金額 OpportunityValue	営業案件の見積金額または実際の金額です。
説明この属性は、営業案件に関連する見込み売上または確定売上を示します。プロセスの各段階で、営業案件の分類や優先順位付けに利用できます。プロセスマイニングでは、営業案件金額を分析することで、プロセスのバリアントが高額案件と低額案件にどのような影響を与えるかを把握できます。「営業案件の失注と離脱理由」分析など、売上の逸失を追跡するダッシュボードでは、プロセスの経路と財務上の結果を関連付けるために欠かせません。重要な理由プロセスの非効率による財務的な影響を数値化し、営業案件や改善施策の優先順位付けに役立ちます。入手先 Oracle CX SalesのOpportunityオブジェクトにある「Revenue」や「Amount」などのフィールドから取得できる場合があります。例 50000.00125000.0025000.00
	地域 Region	営業案件に関連付けられた地理的な地域または営業テリトリーです。
説明地域属性は、「北米」「EMEA」「APAC」など、営業案件を地理的な場所ごとに分類します。業績を分類する際によく使われる分析軸です。「地域別営業パフォーマンスのベンチマーク」ダッシュボードに欠かせない属性です。地域ごとに営業サイクルタイムや転換率、プロセスのバリアントなどの主要指標を比較し、成果の高い地域や重点的な改善が必要な地域を特定できます。重要な理由地域ごとのプロセスパフォーマンスを比較し、地域による違いや優れた取り組みを把握できます。入手先 Oracle CX SalesのAccountまたはOpportunityオブジェクトにある標準フィールドまたはカスタムフィールドから取得できる場合があります。例北米EMEAAPACLATAM
	失注理由 LossReason	営業案件を失注した理由です。
説明営業案件が受注に至らず終了した場合、失注理由には「競合に敗れた」「価格」「決定見送り」など、主な原因が記録されます。この情報は、戦略の検討やプロセスの改善に役立ちます。「営業案件の失注と離脱理由」ダッシュボードの基礎となる属性です。失注理由と失注したステージを合わせて分析すると、競争上の弱点を把握し、営業戦略や製品構成、価格設定の見直しにつなげられます。重要な理由商談を受注できなかった理由を把握し、営業プロセスや製品構成の改善に役立てられます。入手先 Oracle CX Salesで営業案件のステータスを「Closed Lost」に設定した際に記録される標準フィールドです。例価格競合に敗れた製品との適合性決定見送り
	フルフィルメント前の請求書発行 InvoiceBeforeFulfillment	注文のフルフィルメント完了前に請求書が作成されたことを示すフラグです。
説明特定のケースで「請求書を生成」イベントが「注文のフルフィルメント完了」イベントより前に発生した場合、この真偽値属性はtrueになります。これは、コンプライアンスに反する、またはリスクのあるプロセス経路を示します。この属性は「フルフィルメント前の請求書発行率」の重要業績評価指標（KPI）に直接関係し、プロセスコンプライアンスのダッシュボードで使用します。この逸脱を追跡することで、組織は適切な請求手順を徹底し、顧客との紛争や収益認識上のリスクを抑えられます。重要な理由注文のフルフィルメント完了前に顧客へ請求する、重大なコンプライアンス違反を示します。顧客満足度の低下や財務リスクにつながる可能性があります。入手先同じケース内の「請求書を生成」と「注文のフルフィルメント完了」アクティビティのタイムスタンプを比較して算出します。例 truefalse
	ユーザー名 UserName	特定のアクティビティまたはイベントを実行したユーザーです。
説明この属性は、「見積書を作成」や「注文を送信」などのタスクを実行した担当者を示します。営業案件の担当者が商談全体を管理するのに対し、ユーザー名は個々の操作を実行した人を記録します。この情報を使うと、リソースの割り当てや業務量の分布、役割と責任の遵守状況を詳しく把握できます。特定のユーザーがプロセスのボトルネックになっていないか、権限のない担当者が特定のタスクを繰り返し処理していないかを確認する際にも役立ちます。重要な理由個々の操作を実行した担当者を記録し、業務量の詳細な分析やアクティビティの監査に役立ちます。入手先通常は、Oracle CX Salesでアクティビティに関連するオブジェクトの「CreatedBy」または「LastUpdatedBy」フィールドから取得します。例 Alice WilliamsBob BrownCharlie Davis
	停滞の有無 IsStalled	営業案件が同じ営業ステージに長期間とどまっていることを示すフラグです。
説明この属性は真偽値のフラグです。営業案件における連続した2つのアクティビティの間隔が、あらかじめ定めた業務上のしきい値（例：30日）を超えた場合にtrueになります。「停滞した営業案件の割合」の重要業績評価指標（KPI）の計算に使われ、「停滞した営業案件のステージ分析」ダッシュボードに欠かせません。停滞した商談を特定することで、営業マネージャーは早めに介入して支援し、営業パイプライン全体の進行を改善できます。重要な理由対応の遅れによる失注リスクがある商談を早期に特定し、適切なタイミングで対応できます。入手先ケース内の連続するイベント間の時間を測定し、定義済みのしきい値と比較して算出します。例 truefalse
	割引率 DiscountPercentage	営業見積もりまたは営業案件に適用された割引率です。
説明この属性には、個別の商談に適用された割引率が記録されます。最終価格と販売利益に直接影響します。割引水準の分析は、「平均割引適用率」の重要業績評価指標（KPI）を確認するうえで重要です。割引が利益率に与える影響を把握し、割引が一貫性なく適用されていないか、適切な承認を経ずに適用されていないかを確認できます。見積もり承認ワークフローの問題を見つける手掛かりにもなります。重要な理由利益率や割引戦略の効果を分析し、管理されていない割引の可能性を特定できます。入手先 Oracle CX Salesの文書で、QuoteまたはOpportunity Product Line Itemオブジェクトに割引フィールドがあるか確認してください。例 0.050.100.150.20
	注文ID OrderId	受注した営業案件から作成された販売注文を一意に識別するIDです。
説明注文IDは、顧客が見積書を承諾し、営業案件が受注となった後、フルフィルメントに送られる正式な販売注文の参照番号です。営業から業務処理への重要な移行点を示します。「フルフィルメント用に注文を送信」アクティビティ以降のプロセスを追跡するうえで重要です。営業とフルフィルメントの工程を結び付け、リードから入金までのプロセスにおける注文処理とフルフィルメントの所要時間を一貫して分析できます。重要な理由営業案件とフルフィルメントのプロセスを結び付け、リードから最終納品までを一貫して分析できます。入手先 Oracle CX Salesの文書または連携先のERPシステムで、Sales Orderオブジェクトの主要な識別子を確認してください。例 SO-554433SO-554434SO-554435
	製品名 ProductName	営業案件で販売する主な製品またはサービスです。
説明この属性は、営業案件に関連する製品または製品ファミリーを示します。複数の製品を含む営業案件では、主な対象製品を示す場合と、製品明細ごとに繰り返し記録する場合があります。製品ごとにプロセスの流れを分析すると、販売サイクルが長い製品や、より複雑な販売プロセスを要する製品を特定できます。この結果を、製品別の営業戦略やトレーニング、プロセス改善に役立てられます。重要な理由製品やサービスごとの営業プロセスの違いを分析し、製品固有のボトルネックを特定できます。入手先 Oracle CX SalesのProductオブジェクトにあり、Opportunity Product Line Itemを介して関連付けられています。例エンタープライズCRMライセンスクラウドストレージ・ティア1プロフェッショナルサービスパッケージ
	見積もり手戻りの有無 IsQuoteRework	同じ営業案件に対して、見積書の手戻りが発生した、または複数回作成されたことを示すフラグです。
説明 1つの営業案件で「見積書を改訂」などのアクティビティが発生した場合や、「見積書を作成」イベントが2回目に発生した場合、この真偽値属性はtrueになります。見積もり段階でのプロセスの非効率を特定するのに役立ちます。このフラグは、「見積もり手戻り率」の重要業績評価指標（KPI）の計算や、「プロセス逸脱と手戻り分析」ダッシュボードに使用します。手戻りを可視化することで、要件の初期確認、価格設定、製品構成に関する問題など、追加作業や遅延の原因を特定できます。重要な理由見積もりプロセスにおける非効率や逸脱を直接示し、遅延や繰り返し作業の根本原因の特定に役立ちます。入手先イベントログを分析して算出します。特定の営業案件で「見積書を作成」または「見積書を改訂」アクティビティが2回以上発生した場合、trueになります。例 truefalse
	見積書ID QuoteId	営業案件に関連付けられた見積書を一意に識別するIDです。
説明見積書IDは、営業案件に対して作成された見積書の参照番号です。特に手戻りが発生した場合、1つの営業案件に対して複数の見積書が作成されることがあります。このIDを追跡することで、「見積もりから注文までのサイクルタイム」や「見積もり手戻り率」を分析できます。見積書の発行から承諾までの時間を正確に測定し、初回の見積書と改訂版を区別できます。重要な理由見積書を一意に識別し、手戻りや受注までの時間を含む見積もりプロセスを正確に分析できます。入手先 Oracle CX SalesのQuoteオブジェクトで使用される主要な識別子で、Opportunityに関連付けられています。例 QUO-98765QUO-98766QUO-98767
	請求書ID InvoiceId	販売注文に対して作成された請求書を一意に識別するIDです。
説明請求書IDは、注文のフルフィルメント完了後に顧客へ送付する請求書の参照番号です。プロセスの最終段階における財務処理の主要な文書です。「請求書作成サイクルタイム」や「入金回収サイクル」の分析に欠かせません。請求書の作成から最終的な入金までを追跡できるため、キャッシュフローや売掛金の状況を把握するうえで重要です。重要な理由最終段階の財務取引を追跡し、請求サイクルの所要時間や入金回収の効率を分析できます。入手先 Oracle CX Salesの文書または連携先のERP・財務システムで、Invoiceオブジェクトの識別子を確認してください。例 INV-2023-001INV-2023-002INV-2023-003
	顧客名 CustomerName	営業案件に関連付けられた顧客または取引先の名前です。
説明この属性は、商談の見込み顧客または既存顧客を示します。営業プロセスを分類、分析するための基本的な軸です。顧客で絞り込むと、特定の取引先における営業の進み方を詳しく分析できるため、重要顧客の管理に役立ちます。また、顧客の規模や業種などの特性ごとにプロセスパフォーマンスを分類し、営業の進め方を調整できます。重要な理由顧客ごとにプロセスを分析し、顧客固有の傾向を把握したり、重要顧客を管理したりできます。入手先 Oracle CX SalesでOpportunityオブジェクトに関連付けられたAccount Nameです。例 Global Tech Inc.Innovate Solutions LLCPioneer Corp

必須推奨任意

リードから入金までのアクティビティ

プロセスを正確に把握し、ボトルネックを特定するために、イベントログに記録する主なプロセスのステップと節目です。

6 推奨 8 任意

	アクティビティ	説明
	リードから商談への転換	選別済みの営業リードから営業商談が作成されたことを示します。このイベントは、商談を中心としたプロセス分析の開始点です。ユーザーがシステム上でリードを転換したときに明示的に発生します。
重要な理由これはプロセスの主要な開始イベントです。転換されたリードの件数と流入元を分析することは、リード獲得と選別の取り組みの効果を把握するうえで重要です。入手先営業商談レコード（Opportunityオブジェクト）の作成時に、「LeadId」または同様の流入元フィールドに値が設定されている場合、その商談が転換されたリードから作成されたことを示すイベントとして記録します。記録元となるリードへの参照が空でないOpportunityオブジェクトの作成タイムスタンプを記録します。イベントタイプ explicit
	入金確認	顧客からの入金が確認され、記録された時点で、リードから入金までのプロセスが正常に完了したことを示します。このイベントは財務システムから取得します。
重要な理由プロセスが正常に完了したことを示す最終地点であり、売上の実現を表します。販売サイクルタイムとキャッシュフローの効率を測定するうえで重要です。入手先外部の売掛金管理システムまたは財務システムから取得します。プロセス分析を完結させるには、データを営業案件に関連付ける必要があります。記録イベントのタイムスタンプは、財務システムの入金消込記録から取得します。イベントタイプ explicit
	商談の受注	顧客が購入を決定し、取引が成立したことを示します。商談のステータスが最終状態の「クローズ済み・受注」に変わったことから推定します。
重要な理由これは営業ファネルにおける主要な成功マイルストーンです。後続の受注履行や請求プロセスを開始するきっかけとなります。入手先 Opportunityオブジェクトの「StatusCode」が「WON」に更新されたことから推定します。「WinProb」（受注確度）フィールドも通常は100％に変わります。記録 Opportunityのステータスフィールドが、システムで定義された「受注」ステータスに更新されたことを検出します。イベントタイプ inferred
	営業案件の失注	営業案件が受注に至らず終了したことを示します。営業案件のステータスが「Closed - Lost」に更新された場合に、このイベントを推定します。
重要な理由プロセスが失敗に終わったことを示す重要な終点です。営業案件を失注した時期や理由、金額を分析することで、プロセスの弱点や市場の課題を特定できます。入手先 Opportunityオブジェクトの「StatusCode」が「LOST」に更新されたことから推定します。「ReasonWonLostCode」フィールドに理由が記録されている場合があります。記録 Opportunityのステータスフィールドが、システムで定義された「Lost」に更新されたことを検出します。イベントタイプ inferred
	見積書の作成	商談に関連付けられた正式な価格見積書が作成されたことを示します。商談に紐づく新しいQuoteレコードの作成によって明示的に記録されるイベントです。
重要な理由これは、営業活動が本格化したことを示す重要なマイルストーンです。商談の作成から見積書の作成までの時間を分析すると、営業の進捗速度を測定できます。入手先営業商談ID（OptyId）に紐づくQuoteレコード（Q_Quoteオブジェクト）の作成イベントから記録します。記録商談に関連付けられたQuoteオブジェクトの作成タイムスタンプを使用します。イベントタイプ explicit
	顧客による見積書の承認	顧客が見積書の条件と価格に正式に同意したことを示します。重要なマイルストーンであり、多くの場合、Quoteオブジェクトのステータスが「承認済み」に変わったことで記録されます。
重要な理由これは購入意欲を示す重要なサインであり、受注を作成する前提条件です。交渉段階の完了を示し、見積もりから受注までのサイクルにおけるマイルストーンとなります。入手先 Quoteオブジェクトのステータスが「承認済み」または「顧客承認済み」に変更されたことから推定します。記録 Quoteオブジェクトのステータスフィールドが、指定された「承認済み」の値に変更されたことを検出します。イベントタイプ inferred
	ソリューションの提案	正式なソリューションまたは提案が顧客に提示されたことを示します。商談が「Proposal」または「Presentation」の段階に進んだ時点で推定します。
重要な理由このイベントを追跡すると、ソリューションの作成と提案にかかった時間を分析できます。また、商談が長く滞留しやすいため、「停滞商談率」という重要業績評価指標（KPI）の測定にも役立ちます。入手先 Opportunityオブジェクトの「Sales Stage」フィールドが、「4 - Proposal」や「Presentation」などの値に変更されたことから推定します。記録 Opportunityの営業ステージフィールドが、提案のステータスに変更されたことを検出します。イベントタイプ inferred
	ニーズ分析の完了	営業チームが顧客の要件を収集し、文書化したことを示します。通常は、商談の営業ステージがディスカバリーまたは分析の段階を過ぎたことから推定します。
重要な理由これは、ソリューションを提案する前の重要なマイルストーンです。この段階での遅延は、顧客との関係構築や、技術的な詳細分析に必要なリソースの確保に問題があることを示す場合があります。入手先 Opportunityオブジェクトの「Sales Stage」フィールドの変更から推定します。たとえば、「2 - Discovery」から「3 - Solution Building」への変更が該当します。記録 Opportunityの営業ステージフィールドが、ディスカバリーの完了を示すステータスに変更されたことを検出します。イベントタイプ inferred
	受注履行の完了	製品が出荷された、またはサービスが顧客に提供されたことを示します。このイベントデータはOracle CX Salesには標準で含まれないため、連携先の受注管理システムまたはERPシステムから取得する必要があります。
重要な理由顧客への納品約束が果たされたことを示し、請求を開始するきっかけとなります。受注履行のサイクルタイムを測定するうえで欠かせません。入手先外部のERPシステムまたは受注履行システムとの連携が必要です。データは、元となる営業商談IDに紐づける必要があります。記録イベントのタイムスタンプは、連携を通じて受注履行システムから取得します。イベントタイプ explicit
	受注履行への引き継ぎ	営業チームから受注履行チームへの引き継ぎを示します。Oracle CX Salesでは、商談の受注をきっかけに、連携先のERPシステムで受注を作成するプロセスが開始されたことから推定できます。
重要な理由このアクティビティは営業と業務をつなぐものです。この引き継ぎを分析することは、「受注履行時間」という重要業績評価指標（KPI）を把握し、最適化するうえで重要です。入手先このイベントはCX Sales内では概念上のものとなることが多く、別のシステムで受注を作成するきっかけを表します。「商談の受注」のタイムスタンプ、またはその後に記録される連携確認ステータスに関連付けられます。記録多くの場合、「商談の受注」のタイムスタンプを代用するか、連携先の受注管理システムのデータが必要です。イベントタイプ inferred
	商談の選別完了	商談の初期選別段階が完了したことを示します。通常は、初期評価が完了し、有望な商談であることを示すように営業ステージが更新された時点で推定します。
重要な理由このマイルストーンを追跡すると、営業初期段階の効率を測定し、商談が選別にかかる時間を把握できます。リードから商談への転換率という重要業績評価指標（KPI）の測定にも役立ちます。入手先 Opportunityオブジェクトの「Sales Stage」フィールド（StgId）が選別を示す値に変更されたことから推定します。たとえば、「1 - Qualification」から「2 - Discovery」への変更が該当します。記録 Opportunityの営業ステージフィールドが、指定された「選別済み」ステータスに変更されたことを検出します。イベントタイプ inferred
	見積書の再作成	見積書が修正され、顧客に再発行されたケースを記録します。同じ商談で「見積書の作成」イベントが複数回発生した場合や、1つの見積書レコードにバージョンが記録されている場合に推定します。
重要な理由頻繁な手戻りは、最初の提案の精度不足や交渉の長期化を示し、営業サイクルを延ばす可能性があります。「見積書の手戻り率」という重要業績評価指標（KPI）の測定や、手戻り分析ダッシュボードにも役立ちます。入手先顧客への送付後にQuoteの新しいバージョンが作成された場合や、既存の見積書が大幅に更新された場合（例：ステータスが下書きに戻る）に推定します。記録同じ商談に対して後続の「見積書の作成」イベントが発生したこと、またはバージョン番号が増えたことを特定します。イベントタイプ inferred
	見積書の顧客への送付	見積書が確認のために正式に顧客へ送付された時点を示します。通常は、Quoteオブジェクトのステータスが「提示済み」や「送付済み」に変わったことから推定します。
重要な理由このアクティビティを起点に、顧客による確認や交渉の期間を測定します。「見積もりから受注作成までの時間」という重要業績評価指標（KPI）の測定開始点です。入手先商談に関連付けられたQuoteオブジェクトのステータス変更から推定します。ステータスフィールドの名前は「StatusCode」などの場合があります。記録 Quoteオブジェクトのステータスフィールドが「送付済み」または「提示済み」に変更されたことを検出します。イベントタイプ inferred
	請求書の発行	履行済みの受注に対する顧客向け請求書の作成を示します。このアクティビティはOracle CX Salesではなく、請求または財務システムで発生するため、データを連携する必要があります。
重要な理由このイベントを起点に入金回収サイクルが始まります。受注履行から請求書発行までの遅延は、キャッシュフローや「請求書発行から入金までのサイクルタイム」という重要業績評価指標（KPI）に悪影響を及ぼす可能性があります。入手先外部のERPまたは売掛金管理システムから取得します。プロセス分析には、イベントデータを営業案件IDと関連付ける必要があります。記録イベントのタイムスタンプは、財務システムの請求書作成ログから取得します。イベントタイプ explicit

推奨任意

データ抽出ガイド

Oracle CX Salesからデータを取得する方法

ステップ

前提条件と認証：Oracle CX Salesで、営業案件や見積もりのREST APIにアクセスするための権限（営業管理者など）を持つユーザーアカウントを用意します。APIリクエストの認証とベアラートークンの取得に使うOAuth 2.0のクライアント認証情報（クライアントIDとクライアントシークレット）を、Oracle Cloud管理者から入手します。
環境を準備する：ローカルマシンまたはサーバーにNode.js環境を設定します。HTTPリクエストの送信とCSVファイルの処理に必要なライブラリをインストールします。ターミナルを開き、次のコマンドを実行します。 npm install axios npm install json2csv
APIエンドポイントを確認する：この抽出で使用する主なエンドポイントは、OpportunityオブジェクトとQuoteオブジェクトです。ベースURLはOracleインスタンスごとに異なります。例：https://[your-oracle-cx-cloud-host].fa.us2.oraclecloud.com。主なリソースは次のとおりです。

営業案件：/salesApi/resources/latest/opportunities
見積もり（営業案件の子オブジェクト）：/salesApi/resources/latest/opportunities/{OptyId}/child/Quote

抽出スクリプトを設定する：提供されたJavaScriptコードをextract.jsなどのファイルにコピーします。スクリプト先頭のプレースホルダー変数を、Oracle CX CloudのホストURL、クライアントID、クライアントシークレット、および抽出対象の日付範囲に置き換えます。
スクリプトを実行する：ターミナルでnode extract.jsを実行します。スクリプトはまず認証トークンを取得し、その後APIから営業案件をページ単位で取得します。
データ取得とページ分割：スクリプトがAPIのページネーションを自動で処理します。1回のリクエストで指定件数の営業案件を取得し、offsetパラメーターを使って次のページを順にリクエストします。指定した日付範囲内の営業案件をすべて取得するまで繰り返します。
関連する見積もりデータを取得する：取得した各営業案件について、関連する見積もりをすべて取得するため、追加のAPIリクエストを行います。このデータは、「見積もり作成」や「見積もり承認」などのアクティビティを生成するために必要です。
イベントログ用にデータを変換する：スクリプトの主要な処理では、各営業案件と関連する見積もりを処理します。階層構造のJSONデータを、表形式のイベントログに変換します。必要に応じて、ステータスコード、営業ステージ、作成日からイベントを推定し、業務アクティビティごとに個別の行を作成します。
外部データへの依存に対応する：「注文履行済み」「請求書発行」「入金」などのアクティビティは外部システムで発生します。スクリプトは、営業から履行への引き継ぎを示す仮のアクティビティを生成します。ERPや財務システムから別途データを抽出し、共通キーのSalesOpportunityを使ってイベントログに結合してください。
CSVにエクスポートする：すべてのデータを取得して変換した後、json2csvライブラリでイベントログのレコード配列をoracle_cx_sales_event_log.csvというCSVファイルに変換します。ファイルはスクリプトを実行したディレクトリに保存されます。
アップロードの準備をする：生成されたCSVファイルを確認し、内容が正しく、必要なデータがそろっていることを確かめます。ファイルにはSalesOpportunity、ActivityName、EventTimeなどの必要な列が含まれており、ProcessMindにアップロードして分析できます。

設定

APIホストURL：Oracle CX Sales環境のベースURLです。例：https://[your-instance].fa.us2.oraclecloud.com。
認証：スクリプトでは、サーバー間認証にクライアントIDとクライアントシークレットを使ったOAuth 2.0を使用します。これらの認証情報は、Oracle CloudのID管理設定で発行する必要があります。
日付範囲：スクリプトのLastUpdateDateフィールドを使って営業案件を絞り込みます。データ量とAPIへの負荷を抑えるため、まず直近3～6か月などの期間を指定することを推奨します。形式はYYYY-MM-DDです。
フィールドの選択：スクリプトではfieldsクエリパラメーターを使い、APIから必要なフィールドだけを取得します。これによりパフォーマンスが大幅に向上し、ネットワーク通信量も減らせます。カスタムフィールドを使う場合は、このパラメーターに追加してください。
ページネーションの上限：limitパラメーターで、1回のAPI呼び出しで返されるレコード数を指定します。スクリプトでは一般的な最大値の500を設定し、必要なAPI呼び出し回数を抑えています。
必要な権限：使用するユーザーまたはOAuthアプリケーションの認証情報には、標準フィールドと分析に必要なカスタムフィールドを含め、「Opportunity」と「Quote」のRESTリソースへの読み取り権限が必要です。

クエリの例 javascript

const axios = require('axios');
const { Parser } = require('json2csv');
const fs = require('fs');

// --- Configuration --- //
const ORACLE_CX_HOST = 'https://[your-oracle-cx-cloud-host].fa.us2.oraclecloud.com';
const CLIENT_ID = '[Your Client ID]';
const CLIENT_SECRET = '[Your Client Secret]';
const START_DATE = '2023-01-01'; // YYYY-MM-DD
const END_DATE = '2023-06-30'; // YYYY-MM-DD
const PAGE_LIMIT = 500;
// --- End Configuration --- //

const tokenUrl = `${ORACLE_CX_HOST}/fscmRestApi/tokenrelay`;
const opportunitiesUrl = `${ORACLE_CX_HOST}/salesApi/resources/latest/opportunities`;

const getAuthToken = async () => {
    try {
        const response = await axios.post(tokenUrl, 'grant_type=client_credentials', {
            headers: {
                'Content-Type': 'application/x-www-form-urlencoded',
                'Authorization': `Basic ${Buffer.from(`${CLIENT_ID}:${CLIENT_SECRET}`).toString('base64')}`
            }
        });
        console.log('Successfully obtained authentication token.');
        return response.data.access_token;
    } catch (error) {
        console.error('Error fetching auth token:', error.response ? error.response.data : error.message);
        throw new Error('Authentication failed.');
    }
};

const fetchAllOpportunities = async (token) => {
    let allOpportunities = [];
    let hasMore = true;
    let offset = 0;

    console.log(`Fetching opportunities updated between ${START_DATE} and ${END_DATE}...`);

    while (hasMore) {
        const params = {
            q: `LastUpdateDate between '${START_DATE}' and '${END_DATE}'`,
            onlyData: true,
            limit: PAGE_LIMIT,
            offset: offset,
            fields: 'OptyId,CreationDate,LastUpdateDate,Name,SalesStage,StatusCode,RevnAmount,OwnerResourcePartyId,PrimaryContactPartyName,LossReasonCode,LeadId,OrganizationName,OptyNumber,OwnerName'
        };

        try {
            const response = await axios.get(opportunitiesUrl, { headers: { Authorization: `Bearer ${token}` }, params });
            const opportunities = response.data.items;
            if (opportunities && opportunities.length > 0) {
                allOpportunities.push(...opportunities);
                offset += opportunities.length;
                console.log(`Fetched ${opportunities.length} opportunities, total so far: ${allOpportunities.length}`);
            } else {
                 hasMore = false;
            }
            hasMore = response.data.hasMore;
        } catch (error) {
            console.error(`Error fetching opportunities at offset ${offset}:`, error.response ? error.response.data : error.message);
            hasMore = false; // Stop on error
        }
    }
    return allOpportunities;
};

const fetchQuotesForOpportunity = async (token, optyId) => {
    const quotesUrl = `${opportunitiesUrl}/${optyId}/child/Quote`;
    try {
        const response = await axios.get(quotesUrl, {
            headers: { Authorization: `Bearer ${token}` },
            params: { fields: 'QuoteId,CreationDate,LastUpdateDate,QuoteStatus,QuoteNumber', onlyData: true }
        });
        return response.data.items;
    } catch (error) {
        console.error(`Error fetching quotes for opportunity ${optyId}:`, error.response ? error.response.data : error.message);
        return [];
    }
};

const transformToEventLog = async (token, opportunities) => {
    const eventLog = [];
    const now = new Date().toISOString();

    for (const opp of opportunities) {
        const commonAttributes = {
            SalesOpportunity: opp.OptyNumber,
            SourceSystem: 'Oracle CX Sales',
            LastDataUpdate: now,
            OpportunityValue: opp.RevnAmount,
            SalesStage: opp.SalesStage,
            OpportunityOwner: opp.OwnerName,
            Region: opp.OrganizationName, // Example mapping, adjust as needed
            LossReason: opp.LossReasonCode
        };

        // Activity: Lead Converted To Opportunity
        if (opp.LeadId) {
            eventLog.push({ ...commonAttributes, ActivityName: 'Lead Converted To Opportunity', EventTime: opp.CreationDate });
        }
        
        // Inferred stage-based activities. Using LastUpdateDate as proxy.
        // A more accurate method requires audit trail data which is more complex to extract.
        const stageNumber = parseInt(opp.SalesStage?.split('-')[0], 10);
        if (stageNumber >= 2) {
             eventLog.push({ ...commonAttributes, ActivityName: 'Opportunity Qualified', EventTime: opp.LastUpdateDate });
        }
        if (stageNumber >= 3) {
             eventLog.push({ ...commonAttributes, ActivityName: 'Needs Analysis Completed', EventTime: opp.LastUpdateDate });
        }
        if (stageNumber >= 4) {
             eventLog.push({ ...commonAttributes, ActivityName: 'Solution Proposed', EventTime: opp.LastUpdateDate });
        }

        // Fetch and process quotes
        const quotes = await fetchQuotesForOpportunity(token, opp.OptyId);
        let quoteCreationCount = 0;
        for (const quote of quotes) {
            quoteCreationCount++;
            // Activity: Quote Created
            eventLog.push({ ...commonAttributes, ActivityName: 'Quote Created', EventTime: quote.CreationDate });
            // Activity: Quote Reworked (inferred from second or later quote creation)
            if (quoteCreationCount > 1) {
                 eventLog.push({ ...commonAttributes, ActivityName: 'Quote Reworked', EventTime: quote.CreationDate });
            }
            // Activity: Quote Sent To Customer
            if (['PRESENTED', 'SENT'].includes(quote.QuoteStatus)) {
                 eventLog.push({ ...commonAttributes, ActivityName: 'Quote Sent To Customer', EventTime: quote.LastUpdateDate });
            }
            // Activity: Quote Accepted By Customer
            if (quote.QuoteStatus === 'ACCEPTED') {
                 eventLog.push({ ...commonAttributes, ActivityName: 'Quote Accepted By Customer', EventTime: quote.LastUpdateDate });
            }
        }

        // Final Opportunity Status activities
        if (opp.StatusCode === 'WON') {
            eventLog.push({ ...commonAttributes, ActivityName: 'Opportunity Won', EventTime: opp.LastUpdateDate });
            // Activity: Order Submitted For Fulfillment (inferred from Opportunity Won)
            eventLog.push({ ...commonAttributes, ActivityName: 'Order Submitted For Fulfillment', EventTime: opp.LastUpdateDate });
            
            // Placeholder for events from external systems. Data should be merged from other sources.
            // eventLog.push({ ...commonAttributes, ActivityName: 'Order Fulfilled', EventTime: [Timestamp from ERP] });
            // eventLog.push({ ...commonAttributes, ActivityName: 'Invoice Generated', EventTime: [Timestamp from Financials] });
            // eventLog.push({ ...commonAttributes, ActivityName: 'Payment Received', EventTime: [Timestamp from Financials] });

        } else if (opp.StatusCode === 'LOST') {
            eventLog.push({ ...commonAttributes, ActivityName: 'Opportunity Lost', EventTime: opp.LastUpdateDate });
        }
    }
    return eventLog;
};

const main = async () => {
    try {
        const token = await getAuthToken();
        const opportunities = await fetchAllOpportunities(token);
        console.log(`Total opportunities to process: ${opportunities.length}`);

        if (opportunities.length > 0) {
            console.log('Transforming data into event log...');
            const eventLog = await transformToEventLog(token, opportunities);
            console.log(`Generated ${eventLog.length} event records.`);
            
            const parser = new Parser();
            const csv = parser.parse(eventLog);
            fs.writeFileSync('oracle_cx_sales_event_log.csv', csv);
            console.log('Event log saved to oracle_cx_sales_event_log.csv');
        }
    } catch (error) {
        console.error('An error occurred during the extraction process:', error.message);
    }
};

main();

ステップ

Python環境を準備する：システムにPythonがインストールされていることを確認します。pipを使って必要なライブラリをインストールします：pip install requests pandas。
API認証情報を取得する：管理者アカウントでOracle CX Salesインスタンスにログインします。「セキュリティコンソール」（ナビゲーター > ツール > セキュリティコンソール）に移動し、「営業担当者」またはカスタムの連携ロールを持つユーザーを新規作成します。このユーザーには、salesLeads、opportunities、quotesおよび関連オブジェクトへのAPIアクセス権が必要です。ユーザー名とパスワードを控えておきます。
Oracle CXのドメインを確認する：Oracle CX SalesのドメインURLを確認します。通常はhttps://[your-pod-name].fa.em2.oraclecloud.comの形式です。
スクリプトを設定する：提供されたPythonスクリプトをエディターで開きます。ORACLE_CX_DOMAIN、USERNAME、PASSWORD、START_DATE、END_DATEのプレースホルダーを、実際の認証情報と抽出対象の日付範囲に置き換えます。
APIエンドポイントとフィールドを調整する：スクリプト内のAPI呼び出しを確認します。OptyId、名前、SalesStage、StatusCodeなどのフィールドは標準項目です。分析に必要なカスタムフィールド（接尾辞_c）がある場合は、該当するAPIリクエストのfieldsパラメーターに追加します。
外部システムとの連携を実装する：スクリプトには、Oracle CX Sales以外で発生するアクティビティ用のプレースホルダー関数（get_order_data_from_erp、get_invoice_data_from_finance、get_payment_data_from_finance）が含まれています。Order Submitted、Order Fulfilled、Invoice Generated、Payment Receivedのイベントデータを取得するため、プレースホルダーの処理をERPおよび財務システムへの実際のAPI呼び出しに置き換えてください。リードから入金までのプロセス全体を把握するには、この連携が必要です。
スクリプトを実行する：コマンドラインからpython your_script_name.pyを実行します。スクリプトがOracle CX Salesに複数回APIリクエストを送り、データを処理して1つのイベントログにまとめます。
出力を確認する：スクリプトによってlead_to_cash_event_log.csvというファイルが生成されます。表計算アプリケーションで開き、構成と内容を確認します。SalesOpportunity、ActivityName、EventTime、SourceSystemなど、想定した列が含まれていることを確認してください。
APIのページネーションに対応する：提供されたスクリプトには基本的なページネーション処理が含まれています。データセットが非常に大きい場合は、APIのレート制限を超えないよう、エラー処理を強化したり、リクエスト間に短い待ち時間を設けたりする必要があります。
アップロードの準備をする：最終的なCSVファイルはProcessMindに直接アップロードできる形式です。列見出しがProcessMindプロジェクトのマッピングと一致していることを確認してください。追加の書式設定は不要です。

設定

API認証情報：Sales Lead、Sales Opportunity、Quoteオブジェクトを読み取るための十分な権限を持つ専用APIユーザーが必要です。ステータスやステージの変更履歴など、過去のデータや監査履歴にもアクセスできる必要があります。
Oracle CXドメイン：Oracle CX SalesインスタンスのベースURLをスクリプトに正しく指定してください。
日付範囲：スクリプトのSTART_DATEとEND_DATE変数を設定し、抽出期間を指定します。初回の分析では、データ量とパフォーマンスのバランスを考慮し、3～6か月の範囲を推奨します。
営業案件のフィルター：特定の条件で営業案件を絞り込むよう、スクリプトをカスタマイズできます。たとえば、API URLにクエリパラメーターを追加し、Organization_Idやカスタムフィールドで絞り込むと、特定の事業部門や営業案件の種類に対象を限定できます。
外部システムのエンドポイント：ERPおよび財務システムから注文、請求書、入金データを抽出するには、実際のAPIエンドポイント、認証情報、処理ロジックを用意する必要があります。スクリプトでは、営業案件IDまたは関連する注文IDを使って各システムのデータを関連付けることを前提としています。
ページネーションの上限：API呼び出しのlimitパラメーターは100に設定されています。変更できますが、値を大きくすると、複雑なクエリでタイムアウトが発生するリスクが高まる場合があります。

クエリの例 python

import requests
import pandas as pd
from requests.auth import HTTPBasicAuth
import datetime

class=class="hl-string">"hl-comment"># --- Configuration Settings ---
class=class="hl-string">"hl-comment"># Replace with your Oracle CX Sales domain, username, and password
ORACLE_CX_DOMAIN = class="hl-string">"https://[your-pod-name].fa.em2.oraclecloud.com"
USERNAME = class="hl-string">"[Your_API_Username]"
PASSWORD = class="hl-string">"[Your_API_Password]"

class=class="hl-string">"hl-comment"># Define the date range for the extraction (YYYY-MM-DD format)
START_DATE = class="hl-string">"2023-01-01"
END_DATE = class="hl-string">"2023-12-31"

class=class="hl-string">"hl-comment"># --- Helper Function for API Calls ---
def fetch_all_pages(endpoint, q_filter):
    all_items = []
    url = fclass="hl-string">"{ORACLE_CX_DOMAIN}/salesApi/resources/latest/{endpoint}"
    params = {
        class="hl-string">'q': q_filter,
        class="hl-string">'onlyData': class="hl-string">'true',
        class="hl-string">'limit': 100, class=class="hl-string">"hl-comment"># Max records per page
        class="hl-string">'offset': 0
    }
    
    while True:
        try:
            response = requests.get(url, auth=HTTPBasicAuth(USERNAME, PASSWORD), params=params)
            response.raise_for_status()
            data = response.json()
            items = data.get(class="hl-string">'items', [])
            if not items:
                break
            all_items.extend(items)
            if data.get(class="hl-string">'hasMore', False):
                params[class="hl-string">'offset'] += params[class="hl-string">'limit']
            else:
                break
        except requests.exceptions.RequestException as e:
            print(fclass="hl-string">"Error fetching {url}: {e}")
            break
    return all_items

class=class="hl-string">"hl-comment"># --- Placeholder Functions for External Systems ---
def get_order_data_from_erp(opportunity_ids):
    class=class="hl-string">"hl-comment"># CRITICAL: Replace this with actual API calls to your ERP system.
    class=class="hl-string">"hl-comment"># This function should return a list of dictionaries.
    class=class="hl-string">"hl-comment"># Each dictionary should have class="hl-string">'OptyId', class="hl-string">'EventTime', class="hl-string">'ActivityName'.
    print(class="hl-string">"Fetching placeholder Order data from ERP...")
    placeholder_data = []
    class=class="hl-string">"hl-comment"># Example: placeholder_data.append({class="hl-string">'OptyId': 12345, class="hl-string">'EventTime': class="hl-string">'2023-10-25T10:00:00Z', class="hl-string">'ActivityName': class="hl-string">'Order Submitted For Fulfillment'})
    class=class="hl-string">"hl-comment"># Example: placeholder_data.append({class="hl-string">'OptyId': 12345, class="hl-string">'EventTime': class="hl-string">'2023-10-28T14:00:00Z', class="hl-string">'ActivityName': class="hl-string">'Order Fulfilled'})
    return placeholder_data

def get_invoice_data_from_finance(opportunity_ids):
    class=class="hl-string">"hl-comment"># CRITICAL: Replace this with actual API calls to your financial system.
    print(class="hl-string">"Fetching placeholder Invoice data...")
    return [] class=class="hl-string">"hl-comment"># Example: [{class="hl-string">'OptyId': 12345, class="hl-string">'EventTime': class="hl-string">'2023-10-29T11:00:00Z', class="hl-string">'ActivityName': class="hl-string">'Invoice Generated'}]

def get_payment_data_from_finance(opportunity_ids):
    class=class="hl-string">"hl-comment"># CRITICAL: Replace this with actual API calls to your financial system.
    print(class="hl-string">"Fetching placeholder Payment data...")
    return [] class=class="hl-string">"hl-comment"># Example: [{class="hl-string">'OptyId': 12345, class="hl-string">'EventTime': class="hl-string">'2023-11-15T09:30:00Z', class="hl-string">'ActivityName': class="hl-string">'Payment Received'}]


class=class="hl-string">"hl-comment"># --- Main Extraction Logic ---
print(class="hl-string">"Starting Lead to Cash extraction...")

class=class="hl-string">"hl-comment"># 1. Fetch all relevant opportunities within the date range
date_filter = fclass="hl-string">"LastUpdateDate between '{START_DATE}' and '{END_DATE}'"
opportunities = fetch_all_pages(class="hl-string">'opportunities', date_filter)

if not opportunities:
    print(class="hl-string">"No opportunities found for the given date range. Exiting.")
    exit()

print(fclass="hl-string">"Found {len(opportunities)} opportunities to process.")
opp_ids = [opp[class="hl-string">'OptyId'] for opp in opportunities]

class=class="hl-string">"hl-comment"># DataFrame to hold all events
event_log_df = pd.DataFrame()

class=class="hl-string">"hl-comment"># 2. Extract activities from Opportunity and related objects
all_events = []

for opp in opportunities:
    opp_id = opp[class="hl-string">'OptyId']
    last_update = datetime.datetime.now().isoformat()

    base_attributes = {
        class="hl-string">'SalesOpportunity': opp_id,
        class="hl-string">'OpportunityValue': opp.get(class="hl-string">'Revenue'),
        class="hl-string">'SalesStage': opp.get(class="hl-string">'SalesStage'),
        class="hl-string">'OpportunityOwner': opp.get(class="hl-string">'OwnerResourcePartyName'),
        class="hl-string">'Region': opp.get(class="hl-string">'TerritoryName_c'), class=class="hl-string">"hl-comment"># Example custom field
        class="hl-string">'LossReason': opp.get(class="hl-string">'ReasonWonLostCode'),
        class="hl-string">'SourceSystem': class="hl-string">'Oracle CX Sales',
        class="hl-string">'LastDataUpdate': last_update
    }
    
    class=class="hl-string">"hl-comment"># Activity: Lead Converted To Opportunity (inference)
    if opp.get(class="hl-string">'PrimaryContactEmailAddress') and opp.get(class="hl-string">'SalesMethod') != class="hl-string">'Renewal': class=class="hl-string">"hl-comment"># Heuristic for lead-based opportunities
        all_events.append({**base_attributes, class="hl-string">'ActivityName': class="hl-string">'Lead Converted To Opportunity', class="hl-string">'EventTime': opp.get(class="hl-string">'CreationDate')})
        
    class=class="hl-string">"hl-comment"># Activities from Sales Stage history
    stage_history = opp.get(class="hl-string">'ChildSalesStage', [])
    for stage in stage_history:
        stage_name = stage.get(class="hl-string">'SalesStageCode')
        event_time = stage.get(class="hl-string">'LastUpdateDate')
        activity = None
        if stage_name in [class="hl-string">'01-QUALIFICATION', class="hl-string">'QUALIFIED']: activity = class="hl-string">'Opportunity Qualified'
        elif stage_name in [class="hl-string">'02-DISCOVERY', class="hl-string">'ANALYSIS']: activity = class="hl-string">'Needs Analysis Completed'
        elif stage_name in [class="hl-string">'03-PROPOSAL', class="hl-string">'SOLUTION_PROPOSED']: activity = class="hl-string">'Solution Proposed'
        
        if activity:
            all_events.append({**base_attributes, class="hl-string">'ActivityName': activity, class="hl-string">'EventTime': event_time})

    class=class="hl-string">"hl-comment"># Activities: Opportunity Won / Lost
    if opp.get(class="hl-string">'StatusCode') == class="hl-string">'WON':
        all_events.append({**base_attributes, class="hl-string">'ActivityName': class="hl-string">'Opportunity Won', class="hl-string">'EventTime': opp.get(class="hl-string">'LastUpdateDate')})
    elif opp.get(class="hl-string">'StatusCode') == class="hl-string">'LOST':
        all_events.append({**base_attributes, class="hl-string">'ActivityName': class="hl-string">'Opportunity Lost', class="hl-string">'EventTime': opp.get(class="hl-string">'LastUpdateDate')})

    class=class="hl-string">"hl-comment"># Activities from Quotes
    quotes = opp.get(class="hl-string">'ChildQuote', [])
    quote_creation_dates = []
    for quote in quotes:
        quote_creation_dates.append(quote.get(class="hl-string">'CreationDate'))
        all_events.append({**base_attributes, class="hl-string">'ActivityName': class="hl-string">'Quote Created', class="hl-string">'EventTime': quote.get(class="hl-string">'CreationDate')})
        
        class=class="hl-string">"hl-comment"># Infer other quote events from status or custom date fields
        if quote.get(class="hl-string">'QuoteStatus_c') == class="hl-string">'SENT' and quote.get(class="hl-string">'DateSent_c'):
            all_events.append({**base_attributes, class="hl-string">'ActivityName': class="hl-string">'Quote Sent To Customer', class="hl-string">'EventTime': quote.get(class="hl-string">'DateSent_c')})
        if quote.get(class="hl-string">'QuoteStatus_c') == class="hl-string">'ACCEPTED' and quote.get(class="hl-string">'DateAccepted_c'):
            all_events.append({**base_attributes, class="hl-string">'ActivityName': class="hl-string">'Quote Accepted By Customer', class="hl-string">'EventTime': quote.get(class="hl-string">'DateAccepted_c')})
    
    class=class="hl-string">"hl-comment"># Activity: Quote Reworked (inference)
    if len(quote_creation_dates) > 1:
        class=class="hl-string">"hl-comment"># Mark all but the first creation as a rework event
        sorted_dates = sorted(quote_creation_dates)
        for rework_date in sorted_dates[1:]:
            all_events.append({**base_attributes, class="hl-string">'ActivityName': class="hl-string">'Quote Reworked', class="hl-string">'EventTime': rework_date})

class=class="hl-string">"hl-comment"># 3. Add data from external systems
print(class="hl-string">"Fetching data from external systems...")
order_events = get_order_data_from_erp(opp_ids)
invoice_events = get_invoice_data_from_finance(opp_ids)
payment_events = get_payment_data_from_finance(opp_ids)

external_system_events = []
last_update = datetime.datetime.now().isoformat()

for event in order_events + invoice_events + payment_events:
    opp_id = event[class="hl-string">'OptyId']
    class=class="hl-string">"hl-comment"># Find the corresponding opportunity to get base attributes
    opp_data = next((item for item in opportunities if item[class="hl-string">"OptyId"] == opp_id), None)
    if opp_data:
         base_attributes = {
            class="hl-string">'SalesOpportunity': opp_id,
            class="hl-string">'OpportunityValue': opp_data.get(class="hl-string">'Revenue'),
            class="hl-string">'SalesStage': opp_data.get(class="hl-string">'SalesStage'),
            class="hl-string">'OpportunityOwner': opp_data.get(class="hl-string">'OwnerResourcePartyName'),
            class="hl-string">'Region': opp_data.get(class="hl-string">'TerritoryName_c'),
            class="hl-string">'LossReason': opp_data.get(class="hl-string">'ReasonWonLostCode'),
            class="hl-string">'SourceSystem': class="hl-string">'ERP/Finance',
            class="hl-string">'LastDataUpdate': last_update
        }
    else:
        base_attributes = {class="hl-string">'SalesOpportunity': opp_id, class="hl-string">'SourceSystem': class="hl-string">'ERP/Finance', class="hl-string">'LastDataUpdate': last_update}
    
    external_system_events.append({**base_attributes, class="hl-string">'ActivityName': event[class="hl-string">'ActivityName'], class="hl-string">'EventTime': event[class="hl-string">'EventTime']})

all_events.extend(external_system_events)

class=class="hl-string">"hl-comment"># 4. Finalize the DataFrame
if all_events:
    event_log_df = pd.DataFrame(all_events)
    class=class="hl-string">"hl-comment"># Standardize column names
    event_log_df = event_log_df.rename(columns={class="hl-string">'ActivityName': class="hl-string">'ActivityName', class="hl-string">'EventTime': class="hl-string">'EventTime'})
    
    class=class="hl-string">"hl-comment"># Ensure required columns exist
    required_cols = [class="hl-string">'SalesOpportunity', class="hl-string">'ActivityName', class="hl-string">'EventTime', class="hl-string">'SourceSystem', class="hl-string">'LastDataUpdate', class="hl-string">'OpportunityValue', class="hl-string">'SalesStage', class="hl-string">'OpportunityOwner', class="hl-string">'Region', class="hl-string">'LossReason']
    for col in required_cols:
        if col not in event_log_df.columns:
            event_log_df[col] = None
            
    class=class="hl-string">"hl-comment"># Select and order columns
    event_log_df = event_log_df[required_cols]
    
    class=class="hl-string">"hl-comment"># Clean up and sort
    event_log_df = event_log_df.dropna(subset=[class="hl-string">'SalesOpportunity', class="hl-string">'ActivityName', class="hl-string">'EventTime'])
    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">'SalesOpportunity', class="hl-string">'EventTime'])
    
    class=class="hl-string">"hl-comment"># Save to CSV
    output_filename = class="hl-string">'lead_to_cash_event_log.csv'
    event_log_df.to_csv(output_filename, index=False, date_format=class="hl-string">'%Y-%m-%dT%H:%M:%S.%fZ')
    print(fclass="hl-string">"Extraction complete. Event log saved to {output_filename}")
else:
    print(class="hl-string">"No events were generated.")

始める準備はできましたか？

このテンプレートを使ってデータを準備し、リードから入金までのプロセスに関するインサイトを見つけましょう。今日から業務の効率化に取り組めます。

改善ガイドに戻る

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

リードから入金までの成約率を今すぐ20％向上

ボトルネックを特定し、失注を減らして、成約率を20％高めます。

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

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

リードから入金までのデータテンプレート

リードから入金までのデータテンプレート

リードから入金までの属性

リードから入金までのアクティビティ

データ抽出ガイド

Oracle CX Sales REST APIへの直接クエリによるデータ抽出

ステップ

設定

クエリの例 javascript

Oracle CX Sales REST APIを使ったPythonスクリプト

ステップ

設定

クエリの例 python

始める準備はできましたか？

リードから入金までの成約率を今すぐ20％向上