> 持续流程改进 > 线索到收款 > Salesforce Sales Cloud > 数据模板

您的Lead to Cash数据模板

Salesforce Sales Cloud

← 返回改进指南

线索到收款属性 (18) 线索到收款活动 (16) 提取指南 (3)

您的Lead to Cash数据模板

该模板为收集Lead to Cash流程分析所需的关键数据提供清晰路径，列出需要采集的主要属性和跟踪的关键活动，并提供从系统中提取这些信息的实用指导。借助该模板，您可以高效准备数据，获得流程挖掘带来的深度洞察。

建议采集的属性
需要跟踪的关键活动
Salesforce Sales Cloud数据提取指南

刚接触事件日志？了解如何创建流程挖掘事件日志.

下载模板

线索到收款属性

这些数据字段对于创建完整的事件日志至关重要，可支持对您的线索到收款流程进行详细分析。

3 必需 5 建议 10 可选

	名称	说明
	开始时间 EventTimestamp	活动发生的准确日期和时间。
说明 Event Timestamp记录活动发生的准确时刻。该时间戳对于按时间顺序排列事件以及开展所有基于时间的流程分析至关重要。此属性是计算周期时间、持续时间和等待时间等所有绩效指标的基础。例如，“Invoice Generated”和“Payment Received”时间戳之差，可为“Average Days to Payment”KPI提供数据。准确的时间戳对于识别瓶颈和衡量流程效率至关重要。为什么重要此属性提供事件的时间顺序，是所有时长和绩效计算的基础。获取位置从Salesforce的多个日期字段提取，例如Opportunity对象的CreatedDate、Opportunity History中的LastModifiedDate，或Quote和Contract等相关对象中的特定日期字段。示例 2023-04-15T10:30:00Z2023-05-20T14:00:00Z2023-06-01T09:15:00Z
	活动 ActivityName	销售流程中特定时间点发生的业务事件或活动名称。
说明活动名称用于描述订单到收款过程中的具体步骤或里程碑，例如“Opportunity Created”“Quote Sent”或“Contract Signed”。这些活动源自Salesforce中关键字段的变更或相关记录的创建。分析这些活动的顺序，可以将流程顺序可视化，识别常见路径，并发现偏离标准销售流程的情况。这是构建流程图以及计算不同步骤之间周期时间等KPI的基础。为什么重要它定义流程图中的步骤，用于呈现和分析从潜在客户到回款的销售旅程。获取位置通常由多个数据源组合生成，包括Opportunity History对象中的字段变更记录（如Stage）、相关对象的创建日期（如Quote、Contract），以及特定的Task或Event记录。示例商机创建向客户提交报价商机赢单关闭发票生成
	销售商机 SalesOpportunity	每个销售商机的唯一标识符，是Lead to Cash流程的主要案例标识符。
说明 Sales Opportunity是跟踪潜在交易从资格审查到关闭的核心对象。每个商机都有唯一ID，用于关联所有相关活动、沟通记录、报价和合同。在流程挖掘中，该ID对于重建每笔交易的端到端旅程至关重要。将Sales Opportunity用作Case ID后，我们可以分析完整生命周期，衡量各阶段之间的时长，识别流程差异，并了解促成交易成功或失败的因素。为什么重要这是连接所有流程步骤的基础标识符，可对每笔交易的销售周期进行完整、准确的分析。获取位置这是Salesforce Sales Cloud中Opportunity对象的标准“Id”字段，例如Opportunity.Id。示例 0068c00001KvM7RAAV0068c00001LpA9BAAV0068c00001NqB3CAAV
	商机负责人 OpportunityOwner	负责该销售商机的销售代表。
说明 Opportunity Owner是Salesforce中主要负责管理交易的用户，也是绩效分析的重要维度。通过按Opportunity Owner分析数据，组织可以构建“Sales Representative Performance”仪表板，比较不同团队成员的周期时间、赢单率和平均交易金额，识别高绩效人员及辅导机会。为什么重要此属性对于分析销售团队绩效、比较个人结果和识别辅导需求至关重要。获取位置这是Opportunity对象中的“OwnerId”字段，用于关联User对象。示例 John SmithMaria GarciaDavid Chen
	商机金额 Amount	商机预计总销售金额。
说明此属性记录潜在交易的货币价值，是财务和绩效分析中最重要的指标之一。 Opportunity Amount几乎用于所有财务视图，包括计算管道总价值和平均交易金额，以及分析金额与折扣、周期时间等因素的关联。它是“Sales Representative Performance”和“Opportunity Discount Effectiveness”仪表板的重要组成部分。为什么重要它提供每笔交易的财务价值，是管道报告、收入预测和绩效分析的基础。获取位置这是Opportunity对象中的标准“Amount”字段。示例 50000125000.75250000
	折扣百分比 DiscountPercentage	应用于商机的折扣百分比。
说明该属性记录交易折扣，通常以总价的百分比表示，是了解交易盈利能力和销售行为的关键因素。该指标是“Opportunity Discount Effectiveness”仪表板和“Average Discount on Won Deals”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
	销售阶段 StageName	商机在销售管道中的当前阶段，例如“Qualification”或“Negotiation”。
说明 Sales Stage表示商机在预定义销售流程中的推进情况。该字段的变化是流程中的关键事件，例如“Proposal Stage Reached”。此属性是构建“Sales Pipeline Bottleneck Identification”和“Daily Sales Funnel Operational View”仪表板的基础，可用于分析商机在各阶段停留的时间、阶段间转化率以及销售管道的整体健康状况。为什么重要它跟踪商机在销售漏斗中的推进情况，支持瓶颈分析和管道管理。获取位置这是Opportunity对象中的标准“StageName”字段。示例潜在客户开发资格审查需求分析Proposal/Price Quote谈判／评审
	最近数据更新时间 LastDataUpdate	表示数据最近一次从源系统刷新时间的时间戳。
说明此属性显示最近一次从Salesforce Sales Cloud提取数据的日期和时间，帮助用户了解所分析数据的新鲜度。了解数据最近更新时间对于正确解读分析结果至关重要，尤其适用于“Daily Sales Funnel Operational View”等运营仪表板。这有助于确保决策建立在对数据时效性的准确理解之上。为什么重要告知用户数据的时效性，确保用户了解当前流程分析所依据的数据有多新。获取位置这是数据管道或ETL工具在提取数据时生成的元数据属性。示例 2023-10-27T02:00:00Z2023-10-28T02:00:00Z
	区域 Region	商机所属的地理区域或销售区域。
说明 Region属性根据地理位置对商机进行细分，例如“North America”、“EMEA”或“APAC”。销售组织通常会据此搭建团队和报表体系。该属性是“Regional Sales Performance Comparison”仪表板的关键分析维度，支持管理层比较不同地区的流程表现，识别高绩效地区的最佳实践以及其他地区需要改进的方面。分析内容可包括周期时间、赢单率和折扣使用情况。为什么重要支持比较不同地理区域的销售流程和绩效，识别各地区的优势与不足。获取位置这通常是Opportunity或Account对象中的自定义字段。请参阅Salesforce Sales Cloud文档或咨询管理员。示例北美EMEAAPACLATAM
	合同ID ContractId	与商机关联的合同唯一标识符。
说明 Contract ID将商机关联至Salesforce中的正式合同记录，是交易完成阶段的关键步骤。该属性支持对合同阶段进行详细分析，为“Quote to Contract Cycle Time”和“Contract Compliance and Adherence”仪表板提供数据。它支持跟踪“Contract Sent for Signature”和“Contract Activated”等活动，并衡量其持续时间及SLA遵循情况。为什么重要支持精确跟踪合同管理子流程，包括周期时间和合规情况。获取位置该ID来自Contract对象的“Id”字段，通常与Opportunity或Account相关联。示例 8008c000001LxD9AAK8008c000001MyE4AAK8008c000001NzF0AAK
	报价ID QuoteId	与商机关联的销售报价唯一标识符。
说明 Quote ID用于识别针对某个商机向客户提供的具体报价。一个商机在其生命周期内可能对应多个报价。跟踪Quote ID对于分析销售流程中的报价环节至关重要。它有助于衡量“Quote to Contract Cycle Time”、了解报价修改“Quote Modified”的次数，并通过区分不同报价版本支持“Quote Rework Frequency”KPI。为什么重要该属性支持分析报价周期，包括修改次数以及从报价到接受的时间。获取位置该ID来自Quote对象的“Id”字段，该对象与Opportunity相关联。示例 0Q08c000001OxP1AAK0Q08c000001PyQ2AAK0Q08c000001QzR3AAK
	是否返工 IsRework	用于标识某项活动是否代表返工或重复步骤的计算标记。
说明 Is Rework是一个布尔标记，当流程回到较早阶段时设为true。例如，在“Quote Presented to Customer”之后发生“Quote Modified”，则视为返工。该属性对于量化流程低效至关重要，直接支持“Order Processing Error Rate”和“Quote Rework Frequency”KPI的计算。突出显示返工，有助于定位需求不清、沟通问题或质量问题。为什么重要通过识别并标记返工循环中的活动，量化流程低效，帮助确定改进重点。获取位置流程挖掘工具通过分析活动顺序并检测流程中的回退，计算得出该标记。示例 truefalse
	机会类型 Type	对商机进行分类，例如“New Business”或“Existing Customer”。
说明 Opportunity Type是用于细分交易的标准分类字段，有助于了解获取新客户与向现有客户追加销售时所采用的不同销售流程或周期。在流程挖掘中，该属性支持对比分析。例如，企业可以筛选流程图，比较“New Business”的销售周期是否比“Existing Customer”续约更长、步骤更多，从而为战略决策和流程优化提供依据。为什么重要按类型细分商机，可以比较新业务与现有业务在销售流程、周期时间和成功率方面的差异。获取位置这是Opportunity对象中的标准“Type”字段。示例新业务现有客户，升级现有客户，续约增购业务
	源系统 SourceSystem	标识提取数据的源系统。
说明此属性指定事件数据来源的记录系统。对于Lead to Cash流程，通常为“Salesforce Sales Cloud”。在多个系统集成的环境中，该字段对于数据血缘、问题排查以及明确不同流程步骤的权威系统至关重要，有助于确保数据基础清晰可信。为什么重要它提供数据来源的背景信息，对于数据治理、验证以及多系统环境中的数据管理至关重要。获取位置通常是在数据提取和转换过程中添加的静态值，用于标记数据集来源。示例 Salesforce Sales CloudSFSC
	潜在客户来源 LeadSource	线索来源渠道，例如“Web”、“Partner”或“Trade Show”。
说明 Lead Source用于记录产生初始线索的营销渠道或销售活动。这些信息对于了解不同客户获取策略的效果至关重要。该属性是“Lead Conversion Performance Analysis”仪表板的主要分析维度。按线索来源分析转化率和交易金额，有助于企业优化营销投入，聚焦利润最高的渠道。为什么重要通过将线索与其来源及后续成功率关联，帮助判断各营销渠道的效果。获取位置这是Lead对象中的标准“LeadSource”字段，通常会在转化后传递至Opportunity对象。示例网站电话咨询合作伙伴推荐购买的名单
	订单ID OrderId	由赢单商机创建的销售订单唯一标识符。
说明 Order ID将销售商机关联至后续履约流程，是销售向运营交接的节点。该ID对于将流程分析从“Opportunity Closed Won”阶段延伸至订单管理至关重要。它支持跟踪“Order Created”和“Order Fulfilled”活动，也是监控“Order Fulfillment Error Rate”所必需的数据。为什么重要它将流程中的销售环节与订单履约环节连接起来，支持真正端到端的Lead to Cash分析。获取位置该ID来自Order对象的“Id”字段，通常与Opportunity相关联。示例 8018c000001IyA6AAK8018c000001JyB1AAK8018c000001KzC6AAK
	账户名称 AccountName	与商机关联的客户账户或公司名称。
说明 Account Name将销售商机关联至特定客户，从而支持以客户为中心的销售流程分析。按客户分析流程，可以了解战略客户的销售周期，识别频繁返工或谈判阶段过长的客户，并制定针对性的客户互动策略。该属性还可用于筛选和深入分析流程数据。为什么重要将销售流程关联至特定客户，支持在客户层面分析销售周期时间和互动模式。获取位置该字段源自Opportunity对象中的“AccountId”查找字段，该字段引用Account对象的“Name”字段。示例 Global Tech Inc.Innovate Solutions LLCQuantum Industries

必需建议可选

线索到收款活动

以下是需要跟踪的关键流程步骤和里程碑，可用于准确发现流程并分析绩效。

8 建议 8 可选

	活动	说明
	合同生效	此活动表示合同已由所有相关方正式签署并完成执行，具备法律效力。通常通过将Contract对象的状态变更为“Activated”来记录。
为什么重要这是与客户达成法律协议的最终确认，也是收入确认和合规管理的重要里程碑。此处延误可能直接影响财务预测。获取位置根据Contract对象的Status字段变为“Activated”推断。该变更时间通过字段历史跟踪获取。采集识别Contract对象的Status字段设置为“Activated”的时间戳。事件类型 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
	客户接受报价	此活动标志着客户同意报价条款和价格。通常由用户将Quote的状态更新为“Accepted”来记录。
为什么重要这是重要的购买信号，也是生成合同前的主要里程碑。从报价提交到接受之间的时间，是衡量销售周期阻力的关键指标。获取位置根据Quote对象的Status字段变为“Accepted”推断。该变更的时间戳来自字段历史跟踪。采集识别Quote的Status字段变为“Accepted”的时间戳。事件类型 inferred
	报价创建	表示为客户生成正式报价文件。当创建新的Quote记录并将其关联到Opportunity时，系统会记录此活动。
为什么重要创建报价是促成交易成交的重要步骤。分析报价数量及其创建耗时，有助于评估销售团队效率和交易推进情况。获取位置从Quote对象的CreatedDate系统字段获取。Quote对象通过查找关系关联其父级Opportunity。采集使用与Opportunity关联的Quote对象中的CreatedDate。事件类型 explicit
	收到付款	此活动确认已收到客户付款，并已将其核销到发票。通常可根据发票状态变为“Paid”或创建Payment记录推断。
为什么重要这是Lead to Cash流程的最后一个活动，代表收入实现。从开票到收款的时长是关键现金流KPI。获取位置根据Invoice对象的状态变为“Paid”，或创建与发票关联的Payment对象推断。这些数据通常来自外部财务系统。采集识别Invoice的Status变为“Paid”的时间，或相关Payment记录创建的时间。事件类型 inferred
	潜在客户转化为商机	此活动标志着合格潜在客户转化为销售商机，并同时关联相应的客户和联系人。通常，这是销售代表在Salesforce中执行的明确操作。
为什么重要这是从营销或潜在客户开发团队向销售团队交接的关键环节。分析从此环节开始的耗时和转化率，有助于评估潜在客户质量及初始销售流程的效率。获取位置当Lead对象的IsConverted字段为true且ConvertedOpportunityId字段已填充时，即可识别此事件。时间戳为ConvertedDate。采集用户转换Lead记录时记录此事件，并填充ConvertedDate和ConvertedOpportunityId字段。事件类型 explicit
	发票生成	表示为已交付的商品或服务创建客户发票。可以通过创建Invoice记录来获取，该记录可能位于Salesforce Billing或集成的外部系统中。
为什么重要此活动启动Lead to Cash周期中的财务环节。开票速度和准确性会直接影响现金流。获取位置需要Salesforce Billing或类似软件包。从Invoice对象的CreatedDate字段获取，该对象与Order或Account关联。采集如有Invoice对象，则使用其CreatedDate。事件类型 explicit
	合同发送签署	表示正式合同已生成并发送给客户签署。通常可根据Contract对象的状态变化推断，例如变为“Sent”或“Out for Signature”。
为什么重要此活动启动交易成交前最后的法律和行政阶段。跟踪该活动有助于监控合同管理流程的效率。获取位置根据Contract对象的状态变化推断。Contract与Opportunity关联，并要求跟踪Contract的Status字段历史。采集识别Contract的Status字段变为“Sent for Signature”等值的时间戳。事件类型 inferred
	向客户提交报价	此事件表示报价已发送给客户或已正式提交客户审核。通常可根据Quote记录的状态变化推断，例如从“Draft”变为“Presented”或“In Review”。
为什么重要此活动启动客户谈判和审批周期。跟踪该活动有助于衡量客户响应时间，并识别报价接受阶段的延误。获取位置根据Quote对象Status字段的变化推断。需要跟踪该字段历史，才能获取具体变更时间戳。采集识别Quote的Status字段变为“Presented”“Sent”或类似值的时间戳。事件类型 inferred
	商机阶段变更	此活动记录商机销售阶段的任何变化，例如从“Qualification”转为“Needs Analysis”。这些变化会记录在系统字段历史中，形成商机推进轨迹。
为什么重要跟踪阶段变化对于了解销售管道推进速度、识别交易停滞的瓶颈以及分析流程合规性至关重要。获取位置从OpportunityFieldHistory对象推断，该对象跟踪Opportunity对象中StageName字段的变化。每条记录都包含时间戳以及变更前后的值。采集从OpportunityFieldHistory表中提取StageName字段的变更事件。事件类型 inferred
	报价修改	表示对现有报价进行更新或修订，通常发生在客户反馈或谈判之后。通过跟踪Quote记录创建后关键字段的修改来记录此活动。
为什么重要频繁修改报价可能表明流程低效、沟通存在缺口或谈判周期过长。分析这一返工循环是缩短报价到合同阶段的关键。获取位置根据Quote对象的LastModifiedDate字段推断，或更细致地通过TotalPrice等字段或明细项的历史跟踪获取。采集比较Quote对象的LastModifiedDate和CreatedDate，或使用Quote字段历史跟踪。事件类型 inferred
	订单创建	此活动标志着销售订单的创建，交易赢单后正式启动履约流程。当创建新的Order记录并将其关联到Opportunity或Account时，系统会记录此活动。
为什么重要这是从销售流程向订单履约和运营团队的正式交接。该环节的效率对于按时交付和客户满意度至关重要。获取位置从Order对象的CreatedDate系统字段获取。Order通常与Account和／或发起该订单的Opportunity关联。采集使用与Opportunity的Account相关联的Order对象中的CreatedDate。事件类型 explicit
	订单履约完成	表示订单中的产品或服务已交付给客户。通常可根据Order对象的状态变为“Fulfilled”或“Completed”等终态值推断。
为什么重要此里程碑标志着对客户交付承诺的完成。从订单创建到履约完成的时间，是衡量运营效率和客户满意度的关键指标。获取位置根据Order对象的Status字段变为完成状态推断。需要字段历史跟踪才能获取事件时间戳。采集识别Order的Status变为“Fulfilled”或“Completed”的时间戳。事件类型 inferred
	进入提案阶段	标志着商机进入“Proposal/Price Quote”阶段这一具体里程碑。该事件根据Opportunity的StageName字段历史记录推断。
为什么重要这是一个关键里程碑，表示潜在解决方案已经确定，可以进行定价和展示。该节点对于分析方案设计和报价所需时间至关重要。获取位置从OpportunityFieldHistory对象推断，具体识别StageName字段更新为“Proposal/Price Quote”或类似自定义阶段值的时间戳。采集筛选OpportunityFieldHistory中Field为StageName且NewValue为提案阶段的记录。事件类型 inferred

建议可选

提取指南

如何从Salesforce Sales Cloud获取数据

步骤

前提检查：Field History Tracking：开始前，请与Salesforce管理员确认，以下对象的关键字段已启用Field History Tracking：Opportunity（StageName、金额）、Quote（Status）、Contract（Status）和Order（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”报告类型创建第二份报告。添加以下列：Lead ID、Converted Date、Converted Opportunity ID和Lead Owner。添加筛选条件，仅显示“Converted”为true的Lead。
创建Quote事件报告：使用“Quotes”报告类型创建第三份报告，最好选择包含历史记录的类型，例如“Quotes with Field History”。添加以下列：Quote ID、Opportunity ID、CreatedDate、LastModifiedDate和Status。该报告用于推导Quote的创建和状态变更。
创建其他报告（Contracts、Orders、Invoices）：按照Quote报告的模式，在Salesforce实例使用这些对象时，分别创建Contracts、Orders和Invoices报告。每份报告都应包含记录ID、关联的Opportunity ID、CreatedDate、LastModifiedDate以及对象的Status字段。
运行并导出所有报告：为每份报告设置一致的日期范围筛选条件，例如“Opportunity Created Date”为最近6个月。运行报告，并使用“Export”功能将结果保存为CSV文件。
在电子表格中合并数据：打开Microsoft Excel等电子表格应用。将每个导出CSV文件中的数据复制到同一工作簿的独立工作表中。
创建最终事件日志工作表：新建名为“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个月的数据，以控制数据量。
数据量：对于商机和活动数量很大的组织，报表生成器可能运行缓慢或达到导出限制（通常约为100,000行，具体取决于版本）。此时，使用每周数据导出服务获取原始数据会更加稳妥。

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访问权限的Salesforce用户账户，并有足够权限读取Opportunity、Lead、Quote、Contract、Order、Invoice对象及其对应的Field History对象。必须为这些对象的关键字段（例如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名称。
执行查询：运行完整查询。根据数据量和所用工具，处理可能需要数分钟。
检查结果：查询完成后，检查返回的数据集，确认其中包含所有不同活动的记录，且各列均已按预期填充。
处理潜在错误：如果查询失败，请检查替换后的占位符名称是否存在拼写错误。确保用户拥有所有查询字段的字段级安全访问权限。如果日期范围过大，查询还可能超时或触及治理限制；请尝试缩短日期范围，例如改为单个季度。
导出数据：将最终结果集导出为CSV文件。
准备上传：确保CSV文件表头与所需属性一致：SalesOpportunity、ActivityName、EventTimestamp、OpportunityOwner、StageName、金额、IsWon和DiscountPercentage。现在可以将该文件上传到流程挖掘工具。

配置

字段历史跟踪：该提取流程依赖于为Opportunity（StageName）、Quote（Status）、Contract（Status）和Order（Status）对象启用字段历史跟踪。未启用时，将无法捕获状态和阶段变更活动。
用户权限：执行查询的用户必须拥有API访问权限，并有权读取查询中的所有对象：Lead、Opportunity、OpportunityFieldHistory、Quote、QuoteHistory、Contract、ContractHistory、Order、OrderHistory、Invoice和InvoiceHistory。
日期范围：必须使用'YYYY-MM-DDThh:mm:ssZ'占位符定义明确的日期范围。首次分析建议选择3至6个月，以平衡数据量和性能。对于规模很大的Salesforce实例，建议先使用较短范围（例如1个月）测试性能和治理限制。
自定义字段和状态：查询使用了自定义字段（例如[Your_Discount_Field__c]）和自定义状态值（例如[Quote_Presented_Status]）占位符。您必须根据Salesforce配置确认正确的API名称和值，并相应更新查询。
对象可用性：该查询假设使用标准Contract和Order对象，以及Invoice对象（Salesforce Billing中常见）。如果您的组织未使用这些对象，或采用其他计费软件包，查询中的相关部分将失败或返回空数据，应将其删除或调整。

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设置，并授予“Access and manage your data (api)”范围。保存后，您将获得“Consumer Key”和“Consumer Secret”。同时，确保脚本使用的用户账户拥有Security Token。您可以在个人设置中的“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对象查询语言（SOQL）查询。每个查询针对特定对象（例如Opportunity、OpportunityFieldHistory和Quote），用于捕获一项独立的业务活动。
汇总数据：每个查询的结果都会转换为名为pandas DataFrame的结构化格式。这些分别代表不同活动的DataFrame随后会汇总到一个列表中。
转换和格式化：脚本将所有DataFrame合并为一个完整的事件日志，将列名重命名为流程挖掘所需的架构（SalesOpportunity、ActivityName、EventTimestamp等），并确保数据类型正确。
执行脚本：在终端中运行以下命令：python extract_lead_to_cash.py。脚本将连接Salesforce、运行查询并处理数据。
获取事件日志：成功完成后，脚本会在同一目录下生成名为sfdc_lead_to_cash_event_log.csv的文件。该CSV文件就是格式化完成、可上传至流程挖掘工具的最终事件日志。

配置

前置条件：Enterprise、Unlimited或Developer Edition版本的Salesforce账户（这些版本支持API访问）。Salesforce用户配置文件必须拥有“API Enabled”权限，并对以下对象拥有读取权限：Lead、Opportunity、OpportunityFieldHistory、Quote、Contract和Order。任何用于开票或付款的自定义对象也需要读取权限。
身份验证：脚本使用用户名、密码和安全令牌进行身份验证。为提升生产环境的安全性，可考虑实施OAuth 2.0 JWT Bearer Flow，simple-salesforce同样支持该方式。
日期范围：脚本中的start_date和end_date变量控制提取时间范围。首次分析建议选择3至6个月，以获得足够数据，同时避免数据量过大。日期筛选会应用于每项活动的主要时间戳字段，例如CreatedDate或ConvertedDate。
API使用量：该脚本会执行多个独立查询。每个查询及后续获取全部结果都会消耗API调用次数，并计入组织的每日限额。在包含许多其他集成的环境中，请特别注意限额。若要提取数百万条记录，应调整脚本以使用Salesforce Bulk API。
自定义配置：脚本尽可能使用标准对象和字段名称。您的组织可能使用自定义字段（例如Discount_Percentage__c）、自定义对象（例如Invoice__c、Payment__c）或自定义关系（例如Contract到Opportunity的查找关系）。您必须调整脚本中的SOQL查询，使其符合具体的Salesforce配置。

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()

准备好开始了吗？

使用该模板简化数据准备，充分发挥流程挖掘在Lead to Cash运营中的价值。立即开始提升效率。

返回改进指南下载模板

不再错失交易：立即优化Lead to Cash

重塑您的Salesforce Lead to Cash流程，将赢单率提升20%。

开始免费试用

无需信用卡

您的Lead to Cash数据模板

您的Lead to Cash数据模板

线索到收款属性

线索到收款活动

提取指南

Salesforce报表生成器和数据导出服务

步骤

配置

a 示例查询 sql

直接使用Salesforce对象查询语言（SOQL）查询

步骤

配置

a 示例查询 sql

使用Salesforce REST或Bulk API的Python脚本

步骤

配置

a 示例查询 python

准备好开始了吗？

不再错失交易：立即优化Lead to Cash

您的Lead to Cash数据模板

您的Lead to Cash数据模板

线索到收款属性

线索到收款活动

提取指南

Salesforce报表生成器和数据导出服务

步骤

配置

a 示例查询 sql

直接使用Salesforce对象查询语言（SOQL）查询

步骤

配置

a 示例查询 sql

使用Salesforce REST或Bulk API的Python脚本

步骤

配置

a 示例查询 python

准备好开始了吗？

不再错失交易：立即优化Lead to Cash

我们重视您的隐私