> 継続的なプロセス改善 > リード・トゥ・キャッシュ > Oracle CX Sales > データテンプレート

お客様のリード・トゥ・キャッシュデータテンプレート

Oracle CX Sales

リード・トゥ・キャッシュの属性 (21) リード・トゥ・キャッシュのアクティビティ (14) 抽出ガイド (2)

お客様のリード・トゥ・キャッシュデータテンプレート

このテンプレートは、プロセスマイニングのためにリード・トゥ・キャッシュデータを準備するのに役立ちます。収集すべき必須属性、追跡すべき主要活動を概説し、Oracle CX Salesからこの情報を抽出するための貴重なガイダンスを提供します。このテンプレートに従うことで、プロセスの包括的かつ正確な分析を確実に実行できます。

リード・トゥ・キャッシュ分析のための推奨属性
営業サイクルと支払いサイクル全体で追跡すべき主要なアクティビティ
Oracle CX Salesからのデータ抽出に関する詳細ガイド

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

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

リード・トゥ・キャッシュの属性

これらは、リード・トゥ・キャッシュプロセスの包括的な分析のために、イベントログに含めることを推奨するデータフィールドです。

5 必須 5 推奨 11 任意

	名前	説明
	アクティビティ名 ActivityName	営業商談において特定の時点で発生した業務活動またはイベントの名前です。
説明この属性は、「リードから商談へ転換」、「見積作成」、「支払い受領」など、リード・トゥ・キャッシュプロセスにおける特定のステップやマイルストーンを記述します。これらの活動は、プロセス図の基本的な構成要素です。これらの活動のシーケンスと頻度を分析することで、プロセスフローを可視化し、一般的および代替パスを特定し、逸脱やボトルネックを検出するのに役立ちます。これは、ステップ間の移行時間を測定し、実際にどのように作業が行われているかを理解するための基礎となります。その重要性この属性は、プロセス図を構築し、営業ライフサイクル内のイベントのシーケンスを理解するための基本となります。取得元通常、ステータス変更、イベントログ、または商談、見積、注文オブジェクトに関連付けられた特定のタスク完了レコードから導き出されます。例商談の適格化顧客に見積送付済み注文完了入金確認済み
	イベント日時 EventTime	特定のアクティビティまたはイベントが発生した時刻を示すタイムスタンプ。
説明イベントタイムとは、活動が記録された日付と時刻のことです。これは、イベントを時系列順に並べ、プロセス内の異なるステップ間の期間を計算するために不可欠です。このタイムスタンプは、サイクルタイムの計算、待機時間の測定によるボトルネックの特定、サービスレベル契約に対するパフォーマンスの監視など、すべての時間ベース分析の基礎となります。正確なタイムスタンプは、信頼性の高いプロセスマイニング分析に不可欠です。その重要性イベントの時系列順序を提供し、サイクルタイムや期間などのすべてのパフォーマンス指標を計算するために不可欠です。取得元これは、ステータス変更タイムスタンプなど、特定の活動に関連するレコードの作成日または最終更新日に対応します。例 2023-04-15T10:00:00Z2023-05-01T14:30:00Z2023-05-20T09:15:00Z
	営業商談 SalesOpportunity	営業商談の一意の識別子であり、リード・トゥ・キャッシュプロセスにおけるケースとして機能します。
説明営業商談は、リードとしての初期段階から、成約または失注としての最終的な解決まで、潜在的な収益を生み出す案件を追跡する中心的なオブジェクトです。適格性評価、見積もり、注文、支払いなど、関連するすべての活動を接続します。プロセスマイニング分析において、この識別子は各案件のエンド・ツー・エンドのジャーニーを再構築するために重要です。ステージ間のサイクルタイム、コンバージョン率、成功する結果につながるパスと失注につながるパスの特定など、ライフサイクル全体を分析することを可能にします。その重要性これは、すべてのプロセスイベントを連携させる必須のCase IDであり、潜在的な各取引の販売ライフサイクル全体を完全かつ正確に把握することを可能にします。取得元これはOracle CX Salesの商談オブジェクトにおける主要な識別子です。例 OPP-0012345OPP-0023456OPP-0034567
	ソースシステム SourceSystem	データを抽出した元システム。
説明この属性は、このコンテキストにおけるプロセスデータ（Oracle CX Sales）の発生元を識別します。複数のシステムがある環境では、このフィールドはデータソースを区別するのに役立ちます。分析においては、データの発生元に関するコンテキストを提供します。これは、複数のシステムからのデータを統合したり、システム固有の動作を理解したりする際に重要になる可能性があります。データガバナンスと追跡可能性のための標準フィールドです。その重要性データの発生元に関する不可欠なコンテキストを提供し、追跡可能性を確保し、複数の統合システムからのデータを管理するのに役立ちます。取得元これは通常、データ抽出プロセス中にデータのソースをラベル付けするために追加される静的値です。例 Oracle CX Sales
	最終データ更新 LastDataUpdate	データが最後に更新されたか、ソースシステムから抽出された時点のタイムスタンプ。
説明この属性は、分析対象データの鮮度を示します。Oracle CX Salesからの最終データ抽出の日付と時刻を表示します。ダッシュボードやレポートにおいて、このタイムスタンプは、ユーザーが閲覧しているデータの適時性について知らせる上で重要です。最新の活動が分析に含まれているかどうかに関する期待値を管理するのに役立ちます。その重要性データの適時性をユーザーに通知します。これはダッシュボードを解釈し、情報に基づいた意思決定を行う上で非常に重要です。取得元この`タイムスタンプ`は、`データ`の抽出、変換、ロード（ETL）プロセス中に生成・追加されます。例 2024-06-10T02:00:00Z
	商談オーナー OpportunityOwner	営業商談の主要な担当者である営業担当者です。
説明商談オーナーは、案件を管理しクローズするために割り当てられた個々のユーザーです。この属性により、個人またはチームレベルでのパフォーマンス分析が可能になります。プロセスマイニングでは、商談オーナーでフィルタリングすることで、異なる働き方、パフォーマンスベンチマーク、標準営業プロセスへの準拠状況を明らかにできます。これにより、営業マネージャーはコーチングの機会を特定し、トップパフォーマーが営業サイクルをどのように進めているかを理解するのに役立ちます。その重要性営業担当者またはチームごとのパフォーマンス分析を可能にし、ベストプラクティスとコーチングが必要な領域を特定するのに役立ちます。取得元 Oracle CX SalesのOpportunity（商談）オブジェクトの標準フィールドである「Owner」または「AssignedTo」として利用可能です。例 John Smithジェーン・ドウPeter Jones
	商談価値 OpportunityValue	営業商談の見積もりまたは実際の金銭的価値です。
説明この属性は、営業商談に関連付けられた潜在的または最終的な収益を表します。これは、ライフサイクル全体を通じて商談をセグメント化し、優先順位付けするために使用できます。プロセスマイニングでは、商談価値を分析することで、異なるプロセスバリアントが高価値案件と低価値案件にどのように影響するかを理解するのに役立ちます。プロセスパスと財務結果を相関させることで、「商談失注・脱落理由」分析など、収益漏洩を追跡するダッシュボードにとって不可欠です。その重要性プロセスの非効率性が財務に与える影響を定量化し、機会と改善の取り組みの優先順位付けに役立ちます。取得元 Oracle CX SalesのOpportunityオブジェクトにある「Revenue」または「Amount」のようなフィールドで利用可能です。例 50000.00125000.0025000.00
	営業ステージ SalesStage	営業パイプラインにおける営業商談の現在のステージです。
説明営業ステージは、「適格性評価」、「ソリューション提案」、「交渉」などの値で、定義された営業プロセスにおける商談の進捗を示します。これは、特定の時点での商談の状態を理解するための主要な属性です。この属性は、営業ファネルの可視化と「停滞商談ステージ分析」ダッシュボードを構築するための基本となります。各ステージでの滞留時間を分析することで、チームは案件が停滞している場所を特定し、パイプラインの滞留を解消するための努力を集中させることができます。その重要性営業ファネル分析において、商談が頻繁に停滞したり失われたりするボトルネックを特定するために不可欠です。取得元これはOracle CX Salesの商談オブジェクトにある標準フィールドで、しばしば「SalesStage」または「StageName」と命名されます。例 01 - Qualification03 - Proposal05 - Negotiation受注済み
	地域 Region	商談に関連付けられた地理的地域または営業テリトリーです。
説明地域属性は、「北米」、「EMEA」、「APAC」などの地理的位置に基づいて商談を分類します。これは事業実績をセグメント化するための一般的な次元です。この属性は「地域別営業パフォーマンスベンチマーク」ダッシュボードに不可欠です。営業サイクル時間、コンバージョン率、プロセスバリアントなどの主要指標を異なる地域間で比較し、高いパフォーマンスを発揮する領域と、的を絞った改善が必要な領域を特定することを可能にします。その重要性異なる地域間でのプロセスパフォーマンスの比較を可能にし、地域ごとの差異やベストプラクティスを明らかにします。取得元 Oracle CX Salesのアカウントまたは商談オブジェクトに、標準フィールドまたはカスタムフィールドとして利用できることが多いです。例北米EMEAAPACLATAM
	損失理由 LossReason	商談が失注した理由として挙げられたものです。
説明商談が成約せずにクローズされた場合、失注理由として「競合に負けた」、「価格」、「決定なし」などの主要な原因が記録されます。この情報は、戦略分析とプロセス改善にとって不可欠です。この属性は「商談失注・脱落理由」ダッシュボードの基礎となります。失注理由と失注が発生したステージを組み合わせて分析することで、企業は競争上の弱点を理解し、営業戦略、製品提供、または価格モデルを改善するのに役立ちます。その重要性案件がなぜ成立しないのかについて重要な洞察を提供し、営業プロセスと製品提供における戦略的な改善を可能にします。取得元これは、Oracle CX Salesで商談ステータスが「失注済み」に設定されたときに取得される標準フィールドです。例価格競合に失注製品適合性決定なし
	ユーザー名 UserName	特定の活動またはイベントを実行したユーザーです。
説明この属性は、「見積作成」や「注文提出」などのタスクを実行した特定の人物を識別します。商談オーナーは案件全体に責任を負いますが、ユーザー名は個々のアクションを実行した人物を追跡します。この詳細レベルは、リソース配分、ワークロードの分散、および役割と責任の順守を理解するのに役立ちます。特定のユーザーがプロセスのボトルネックになっているか、または特定のタスクが常に権限のない担当者によって処理されているかを特定するのに役立ちます。その重要性各特定のアクションを誰が実行したかを追跡し、詳細なワークロード分析と活動の監査を可能にします。取得元通常、Oracle CX Salesの活動に関連するオブジェクトの「CreatedBy」または「LastUpdatedBy」フィールドに見られます。例アリス・ウィリアムズボブ・ブラウンチャーリー・デイビス
	停滞中 IsStalled	商談が同じ営業ステージに長期間留まっているかどうかを示すフラグ。
説明この属性は、商談における2つの連続する活動間の時間が事前定義されたビジネス閾値（例：30日）を超えた場合にtrueに設定されるブールフラグです。これは「停滞商談率」KPIの計算に使用され、「停滞商談ステージ分析」ダッシュボードに不可欠です。停滞した案件を特定することで、営業マネージャーはプロアクティブに介入し、サポートを提供し、営業パイプライン全体の推進力を向上させることができます。その重要性無策のために失われるリスクのある取引を事前に特定し、タイムリーな介入を可能にするのに役立ちます。取得元ケースの連続するイベント間の時間を測定し、定義されたしきい値と比較して計算されます。例 truefalse
	割引率 DiscountPercentage	営業見積もりまたは商談に適用された割引率です。
説明この属性は、特定の案件に適用された割引率を記録します。これは、最終価格と販売の収益性に直接影響を与えます。割引レベルの分析は、「平均割引利用率」KPIにとって重要です。割引が利益率に与える影響を企業が理解するのに役立ち、割引が一貫性のない方法で、または適切な承認なしに適用されているかどうかを明らかにし、見積承認ワークフローにおける潜在的な問題を浮き彫りにすることができます。その重要性収益性と割引戦略の有効性を分析し、潜在的な無秩序な割引を特定するのに役立ちます。取得元見積もりまたは商談製品ラインアイテムオブジェクトの割引フィールドについては、Oracle CX Salesのドキュメントを参照してください。例 0.050.100.150.20
	営業サイクル時間 SalesCycleTime	営業商談が作成されてからクローズされるまでの全期間です。
説明この指標は、各ケースについて、最初のイベント（例：「リードから商談へ転換」）から最後のイベント（例：「商談成立」または「商談失注」）までの経過総時間を計算します。これは「エンド・ツー・エンド営業サイクルパフォーマンス」ダッシュボードで使用される主要業績評価指標（KPI）です。その平均と分布を分析することで、営業プロセス全体における体系的な遅延を特定し、プロセス改善の取り組みのための高レベルのベンチマークを提供します。その重要性営業プロセス全体の効率性とスピードを測定するための重要なKPIを提供します。取得元各Sales Opportunityの最終イベントのタイムスタンプから最初のイベントのタイムスタンプを差し引くことで計算されます。例 30 days 10:05:0095 days 02:00:0045 days 12:30:00
	履行前の請求書発行 InvoiceBeforeFulfillment	注文が履行される前に請求書が生成されたかどうかを示すフラグ。
説明このブール属性は、特定のケースで「請求書生成済み」イベントが「注文履行済み」イベントより前に発生した場合にtrueに設定されます。これは、コンプライアンス違反またはリスクのあるプロセスパスを表します。この属性は「履行前請求率」KPIを直接サポートし、プロセスコンプライアンスダッシュボードで使用されます。この逸脱を追跡することは、組織が適切な請求手順を遵守し、顧客紛争を減らし、収益認識リスクを軽減するのに役立ちます。その重要性顧客が注文履行前に請求されるという、重要なプロセスコンプライアンス違反にフラグを立てます。これは顧客の不満や財務リスクにつながる可能性があります。取得元同一ケース内の「請求書生成済み」および「注文処理済み」アクティビティのタイムスタンプを比較して計算されます。例 truefalse
	注文ID OrderId	成立した商談から作成された販売注文の一意の識別子です。
説明注文IDは、顧客が見積もりを承認し、商談が成立した後に履行のために送付される正式な販売注文の参照です。これは営業から運用への重要な移行を示します。この識別子は、「注文履行のために提出済み」活動以降のプロセスを追跡するために重要です。リード・トゥ・キャッシュサイクルの営業と履行の部分を橋渡しするのに役立ち、注文処理と履行時間のエンド・ツー・エンド分析を可能にします。その重要性販売機会と履行プロセスを連携させ、リードから最終的な納品までの真のエンド・ツー・エンド分析を可能にします。取得元 Sales Orderオブジェクトのプライマリ識別子については、Oracle CX Salesのドキュメントまたは統合されたERPシステムを参照してください。例 SO-554433SO-554434SO-554435
	製品名 ProductName	商談で販売されている主要な製品またはサービスです。
説明この属性は、営業商談に関連付けられた製品または製品ファミリーを指定します。複数の製品がある商談の場合、これは主要な関心製品を表すか、各製品明細ごとに繰り返されることがあります。製品別にプロセスフローを分析することで、特定の製品がより長く、あるいはより複雑な営業サイクルを持つかどうかを明らかにできます。この洞察は、製品固有の営業戦略、トレーニング、およびプロセス最適化の取り組みに役立ちます。その重要性さまざまな製品やサービスで営業プロセスがどのように異なるかを分析でき、製品固有のボトルネックを強調表示します。取得元 Oracle CX SalesのOpportunity Product Line Itemを介してリンクされたProductオブジェクトにあります。例エンタープライズCRMライセンスクラウドストレージ Tier 1プロフェッショナルサービスパッケージ
	見積ID QuoteId	商談に関連付けられた営業見積もりの一意の識別子です。
説明見積IDは、商談に対して生成された特定の営業見積書文書の参照番号です。手戻りが発生した場合など、商談のライフサイクル中に複数の見積もりが存在する可能性があります。この識別子の追跡は、「見積もりから注文までのサイクルタイム」と「見積手戻り率」の分析にとって重要です。これにより、見積もり発行から承認までの時間を正確に測定し、初期見積と改訂版を区別するのに役立ちます。その重要性営業見積もりを一意に識別し、手戻りや変換時間を含む見積もりサイクルの正確な分析を可能にします。取得元これはOracle CX Salesの見積オブジェクトの主要な識別子であり、商談に関連しています。例 QUO-98765QUO-98766QUO-98767
	見積もり手戻り有無 IsQuoteRework	同じ商談に対して見積もりが手戻りされた、または複数回作成されたかどうかを示すフラグ。
説明このブール属性は、「見積手戻り」や2回目の「見積作成」イベントが単一の営業商談で発生した場合にtrueに設定されます。これは、見積もりステージにおけるプロセス非効率の事例を特定するのに役立ちます。このフラグは「見積手戻り率」KPIの計算や、「プロセス逸脱と手戻り分析」ダッシュボードに利用されます。手戻りを強調表示することで、追加の労力と遅延につながる初期要件収集、価格設定、または製品構成に関する問題を特定するのに役立ちます。その重要性見積もりプロセスにおける非効率性や逸脱のケースに直接フラグを立て、遅延や繰り返し作業の根本原因特定に役立ちます。取得元イベントログを分析して計算されます。特定のSales Opportunityに対して「見積もり作成済み」または「見積もり手戻り済み」アクティビティが複数回出現する場合に真となります。例 truefalse
	請求書ID InvoiceId	販売注文に対して生成された請求書の一意の識別子です。
説明請求書IDは、注文履行後に顧客に送付される請求書文書の参照番号です。プロセスにおける最終的な財務段階の主要な文書となります。この識別子は、「請求書生成サイクルタイム」および「支払い回収サイクル」の分析に不可欠です。各請求書が作成から最終支払いまで追跡できるため、キャッシュフローと売掛金パフォーマンスを監視する上で重要です。その重要性最終的な金融取引を追跡します。これは、請求サイクル時間と支払い回収効率を分析するために不可欠です。取得元 Invoiceオブジェクトの識別子については、Oracle CX Salesのドキュメントまたは統合されたERP/財務システムを参照してください。例 INV-2023-001INV-2023-002INV-2023-003
	顧客名 CustomerName	営業商談に関連付けられた顧客またはアカウントの名前です。
説明この属性は、案件の見込み客または既存顧客を識別します。これは、営業プロセスをセグメント化し、分析するための基本的な次元です。顧客でフィルタリングすることで、特定のアカウントの営業ジャーニーを詳細に分析でき、これは主要アカウント管理に役立ちます。また、顧客規模、業界、またはその他の特性によってプロセスパフォーマンスをセグメント化し、営業アプローチを調整することも可能にします。その重要性顧客ごとにプロセス分析をセグメント化することができ、顧客固有の行動を理解し、主要なアカウントを管理する上で重要です。取得元 Oracle CX Salesの商談オブジェクトにリンクされているアカウント名です。例 `Global Tech Inc.`Innovate Solutions LLCPioneer Corp

必須推奨任意

リード・トゥ・キャッシュのアクティビティ

これらは、正確なプロセス発見とボトルネック特定のために、イベントログに含めるべき重要なプロセスステップとマイルストーンです。

6 推奨 8 任意

	アクティビティ	説明
	リードから商談に転換済み	適格な営業リードから営業商談が作成されたことを示すイベントです。このイベントは、商談中心のプロセス分析の出発点となり、ユーザーがシステム内でリードを変換する際に明示的にトリガーされます。
その重要性これはプロセスの主要な開始イベントです。変換されたリードの量と発生元を分析することは、リード生成および選別活動の有効性を理解するために不可欠です。取得元このイベントは、営業商談レコード（商談オブジェクト）の作成から取得されます。このとき、「リードID」または類似のソースフィールドが入力され、変換されたリードが起源であることを示します。取得非NULLの元リード参照を持つOpportunityオブジェクトの作成タイムスタンプを捕捉します。イベントタイプ explicit
	入金確認済み	顧客からの支払いが受領・記録され、リード・トゥ・キャッシュサイクルが最終的に成功裏に完了したことを示すイベントです。このイベントは財務システムから発生します。
その重要性これはプロセスの最終的な成功終点であり、収益実現を示します。営業サイクル全体の時間とキャッシュフロー効率を測定するために重要です。取得元外部の売掛金管理または財務システムから取得されます。プロセス分析のループを閉じるためには、データが営業商談にリンクされる必要があります。取得イベントタイムスタンプは、財務システムの支払い適用レコードからのものです。イベントタイプ explicit
	商談失注	商談が成約せずに終了した、不成功の結果を表します。これは、商談のステータスが「失注済み」に更新されたときに推測されます。
その重要性これは致命的な失敗の終点です。いつ、なぜ、どのような価値の商談が失注したのかを分析することは、プロセスの弱点と市場の課題を特定するのに役立ちます。取得元 Opportunityオブジェクトの「StatusCode」が「LOST」値に更新されたことから推測されます。「ReasonWonLostCode」フィールドはしばしばコンテキストを提供します。取得 Opportunityステータスフィールドがシステム定義の「Lost」ステータスに更新されたときに検出します。イベントタイプ inferred
	商談成立	顧客が購入を確約し、案件が成功裏にクローズされたことを表します。これは、商談のステータスが最終的な「成約済み」に変わったときに推測されます。
その重要性これは営業ファネルにおける主要な成功マイルストーンです。下流の履行および請求プロセスのトリガーとなります。取得元 Opportunityオブジェクトの「StatusCode」が「WON」値に更新されたことから推測されます。「WinProb」（勝率）フィールドも通常100%に変化します。取得 Opportunityステータスフィールドがシステム定義の「Won」ステータスに更新されたときに検出します。イベントタイプ inferred
	見積作成済み	商談に関連付けられた正式な価格見積書が生成されたことを表します。これは、商談にリンクされた新しい見積レコードが作成されたことによって示される明示的なイベントです。
その重要性これは真剣な販売意図を示す主要なマイルストーンです。商談作成から見積作成までの時間を分析することは、営業速度を測定するのに役立ちます。取得元 Sales Opportunity ID (OptyId) にリンクされたQuoteレコード (Q_Quoteオブジェクト) の作成イベントから取得されます。取得商談に関連付けられた見積オブジェクトの作成タイムスタンプを使用します。イベントタイプ explicit
	顧客に見積承認済み	顧客が見積もり内の条件と価格に正式に合意したことを示します。これは重要なマイルストーンであり、多くの場合、Quoteオブジェクトのステータスが「Accepted」に変更されることで記録されます。
その重要性これは重要な購買シグナルであり、販売注文を作成するための前提条件です。交渉フェーズの成功裏の完了を示し、見積もりから注文までのサイクルにおけるマイルストーンです。取得元 Quoteオブジェクトのステータスが「Accepted」または「Customer Approved」ステータスに変更されたことから推測されます。取得 Quoteオブジェクトのステータスフィールドが指定された「Accepted」の値に変更されたことを検出します。イベントタイプ inferred
	ニーズ分析完了	営業チームが顧客の要件を収集し、文書化したことを示します。これは通常、商談の営業ステージが発見または分析フェーズを過ぎて進んだときに推測されます。
その重要性この活動は、ソリューションが提案される前の重要なマイルストーンです。ここでの遅延は、顧客エンゲージメントの問題や、技術的な深掘りのためのリソースの可用性の問題を示唆している可能性があります。取得元 Opportunityオブジェクトの「Sales Stage」フィールドが変更されたこと、例えば「2 - Discovery」から「3 - Solution Building」へ移行したことから推測されます。取得商談の営業ステージフィールドが、調査が完了したことを示すステータスに変更されたことを検出します。イベントタイプ inferred
	商談の適格化	商談の初期適格性評価ステージが完了したことを表します。これは通常、商談の営業ステージが、初期審査が完了し、有望な商談であると反映するように更新されたときに推測されます。
その重要性このマイルストーンを追跡することは、初期営業プロセスの効率性を測定し、商談が適格性評価にどのくらいの時間を費やすかを特定するのに役立ちます。これは、リードから商談への転換率KPIにとって重要です。取得元 Opportunityオブジェクトの「Sales Stage」フィールド (StgId) が適格性を示す値、例えば「1 - Qualification」から「2 - Discovery」への変更から推測されます。取得商談の営業ステージフィールドが指定された「Qualified」ステータスに変更されたことを検出します。イベントタイプ inferred
	注文完了	製品が出荷されたか、サービスが顧客に提供されたことを示します。このイベントデータはOracle CX Salesにネイティブなものではなく、統合された受注管理システムまたはERPシステムから取得する必要があります。
その重要性顧客への納期を完了し、請求書発行のトリガーとなるイベントです。これは、履行サイクルタイムを測定する上で不可欠です。取得元外部ERPまたは履行システムとの連携が必要です。データは元の営業商談IDに紐付けられる必要があります。取得イベントタイムスタンプは、統合を介してフルフィルメントシステムから取得されます。イベントタイプ explicit
	注文履行のために提出済み	営業部門から受注処理チームへの引き渡しを示すイベントです。Oracle CX Salesでは、商談が成立した際に、統合されたERPシステムで販売注文を作成するプロセスがトリガーされることで、このイベントが推測される場合があります。
その重要性この活動は、営業と運用の間のギャップを埋めます。この引き渡しを分析することは、「注文履行時間」KPIを理解し、最適化するために重要です。取得元このイベントは、CX Sales自体では概念的な場合が多く、別のシステムでの注文作成のトリガーを表します。「商談成立」のタイムスタンプ、またはその後の統合確認ステータスと関連付けることができます。取得多くの場合、「商談成立」のタイムスタンプを代用として使用するか、統合された注文管理システムからのデータが必要です。イベントタイプ inferred
	見積手戻り	見積もりが改訂され、顧客に再発行されるケースを捕捉します。これは、同じ商談に対して複数の「見積もり作成済み」イベントが観察されたり、単一の見積もりレコードがバージョン管理されていることから推測されます。
その重要性頻繁な手戻りは、不正確な初期提案や長期にわたる交渉を示し、営業サイクルを延長する可能性があります。これは、「見積もり手戻り率」KPIと手戻り分析ダッシュボードを直接サポートします。取得元顧客に既に送付された見積もりの新しいバージョンが作成された、または既存の見積もりに大幅な更新があった（例：ステータスがドラフトにリセットされた）ことを検出することで推測されます。取得同じ商談に対する後続の「見積もり作成済み」イベントまたはバージョン増分を特定します。イベントタイプ inferred
	解決策提示済み	正式なソリューションまたは提案が顧客に提示されたことを示します。このアクティビティは、商談が「提案」または「プレゼンテーション」ステージに移行したときに推測されます。
その重要性これを追跡することは、ソリューションを開発し提案するのにかかる時間を分析するのに役立ちます。また、商談がここに留まることが多いため、「停滞商談率」KPIにとっても重要なステージです。取得元 Opportunityオブジェクトの「Sales Stage」フィールドが「4 - Proposal」や「Presentation」のような値に変更されたことから推測されます。取得商談の営業ステージフィールドが提案ステータスに変更されたことを検出します。イベントタイプ inferred
	請求書生成済み	履行された注文に対する顧客請求書の作成を表します。この活動はOracle CX Salesではなく、請求または財務システムで行われ、データは統合されている必要があります。
その重要性このイベントは、支払い回収サイクルを開始します。履行と請求の間の遅延は、キャッシュフローと「請求から支払いまでのサイクルタイム」KPIに悪影響を与える可能性があります。取得元外部ERPまたは売掛金管理システムから取得されます。プロセス分析のためには、イベントデータが営業商談IDと関連付けられている必要があります。取得イベントタイムスタンプは、財務システムの請求書作成ログから取得されます。イベントタイプ explicit
	顧客に見積送付済み	見積もりが正式に顧客に提示され、検討を依頼した時点を示すイベントです。このイベントは通常、見積オブジェクト自体のステータスが「提示済み」や「送信済み」に変わることで推測されます。
その重要性この活動は、顧客のレビューと交渉サイクルを開始します。「見積もりから注文作成までの時間」KPIを測定するための出発点です。取得元商談に関連付けられたQuoteオブジェクトのステータス変更から推測されます。ステータスフィールドは「StatusCode」または類似の名前である場合があります。取得 Quoteオブジェクトのステータスフィールドが「Sent」または「Presented」の値に変更されたことを検出します。イベントタイプ inferred

推奨任意

抽出ガイド

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

ステップ

前提条件と認証: Oracle CX Salesのユーザーアカウントに、営業管理者または同様のロールなど、商談および見積もりのREST APIにアクセスするために必要な権限があることを確認してください。APIリクエストを認証し、ベアラートークンを生成するために、Oracle Cloud管理者からOAuth 2.0クライアント資格情報 (クライアントIDおよびクライアントシークレット) を取得してください。
環境設定: ローカルマシンまたはサーバーにNode.js環境をセットアップします。HTTPリクエストの作成とCSVファイルの処理に必要なライブラリをインストールします。ターミナルを開き、以下のコマンドを実行します: npm install axios npm install json2csv
APIエンドポイントの特定: この抽出の主要なエンドポイントは、Opportunity（商談）オブジェクトとQuote（見積もり）オブジェクト用です。ベースURLは、https://[your-oracle-cx-cloud-host].fa.us2.oraclecloud.comのように、お使いのOracleインスタンスに固有のものです。主要なリソースは以下の通りです:

商談 (Opportunities): /salesApi/resources/latest/opportunities
見積もり (Quote) (商談の子として): /salesApi/resources/latest/opportunities/{OptyId}/child/Quote

抽出スクリプトの構成: 提供されているJavaScriptコードを、例えばextract.jsというファイルにコピーします。スクリプト上部のプレースホルダー変数に、特定のOracle CX CloudホストURL、クライアントID、クライアントシークレット、および抽出したい日付範囲を更新してください。
スクリプトの実行: ターミナルからnode extract.jsコマンドを使用してスクリプトを実行します。スクリプトはまず認証トークンを取得し、その後APIから商談をページごとに取得し始めます。
データ取得とページング: スクリプトはAPIのページネーションを自動的に処理します。1回のAPI呼び出しで一定数の商談を要求し、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パラメータは、単一のAPI呼び出しで返されるレコード数を制御します。スクリプトは、必要なAPI呼び出しの数を最適化するために、一般的な最大値である500の制限を使用します。
必要な権限: 使用されるユーザーまたはOAuthアプリケーションの資格情報は、すべての標準フィールドおよび関連するカスタムフィールドを含む「Opportunity」および「Quote」RESTリソースに対する読み取りアクセス権を持っている必要があります。

a クエリ例 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インスタンスにログインします。「Security Console」(ナビゲーター > ツール > セキュリティコンソール)に移動し、「Sales Representative」またはカスタム統合ロールを持つ新しいユーザーを作成します。このユーザーには、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、Name、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呼び出しを行い、データを処理し、単一のイベントログに結合します。
出力の確認: スクリプトはlead_to_cash_event_log.csvという名前のファイルを生成します。このファイルをスプレッドシートアプリケーションで開き、その構造と内容を確認してください。SalesOpportunity、ActivityName、EventTime、SourceSystemなどの期待される列があることを確認します。
APIページネーションの処理: 提供されているスクリプトには、基本的なページネーションループが含まれています。非常に大規模なデータセットの場合、APIレート制限に達するのを避けるために、より堅牢なエラー処理やリクエスト間の短い一時停止を追加する必要がある場合があります。
アップロードの準備: 最終的なCSVファイルは、ProcessMindへの直接アップロード用に構造化されています。列ヘッダーがProcessMindプロジェクトのマッピングと一致していることを確認してください。これ以上の書式設定は不要です。

設定

API資格情報: 販売リード、販売商談、および見積もりオブジェクトを読み取るための十分な権限を持つ専用のAPIユーザーが必要です。これには、ステータスおよびステージ変更の履歴データまたは監査証跡へのアクセスが含まれます。
Oracle CXドメイン: Oracle CX SalesインスタンスのベースURLは、スクリプトで正しく指定されている必要があります。
日付範囲: 抽出期間を定義するために、スクリプト内のSTART_DATEおよびEND_DATE変数を設定します。データ量とパフォーマンスのバランスを取るため、初期分析には3〜6か月の範囲を推奨します。
商談フィルター: スクリプトは、特定の基準に基づいて商談をフィルターするようにカスタマイズできます。例えば、Organization_IdでフィルターするためにAPI URLにクエリパラメータを追加したり、抽出を特定の事業部門または商談タイプに限定するためにカスタムフィールドを追加したりできます。
外部システムエンドポイント: 注文、請求書、および支払いデータを抽出するために、ERPおよび財務システムの実際のAPIエンドポイント、資格情報、およびロジックを提供する必要があります。スクリプトは、これらのシステムが販売商談IDまたは関連する注文IDを使用して相関付けられることを前提としています。
ページネーション制限: API呼び出しのlimitパラメータは100に設定されています。これは調整可能ですが、複雑なクエリの場合、値が高いとタイムアウトのリスクが増加する可能性があります。

a クエリ例 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.")

お客様のリード・トゥ・キャッシュデータテンプレート

お客様のリード・トゥ・キャッシュデータテンプレート

リード・トゥ・キャッシュの属性

リード・トゥ・キャッシュのアクティビティ

抽出ガイド

Oracle CX Sales REST API直接クエリ抽出

ステップ

設定

a クエリ例 javascript

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

ステップ

設定

a クエリ例 python

今すぐ始めますか？

今すぐリード・トゥ・キャッシュ勝率を20%向上させましょう

お客様のリード・トゥ・キャッシュデータテンプレート

お客様のリード・トゥ・キャッシュデータテンプレート

リード・トゥ・キャッシュの属性

リード・トゥ・キャッシュのアクティビティ

抽出ガイド

Oracle CX Sales REST API直接クエリ抽出

ステップ

設定

a クエリ例 javascript

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

ステップ

設定

a クエリ例 python

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

今すぐ始めますか？

今すぐリード・トゥ・キャッシュ勝率を20%向上させましょう