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

您的线索到收款数据模板

Salesforce Sales Cloud

← 返回改进指南

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

您的线索到收款数据模板

此模板为收集分析线索到收款流程所需的关键数据提供清晰指引，列出需要收集的主要属性和跟踪的关键活动，并说明如何从系统中提取这些信息。使用此模板，您可以高效准备数据，为流程挖掘分析做好准备。

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

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

下载模板

线索到收款属性

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

3 必填 5 建议填写 10 选填

	名称	说明
	开始时间 EventTimestamp	活动发生的准确日期和时间。
说明事件时间戳记录活动发生的准确时刻。它对于按时间顺序排列事件以及开展所有基于时间的流程分析至关重要。此属性是计算周期时间、持续时间和等待时间等所有绩效指标的基础。例如，“发票生成”与“收到付款”的时间戳之差，可用于计算“平均回款天数”KPI。准确的时间戳对于识别瓶颈和衡量流程效率至关重要。重要性此属性用于确定事件的先后顺序，是计算各类时长和绩效指标的基础。获取途径从Salesforce的多个日期字段提取，例如Opportunity对象的CreatedDate、Opportunity History中的LastModifiedDate，或Quote和Contract等相关对象中的特定日期字段。示例 2023-04-15T10:30:00Z2023-05-20T14:00:00Z2023-06-01T09:15:00Z
	活动 ActivityName	销售流程特定环节中发生的业务事件或活动名称。
说明活动名称用于描述订单到收款旅程中的具体步骤或里程碑，例如“销售机会已创建”“报价已发送”或“合同已签署”。这些活动根据Salesforce中关键字段的变更或相关记录的创建情况得出。分析这些活动的顺序，可以直观呈现流程、识别常见路径并发现偏离标准销售流程的情况。这是构建流程图以及计算不同步骤间周期时间等KPI的基础。重要性此属性定义流程图中的步骤，可用于呈现和分析从潜在客户到收款的销售旅程。获取途径通常综合多个数据源得出，包括Opportunity History对象（用于获取Stage等字段变更）、相关对象的创建日期（如Quote、Contract），以及特定的Task或Event记录。示例创建销售机会向客户展示报价销售机会赢单关闭生成发票
	销售机会 SalesOpportunity	每个销售机会的唯一标识符，是订单到收款流程的主要案例标识符。
说明销售机会是跟踪潜在交易从资格审核到成交的核心对象。每个销售机会都有唯一ID，可关联所有相关活动、沟通记录、报价和合同。在流程挖掘中，此ID对于还原每笔交易的端到端旅程至关重要。将销售机会用作案例ID后，我们可以分析完整生命周期、衡量各阶段之间的耗时、识别流程差异，并了解促成赢单或输单的因素。重要性这是关联所有流程步骤的基础标识符，可确保完整、准确地分析每笔交易的销售周期。获取途径这是Salesforce Sales Cloud中Opportunity对象的标准Id字段，例如Opportunity.Id。示例 0068c00001KvM7RAAV0068c00001LpA9BAAV0068c00001NqB3CAAV
	折扣百分比 DiscountPercentage	商机适用的折扣百分比。
说明此属性记录交易折扣，通常以总价的百分比表示。它是分析交易盈利能力和销售行为的重要因素。此指标是“商机折扣效果”仪表板和“赢单平均折扣”KPI的核心。销售负责人可以通过分析此属性，判断折扣是否有助于赢单，还是只会压缩利润空间，并比较不同地区或销售代表的折扣行为。重要性此属性对于分析盈利能力、评估定价策略效果以及识别过度折扣至关重要。获取途径这通常是Opportunity或Quote对象上的自定义货币或百分比字段。请查阅Salesforce Sales Cloud文档或咨询管理员。示例 0.050.100.15
	是否赢单 IsWon	用于标明销售机会赢单或输单的布尔值。
说明此属性以true或false表示销售机会的最终结果。如果销售机会阶段为“Closed Won”，则值为true；如果为“Closed Lost”，则值为false。 “是否赢单”是计算“销售机会赢单率”KPI的基础，也是衡量销售成效的关键指标之一。它还可用于细分分析，例如比较赢单与输单的流程路径，或计算“赢单平均折扣”。重要性此属性直接衡量销售机会的结果，可用于分析赢单和输单情况并计算赢单率。获取途径这是Opportunity对象中的标准IsWon字段，根据StageName计算得出。示例 truefalse
	销售机会负责人 OpportunityOwner	被指派负责销售机会的销售代表。
说明销售机会负责人是Salesforce中主要负责管理交易的用户，也是绩效分析的重要维度。按销售机会负责人分析数据，组织可以构建“销售代表绩效”仪表板，比较不同团队成员的周期时间、赢单率和平均交易金额，从而识别表现突出的员工和需要辅导的方面。重要性此属性对于分析销售团队绩效、比较个人业绩和识别辅导需求至关重要。获取途径这是Opportunity对象中的OwnerId字段，关联到User对象。示例约翰·史密斯玛丽亚·加西亚陈大卫
	销售机会金额 Amount	销售机会的预计总销售金额。
说明此属性记录潜在交易的金额，是财务和绩效分析中最重要的指标之一。销售机会金额几乎用于所有财务视图，包括计算销售管道总金额和平均交易金额，以及分析金额与折扣、周期时间等因素之间的关系。它也是“销售代表绩效”和“销售机会折扣效果”仪表板的重要组成部分。重要性此属性提供每笔交易的金额，是销售管道报告、收入预测和绩效分析的重要依据。获取途径这是Opportunity对象中的标准Amount字段。示例 50000125000.75250000
	销售阶段 StageName	销售机会在销售管道中的当前阶段，例如“Qualification”或“Negotiation”。
说明销售阶段表示销售机会在预定义销售流程中的推进情况。此字段的变更是流程中的关键事件，例如“进入提案阶段”。此属性是构建“销售管道瓶颈识别”和“每日销售漏斗运营视图”仪表板的基础，可用于分析销售机会在各阶段停留的时间、阶段间转化率以及销售管道的整体健康状况。重要性此属性跟踪销售机会在销售漏斗中的进展，支持瓶颈分析和销售管道管理。获取途径这是Opportunity对象中的标准StageName字段。示例潜在客户开发资格审核需求分析提案／报价谈判／审核
	合同ID ContractId	与商机关联合同的唯一标识符。
说明合同ID将商机与Salesforce中的正式合同记录关联起来，是交易收尾阶段的重要环节。此属性支持对合同签订阶段进行详细分析，可用于“报价到合同周期时间”和“合同合规与遵循情况”仪表板。您可以跟踪“发送合同以供签署”和“激活合同”等活动，并衡量其耗时及SLA达成情况。重要性此属性可用于精确跟踪合同管理子流程，包括周期时间和合规情况。获取途径此ID来自Contract对象的“Id”字段，该对象通常与Opportunity或Account相关联。示例 8008c000001LxD9AAK8008c000001MyE4AAK8008c000001NzF0AAK
	商机类型 Type	对商机进行分类，例如“新建业务”或“现有客户”。
说明商机类型是用于划分交易的标准分类字段，有助于了解获取新客户与向现有客户追加销售所涉及的不同销售流程或周期。在流程挖掘中，此属性可用于对比分析。例如，组织可以筛选流程图，查看“新建业务”的销售周期是否比“现有客户”续约更长或步骤更多，从而为战略决策和流程优化提供依据。重要性按类型划分商机，可以比较新业务与现有业务的销售流程、周期时间和成功率。获取途径这是Opportunity对象上的标准“Type”字段。示例新建业务现有客户-升级现有客户-续约增购业务
	地区 Region	商机所属的地理区域或销售辖区。
说明地区属性按地理位置划分商机，例如“北美”“欧洲、中东和非洲”或“亚太地区”。销售组织通常会据此划分团队并开展报告分析。此属性是“区域销售业绩对比”仪表板的关键维度。管理层可以比较各地区的流程表现，找出业绩较好地区的有效做法，以及其他地区需要改进之处。分析范围可包括周期时间、赢单率和折扣使用情况。重要性便于比较不同地理辖区的销售流程和业绩，识别各地区的优势与不足。获取途径这通常是Opportunity或Account对象上的自定义字段。请查阅Salesforce Sales Cloud文档或咨询管理员。示例北美欧洲、中东和非洲亚太地区拉丁美洲
	客户名称 AccountName	与商机关联的客户账户或公司名称。
说明客户名称将销售商机与特定客户关联起来，便于从客户角度分析销售流程。按客户分析流程，组织可以了解战略客户的销售周期，识别返工频繁或谈判周期较长的客户，并据此调整客户互动策略。客户名称也可作为筛选和逐级下钻流程数据的重要维度。重要性将销售流程与特定客户关联，便于按客户分析销售周期时间和互动模式。获取途径此值来自Opportunity对象上的“AccountId”查找字段，该字段引用Account对象的“Name”字段。示例 Global Tech Inc.Innovate Solutions LLCQuantum Industries
	报价ID QuoteId	与商机关联销售报价的唯一标识符。
说明报价ID用于标识针对某个商机向客户提供的具体报价。商机在整个生命周期中可能对应多个报价。跟踪报价ID对于分析销售流程中的报价环节至关重要。它有助于衡量“报价到合同周期时间”、了解报价修改（“修改报价”）的次数，并通过区分不同报价版本支持“报价返工频率”KPI的计算。重要性此属性有助于分析报价周期，包括修改次数以及从报价到接受报价所需的时间。获取途径此ID来自Quote对象的“Id”字段，该对象与Opportunity相关联。示例 0Q08c000001OxP1AAK0Q08c000001PyQ2AAK0Q08c000001QzR3AAK
	数据最近更新时间 LastDataUpdate	标明数据最近一次从源系统刷新时间的时间戳。
说明此属性显示最近一次从Salesforce Sales Cloud提取数据的日期和时间，帮助用户了解所分析数据的新旧程度。了解数据的最近更新时间对于正确解读分析结果至关重要，尤其是在查看“每日销售漏斗运营视图”等运营仪表板时。这样可以确保决策者了解数据的时效性。重要性此属性可告知用户数据的时效性，帮助他们了解流程分析反映的是当前情况还是较早状态。获取途径这是由数据管道或ETL工具在提取数据时生成的元数据属性。示例 2023-10-27T02:00:00Z2023-10-28T02:00:00Z
	是否返工 IsRework	用于标记某项活动是否属于返工或重复步骤的计算字段。
说明 “是否返工”是一个布尔标记。当流程返回到较早阶段时，该标记会设为true。例如，在“向客户展示报价”之后发生“修改报价”，就属于返工。此属性对于量化流程低效至关重要，可直接用于计算“订单处理错误率”和“报价返工频率”KPI。标记返工有助于定位需求不明确、沟通不畅或质量问题。重要性通过识别并标记返工循环中的活动，量化流程低效情况，帮助您确定改进重点。获取途径流程挖掘工具会分析活动顺序，检测流程中的回退，从而计算此标记。示例 truefalse
	源系统 SourceSystem	标识数据提取自哪个源系统。
说明此属性用于标明事件数据的来源系统。对于订单到收款流程，通常为“Salesforce Sales Cloud”。在集成多个系统的环境中，此字段对于追踪数据来源、排查问题以及确定不同流程步骤以哪个系统为准至关重要，有助于确保数据基础清晰可信。重要性此属性说明数据来源，对于数据治理、验证以及多系统环境中的数据管理至关重要。获取途径通常在数据提取和转换过程中添加静态值，用于标记数据集的来源。示例 Salesforce Sales CloudSFSC
	潜在客户来源 LeadSource	线索的来源，例如“网站”“合作伙伴”或“展会”。
说明线索来源用于记录产生初始线索的营销渠道或销售活动。了解这一信息有助于评估不同客户获取策略的效果。此属性是“线索转化效果分析”仪表板的主要分析维度。按线索来源分析转化率和交易金额，企业可以优化营销支出，并将资源集中在回报最高的渠道上。重要性将线索与其来源及后续转化情况关联起来，有助于评估各营销渠道的效果。获取途径这是Lead对象上的标准“LeadSource”字段，线索转化后通常会转移到Opportunity对象。示例网站电话咨询合作伙伴推荐购买的名单
	订单ID OrderId	赢单商机所生成销售订单的唯一标识符。
说明订单ID将销售商机与后续履约流程关联起来，是销售向运营交接的节点。此ID对于将流程分析从“商机赢单关闭”阶段延伸到订单管理至关重要。借助它，您可以跟踪“创建订单”和“订单履约”活动，并监控“订单履约错误率”。重要性它将流程中的销售环节与订单履约环节连接起来，从而支持真正端到端的线索到收款分析。获取途径此ID来自Order对象的“Id”字段，该对象通常与Opportunity相关联。示例 8018c000001IyA6AAK8018c000001JyB1AAK8018c000001KzC6AAK

必填建议填写选填

线索到收款活动

这些关键流程步骤和里程碑有助于准确发现流程并分析流程表现。

8 建议填写 8 选填

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

建议填写选填

数据提取指南

如何从Salesforce Sales Cloud获取数据

步骤

前置检查：字段历史跟踪：开始前，请与Salesforce管理员确认已为以下对象的关键字段启用字段历史跟踪：Opportunity（StageName、金额）、引用（Status）、Contract（Status）和订单（Status）。这对于准确记录流程变更至关重要。
进入Salesforce报表：登录Salesforce实例。使用应用程序启动器找到并打开“报表”选项卡。点击“新建报表”开始创建。
创建机会历史报表：此报表用于记录机会创建、阶段变更和关闭事件。选择“带字段历史的机会”报表类型，并添加以下列：Opportunity ID、Opportunity Name、Created Date、Field/Event、Old Value、New Value、Edit Date和Edit By。还需添加建议属性：Owner、金额、Is Won及适用的折扣字段。
创建潜在客户转化报表：使用“潜在客户”报表类型创建第二份报表。添加以下列：Lead ID、Converted Date、Converted Opportunity ID和Lead Owner。设置筛选条件，仅显示“Converted”为true的潜在客户。
创建引用事件报表：使用“引用”报表类型创建第三份报表，优先选择包含历史记录的类型（例如“带字段历史的引用”）。添加以下列：Quote ID、Opportunity ID、CreatedDate、LastModifiedDate和Status。此报表用于推导引用创建和状态变更事件。
创建其他报表（合同、订单、发票）：参照引用报表的做法，分别为合同、订单和发票创建报表（前提是Salesforce实例中使用了这些对象）。每份报表均应包含记录ID、关联的Opportunity ID、CreatedDate、LastModifiedDate和对象的Status字段。
运行并导出所有报表：为每份报表设置一致的日期范围筛选条件，例如“Opportunity Created Date”为最近6个月。运行报表，并使用“导出”功能将结果保存为CSV文件。
在电子表格中合并数据：使用Microsoft Excel等电子表格应用程序，将每个导出的CSV文件分别复制到同一工作簿的不同工作表中。
创建最终事件日志工作表：新建名为“事件日志”的工作表。设置必需表头：SalesOpportunity、ActivityName、EventTimestamp；以及建议表头：OpportunityOwner、StageName、金额、IsWon、DiscountPercentage。
转换并汇总数据：根据来源工作表中的数据，手动填充“事件日志”工作表。为每条来源记录在事件日志中创建对应行。例如，若机会历史工作表中的某行“New Value”为“Closed Won”，则在事件日志中新增一行，将ActivityName设为“机会已赢单”，并将EventTimestamp设为“Edit Date”。对所有来源文件中的16项必需活动重复此操作。
最终格式设置与导出：确保EventTimestamp列采用统一格式（例如YYYY-MM-DD HH:MI:SS）。每行的SalesOpportunity列都必须填写来源报表中的Opportunity ID。最后，将汇总后的“事件日志”工作表保存为CSV文件，以便上传。

配置

报表类型：主要需要使用“带字段历史的商机”报表类型。此外，还需要为线索、引用、合同、订单和发票创建报表。对于这些对象，若能使用包含历史记录的报表类型，数据准确性会显著提高。
字段历史跟踪：必须由Salesforce管理员预先配置。跟踪商机阶段、引用状态、合同状态和订单状态的变更离不开此功能。
权限：运行报表的用户需要拥有以下相关对象的读取权限：线索、客户、商机、OpportunityFieldHistory、引用、合同、订单，以及可能涉及的发票和付款对象。
日期范围筛选：所有报表都必须采用一致的日期范围筛选条件，以确保数据能够相互对应。建议将“商机创建日期”设为最近3至6个月，以控制数据量。
数据量：对于商机和活动数量很大的组织，报表生成器可能运行缓慢或达到导出上限（通常约为100,000行，具体取决于版本）。此时，每周运行一次的数据导出服务是获取原始数据的更可靠选择。

查询示例 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、引用、Contract、订单、发票对象及其对应的Field History对象。必须为这些对象的关键字段（如StageName、Status）启用字段历史跟踪。
选择执行工具：此查询使用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实例，可先选择较短范围（例如一个月），测试性能和治理限制。
自定义字段和状态：查询使用了自定义字段（例如[Your_Discount_Field__c]）和自定义状态值（例如[Quote_Presented_Status]）占位符。您必须从Salesforce配置中确认正确的API名称和值，并据此更新查询。
对象可用性：查询假设使用标准Contract和Order对象，以及Invoice对象（常见于Salesforce Billing）。如果您的组织未使用这些对象，或使用其他计费软件包，相关查询部分将失败或不返回数据，应将其删除或调整。

查询示例 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账户。依次进入“设置”、“应用”和“应用管理器”，创建新的“已连接应用”。为该应用启用OAuth设置，并授予“访问和管理您的数据（api）”范围。保存后，您会获得“使用者密钥”和“使用者密钥”。此外，请确保脚本使用的用户账户拥有安全令牌。您可以在个人设置中的“重置我的安全令牌”下生成或重置令牌。
设置Python脚本：将查询部分提供的完整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文件即为最终事件日志，可上传到流程挖掘工具。

配置

前提条件：需要使用Salesforce企业版、无限版或开发者版账户（这些版本支持API访问）。Salesforce用户资料必须拥有“已启用API”权限，并可读取以下对象：线索、商机、OpportunityFieldHistory、引用、合同和订单。开票或付款所用的自定义对象也需要读取权限。
身份验证：脚本使用用户名、密码和安全令牌进行身份验证。为提高生产环境的安全性，可考虑使用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）或自定义关系（例如合同到商机的查找关系）。您必须调整脚本中的SOQL查询，以匹配Salesforce的具体配置。

查询示例 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报表生成器和数据导出服务

步骤

配置

查询示例 sql

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

步骤

配置

查询示例 sql

使用Salesforce REST API或Bulk API的Python脚本

步骤

配置

查询示例 python

准备好开始了吗？

减少交易流失：立即优化线索到收款流程