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

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

Salesforce Sales Cloud

リードから入金までの属性 (18) リードから入金までのアクティビティ (16) 抽出ガイド (3)

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

このテンプレートは、リードから入金までのプロセスを分析するために必要なデータを収集する際の道筋を示します。収集すべき主要な属性、追跡すべき重要なアクティビティ、システムからデータを抽出するための具体的な手順をまとめています。このテンプレートを使えば、プロセスマイニングで得られる分析結果に向けて、データを効率よく準備できます。

収集を推奨する属性
追跡すべき主要なアクティビティ
Salesforce Sales Cloudからの抽出手順

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

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

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

これらのデータ項目は、詳細な分析が可能な完全なイベントログを作成するために欠かせません。

3 必須 5 推奨 10 任意

	名前	説明
	アクティビティ ActivityName	営業プロセスの特定の時点で発生した業務イベントまたはアクティビティの名称です。
説明アクティビティ名は、「Opportunity Created」、「Quote Sent」、「Contract Signed」など、リードから入金までの過程における具体的なステップまたは節目を示します。Salesforce内の主要フィールドの変更や関連レコードの作成から導出します。これらのアクティビティの順序を分析することで、プロセスフローを可視化し、一般的な経路を特定し、標準的な営業プロセスからの逸脱を検出できます。プロセスマップの作成や、各ステップ間のサイクル時間などのKPIの計算に欠かせません。重要な理由プロセスマップ上のステップを定義し、リードから入金までの営業プロセスを可視化・分析できるようにします。入手先通常は、Opportunity Historyオブジェクト（Stageなどのフィールド変更）、関連オブジェクトの作成日時（Quote、Contractなど）、特定のTaskまたはEventレコードなど、複数のデータソースを組み合わせて導出します。例商談を作成顧客に見積もりを提示商談を受注としてクローズ請求書を発行
	営業商談 SalesOpportunity	リードから入金までのプロセスにおいて、各営業商談を識別する一意の識別子であり、主要なケース識別子として使用します。
説明営業商談は、適格性確認から成約まで、潜在的な案件を追跡する中心的なオブジェクトです。各商談には一意のIDがあり、関連するすべてのアクティビティ、コミュニケーション、見積もり、契約を結び付けます。プロセスマイニングでは、このIDが各案件のエンドツーエンドの進行を再構築するために欠かせません。営業商談をケースIDとして使用することで、ライフサイクル全体を分析し、ステージ間の所要時間を測定し、プロセスのばらつきを特定し、案件の受注または失注につながる要因を把握できます。重要な理由すべてのプロセスステップを結び付ける基本的な識別子であり、案件ごとの営業サイクルを完全かつ正確に分析できます。入手先 Salesforce Sales CloudのOpportunityオブジェクトにある標準の「Id」フィールドです（例：Opportunity.Id）。例 0068c00001KvM7RAAV0068c00001LpA9BAAV0068c00001NqB3CAAV
	開始時刻 EventTimestamp	アクティビティが発生した正確な日付と時刻です。
説明イベントタイムスタンプは、アクティビティが発生した正確な時点を記録します。このタイムスタンプは、イベントを時系列に並べ、時間に基づくプロセス分析を行うために欠かせません。この属性は、サイクル時間、所要時間、待ち時間など、すべてのパフォーマンス指標を計算する基盤です。たとえば、「Invoice Generated」と「Payment Received」のタイムスタンプの差から、「支払いまでの平均日数」KPIを算出できます。正確なタイムスタンプは、ボトルネックの特定とプロセス効率の測定に不可欠です。重要な理由イベントの時系列を示し、所要時間とパフォーマンスに関するすべての計算に必要です。入手先 Salesforceのさまざまな日付フィールドから抽出します。たとえば、Opportunityオブジェクトの「CreatedDate」、Opportunity Historyの「LastModifiedDate」、QuoteやContractなどの関連オブジェクト固有の日付フィールドです。例 2023-04-15T10:30:00Z2023-05-20T14:00:00Z2023-06-01T09:15:00Z
	割引率 DiscountPercentage	商談に適用された割引率です。
説明この属性には、案件に提示した割引が通常は合計金額に対する割合として記録されます。案件の収益性や営業行動を把握するうえで重要な要素です。この指標は、「商談割引効果」ダッシュボードと「成約案件の平均割引率」KPIの基盤となります。この属性を分析することで、営業責任者は割引が成約につながっているのか、それとも利益率を低下させているだけなのかを判断できます。また、地域や営業担当者ごとの割引傾向も比較できます。重要な理由収益性の分析、価格戦略の効果の把握、過度な割引の特定に欠かせません。入手先通常は、OpportunityまたはQuoteオブジェクトに設定されたカスタム通貨フィールドまたはパーセントフィールドです。Salesforce Sales Cloudのドキュメントまたは管理者にご確認ください。例 0.050.100.15
	受注済みかどうか IsWon	商談の受注または失注を示すブール型フラグです。
説明営業商談の最終結果をtrueまたはfalseで示す属性です。商談のステージが「Closed Won」の場合はtrue、「Closed Lost」の場合はfalseに設定されます。「Is Won」は、営業の有効性を測る重要な指標の一つである「Opportunity Win Rate」KPIの算出基盤です。また、受注案件と失注案件のプロセス経路を比較したり、「Average Discount on Won Deals」を算出したりするなど、分析の分類にも使用します。重要な理由営業商談の結果を直接測定し、受注・失注分析と受注率の算出を可能にします。入手先 Opportunityオブジェクトの標準「IsWon」フィールドです。StageNameに基づく数式フィールドです。例 truefalse
	商談所有者 OpportunityOwner	営業商談を担当し、その遂行に責任を負う営業担当者です。
説明商談所有者は、Salesforceで案件の管理を主に担当するユーザーです。パフォーマンス分析における重要な切り口となります。商談所有者別にデータを分析することで、「Sales Representative Performance」ダッシュボードを作成できます。チームメンバーごとのサイクル時間、受注率、平均案件規模を比較し、成果の高い担当者やコーチングの機会を特定できます。重要な理由営業チームのパフォーマンス分析、個人の成果の比較、コーチングの必要性の特定に欠かせない属性です。入手先 Opportunityオブジェクトの「OwnerId」フィールドで、Userオブジェクトに関連付けられています。例 John SmithMaria GarciaDavid Chen
	商談金額 Amount	商談で見込まれる売上の合計金額です。
説明潜在的な案件の金銭的価値を示す属性です。財務分析とパフォーマンス分析における重要な指標の一つです。商談金額は、パイプライン総額、平均案件規模の算出や、割引率・サイクル時間など他の要因との相関分析など、ほぼすべての財務ビューで使用します。「Sales Representative Performance」や「Opportunity Discount Effectiveness」ダッシュボードの主要な構成要素です。重要な理由各案件の金銭的価値を示し、パイプラインレポート、収益予測、パフォーマンス分析に欠かせません。入手先 Opportunityオブジェクトの標準「Amount」フィールドです。例 50000125000.75250000
	営業ステージ StageName	営業パイプラインにおける商談の現在のステージです。「Qualification」や「Negotiation」などがあります。
説明営業ステージは、あらかじめ定義された営業プロセスに沿った商談の進捗を示します。このフィールドの変更は、「Proposal Stage Reached」など、プロセス上の重要なイベントです。この属性は、「Sales Pipeline Bottleneck Identification」や「Daily Sales Funnel Operational View」ダッシュボードの構築に欠かせません。各ステージに商談が滞在する時間、ステージ間のコンバージョン率、営業パイプライン全体の健全性を分析できます。重要な理由商談が営業ファネルを進む状況を追跡し、ボトルネック分析とパイプライン管理に役立ちます。入手先 Opportunityオブジェクトの標準「StageName」フィールドです。例見込み顧客開拓見込み判定ニーズ分析提案／価格見積もり交渉・レビュー
	ソースシステム SourceSystem	データの抽出元となったソースシステムを識別します。
説明イベントデータの発生元である記録システムを示す属性です。リードから入金までのプロセスでは、通常「Salesforce Sales Cloud」が設定されます。複数の連携システムがある環境では、データの系譜の追跡、問題の調査、各プロセスステップでどのシステムを正とするかの把握に欠かせません。データ基盤の透明性と信頼性を確保できます。重要な理由データの出所に関する情報を提供します。データガバナンス、検証、複数システム環境での管理に欠かせません。入手先通常は、データ抽出・変換の際にデータパイプラインまたはETLツールがデータセットの出所を示すために付加する固定値です。例 Salesforce Sales CloudSFSC
	リードソース LeadSource	リードの発生元。例：Web、パートナー、展示会。
説明 Lead Sourceは、最初のリードを生み出したマーケティングチャネルまたは営業活動を記録します。この情報は、さまざまな顧客獲得戦略の効果を把握するうえで重要です。この属性は、「リードコンバージョンパフォーマンス分析」ダッシュボードの主要な分析軸です。リードソース別にコンバージョン率や案件金額を分析することで、マーケティング費用を最適化し、収益性の高いチャネルに注力できます。重要な理由リードを発生元とその後の成約率に関連付けることで、マーケティングチャネルの効果を判断できます。入手先 Leadオブジェクトの標準「LeadSource」フィールドです。通常、コンバージョン時にOpportunityオブジェクトへ引き継がれます。例 Web電話問い合わせパートナー紹介購入リスト
	最終データ更新日時 LastDataUpdate	ソースシステムからデータが最後に更新された時点を示すタイムスタンプです。
説明 Salesforce Sales Cloudからデータが最後に抽出された日付と時刻を示します。分析対象データの鮮度を把握するための情報を提供します。データが最後に更新された時点を把握することは、分析を正しく解釈するうえで欠かせません。特に「Daily Sales Funnel Operational View」のような業務用ダッシュボードでは、データの適時性を理解したうえで意思決定できるようになります。重要な理由データの適時性を示し、プロセス分析がどの時点まで最新であるかを把握できるようにします。入手先データ抽出時にデータパイプラインまたはETLツールが生成するメタデータ属性です。例 2023-10-27T02:00:00Z2023-10-28T02:00:00Z
	取引先名 AccountName	商談に関連付けられた顧客取引先または会社の名前です。
説明 Account Nameは、営業商談を特定の顧客に関連付けます。これにより、顧客単位で営業プロセスを分析できます。顧客別にプロセスを分析すると、戦略的な顧客の営業サイクルを把握し、手戻りが頻発する顧客や交渉期間が長い顧客を特定できます。また、顧客ごとに対応方針を調整できます。プロセスデータを絞り込み、詳細を確認するための有用な分析軸です。重要な理由営業プロセスを特定の顧客に関連付け、顧客単位で営業サイクルタイムや対応パターンを分析できます。入手先 Opportunityオブジェクトの「AccountId」参照フィールドから取得します。このフィールドは、Accountオブジェクトの「Name」フィールドを参照します。例 Global Tech Inc.Innovate Solutions LLCQuantum Industries
	商談タイプ Type	商談を「新規ビジネス」や「既存顧客」などに分類します。
説明 Opportunity Typeは、案件を分類するための標準フィールドです。新規顧客の獲得と既存顧客へのアップセルで、営業プロセスやサイクルがどのように異なるかを把握できます。プロセスマイニングでは、この属性を使って比較分析を行えます。たとえば、組織はプロセスマップを絞り込み、「新規ビジネス」の営業サイクルが「既存顧客」の更新より長いか、ステップ数が多いかを確認できます。こうした分析結果は、戦略的な意思決定やプロセス改善に役立ちます。重要な理由商談をタイプ別に分けることで、新規ビジネスと既存ビジネスの営業プロセス、サイクルタイム、成約率を比較できます。入手先 Opportunityオブジェクトの標準「Type」フィールドです。例新規ビジネス既存顧客：アップグレード既存顧客：更新追加ビジネス
	地域 Region	商談の地理的地域または営業テリトリーです。
説明 Region属性は、「北米」、「EMEA」、「APAC」など、地理的な区分に基づいて商談を分類します。営業組織では、チーム編成やレポート作成にこの方法がよく使われます。「地域別営業パフォーマンス比較」ダッシュボードの主要な分析軸です。経営層は地域間でプロセスのパフォーマンスを比較し、成果の高い地域のベストプラクティスや、改善が必要な地域を特定できます。サイクルタイム、成約率、割引の利用状況などを分析できます。重要な理由地理的に異なるテリトリー間で営業プロセスとパフォーマンスを比較し、地域ごとの強みと課題を特定できます。入手先多くの場合、OpportunityまたはAccountオブジェクトのカスタムフィールドです。Salesforce Sales Cloudのドキュメントまたは管理者にご確認ください。例北米EMEAAPACLATAM
	契約ID ContractId	商談に関連付けられた契約の一意の識別子です。
説明 Contract IDは、商談をSalesforceの正式な契約レコードに関連付けます。案件を成約する最終段階における重要な情報です。この属性により、契約締結フェーズを詳細に分析できます。「見積から契約までのサイクルタイム」や「契約コンプライアンスと遵守状況」ダッシュボードを支援し、「契約書を署名依頼に送付」や「契約を有効化」などのアクティビティを追跡できます。所要時間やSLAの遵守状況も測定できます。重要な理由契約管理サブプロセスのサイクルタイムやコンプライアンスを正確に追跡できます。入手先 Contractオブジェクトの「Id」フィールドから取得します。通常、OpportunityまたはAccountと関連付けられています。例 8008c000001LxD9AAK8008c000001MyE4AAK8008c000001NzF0AAK
	手戻りフラグ IsRework	アクティビティが手戻りまたは繰り返しのステップに該当するかを示す計算フラグです。
説明 Is Reworkは、プロセスが前のステージに戻ったときにtrueになるブール型フラグです。たとえば、「顧客に見積を提示」した後に「見積を変更」アクティビティが発生した場合、手戻りとみなします。この属性は、プロセスの非効率を定量化するうえで欠かせません。「注文処理エラー率」や「見積手戻り頻度」KPIの計算を直接支援します。手戻りを可視化することで、要件が不明確な箇所、コミュニケーション上の問題、品質上の課題を特定できます。重要な理由手戻りループに含まれるアクティビティを特定してフラグを付けることで、プロセスの非効率を定量化し、改善対象を絞り込めます。入手先プロセスマイニングツールがアクティビティの順序を分析し、プロセスフローの後戻りを検出して計算します。例 truefalse
	注文ID OrderId	成約した商談から作成された販売注文の一意の識別子です。
説明 Order IDは、営業商談を後続の履行プロセスに関連付けます。営業から業務部門へ引き継ぐ接点となる情報です。このIDにより、「商談の成約」以降の注文管理までプロセス分析を拡張できます。「注文作成」や「注文履行」アクティビティを追跡し、「注文履行エラー率」を監視するために必要です。重要な理由プロセスの営業部分と注文履行部分をつなぎ、リードから入金までをエンドツーエンドで分析できます。入手先 Orderオブジェクトの「Id」フィールドから取得します。通常、Opportunityと関連付けられています。例 8018c000001IyA6AAK8018c000001JyB1AAK8018c000001KzC6AAK
	見積ID QuoteId	商談に関連付けられた販売見積の一意の識別子です。
説明 Quote IDは、商談に対して顧客へ提示した特定の価格見積を識別します。商談のライフサイクル中に複数の見積が作成される場合があります。 Quote IDを追跡することは、営業プロセスの見積作成部分を分析するうえで欠かせません。「見積から契約までのサイクルタイム」の測定や、見積の修正回数（「見積を変更」）の把握に役立ちます。また、見積のバージョンを区別することで、「見積手戻り頻度」KPIにも利用できます。重要な理由見積作成から承諾までの時間や修正回数など、見積サイクルを分析できます。入手先 Quoteオブジェクトの「Id」フィールドから取得します。Opportunityと関連付けられています。例 0Q08c000001OxP1AAK0Q08c000001PyQ2AAK0Q08c000001QzR3AAK

必須推奨任意

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

正確なプロセスディスカバリーとパフォーマンス分析のため、追跡すべき主要なプロセス手順とマイルストーンです。

8 推奨 8 任意

	アクティビティ	説明
	リードを商談に転換	このアクティビティは、適格性が確認されたリードを、関連する取引先と取引先責任者を伴う営業商談へ転換する時点を示します。通常、Salesforceで営業担当者が明示的に実行する操作です。
重要な理由マーケティングまたはリード開発から営業チームへ引き継ぐ重要な時点です。この時点からの所要時間とコンバージョン率を分析することで、リードの品質と初期営業プロセスの効率を評価できます。入手先このイベントは、LeadオブジェクトのIsConvertedフィールドがtrueで、ConvertedOpportunityIdフィールドに値が設定されていることから特定できます。タイムスタンプにはConvertedDateを使用します。取得ユーザーがLeadレコードを転換し、ConvertedDateフィールドとConvertedOpportunityIdフィールドに値が設定された時点を記録します。イベントタイプ explicit
	入金を確認	顧客からの支払いを受領し、請求書に充当したことを確認するアクティビティです。通常、請求書のステータスが「Paid」に変更されたこと、またはPaymentレコードが作成されたことから推定します。
重要な理由リードから入金までのプロセスにおける最後のアクティビティで、収益の実現を示します。請求から入金までの期間は、キャッシュフローに関する重要なKPIです。入手先 Invoiceオブジェクトのステータスが「Paid」に変更されたこと、または請求書に関連するPaymentオブジェクトが作成されたことから推定します。このデータは外部の財務システムから取得することがよくあります。取得 Invoiceの「Status」が「Paid」になった時点、または関連するPaymentレコードが作成された時点を特定します。イベントタイプ inferred
	商談を作成	Salesforceで新しい営業商談レコードが作成されたことを示し、収益につながる可能性のある商談が開始されたことを意味します。このイベントは、レコードが初めて保存された時点の作成日時とともに明示的に記録されます。
重要な理由このアクティビティは、対象となる商談の営業サイクルが正式に始まる時点です。営業サイクル全体の時間とパイプラインの進行速度を測定する起点になります。入手先 OpportunityオブジェクトのCreatedDateシステムフィールドから取得します。商談レコードが開始された正確な時点を示します。取得 OpportunityオブジェクトのCreatedDateフィールドを使用します。イベントタイプ explicit
	商談を受注としてクローズ	営業商談が成功裏に成約し、受注となったことを示します。OpportunityのStageNameフィールドを手動または自動で「Closed Won」に更新した時点を記録します。
重要な理由営業プロセスにおける主要な成功結果です。受注した商談の傾向と属性を分析することは、営業パフォーマンスと戦略を理解するうえで基本となります。入手先 OpportunityオブジェクトのStageNameフィールドが「Closed Won」に変更されたことから推定します。イベントの日付はCloseDateフィールドに、タイムスタンプはフィールド履歴に記録されます。取得 OpportunityFieldHistoryから、Opportunityの「StageName」が「Closed Won」になった時点のタイムスタンプを特定します。イベントタイプ inferred
	商談を失注としてクローズ	営業商談が成立せず、競合に敗れたか、顧客が購入しないことを決定したことを示します。OpportunityのStageNameが「Closed Lost」に更新された時点を記録します。
重要な理由営業プロセスにおける主要な失敗結果です。商談をいつ、なぜ失注したかを分析することは、営業戦略、トレーニング、製品の訴求方法を改善するうえで重要です。入手先 OpportunityオブジェクトのStageNameフィールドが「Closed Lost」に変更されたことから推定します。日付はCloseDateフィールドに、タイムスタンプはフィールド履歴に記録されます。取得 OpportunityFieldHistoryから、Opportunityの「StageName」が「Closed Lost」になった時点のタイムスタンプを特定します。イベントタイプ inferred
	契約を有効化	契約が全当事者によって正式に締結され、法的に有効になったことを示します。通常、Contractオブジェクトのステータスが「Activated」に変更されたこととして記録します。
重要な理由顧客との法的合意が成立したことを最終確認する重要な節目です。収益認識とコンプライアンスに直結し、ここでの遅延は財務予測に直接影響する可能性があります。入手先 ContractオブジェクトのStatusフィールドが「Activated」に変更されたことから推定します。この変更のタイムスタンプは、フィールド履歴追跡によって取得します。取得 Contractオブジェクトの「Status」が「Activated」に設定された時点のタイムスタンプを特定します。イベントタイプ inferred
	見積もりを作成	顧客向けの正式な価格見積書が作成されたことを示します。新しいQuoteレコードが作成され、Opportunityに関連付けられた時点を記録します。
重要な理由見積もりの作成は、商談成約に向けた重要なステップです。見積もりの件数と作成にかかった時間を分析することで、営業チームの効率と商談の進捗を評価できます。入手先 QuoteオブジェクトのCreatedDateシステムフィールドから取得します。Quoteオブジェクトには、親となるOpportunityへの参照関係があります。取得 Opportunityに関連付けられたQuoteオブジェクトのCreatedDateを使用します。イベントタイプ explicit
	顧客が見積もりを受諾	顧客が見積もりの条件と価格に同意したことを示します。通常、ユーザーがQuoteのステータスを「Accepted」に更新した時点を記録します。
重要な理由購買意向を示す重要なシグナルであり、契約作成前の大きな節目です。提示から受諾までの時間は、営業サイクルの摩擦を示す重要な指標です。入手先 QuoteオブジェクトのStatusフィールドが「Accepted」に変更されたことから推定します。タイムスタンプは、このフィールド変更の履歴から取得します。取得 Quoteの「Status」フィールドが「Accepted」に変更された時点のタイムスタンプを特定します。イベントタイプ inferred
	商談ステージを変更	このアクティビティは、「Qualification」から「Needs Analysis」への移行など、商談の営業ステージが変更されたことを記録します。変更内容はシステムのフィールド履歴に記録され、商談の進捗を追跡できます。
重要な理由ステージの変更を追跡することは、営業パイプラインの進行速度を把握し、商談が停滞するボトルネックを特定し、プロセスのコンプライアンスを分析するうえで欠かせません。入手先 OpportunityオブジェクトのStageNameフィールドの変更を追跡するOpportunityFieldHistoryオブジェクトから推定します。各エントリにはタイムスタンプと変更前後の値が含まれます。取得 OpportunityFieldHistoryテーブルから「StageName」フィールドの変更イベントを抽出します。イベントタイプ inferred
	提案ステージに到達	商談が「Proposal/Price Quote」ステージに移行した具体的な時点を示します。Opportunityの「StageName」フィールドの履歴から推定します。
重要な理由潜在的な解決策が特定され、価格を設定して提示できる状態になったことを示す重要な節目です。解決策の検討と見積もりにかかった時間を分析するうえで重要な時点です。入手先 OpportunityFieldHistoryオブジェクトから、「StageName」フィールドが「Proposal/Price Quote」または同様のカスタムステージ値に更新された時点のタイムスタンプを特定して推定します。取得「Field」が「StageName」で、「NewValue」が提案ステージであるレコードをOpportunityFieldHistoryから抽出します。イベントタイプ inferred
	注文を作成	受注後、履行プロセスを正式に開始する販売注文が作成されたことを示します。新しいOrderレコードが作成され、OpportunityまたはAccountに関連付けられた時点を記録します。
重要な理由営業プロセスから注文履行・業務運用チームへ正式に引き継ぐ時点です。このステップの効率は、納期遵守と顧客満足度に直結します。入手先 OrderオブジェクトのCreatedDateシステムフィールドから取得します。通常、OrderはAccountまたは元のOpportunityに関連付けられています。取得 OpportunityのAccountに関連するOrderオブジェクトのCreatedDateを使用します。イベントタイプ explicit
	注文を履行	注文された製品またはサービスが顧客に提供されたことを示します。通常、Orderオブジェクトのステータスが「Fulfilled」や「Completed」などの完了状態に変更されたことから推定します。
重要な理由顧客への提供約束が完了したことを示す節目です。注文作成から履行までの時間は、業務効率と顧客満足度を測る重要な指標です。入手先 OrderオブジェクトのStatusフィールドが完了を示す値に変更されたことから推定します。イベントのタイムスタンプを取得するには、フィールド履歴追跡が必要です。取得 Orderの「Status」が「Fulfilled」または「Completed」に変更された時点のタイムスタンプを特定します。イベントタイプ inferred
	署名用に契約を送付	正式な契約書が作成され、顧客に署名を依頼して送付されたことを示します。通常、Contractオブジェクトのステータスが「Sent」または「Out for Signature」などに変更されたことから推定します。
重要な理由商談を締結するための最終的な法務・事務処理の段階が始まる時点です。これを追跡することで、契約管理プロセスの効率を確認できます。入手先 Opportunityに関連付けられたContractオブジェクトのステータス変更から推定します。ContractのStatusフィールドの履歴追跡が必要です。取得 Contractの「Status」フィールドが「Sent for Signature」などの値に変更された時点のタイムスタンプを特定します。イベントタイプ inferred
	見積もりを変更	顧客からのフィードバックや交渉を受けて、既存の見積もりが更新または改訂されたことを示します。初回作成後にQuoteレコードの主要フィールドが変更されたことを追跡して記録します。
重要な理由見積もりの変更が頻繁に発生する場合、非効率、コミュニケーション不足、または交渉サイクルの長期化を示している可能性があります。この手戻りのループを分析することは、見積もりから契約までの段階を短縮するうえで重要です。入手先 QuoteオブジェクトのLastModifiedDateフィールドから推定します。より詳細に分析する場合は、TotalPriceや明細項目などのフィールド履歴を使用します。取得 QuoteオブジェクトのLastModifiedDateとCreatedDateを比較するか、Quoteのフィールド履歴を使用します。イベントタイプ inferred
	請求書を発行	提供した商品またはサービスの代金を顧客に請求する請求書が作成されたことを示します。Salesforce Billingまたは連携する外部システムでInvoiceレコードが作成されたことから取得できます。
重要な理由リードから入金までのプロセスにおける財務処理が始まる時点です。請求の速さと正確さは、キャッシュフローに直接影響します。入手先 Salesforce Billingまたは同様のパッケージが必要です。OrderまたはAccountに関連するInvoiceオブジェクトのCreatedDateフィールドから取得します。取得利用できる場合は、InvoiceオブジェクトのCreatedDateを使用します。イベントタイプ explicit
	顧客に見積もりを提示	見積もりが顧客に送付され、確認のため正式に提示されたことを示します。通常、Quoteレコードのステータスが「Draft」から「Presented」または「In Review」などに変更されたことから推定します。
重要な理由顧客との交渉と承認のサイクルが始まる時点です。これを追跡することで、顧客の応答時間を測定し、見積もり受諾段階の遅延を特定できます。入手先 QuoteオブジェクトのStatusフィールドの変更から推定します。変更の正確なタイムスタンプを取得するには、このフィールドの履歴を追跡する必要があります。取得 Quoteの「Status」フィールドが「Presented」、「Sent」または同様の値に変更された時点のタイムスタンプを特定します。イベントタイプ inferred

推奨任意

抽出ガイド

Salesforce Sales Cloudからデータを取得する方法

ステップ

前提条件の確認：Field History Tracking：開始前に、Salesforce管理者に次のオブジェクトの主要フィールドでField History Trackingが有効になっていることを確認してもらいます：Opportunity（StageName、金額）、見積書（Status）、Contract（Status）、注文（Status）。プロセスの変更を正確に取得するために重要です。
Salesforceレポートに移動：Salesforce環境にログインします。App Launcherで「Reports」タブを探して開きます。「New Report」ボタンをクリックして開始します。
Opportunity履歴レポートを作成：このレポートでは、Opportunityの作成、ステージ変更、クローズイベントを取得します。「Opportunities with Field History」レポートタイプを選択します。次の列を追加します：Opportunity ID、Opportunity Name、Created Date、Field/Event、Old Value、New Value、Edit Date、Edit By。推奨属性として、Owner、金額、Is Won、該当する割引フィールドも追加します。
Lead変換レポートを作成：「Leads」レポートタイプを使って2つ目のレポートを作成します。次の列を追加します：Lead ID、Converted Date、Converted Opportunity ID、Lead Owner。「Converted」がtrueのLeadだけを表示するフィルターを適用します。
見積書イベントレポートを作成：「Quotes」レポートタイプを使って3つ目のレポートを作成します。可能であれば、履歴を含むレポートタイプ（例：「Quotes with Field History」）を選択します。次の列を追加します：Quote ID、Opportunity ID、CreatedDate、LastModifiedDate、Status。このレポートを使って、見積書の作成とステータス変更を導出します。
追加レポートを作成（Contracts、注文、請求書）：見積書レポートと同じパターンで、Salesforce環境でこれらのオブジェクトを使用している場合は、Contracts、注文、請求書のレポートを個別に作成します。それぞれにレコードID、関連するOpportunity ID、CreatedDate、LastModifiedDate、オブジェクトのStatusフィールドを含めます。
すべてのレポートを実行してエクスポート：作成した各レポートに、統一した日付範囲フィルターを設定します。例えば、「Opportunity Created Date」が過去6か月のレコードに絞り込みます。各レポートを実行し、「Export」機能で結果をCSVファイルとして保存します。
スプレッドシートでデータを統合：Microsoft Excelなどのスプレッドシートアプリケーションを開きます。エクスポートした各CSVファイルのデータを、1つのブック内の別々のシートにコピーします。
最終イベントログシートを作成：「Event Log」という名前の新しいシートを作成します。必須の列見出しとしてSalesOpportunity、ActivityName、EventTimestampを定義し、推奨列見出しとしてOpportunityOwner、StageName、金額、IsWon、DiscountPercentageを定義します。
データを変換して統合：元データのシートを処理し、「Event Log」シートに手動でデータを入力します。元データの各行に対応する行をイベントログに作成します。例えば、Opportunity Historyシートで「New Value」が「Closed Won」の行について、ActivityNameを「Opportunity Closed Won」、EventTimestampを「Edit Date」に設定した行をイベントログに作成します。すべての元データファイルを対象に、必要な16種類のアクティビティについてこの処理を繰り返します。
最終的な書式設定とエクスポート：EventTimestamp列の形式を統一します（例：YYYY-MM-DD HH:MI:SS）。すべての行でSalesOpportunity列が入力され、元レポートのOpportunity IDが設定されていることを確認します。統合済みの「Event Log」シートをCSVファイルとして保存し、アップロードします。

設定

レポートタイプ：主に必要なレポートタイプは「Opportunities with Field History」です。Leads、Quotes、Contracts、Orders、Invoicesについても追加のレポートが必要です。これらのオブジェクトで履歴対応のレポートタイプを利用できると、データの精度が大きく向上します。
項目履歴管理：Salesforce管理者が事前に設定する必要があります。Opportunity Stage、Quote Status、Contract Status、Order Statusの変更を追跡するために欠かせません。
権限：レポートを実行するユーザーには、関連するすべてのオブジェクト（Lead、Account、Opportunity、OpportunityFieldHistory、Quote、Contract、Order、必要に応じてInvoiceとPayment）への読み取り権限が必要です。
日付範囲フィルター：データを正しく関連付けるため、すべてのレポートに同じ日付範囲フィルターを設定する必要があります。データ量を管理しやすくするため、「Opportunity Created Date」を過去3～6か月に設定することを推奨します。
データ量：商談やアクティビティの量が非常に多い組織では、レポートビルダーの処理が遅くなったり、エクスポート上限（エディションによって通常約10万行）に達したりする場合があります。その場合は、ローデータを取得する方法として、週次のデータエクスポートサービスのほうが適しています。

a サンプルクエリ sql

/*
Salesforce Report Builder is a graphical user interface, so a direct script is not applicable.
The following describes the configuration and transformation logic required to build the final event log file from the various exported reports.
*/

-- **FINAL EVENT LOG STRUCTURE (Target CSV File)**
-- `SalesOpportunity` (TEXT): The Salesforce Opportunity ID (18-digit).
-- `ActivityName` (TEXT): The name of the business event.
-- `EventTimestamp` (DATETIME): The timestamp of the event.
-- `OpportunityOwner` (TEXT): The name of the opportunity owner.
-- `StageName` (TEXT): The stage of the opportunity at the time of the event.
-- `Amount` (NUMERIC): The opportunity amount.
-- `IsWon` (BOOLEAN): True if the opportunity is in a 'Closed Won' stage.
-- `DiscountPercentage` (NUMERIC): The discount percentage, if applicable.

-- **DATA TRANSFORMATION LOGIC (To be applied in a spreadsheet or script)**

-- **From Lead Conversion Report**
-- Activity: 'Lead Converted to Opportunity'
-- `SalesOpportunity` <-- `Converted Opportunity ID`
-- `ActivityName` <-- 'Lead Converted to Opportunity'
-- `EventTimestamp` <-- `Converted Date`

-- **From Opportunity History Report**
-- Activity: 'Opportunity Created'
-- `SalesOpportunity` <-- `Opportunity ID`
-- `ActivityName` <-- 'Opportunity Created'
-- `EventTimestamp` <-- `Created Date`

-- Activity: 'Opportunity Stage Changed'
-- `SalesOpportunity` <-- `Opportunity ID`
-- `ActivityName` <-- 'Opportunity Stage Changed'
-- `EventTimestamp` <-- `Edit Date`
-- Filter: WHERE `Field/Event` = 'Stage'

-- Activity: 'Proposal Stage Reached'
-- `SalesOpportunity` <-- `Opportunity ID`
-- `ActivityName` <-- 'Proposal Stage Reached'
-- `EventTimestamp` <-- `Edit Date`
-- Filter: WHERE `Field/Event` = 'Stage' AND `New Value` = 'Proposal/Price Quote'

-- Activity: 'Opportunity Closed Won'
-- `SalesOpportunity` <-- `Opportunity ID`
-- `ActivityName` <-- 'Opportunity Closed Won'
-- `EventTimestamp` <-- `Edit Date`
-- Filter: WHERE `Field/Event` = 'Stage' AND `New Value` = 'Closed Won'

-- Activity: 'Opportunity Closed Lost'
-- `SalesOpportunity` <-- `Opportunity ID`
-- `ActivityName` <-- 'Opportunity Closed Lost'
-- `EventTimestamp` <-- `Edit Date`
-- Filter: WHERE `Field/Event` = 'Stage' AND `New Value` = 'Closed Lost'

-- **From Quote Report (Requires Quote History Tracking for status changes)**
-- Activity: 'Quote Created'
-- `SalesOpportunity` <-- `Opportunity ID`
-- `ActivityName` <-- 'Quote Created'
-- `EventTimestamp` <-- `CreatedDate`

-- Activity: 'Quote Presented to Customer'
-- `SalesOpportunity` <-- `Opportunity ID`
-- `ActivityName` <-- 'Quote Presented to Customer'
-- `EventTimestamp` <-- [History Edit Date for Status Change to 'Presented']

-- Activity: 'Quote Modified'
-- `SalesOpportunity` <-- `Opportunity ID`
-- `ActivityName` <-- 'Quote Modified'
-- `EventTimestamp` <-- `LastModifiedDate` (Note: This is an approximation)
-- Filter: WHERE `LastModifiedDate` > `CreatedDate`

-- Activity: 'Quote Accepted by Customer'
-- `SalesOpportunity` <-- `Opportunity ID`
-- `ActivityName` <-- 'Quote Accepted by Customer'
-- `EventTimestamp` <-- [History Edit Date for Status Change to 'Accepted']

-- **From Contract Report (Requires Contract History Tracking for status changes)**
-- Activity: 'Contract Sent for Signature'
-- `SalesOpportunity` <-- `Opportunity ID`
-- `ActivityName` <-- 'Contract Sent for Signature'
-- `EventTimestamp` <-- [History Edit Date for Status Change to 'Sent']

-- Activity: 'Contract Activated'
-- `SalesOpportunity` <-- `Opportunity ID`
-- `ActivityName` <-- 'Contract Activated'
-- `EventTimestamp` <-- [History Edit Date for Status Change to 'Activated']

-- **From Order Report (Requires Order History Tracking for status changes)**
-- Activity: 'Order Created'
-- `SalesOpportunity` <-- `Opportunity ID`
-- `ActivityName` <-- 'Order Created'
-- `EventTimestamp` <-- `CreatedDate`

-- Activity: 'Order Fulfilled'
-- `SalesOpportunity` <-- `Opportunity ID`
-- `ActivityName` <-- 'Order Fulfilled'
-- `EventTimestamp` <-- [History Edit Date for Status Change to 'Fulfilled']

-- **From Invoice/Payment Report (If available in Salesforce)**
-- Activity: 'Invoice Generated'
-- `SalesOpportunity` <-- `Opportunity ID`
-- `ActivityName` <-- 'Invoice Generated'
-- `EventTimestamp` <-- [Invoice CreatedDate]

-- Activity: 'Payment Received'
-- `SalesOpportunity` <-- `Opportunity ID`
-- `ActivityName` <-- 'Payment Received'
-- `EventTimestamp` <-- [Payment Date or Invoice Paid Date]

ステップ

前提条件：APIアクセス権を持ち、Opportunity、Lead、見積書、Contract、注文、請求書オブジェクトと、それぞれに対応するField Historyオブジェクトを読み取るために十分な権限を持つSalesforceユーザーアカウントを用意します。これらのオブジェクトの主要フィールド（例：StageName、Status）でField History Trackingが有効になっている必要があります。
実行ツールを選択：このクエリではUNION ALL句を使用しており、Salesforce標準のDeveloper ConsoleやWorkbenchではサポートされていません。Salesforceに接続してSQL形式のクエリを実行できる外部ツールを使用する必要があります。例えば、ビジネスインテリジェンス（BI）ツール（Tableau、Power BI）、ETLツール（MuleSoft、Informatica）、またはSalesforceコネクターを備えたデータクエリツール（DBeaver、DataGrip）を利用できます。
Salesforce接続を確立：選択したツールでSalesforce環境への接続を設定します。通常、ユーザー名、パスワード、セキュリティトークンが必要です。Salesforce（API）コネクターを選択します。
クエリを準備：この文書のqueryセクションに記載されている完全なSOQLクエリを、ツールのクエリエディターにコピーします。
プレースホルダーを設定：クエリには、Salesforce組織に固有の値に置き換える必要があるプレースホルダーが複数あります。次の項目が含まれます。
- 'YYYY-MM-DDThh:mm:ssZ'：抽出期間の開始日と終了日として指定する日付に、すべての箇所を置き換えます。ISO 8601形式を使用します。
- [Your_Discount_Field__c]：Opportunityオブジェクトの割引率用カスタムフィールドのAPI名に置き換えます。
- [Quote_Presented_Status]：見積書を顧客に提示した際に使用する実際のステータス値に置き換えます（例：「Presented」、「In Review」）。
- [Opportunity_Lookup_On_Contract__c]：ContractオブジェクトでOpportunityにリンクする参照フィールドのAPI名に置き換えます。
- [Order_Fulfilled_Status]：注文が履行済みであることを示すステータス値に置き換えます（例：「Fulfilled」、「Shipped」、「Completed」）。
- [Opportunity_Lookup_On_Invoice__c]：InvoiceオブジェクトでOpportunityにリンクする参照フィールドのAPI名に置き換えます。
クエリを実行：完全なクエリを実行します。データ量と使用するツールによっては、完了まで数分かかる場合があります。
結果を確認：クエリが完了したら、返されたデータセットにさまざまなアクティビティの行が含まれ、列に想定どおり値が設定されていることを確認します。
潜在的なエラーに対処：クエリが失敗した場合は、置き換えたプレースホルダー名に誤りがないか確認します。ユーザーに、クエリ対象のすべてのフィールドへのフィールドレベルセキュリティアクセス権があることを確認します。日付範囲が広すぎるとタイムアウトやガバナ制限に達する可能性があるため、その場合は、例えば1四半期など、より短い期間に縮小します。
データをエクスポート：最終結果セットをCSVファイルとしてエクスポートします。
アップロードの準備：CSVファイルの列見出しが、必須属性であるSalesOpportunity、ActivityName、EventTimestamp、OpportunityOwner、StageName、金額、IsWon、DiscountPercentageと一致していることを確認します。これで、プロセスマイニングツールにアップロードできます。

設定

項目履歴管理：この抽出は、Opportunity（StageName）、Quote（Status）、Contract（Status）、Order（Status）オブジェクトで項目履歴管理が有効になっていることを前提としています。有効でない場合、ステータスやステージの変更アクティビティは記録されません。
ユーザー権限：実行ユーザーには、クエリで使用するすべてのオブジェクト（Lead、Opportunity、OpportunityFieldHistory、Quote、QuoteHistory、Contract、ContractHistory、Order、OrderHistory、Invoice、InvoiceHistory）へのAPIアクセス権と読み取り権限が必要です。
日付範囲：'YYYY-MM-DDThh:mm:ssZ'プレースホルダーを使って、具体的な日付範囲を指定する必要があります。初回の分析では、データ量とパフォーマンスのバランスを取るため、3～6か月の期間を推奨します。Salesforce環境の規模が非常に大きい場合は、まず1か月など短い期間で実行し、パフォーマンスやガバナ制限の問題がないか確認してください。
カスタム項目とステータス：クエリには、カスタム項目（例：[Your_Discount_Field__c]）やカスタムステータス値（例：[Quote_Presented_Status]）のプレースホルダーが含まれています。Salesforceの設定から正しいAPI名と値を確認し、クエリを更新してください。
オブジェクトの利用可否：このクエリは、標準のContractおよびOrderオブジェクトと、Salesforce Billingでよく使われるInvoiceオブジェクトを前提としています。組織でこれらのオブジェクトを使用していない場合や、請求に別のパッケージを使用している場合、該当部分は失敗するかデータを返しません。削除または適切に修正してください。

a サンプルクエリ sql

SELECT
    ConvertedOpportunityId AS SalesOpportunity,
    'Lead Converted to Opportunity' AS ActivityName,
    ConvertedDate AS EventTimestamp,
    ConvertedOpportunity.Owner.Name AS OpportunityOwner,
    ConvertedOpportunity.StageName AS StageName,
    ConvertedOpportunity.Amount AS Amount,
    ConvertedOpportunity.IsWon AS IsWon,
    ConvertedOpportunity.[Your_Discount_Field__c] AS DiscountPercentage
FROM Lead
WHERE IsConverted = TRUE AND ConvertedDate >= YYYY-MM-DDThh:mm:ssZ AND ConvertedDate <= YYYY-MM-DDThh:mm:ssZ AND ConvertedOpportunityId != NULL

UNION ALL

SELECT
    Id AS SalesOpportunity,
    'Opportunity Created' AS ActivityName,
    CreatedDate AS EventTimestamp,
    Owner.Name AS OpportunityOwner,
    StageName AS StageName,
    Amount AS Amount,
    IsWon AS IsWon,
    [Your_Discount_Field__c] AS DiscountPercentage
FROM Opportunity
WHERE CreatedDate >= YYYY-MM-DDThh:mm:ssZ AND CreatedDate <= YYYY-MM-DDThh:mm:ssZ

UNION ALL

SELECT
    OpportunityId AS SalesOpportunity,
    'Opportunity Stage Changed' AS ActivityName,
    CreatedDate AS EventTimestamp,
    Opportunity.Owner.Name AS OpportunityOwner,
    NewValue AS StageName,
    Opportunity.Amount AS Amount,
    Opportunity.IsWon AS IsWon,
    Opportunity.[Your_Discount_Field__c] AS DiscountPercentage
FROM OpportunityFieldHistory
WHERE Field = 'StageName' AND CreatedDate >= YYYY-MM-DDThh:mm:ssZ AND CreatedDate <= YYYY-MM-DDThh:mm:ssZ

UNION ALL

SELECT
    OpportunityId AS SalesOpportunity,
    'Proposal Stage Reached' AS ActivityName,
    CreatedDate AS EventTimestamp,
    Opportunity.Owner.Name AS OpportunityOwner,
    NewValue AS StageName,
    Opportunity.Amount AS Amount,
    Opportunity.IsWon AS IsWon,
    Opportunity.[Your_Discount_Field__c] AS DiscountPercentage
FROM OpportunityFieldHistory
WHERE Field = 'StageName' AND NewValue = 'Proposal/Price Quote' AND CreatedDate >= YYYY-MM-DDThh:mm:ssZ AND CreatedDate <= YYYY-MM-DDThh:mm:ssZ

UNION ALL

SELECT
    OpportunityId AS SalesOpportunity,
    'Quote Created' AS ActivityName,
    CreatedDate AS EventTimestamp,
    Opportunity.Owner.Name AS OpportunityOwner,
    Opportunity.StageName AS StageName,
    Opportunity.Amount AS Amount,
    Opportunity.IsWon AS IsWon,
    Opportunity.[Your_Discount_Field__c] AS DiscountPercentage
FROM Quote
WHERE CreatedDate >= YYYY-MM-DDThh:mm:ssZ AND CreatedDate <= YYYY-MM-DDThh:mm:ssZ AND OpportunityId != NULL

UNION ALL

SELECT
    Quote.OpportunityId AS SalesOpportunity,
    'Quote Presented to Customer' AS ActivityName,
    CreatedDate AS EventTimestamp,
    Quote.Opportunity.Owner.Name AS OpportunityOwner,
    Quote.Opportunity.StageName AS StageName,
    Quote.Opportunity.Amount AS Amount,
    Quote.Opportunity.IsWon AS IsWon,
    Quote.Opportunity.[Your_Discount_Field__c] AS DiscountPercentage
FROM QuoteHistory
WHERE Field = 'Status' AND NewValue = '[Quote_Presented_Status]' AND CreatedDate >= YYYY-MM-DDThh:mm:ssZ AND CreatedDate <= YYYY-MM-DDThh:mm:ssZ AND Quote.OpportunityId != NULL

UNION ALL

SELECT
    Quote.OpportunityId AS SalesOpportunity,
    'Quote Modified' AS ActivityName,
    CreatedDate AS EventTimestamp,
    Quote.Opportunity.Owner.Name AS OpportunityOwner,
    Quote.Opportunity.StageName AS StageName,
    Quote.Opportunity.Amount AS Amount,
    Quote.Opportunity.IsWon AS IsWon,
    Quote.Opportunity.[Your_Discount_Field__c] AS DiscountPercentage
FROM QuoteHistory
WHERE CreatedDate > Quote.CreatedDate AND CreatedDate >= YYYY-MM-DDThh:mm:ssZ AND CreatedDate <= YYYY-MM-DDThh:mm:ssZ AND Quote.OpportunityId != NULL

UNION ALL

SELECT
    Quote.OpportunityId AS SalesOpportunity,
    'Quote Accepted by Customer' AS ActivityName,
    CreatedDate AS EventTimestamp,
    Quote.Opportunity.Owner.Name AS OpportunityOwner,
    Quote.Opportunity.StageName AS StageName,
    Quote.Opportunity.Amount AS Amount,
    Quote.Opportunity.IsWon AS IsWon,
    Quote.Opportunity.[Your_Discount_Field__c] AS DiscountPercentage
FROM QuoteHistory
WHERE Field = 'Status' AND NewValue = 'Accepted' AND CreatedDate >= YYYY-MM-DDThh:mm:ssZ AND CreatedDate <= YYYY-MM-DDThh:mm:ssZ AND Quote.OpportunityId != NULL

UNION ALL

SELECT
    Contract.[Opportunity_Lookup_On_Contract__c] AS SalesOpportunity,
    'Contract Sent for Signature' AS ActivityName,
    CreatedDate AS EventTimestamp,
    Contract.Opportunity__r.Owner.Name AS OpportunityOwner,
    Contract.Opportunity__r.StageName AS StageName,
    Contract.Opportunity__r.Amount AS Amount,
    Contract.Opportunity__r.IsWon AS IsWon,
    Contract.Opportunity__r.[Your_Discount_Field__c] AS DiscountPercentage
FROM ContractHistory
WHERE Field = 'Status' AND NewValue = 'Sent for Signature' AND CreatedDate >= YYYY-MM-DDThh:mm:ssZ AND CreatedDate <= YYYY-MM-DDThh:mm:ssZ AND Contract.[Opportunity_Lookup_On_Contract__c] != NULL

UNION ALL

SELECT
    Contract.[Opportunity_Lookup_On_Contract__c] AS SalesOpportunity,
    'Contract Activated' AS ActivityName,
    CreatedDate AS EventTimestamp,
    Contract.Opportunity__r.Owner.Name AS OpportunityOwner,
    Contract.Opportunity__r.StageName AS StageName,
    Contract.Opportunity__r.Amount AS Amount,
    Contract.Opportunity__r.IsWon AS IsWon,
    Contract.Opportunity__r.[Your_Discount_Field__c] AS DiscountPercentage
FROM ContractHistory
WHERE Field = 'Status' AND NewValue = 'Activated' AND CreatedDate >= YYYY-MM-DDThh:mm:ssZ AND CreatedDate <= YYYY-MM-DDThh:mm:ssZ AND Contract.[Opportunity_Lookup_On_Contract__c] != NULL

UNION ALL

SELECT
    OpportunityId AS SalesOpportunity,
    'Opportunity Closed Won' AS ActivityName,
    CreatedDate AS EventTimestamp,
    Opportunity.Owner.Name AS OpportunityOwner,
    NewValue AS StageName,
    Opportunity.Amount AS Amount,
    Opportunity.IsWon AS IsWon,
    Opportunity.[Your_Discount_Field__c] AS DiscountPercentage
FROM OpportunityFieldHistory
WHERE Field = 'StageName' AND NewValue = 'Closed Won' AND CreatedDate >= YYYY-MM-DDThh:mm:ssZ AND CreatedDate <= YYYY-MM-DDThh:mm:ssZ

UNION ALL

SELECT
    OpportunityId AS SalesOpportunity,
    'Order Created' AS ActivityName,
    CreatedDate AS EventTimestamp,
    Opportunity.Owner.Name AS OpportunityOwner,
    Opportunity.StageName AS StageName,
    Opportunity.Amount AS Amount,
    Opportunity.IsWon AS IsWon,
    Opportunity.[Your_Discount_Field__c] AS DiscountPercentage
FROM Order
WHERE CreatedDate >= YYYY-MM-DDThh:mm:ssZ AND CreatedDate <= YYYY-MM-DDThh:mm:ssZ AND OpportunityId != NULL

UNION ALL

SELECT
    Order.OpportunityId AS SalesOpportunity,
    'Order Fulfilled' AS ActivityName,
    CreatedDate AS EventTimestamp,
    Order.Opportunity.Owner.Name AS OpportunityOwner,
    Order.Opportunity.StageName AS StageName,
    Order.Opportunity.Amount AS Amount,
    Order.Opportunity.IsWon AS IsWon,
    Order.Opportunity.[Your_Discount_Field__c] AS DiscountPercentage
FROM OrderHistory
WHERE Field = 'Status' AND NewValue = '[Order_Fulfilled_Status]' AND CreatedDate >= YYYY-MM-DDThh:mm:ssZ AND CreatedDate <= YYYY-MM-DDThh:mm:ssZ AND Order.OpportunityId != NULL

UNION ALL

SELECT
    [Opportunity_Lookup_On_Invoice__c] AS SalesOpportunity,
    'Invoice Generated' AS ActivityName,
    CreatedDate AS EventTimestamp,
    Opportunity__r.Owner.Name AS OpportunityOwner,
    Opportunity__r.StageName AS StageName,
    Opportunity__r.Amount AS Amount,
    Opportunity__r.IsWon AS IsWon,
    Opportunity__r.[Your_Discount_Field__c] AS DiscountPercentage
FROM Invoice
WHERE CreatedDate >= YYYY-MM-DDThh:mm:ssZ AND CreatedDate <= YYYY-MM-DDThh:mm:ssZ AND [Opportunity_Lookup_On_Invoice__c] != NULL

UNION ALL

SELECT
    Invoice.[Opportunity_Lookup_On_Invoice__c] AS SalesOpportunity,
    'Payment Received' AS ActivityName,
    CreatedDate AS EventTimestamp,
    Invoice.Opportunity__r.Owner.Name AS OpportunityOwner,
    Invoice.Opportunity__r.StageName AS StageName,
    Invoice.Opportunity__r.Amount AS Amount,
    Invoice.Opportunity__r.IsWon AS IsWon,
    Invoice.Opportunity__r.[Your_Discount_Field__c] AS DiscountPercentage
FROM InvoiceHistory
WHERE Field = 'Status' AND NewValue = 'Paid' AND CreatedDate >= YYYY-MM-DDThh:mm:ssZ AND CreatedDate <= YYYY-MM-DDThh:mm:ssZ AND Invoice.[Opportunity_Lookup_On_Invoice__c] != NULL

UNION ALL

SELECT
    OpportunityId AS SalesOpportunity,
    'Opportunity Closed Lost' AS ActivityName,
    CreatedDate AS EventTimestamp,
    Opportunity.Owner.Name AS OpportunityOwner,
    NewValue AS StageName,
    Opportunity.Amount AS Amount,
    Opportunity.IsWon AS IsWon,
    Opportunity.[Your_Discount_Field__c] AS DiscountPercentage
FROM OpportunityFieldHistory
WHERE Field = 'StageName' AND NewValue = 'Closed Lost' AND CreatedDate >= YYYY-MM-DDThh:mm:ssZ AND CreatedDate <= YYYY-MM-DDThh:mm:ssZ

ステップ

環境を準備：システムにPython 3.6以降がインストールされていることを確認します。必要なライブラリをインストールするため、Pythonのパッケージインストーラーであるpipも必要です。
必要なライブラリをインストール：コマンドラインまたはターミナルを開き、次のコマンドを実行してsimple-salesforceとpandasライブラリをインストールします：pip install simple-salesforce pandas。
Salesforce APIアクセスを設定：管理者プロファイルでSalesforceアカウントにログインします。Setup、Apps、App Managerの順に移動します。新しい「Connected App」を作成します。アプリでOAuth Settingsを有効にし、「Access and manage your data (api)」スコープを付与します。保存すると、「Consumer Key」と「Consumer Secret」が発行されます。また、スクリプトで使用するユーザーアカウントにセキュリティトークンがあることを確認します。個人設定の「Reset My Security Token」から生成またはリセットできます。
Pythonスクリプトを設定：Queryセクションに記載されている完全なPythonスクリプトを、extract_lead_to_cash.pyという名前のファイルにコピーします。
認証情報を入力：スクリプトファイルを開き、username、password、security_token、instance_urlのプレースホルダーを、Salesforceの実際の認証情報に置き換えます。本番環境で認証情報をハードコードせず、環境変数や設定ファイルなどの安全な方法を使用してください。
抽出期間を定義：スクリプトのstart_dateとend_date変数を変更し、抽出対象データの期間を指定します。YYYY-MM-DD形式を使用します。
スクリプトのロジックを理解：スクリプトはSalesforce APIに接続し、一連のSalesforce Object Query Language（SOQL）クエリを実行します。各クエリは特定のオブジェクト（例：Opportunity、OpportunityFieldHistory、見積書）を対象とし、個別の業務アクティビティを取得します。
データを集約：各クエリの結果を、pandasのDataFrameという構造化形式に変換します。各アクティビティを表す個別のDataFrameを1つのリストにまとめます。
変換と書式設定：スクリプトはすべてのDataFrameを1つのイベントログに連結します。列名をプロセスマイニングに必要なスキーマ（SalesOpportunity、ActivityName、EventTimestampなど）に変更し、データ型が正しいことを確認します。
スクリプトを実行：ターミナルで次のコマンドを実行します：python extract_lead_to_cash.py。スクリプトがSalesforceに接続し、クエリを実行してデータを処理します。
イベントログを取得：正常に完了すると、同じディレクトリにsfdc_lead_to_cash_event_log.csvというファイルが生成されます。このCSVファイルが、プロセスマイニングツールへのアップロード用に整形された最終イベントログです。

設定

前提条件：APIアクセスが可能なEnterprise、Unlimited、またはDeveloper EditionのSalesforceアカウント。ユーザープロファイルに「API Enabled」権限があり、次のオブジェクトへの読み取り権限が必要です：Lead、Opportunity、OpportunityFieldHistory、Quote、Contract、Order。請求や支払いに使用するカスタムオブジェクトにも読み取り権限が必要です。
認証：スクリプトでは、ユーザー名、パスワード、セキュリティトークンによる認証を使用します。本番環境でセキュリティを高めるには、simple-salesforceも対応しているOAuth 2.0 JWT Bearer Flowの導入を検討してください。
日付範囲：スクリプトのstart_dateとend_date変数で抽出期間を指定します。初回の分析では、十分なデータを確保しつつ量が過大にならないよう、3～6か月を推奨します。日付フィルターは、各アクティビティの主要なタイムスタンプ項目（CreatedDateやConvertedDateなど）に適用されます。
APIの利用：このスクリプトは複数の個別クエリを実行します。各クエリと、その後の全結果の取得でAPIコールが発生し、組織の1日あたりの上限に加算されます。他の連携処理も多い環境では、上限に注意してください。数百万件のレコードを抽出する場合は、Salesforce Bulk APIを使うようスクリプトを変更する必要があります。
カスタマイズ：可能な範囲で標準のオブジェクト名と項目名を前提としています。組織によっては、カスタム項目（例：Discount_Percentage__c）、カスタムオブジェクト（例：Invoice__c、Payment__c）、カスタムの関連付け（例：ContractからOpportunityへの参照）が使われている場合があります。使用環境に合わせて、スクリプト内のSOQLクエリを修正してください。

a サンプルクエリ python

import pandas as pd
from simple_salesforce import Salesforce
from datetime import datetime

class=class="hl-string">"hl-comment"># --- Configuration Settings ---
class=class="hl-string">"hl-comment"># Replace with your Salesforce credentials and instance URL
SF_USERNAME = class="hl-string">'[your_salesforce_username]'
SF_PASSWORD = class="hl-string">'[your_salesforce_password]'
SF_SECURITY_TOKEN = class="hl-string">'[your_salesforce_security_token]'
SF_INSTANCE_URL = class="hl-string">'[your_salesforce_instance_url]'

class=class="hl-string">"hl-comment"># Define the date range for the extraction
start_date = class="hl-string">'2023-01-01'
end_date = class="hl-string">'2023-12-31'

class=class="hl-string">"hl-comment"># --- Main Script ---
def main():
    class=class="hl-string">"hl-comment"># Establish connection to Salesforce
    try:
        sf = Salesforce(username=SF_USERNAME, password=SF_PASSWORD, security_token=SF_SECURITY_TOKEN, instance_url=SF_INSTANCE_URL)
        print(fclass="hl-string">"Successfully connected to Salesforce instance: {sf.sf_instance}")
    except Exception as e:
        print(fclass="hl-string">"Salesforce connection failed: {e}")
        return

    class=class="hl-string">"hl-comment"># List to hold DataFrames for each activity
    event_log_parts = []

    class=class="hl-string">"hl-comment"># Define common fields to query for Opportunity context
    common_opp_fields = class="hl-string">"Opportunity.Id, Opportunity.Owner.Name, Opportunity.StageName, Opportunity.Amount, Opportunity.IsWon, Opportunity.Discount_Percentage__c"

    class=class="hl-string">"hl-comment"># 1. Lead Converted to Opportunity
    print(class="hl-string">"Extracting: Lead Converted to Opportunity")
    query = fclass="hl-string">"SELECT ConvertedOpportunityId, ConvertedDate, (SELECT Name FROM Owner) FROM Lead WHERE IsConverted = TRUE AND ConvertedDate >= {start_date}T00:00:00Z AND ConvertedDate <= {end_date}T23:59:59Z"
    df = pd.DataFrame(sf.query_all(query)[class="hl-string">'records'])
    if not df.empty:
        df[class="hl-string">'ActivityName'] = class="hl-string">'Lead Converted to Opportunity'
        df[class="hl-string">'EventTimestamp'] = pd.to_datetime(df[class="hl-string">'ConvertedDate']).dt.tz_localize(None)
        df[class="hl-string">'SalesOpportunity'] = df[class="hl-string">'ConvertedOpportunityId']
        df[class="hl-string">'OpportunityOwner'] = df[class="hl-string">'Owner'].apply(lambda x: x[class="hl-string">'Name'] if x else None)
        df = df[[class="hl-string">'SalesOpportunity', class="hl-string">'ActivityName', class="hl-string">'EventTimestamp', class="hl-string">'OpportunityOwner']]
        event_log_parts.append(df)

    class=class="hl-string">"hl-comment"># 2. Opportunity Created
    print(class="hl-string">"Extracting: Opportunity Created")
    query = fclass="hl-string">"SELECT Id, CreatedDate, Owner.Name, StageName, Amount, IsWon, Discount_Percentage__c FROM Opportunity WHERE CreatedDate >= {start_date}T00:00:00Z AND CreatedDate <= {end_date}T23:59:59Z"
    df = pd.DataFrame(sf.query_all(query)[class="hl-string">'records'])
    if not df.empty:
        df[class="hl-string">'ActivityName'] = class="hl-string">'Opportunity Created'
        df[class="hl-string">'EventTimestamp'] = pd.to_datetime(df[class="hl-string">'CreatedDate']).dt.tz_localize(None)
        df = df.rename(columns={class="hl-string">'Id': class="hl-string">'SalesOpportunity', class="hl-string">'Name': class="hl-string">'OpportunityOwner', class="hl-string">'Discount_Percentage__c': class="hl-string">'DiscountPercentage'})
        df[class="hl-string">'OpportunityOwner'] = df.apply(lambda row: row[class="hl-string">'Owner'][class="hl-string">'Name'] if row[class="hl-string">'Owner'] else None, axis=1)
        event_log_parts.append(df[[class="hl-string">'SalesOpportunity', class="hl-string">'ActivityName', class="hl-string">'EventTimestamp', class="hl-string">'OpportunityOwner', class="hl-string">'StageName', class="hl-string">'Amount', class="hl-string">'IsWon', class="hl-string">'DiscountPercentage']])

    class=class="hl-string">"hl-comment"># 3, 4, 11, 16. Opportunity Stage Changes (includes Proposal, Closed Won, Closed Lost)
    print(class="hl-string">"Extracting: Opportunity Stage Changes")
    query = fclass="hl-string">"SELECT OpportunityId, CreatedDate, NewValue, OldValue, {common_opp_fields} FROM OpportunityFieldHistory WHERE Field = 'StageName' AND CreatedDate >= {start_date}T00:00:00Z AND CreatedDate <= {end_date}T23:59:59Z"
    df = pd.DataFrame(sf.query_all(query)[class="hl-string">'records'])
    if not df.empty:
        df_opp = pd.json_normalize(df[class="hl-string">'Opportunity']).add_prefix(class="hl-string">'Opportunity.')
        df = pd.concat([df.drop(class="hl-string">'Opportunity', axis=1), df_opp], axis=1)
        df[class="hl-string">'ActivityName'] = class="hl-string">'Opportunity Stage Changed'
        class=class="hl-string">"hl-comment"># Specific stage milestones
        df.loc[df[class="hl-string">'NewValue'] == class="hl-string">'Proposal/Price Quote', class="hl-string">'ActivityName'] = class="hl-string">'Proposal Stage Reached'
        df.loc[df[class="hl-string">'NewValue'] == class="hl-string">'Closed Won', class="hl-string">'ActivityName'] = class="hl-string">'Opportunity Closed Won'
        df.loc[df[class="hl-string">'NewValue'] == class="hl-string">'Closed Lost', class="hl-string">'ActivityName'] = class="hl-string">'Opportunity Closed Lost'
        df[class="hl-string">'EventTimestamp'] = pd.to_datetime(df[class="hl-string">'CreatedDate']).dt.tz_localize(None)
        df = df.rename(columns={class="hl-string">'OpportunityId': class="hl-string">'SalesOpportunity', class="hl-string">'Opportunity.Owner.Name': class="hl-string">'OpportunityOwner', class="hl-string">'Opportunity.StageName': class="hl-string">'StageName', class="hl-string">'Opportunity.Amount': class="hl-string">'Amount', class="hl-string">'Opportunity.IsWon': class="hl-string">'IsWon', class="hl-string">'Opportunity.Discount_Percentage__c': class="hl-string">'DiscountPercentage'})
        event_log_parts.append(df[[class="hl-string">'SalesOpportunity', class="hl-string">'ActivityName', class="hl-string">'EventTimestamp', class="hl-string">'OpportunityOwner', class="hl-string">'StageName', class="hl-string">'Amount', class="hl-string">'IsWon', class="hl-string">'DiscountPercentage']])

    class=class="hl-string">"hl-comment"># 5. Quote Created
    print(class="hl-string">"Extracting: Quote Created")
    query = fclass="hl-string">"SELECT CreatedDate, OpportunityId, {common_opp_fields} FROM Quote WHERE CreatedDate >= {start_date}T00:00:00Z AND CreatedDate <= {end_date}T23:59:59Z"
    df = pd.DataFrame(sf.query_all(query)[class="hl-string">'records'])
    if not df.empty:
        df_opp = pd.json_normalize(df[class="hl-string">'Opportunity']).add_prefix(class="hl-string">'Opportunity.')
        df = pd.concat([df.drop(class="hl-string">'Opportunity', axis=1), df_opp], axis=1)
        df[class="hl-string">'ActivityName'] = class="hl-string">'Quote Created'
        df[class="hl-string">'EventTimestamp'] = pd.to_datetime(df[class="hl-string">'CreatedDate']).dt.tz_localize(None)
        df = df.rename(columns={class="hl-string">'OpportunityId': class="hl-string">'SalesOpportunity', class="hl-string">'Opportunity.Owner.Name': class="hl-string">'OpportunityOwner', class="hl-string">'Opportunity.StageName': class="hl-string">'StageName', class="hl-string">'Opportunity.Amount': class="hl-string">'Amount', class="hl-string">'Opportunity.IsWon': class="hl-string">'IsWon', class="hl-string">'Opportunity.Discount_Percentage__c': class="hl-string">'DiscountPercentage'})
        event_log_parts.append(df[[class="hl-string">'SalesOpportunity', class="hl-string">'ActivityName', class="hl-string">'EventTimestamp', class="hl-string">'OpportunityOwner', class="hl-string">'StageName', class="hl-string">'Amount', class="hl-string">'IsWon', class="hl-string">'DiscountPercentage']])

    class=class="hl-string">"hl-comment"># 6, 7, 8. Quote Status Changes (Presented, Modified, Accepted)
    print(class="hl-string">"Extracting: Quote Status Changes")
    query = fclass="hl-string">"SELECT LastModifiedDate, CreatedDate, Status, OpportunityId, {common_opp_fields} FROM Quote WHERE LastModifiedDate >= {start_date}T00:00:00Z AND LastModifiedDate <= {end_date}T23:59:59Z"
    df = pd.DataFrame(sf.query_all(query)[class="hl-string">'records'])
    if not df.empty:
        df_opp = pd.json_normalize(df[class="hl-string">'Opportunity']).add_prefix(class="hl-string">'Opportunity.')
        df = pd.concat([df.drop(class="hl-string">'Opportunity', axis=1), df_opp], axis=1)
        df[class="hl-string">'EventTimestamp'] = pd.to_datetime(df[class="hl-string">'LastModifiedDate']).dt.tz_localize(None)
        df[class="hl-string">'CreatedTimestamp'] = pd.to_datetime(df[class="hl-string">'CreatedDate']).dt.tz_localize(None)
        df = df.rename(columns={class="hl-string">'OpportunityId': class="hl-string">'SalesOpportunity', class="hl-string">'Opportunity.Owner.Name': class="hl-string">'OpportunityOwner', class="hl-string">'Opportunity.StageName': class="hl-string">'StageName', class="hl-string">'Opportunity.Amount': class="hl-string">'Amount', class="hl-string">'Opportunity.IsWon': class="hl-string">'IsWon', class="hl-string">'Opportunity.Discount_Percentage__c': class="hl-string">'DiscountPercentage'})
        class=class="hl-string">"hl-comment"># Presented
        df_presented = df[df[class="hl-string">'Status'] == class="hl-string">'Presented'].copy()
        if not df_presented.empty: df_presented[class="hl-string">'ActivityName'] = class="hl-string">'Quote Presented to Customer'; event_log_parts.append(df_presented)
        class=class="hl-string">"hl-comment"># Accepted
        df_accepted = df[df[class="hl-string">'Status'] == class="hl-string">'Accepted'].copy()
        if not df_accepted.empty: df_accepted[class="hl-string">'ActivityName'] = class="hl-string">'Quote Accepted by Customer'; event_log_parts.append(df_accepted)
        class=class="hl-string">"hl-comment"># Modified (any change after creation)
        df_modified = df[df[class="hl-string">'EventTimestamp'] > df[class="hl-string">'CreatedTimestamp']].copy()
        if not df_modified.empty: df_modified[class="hl-string">'ActivityName'] = class="hl-string">'Quote Modified'; event_log_parts.append(df_modified)

    class=class="hl-string">"hl-comment"># 9, 10. Contract Status Changes (Sent, Activated)
    print(class="hl-string">"Extracting: Contract Events")
    query = fclass="hl-string">"SELECT LastModifiedDate, ActivatedDate, Status, Opportunity__c, (SELECT Id, Owner.Name, StageName, Amount, IsWon, Discount_Percentage__c FROM Opportunity__r) FROM Contract WHERE (LastModifiedDate >= {start_date}T00:00:00Z AND LastModifiedDate <= {end_date}T23:59:59Z) OR (ActivatedDate >= {start_date} AND ActivatedDate <= {end_date}) AND Opportunity__c != NULL"
    df = pd.DataFrame(sf.query_all(query)[class="hl-string">'records'])
    if not df.empty:
        df_opp = pd.json_normalize(df[class="hl-string">'Opportunity__r']).add_prefix(class="hl-string">'Opportunity.')
        df = pd.concat([df.drop(class="hl-string">'Opportunity__r', axis=1), df_opp], axis=1)
        df = df.rename(columns={class="hl-string">'Opportunity__c': class="hl-string">'SalesOpportunity', class="hl-string">'Opportunity.Owner.Name': class="hl-string">'OpportunityOwner', class="hl-string">'Opportunity.StageName': class="hl-string">'StageName', class="hl-string">'Opportunity.Amount': class="hl-string">'Amount', class="hl-string">'Opportunity.IsWon': class="hl-string">'IsWon', class="hl-string">'Opportunity.Discount_Percentage__c': class="hl-string">'DiscountPercentage'})
        class=class="hl-string">"hl-comment"># Sent for Signature
        df_sent = df[df[class="hl-string">'Status'] == class="hl-string">'Sent'].copy()
        if not df_sent.empty: df_sent[class="hl-string">'ActivityName'] = class="hl-string">'Contract Sent for Signature'; df_sent[class="hl-string">'EventTimestamp'] = pd.to_datetime(df_sent[class="hl-string">'LastModifiedDate']).dt.tz_localize(None); event_log_parts.append(df_sent)
        class=class="hl-string">"hl-comment"># Activated
        df_activated = df[df[class="hl-string">'Status'] == class="hl-string">'Activated'].copy()
        if not df_activated.empty: df_activated[class="hl-string">'ActivityName'] = class="hl-string">'Contract Activated'; df_activated[class="hl-string">'EventTimestamp'] = pd.to_datetime(df_activated[class="hl-string">'ActivatedDate']).dt.tz_localize(None); event_log_parts.append(df_activated)

    class=class="hl-string">"hl-comment"># 12. Order Created
    print(class="hl-string">"Extracting: Order Created")
    query = fclass="hl-string">"SELECT CreatedDate, OpportunityId, {common_opp_fields} FROM Order WHERE CreatedDate >= {start_date}T00:00:00Z AND CreatedDate <= {end_date}T23:59:59Z AND OpportunityId != NULL"
    df = pd.DataFrame(sf.query_all(query)[class="hl-string">'records'])
    if not df.empty:
        df_opp = pd.json_normalize(df[class="hl-string">'Opportunity']).add_prefix(class="hl-string">'Opportunity.')
        df = pd.concat([df.drop(class="hl-string">'Opportunity', axis=1), df_opp], axis=1)
        df[class="hl-string">'ActivityName'] = class="hl-string">'Order Created'
        df[class="hl-string">'EventTimestamp'] = pd.to_datetime(df[class="hl-string">'CreatedDate']).dt.tz_localize(None)
        df = df.rename(columns={class="hl-string">'OpportunityId': class="hl-string">'SalesOpportunity', class="hl-string">'Opportunity.Owner.Name': class="hl-string">'OpportunityOwner', class="hl-string">'Opportunity.StageName': class="hl-string">'StageName', class="hl-string">'Opportunity.Amount': class="hl-string">'Amount', class="hl-string">'Opportunity.IsWon': class="hl-string">'IsWon', class="hl-string">'Opportunity.Discount_Percentage__c': class="hl-string">'DiscountPercentage'})
        event_log_parts.append(df)
        
    class=class="hl-string">"hl-comment"># 13. Order Fulfilled
    print(class="hl-string">"Extracting: Order Fulfilled")
    query = fclass="hl-string">"SELECT LastModifiedDate, Status, OpportunityId, {common_opp_fields} FROM Order WHERE LastModifiedDate >= {start_date}T00:00:00Z AND LastModifiedDate <= {end_date}T23:59:59Z AND Status = 'Fulfilled' AND OpportunityId != NULL"
    df = pd.DataFrame(sf.query_all(query)[class="hl-string">'records'])
    if not df.empty:
        df_opp = pd.json_normalize(df[class="hl-string">'Opportunity']).add_prefix(class="hl-string">'Opportunity.')
        df = pd.concat([df.drop(class="hl-string">'Opportunity', axis=1), df_opp], axis=1)
        df[class="hl-string">'ActivityName'] = class="hl-string">'Order Fulfilled'
        df[class="hl-string">'EventTimestamp'] = pd.to_datetime(df[class="hl-string">'LastModifiedDate']).dt.tz_localize(None)
        df = df.rename(columns={class="hl-string">'OpportunityId': class="hl-string">'SalesOpportunity', class="hl-string">'Opportunity.Owner.Name': class="hl-string">'OpportunityOwner', class="hl-string">'Opportunity.StageName': class="hl-string">'StageName', class="hl-string">'Opportunity.Amount': class="hl-string">'Amount', class="hl-string">'Opportunity.IsWon': class="hl-string">'IsWon', class="hl-string">'Opportunity.Discount_Percentage__c': class="hl-string">'DiscountPercentage'})
        event_log_parts.append(df)

    class=class="hl-string">"hl-comment"># 14. Invoice Generated (using placeholder custom object Invoice__c)
    print(class="hl-string">"Extracting: Invoice Generated")
    query = fclass="hl-string">"SELECT CreatedDate, Opportunity__c, (SELECT Id, Owner.Name, StageName, Amount, IsWon, Discount_Percentage__c FROM Opportunity__r) FROM Invoice__c WHERE CreatedDate >= {start_date}T00:00:00Z AND CreatedDate <= {end_date}T23:59:59Z AND Opportunity__c != NULL"
    try:
        df = pd.DataFrame(sf.query_all(query)[class="hl-string">'records'])
        if not df.empty:
            df_opp = pd.json_normalize(df[class="hl-string">'Opportunity__r']).add_prefix(class="hl-string">'Opportunity.')
            df = pd.concat([df.drop(class="hl-string">'Opportunity__r', axis=1), df_opp], axis=1)
            df[class="hl-string">'ActivityName'] = class="hl-string">'Invoice Generated'
            df[class="hl-string">'EventTimestamp'] = pd.to_datetime(df[class="hl-string">'CreatedDate']).dt.tz_localize(None)
            df = df.rename(columns={class="hl-string">'Opportunity__c': class="hl-string">'SalesOpportunity', class="hl-string">'Opportunity.Owner.Name': class="hl-string">'OpportunityOwner', class="hl-string">'Opportunity.StageName': class="hl-string">'StageName', class="hl-string">'Opportunity.Amount': class="hl-string">'Amount', class="hl-string">'Opportunity.IsWon': class="hl-string">'IsWon', class="hl-string">'Opportunity.Discount_Percentage__c': class="hl-string">'DiscountPercentage'})
            event_log_parts.append(df)
    except Exception as e:
        print(class="hl-string">"Could not extract 'Invoice Generated'. Check if 'Invoice__c' object and 'Opportunity__c' field exist and are accessible.")

    class=class="hl-string">"hl-comment"># 15. Payment Received (using placeholder custom object Invoice__c status change)
    print(class="hl-string">"Extracting: Payment Received")
    query = fclass="hl-string">"SELECT LastModifiedDate, Status__c, Opportunity__c, (SELECT Id, Owner.Name, StageName, Amount, IsWon, Discount_Percentage__c FROM Opportunity__r) FROM Invoice__c WHERE LastModifiedDate >= {start_date}T00:00:00Z AND LastModifiedDate <= {end_date}T23:59:59Z AND Status__c = 'Paid' AND Opportunity__c != NULL"
    try:
        df = pd.DataFrame(sf.query_all(query)[class="hl-string">'records'])
        if not df.empty:
            df_opp = pd.json_normalize(df[class="hl-string">'Opportunity__r']).add_prefix(class="hl-string">'Opportunity.')
            df = pd.concat([df.drop(class="hl-string">'Opportunity__r', axis=1), df_opp], axis=1)
            df[class="hl-string">'ActivityName'] = class="hl-string">'Payment Received'
            df[class="hl-string">'EventTimestamp'] = pd.to_datetime(df[class="hl-string">'LastModifiedDate']).dt.tz_localize(None)
            df = df.rename(columns={class="hl-string">'Opportunity__c': class="hl-string">'SalesOpportunity', class="hl-string">'Opportunity.Owner.Name': class="hl-string">'OpportunityOwner', class="hl-string">'Opportunity.StageName': class="hl-string">'StageName', class="hl-string">'Opportunity.Amount': class="hl-string">'Amount', class="hl-string">'Opportunity.IsWon': class="hl-string">'IsWon', class="hl-string">'Opportunity.Discount_Percentage__c': class="hl-string">'DiscountPercentage'})
            event_log_parts.append(df)
    except Exception as e:
        print(class="hl-string">"Could not extract 'Payment Received'. Check if 'Invoice__c' object and relevant fields exist and are accessible.")

    class=class="hl-string">"hl-comment"># --- Finalize Event Log ---
    if not event_log_parts:
        print(class="hl-string">"No data extracted. The event log is empty.")
        return

    print(class="hl-string">"Concatenating and cleaning final event log...")
    final_event_log = pd.concat(event_log_parts, ignore_index=True)

    class=class="hl-string">"hl-comment"># Select and order final columns
    final_columns = [
        class="hl-string">'SalesOpportunity', class="hl-string">'ActivityName', class="hl-string">'EventTimestamp', 
        class="hl-string">'OpportunityOwner', class="hl-string">'StageName', class="hl-string">'Amount', class="hl-string">'IsWon', class="hl-string">'DiscountPercentage'
    ]
    class=class="hl-string">"hl-comment"># Add any missing columns with null values
    for col in final_columns:
        if col not in final_event_log.columns:
            final_event_log[col] = None
    
    final_event_log = final_event_log[final_columns]

    class=class="hl-string">"hl-comment"># Sort the event log
    final_event_log = final_event_log.sort_values(by=[class="hl-string">'SalesOpportunity', class="hl-string">'EventTimestamp'])

    class=class="hl-string">"hl-comment"># Save to CSV
    output_filename = class="hl-string">'sfdc_lead_to_cash_event_log.csv'
    final_event_log.to_csv(output_filename, index=False, date_format=class="hl-string">'%Y-%m-%d %H:%M:%S')
    print(fclass="hl-string">"Extraction complete. Event log saved to {output_filename}")

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

準備はできましたか？

このテンプレートを使ってデータ準備を効率化し、リードから入金までの業務におけるプロセスマイニングの効果を引き出してください。今日から効率化を始めましょう。

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

案件の失注を防ぐ：今すぐリードから入金までを最適化

Salesforceのリードから入金までを変革し、成約率を20％高めます。

無料トライアルを開始

クレジットカードは不要です

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

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

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

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

抽出ガイド

Salesforceレポートビルダーとデータエクスポートサービス

ステップ

設定

a サンプルクエリ sql

Salesforceオブジェクトクエリ言語（SOQL）を直接実行するクエリ

ステップ

設定

a サンプルクエリ sql

Salesforce RESTまたはBulk APIを使うPythonスクリプト

ステップ

設定

a サンプルクエリ python

準備はできましたか？

案件の失注を防ぐ：今すぐリードから入金までを最適化

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

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

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

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

抽出ガイド

Salesforceレポートビルダーとデータエクスポートサービス

ステップ

設定

a サンプルクエリ sql

Salesforceオブジェクトクエリ言語（SOQL）を直接実行するクエリ

ステップ

設定

a サンプルクエリ sql

Salesforce RESTまたはBulk APIを使うPythonスクリプト

ステップ

設定

a サンプルクエリ python

準備はできましたか？

案件の失注を防ぐ：今すぐリードから入金までを最適化

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