> Miglioramento continuo dei processi > Lead to Cash > Salesforce Sales Cloud > Template dei dati

Il Suo Template dei dati Lead to Cash

Salesforce Sales Cloud

Attributi Lead to Cash (18) Attività Lead to Cash (16) Guide all’estrazione (3)

Il Suo Template dei dati Lead to Cash

Questo Template offre una roadmap chiara per raccogliere i dati essenziali necessari ad analizzare il processo Lead to Cash. Indica gli attributi principali da raccogliere, le attività critiche da monitorare e fornisce indicazioni pratiche per estrarre queste informazioni dal Suo sistema. Con questo Template, può preparare i dati in modo efficiente e ottenere insight di Process Mining più approfonditi.

Attributi consigliati da raccogliere
Attività principali da monitorare
Indicazioni per l’estrazione da Salesforce Sales Cloud

Non conosce ancora gli Event Log? Scopra come creare un Event Log per il Process Mining.

Scarica il Template

Attributi Lead to Cash

Questi campi dati sono essenziali per creare un Event Log completo e consentire un’analisi dettagliata del processo Lead to Cash.

3 Obbligatorio 5 Consigliato 10 Facoltativo

	Nome	Descrizione
	Attività ActivityName	Il nome dell'evento o dell'attività aziendale che si è verificato in un determinato momento del processo di vendita.
Descrizione Activity Name descrive una fase o una tappa specifica del percorso Lead to Cash, come 'Opportunity Created', 'Quote Sent' o 'Contract Signed'. Questi valori derivano dalle modifiche ai campi chiave o dalla creazione di record correlati in Salesforce. Analizzare la sequenza di queste attività consente di visualizzare il flusso del processo, individuare i percorsi più comuni e rilevare le deviazioni dal processo di vendita standard. È fondamentale per creare mappe di processo e calcolare KPI come i tempi di ciclo tra le diverse fasi. Perché è importante Definisce le fasi della mappa di processo, consentendo di visualizzare e analizzare il percorso di vendita dal lead all'incasso. Dove reperirlo In genere deriva dalla combinazione di diverse fonti di dati, tra cui l'oggetto Opportunity History, per le modifiche ai campi come Stage, le date di creazione degli oggetti correlati, ad esempio Quote e Contract, e specifici record Task o Event. Esempi Opportunity creataQuote presentata al clienteOpportunity chiusa con esito positivoFattura generata
	Opportunità di vendita SalesOpportunity	L'identificativo univoco di ogni opportunità di vendita, utilizzato come identificativo principale del caso per il processo Lead to Cash.
Descrizione La Sales Opportunity è l'oggetto centrale che monitora una potenziale trattativa dalla qualificazione alla chiusura. Ogni opportunità dispone di un ID univoco che collega tutte le attività, comunicazioni, Quote e Contract correlati. Nel Process Mining, questo ID è essenziale per ricostruire il percorso end-to-end di ogni trattativa. Utilizzando la Sales Opportunity come Case ID, è possibile analizzare l'intero ciclo di vita, misurare la durata tra gli stage, individuare le variazioni del processo e comprendere i fattori che portano alla vittoria o alla perdita delle trattative. Perché è importante È l'identificativo fondamentale che collega tutte le fasi del processo, consentendo un'analisi completa e accurata del ciclo di vendita di ogni trattativa. Dove reperirlo È il campo standard 'Id' dell'oggetto Opportunity in Salesforce Sales Cloud, ad esempio Opportunity.Id. Esempi 0068c00001KvM7RAAV0068c00001LpA9BAAV0068c00001NqB3CAAV
	Ora di inizio EventTimestamp	La data e l'ora precise in cui si è verificata l'attività.
Descrizione Event Timestamp registra il momento esatto in cui si è verificata un'attività. Questo timestamp è fondamentale per ordinare cronologicamente gli eventi e per tutte le analisi di processo basate sul tempo. Questo attributo costituisce la base per calcolare tutte le metriche di performance, come tempi di ciclo, durate e tempi di attesa. Ad esempio, la differenza tra i timestamp di 'Invoice Generated' e 'Payment Received' fornisce i dati per il KPI 'Average Days to Payment'. Timestamp accurati sono essenziali per individuare i colli di bottiglia e misurare l'efficienza del processo. Perché è importante Questo attributo fornisce l'ordine cronologico degli eventi ed è essenziale per tutti i calcoli di durata e performance. Dove reperirlo Viene estratto da diversi campi data di Salesforce, come 'CreatedDate' sull'oggetto Opportunity, 'LastModifiedDate' da Opportunity History o specifici campi data sugli oggetti correlati, come Quote e Contract. Esempi 2023-04-15T10:30:00Z2023-05-20T14:00:00Z2023-06-01T09:15:00Z
	Importo dell'Opportunity Amount	L'importo totale stimato della vendita associata all'opportunità.
Descrizione Questo attributo registra il valore monetario di una potenziale trattativa. È una delle metriche più importanti per l'analisi finanziaria e delle performance. L'importo dell'Opportunity viene utilizzato in quasi tutte le viste finanziarie, tra cui il calcolo del valore totale della pipeline, del valore medio delle trattative e della correlazione del valore con altri fattori, come sconti o tempi di ciclo. È un componente chiave delle Dashboard 'Sales Representative Performance' e 'Opportunity Discount Effectiveness'. Perché è importante Fornisce il valore finanziario di ogni trattativa, essenziale per i report sulla pipeline, le previsioni dei ricavi e l'analisi delle performance. Dove reperirlo È il campo standard 'Amount' dell'oggetto Opportunity. Esempi 50000125000.75250000
	Percentuale di sconto DiscountPercentage	La percentuale di sconto applicata all’Opportunity.
Descrizione Questo attributo registra lo sconto offerto su una trattativa, generalmente espresso come percentuale del prezzo totale. È un fattore essenziale per comprendere la redditività delle trattative e i comportamenti di vendita. Questa metrica costituisce la base della Dashboard «Efficacia degli sconti sulle Opportunity» e del KPI «Sconto medio sulle trattative vinte». Analizzando questo attributo, i responsabili delle vendite possono determinare se gli sconti favoriscono effettivamente le vittorie o se riducono semplicemente i margini, oltre a confrontare le politiche di sconto adottate nelle diverse aree geografiche o dai diversi rappresentanti commerciali. Perché è importante È fondamentale per analizzare la redditività, comprendere l’efficacia della strategia di pricing e individuare sconti eccessivi. Dove reperirlo In genere è un campo personalizzato di tipo valuta o percentuale dell’oggetto Opportunity o Quote. Consulti la documentazione di Salesforce Sales Cloud o il Suo amministratore. Esempi 0.050.100.15
	Responsabile dell'Opportunity OpportunityOwner	Il rappresentante commerciale assegnato all'opportunità di vendita e responsabile della sua gestione.
Descrizione L'Opportunity Owner è l'utente di Salesforce principalmente responsabile della gestione della trattativa. Si tratta di una dimensione fondamentale per l'analisi delle performance. Analizzando i dati in base all'Opportunity Owner, le organizzazioni possono creare la Dashboard 'Sales Representative Performance'. Questo consente di confrontare i tempi di ciclo, i tassi di vittoria e il valore medio delle trattative tra i diversi membri del team, individuando i migliori performer e le opportunità di coaching. Perché è importante Questo attributo è essenziale per analizzare le performance del team di vendita, confrontare i risultati individuali e individuare le esigenze di coaching. Dove reperirlo È il campo 'OwnerId' dell'oggetto Opportunity, che collega all'oggetto User. Esempi John SmithMaria GarciaDavid Chen
	Stage di vendita StageName	Lo stage attuale dell'opportunità nella pipeline di vendita, ad esempio 'Qualification' o 'Negotiation'.
Descrizione Sales Stage rappresenta l'avanzamento di un'opportunità attraverso il processo di vendita predefinito. Le modifiche a questo campo costituiscono eventi chiave del processo, come 'Proposal Stage Reached'. Questo attributo è fondamentale per creare le Dashboard 'Sales Pipeline Bottleneck Identification' e 'Daily Sales Funnel Operational View'. Consente di analizzare quanto tempo le opportunità trascorrono in ogni stage, i tassi di conversione tra gli stage e lo stato complessivo della pipeline di vendita. Perché è importante Monitora l'avanzamento dell'opportunità nel funnel di vendita, consentendo l'analisi dei colli di bottiglia e la gestione della pipeline. Dove reperirlo È il campo standard 'StageName' dell'oggetto Opportunity. Esempi ProspezioneQualificazioneAnalisi delle esigenzeProposal/Price QuoteNegoziazione/Revisione
	Vinta IsWon	Un indicatore booleano che segnala se l'opportunità è stata vinta o persa.
Descrizione Questo attributo indica con un semplice valore true o false l'esito finale di un'opportunità di vendita. È impostato su true se lo stage dell'opportunità è 'Closed Won' e su false se è 'Closed Lost'. 'Is Won' costituisce la base per il calcolo del KPI 'Opportunity Win Rate', una delle misure più importanti dell'efficacia commerciale. Viene inoltre utilizzato per segmentare l'analisi, ad esempio confrontando i percorsi delle trattative vinte e perse o calcolando lo 'Average Discount on Won Deals'. Perché è importante Misura direttamente l'esito di un'opportunità di vendita, consentendo l'analisi delle vittorie e delle perdite e il calcolo dei tassi di vittoria. Dove reperirlo È il campo standard 'IsWon' dell'oggetto Opportunity. Si tratta di un campo formula basato su StageName. Esempi truefalse
	È una rilavorazione IsRework	Un flag calcolato che indica se un’attività rappresenta una rilavorazione o un passaggio ripetuto.
Descrizione Is Rework è un flag booleano impostato su true quando il processo torna a una fase precedente. Ad esempio, se l’attività «Quote Modified» si verifica dopo «Quote Presented to Customer», viene considerata una rilavorazione. Questo attributo è fondamentale per quantificare le inefficienze del processo. Supporta direttamente il calcolo dei KPI «Tasso di errore nell’elaborazione degli ordini» e «Frequenza di rilavorazione dei preventivi». Evidenziare le rilavorazioni aiuta a individuare aree caratterizzate da requisiti poco chiari, problemi di comunicazione o criticità qualitative. Perché è importante Quantifica le inefficienze del processo identificando e segnalando le attività che fanno parte di cicli di rilavorazione, così da orientare gli interventi di miglioramento. Dove reperirlo Questo flag viene calcolato dallo strumento di Process Mining, che analizza la sequenza delle attività e rileva i ritorni all’indietro nel flusso del processo. Esempi truefalse
	ID del contratto ContractId	L’identificativo univoco del contratto associato all’Opportunity.
Descrizione Contract ID collega l’Opportunity a un record contrattuale formale in Salesforce. È un passaggio fondamentale nelle fasi finali della chiusura di una trattativa. Questo attributo consente di analizzare in dettaglio la fase di contrattualizzazione e supporta le Dashboard «Tempo di ciclo da Quote a Contract» e «Conformità e rispetto dei contratti». Permette di monitorare attività come «Contract Sent for Signature» e «Contract Activated», misurandone la durata e il rispetto degli SLA. Perché è importante Consente di monitorare con precisione il sottoprocesso di gestione dei contratti, inclusi i tempi di ciclo e la conformità. Dove reperirlo Questo ID proviene dal campo «Id» dell’oggetto Contract, generalmente associato all’Opportunity o all’Account. Esempi 8008c000001LxD9AAK8008c000001MyE4AAK8008c000001NzF0AAK
	ID del preventivo QuoteId	L’identificativo univoco di un preventivo di vendita collegato all’Opportunity.
Descrizione Quote ID identifica uno specifico preventivo fornito al cliente per un’Opportunity. Nel corso del suo ciclo di vita, un’Opportunity può avere più preventivi. Monitorare gli ID dei preventivi è essenziale per analizzare la fase di preventivazione del processo di vendita. Consente di misurare il «Tempo di ciclo da Quote a Contract», comprendere quante revisioni del preventivo («Quote Modified») vengono effettuate e supporta il KPI «Frequenza di rilavorazione dei preventivi», distinguendo tra le diverse versioni. Perché è importante Questo attributo consente di analizzare il ciclo di preventivazione, incluso il numero di revisioni e il tempo che intercorre tra il preventivo e l’accettazione. Dove reperirlo Questo ID proviene dal campo «Id» dell’oggetto Quote, associato all’Opportunity. Esempi 0Q08c000001OxP1AAK0Q08c000001PyQ2AAK0Q08c000001QzR3AAK
	ID dell’ordine OrderId	L’identificativo univoco dell’ordine di vendita creato a partire da un’Opportunity vinta.
Descrizione Order ID collega un’Opportunity di vendita al successivo processo di evasione dell’ordine. Rappresenta il punto di passaggio dalle vendite alle operations. Questo ID è fondamentale per estendere l’analisi del processo oltre la fase «Opportunity Closed Won», fino alla gestione degli ordini. Consente di monitorare le attività «Order Created» e «Order Fulfilled» ed è necessario per misurare il «Tasso di errore nell’evasione degli ordini». Perché è importante Collega la parte commerciale del processo a quella relativa all’evasione dell’ordine, consentendo una vera analisi end-to-end Lead to Cash. Dove reperirlo Questo ID proviene dal campo «Id» dell’oggetto Order, spesso associato all’Opportunity. Esempi 8018c000001IyA6AAK8018c000001JyB1AAK8018c000001KzC6AAK
	Nome dell’Account AccountName	Il nome dell’account cliente o dell’azienda associata all’Opportunity.
Descrizione Account Name collega l’Opportunity di vendita a un cliente specifico, consentendo un’analisi del processo di vendita incentrata sul cliente. Analizzare il processo per cliente permette alle organizzazioni di comprendere i cicli di vendita degli account strategici, individuare i clienti caratterizzati da frequenti rilavorazioni o lunghe fasi di negoziazione e personalizzare le strategie di relazione. Offre inoltre una dimensione preziosa per filtrare i dati di processo e analizzarli in dettaglio. Perché è importante Collega il processo di vendita a un cliente specifico, consentendo di analizzare a livello di cliente i tempi del ciclo di vendita e i modelli di interazione. Dove reperirlo Deriva dal campo di ricerca «AccountId» dell’oggetto Opportunity, che fa riferimento al campo «Name» dell’oggetto Account. Esempi Global Tech Inc.Innovate Solutions LLCQuantum Industries
	Origine del Lead LeadSource	La fonte da cui ha avuto origine il lead, ad esempio «Web», «Partner» o «Fiera».
Descrizione Lead Source indica il canale di marketing o l’attività commerciale che ha generato il lead iniziale. Queste informazioni sono fondamentali per comprendere l’efficacia delle diverse strategie di acquisizione dei clienti. Questo attributo costituisce la dimensione principale della Dashboard «Analisi delle prestazioni di conversione dei lead». Analizzando i tassi di conversione e il valore delle trattative in base alla fonte del lead, le aziende possono ottimizzare gli investimenti di marketing e concentrarsi sui canali più redditizi. Perché è importante Consente di determinare l’efficacia dei canali di marketing collegando i lead alla loro origine e ai successivi tassi di successo. Dove reperirlo È il campo standard «LeadSource» dell’oggetto Lead, che in genere viene trasferito all’oggetto Opportunity al momento della conversione. Esempi WebRichiesta telefonicaSegnalazione da un partnerElenco acquistato
	Regione Region	La regione geografica o il territorio commerciale dell’Opportunity.
Descrizione L’attributo Region segmenta le Opportunity in base all’area geografica, ad esempio «Nord America», «EMEA» o «APAC». È un criterio comune con cui le organizzazioni commerciali strutturano i team e la reportistica. Questa è la dimensione principale della Dashboard «Confronto delle prestazioni di vendita regionali». Consente al management di confrontare le prestazioni dei processi nelle diverse regioni, individuando le best practice nelle aree più performanti e quelle che richiedono miglioramenti. L’analisi può includere tempi di ciclo, tassi di vittoria e utilizzo degli sconti. Perché è importante Consente di confrontare processi e prestazioni di vendita in diversi territori geografici, così da individuare punti di forza e aree di debolezza regionali. Dove reperirlo Spesso è un campo personalizzato dell’oggetto Opportunity o Account. Consulti la documentazione di Salesforce Sales Cloud o il Suo amministratore. Esempi Nord AmericaEMEAAPACLATAM
	Sistema di origine SourceSystem	Identifica il sistema di origine da cui sono stati estratti i dati.
Descrizione Questo attributo specifica il sistema di riferimento in cui hanno avuto origine i dati degli eventi. Per il processo Lead to Cash, in genere sarà 'Salesforce Sales Cloud'. Negli ambienti con più sistemi integrati, questo campo è fondamentale per la data lineage, la risoluzione dei problemi e la comprensione del sistema autorevole per le diverse fasi del processo. Garantisce chiarezza e affidabilità alla base dati. Perché è importante Fornisce il contesto sull'origine dei dati, elemento fondamentale per la governance dei dati, la validazione e la gestione degli ambienti multi-sistema. Dove reperirlo In genere è un valore statico aggiunto durante il processo di estrazione e trasformazione dei dati per indicare l'origine del dataset. Esempi Salesforce Sales CloudSFSC
	Tipo di Opportunity Type	Classifica l’Opportunity, ad esempio come «Nuovo business» o «Cliente esistente».
Descrizione Opportunity Type è un campo di classificazione standard utilizzato per segmentare le trattative. Consente di comprendere le differenze tra i processi o i cicli di vendita necessari per acquisire nuovi clienti e quelli utilizzati per proporre vendite aggiuntive ai clienti esistenti. Nel Process Mining, questo attributo consente di effettuare analisi comparative. Ad esempio, un’organizzazione può filtrare la mappa di processo per verificare se il ciclo di vendita per «Nuovo business» è più lungo o prevede più passaggi rispetto ai rinnovi di «Cliente esistente». Queste informazioni supportano le decisioni strategiche e le iniziative di ottimizzazione dei processi. Perché è importante La segmentazione delle Opportunity per tipo consente di confrontare processi di vendita, tempi di ciclo e tassi di successo diversi per il nuovo business e per quello esistente. Dove reperirlo È il campo standard «Type» dell’oggetto Opportunity. Esempi Nuovo clienteCliente esistente - UpgradeCliente esistente - RinnovoVendita aggiuntiva
	Ultimo aggiornamento dei dati LastDataUpdate	Il timestamp che indica quando i dati sono stati aggiornati l'ultima volta dal sistema di origine.
Descrizione Questo attributo mostra la data e l'ora dell'estrazione dati più recente da Salesforce Sales Cloud. Fornisce agli utenti il contesto necessario per valutare l'aggiornamento dei dati analizzati. Sapere quando i dati sono stati aggiornati l'ultima volta è essenziale per interpretare correttamente l'analisi, soprattutto per Dashboard operative come 'Daily Sales Funnel Operational View'. In questo modo, le decisioni vengono prese tenendo conto dell'attualità dei dati. Perché è importante Informa gli utenti sull'aggiornamento dei dati, assicurando che conoscano il livello di attualità dell'analisi del processo. Dove reperirlo È un attributo di metadati generato dalla pipeline dati o dallo strumento ETL al momento dell'estrazione dei dati. Esempi 2023-10-27T02:00:00Z2023-10-28T02:00:00Z

Obbligatorio Consigliato Facoltativo

Attività Lead to Cash

Queste sono le fasi chiave del processo e le tappe fondamentali da monitorare, per consentire una corretta individuazione del processo e l’analisi delle prestazioni.

8 Consigliato 8 Facoltativo

	Attività	Descrizione
	Contratto attivato	Questa attività indica che un contratto è stato completamente perfezionato e firmato da tutte le parti, diventando legalmente efficace. In genere viene registrata come modifica dello stato dell'oggetto Contract a 'Activated'.
Perché è importante È la conferma finale dell'accordo legale con il cliente, una tappa fondamentale per la rilevazione dei ricavi e la conformità. Eventuali ritardi possono incidere direttamente sulle previsioni finanziarie. Dove reperirlo Viene dedotta dalla modifica del campo Status dell'oggetto Contract a 'Activated'. Il timestamp della modifica viene acquisito tramite il monitoraggio della cronologia dei campi. Acquisizione Individui il timestamp in cui il campo 'Status' dell'oggetto Contract viene impostato su 'Activated'. Tipo di evento inferred
	Lead convertito in Opportunity	Questa attività indica il momento in cui un lead qualificato viene convertito in un'opportunità di vendita, insieme al relativo account e contatto. In Salesforce si tratta generalmente di un'azione esplicita eseguita da un rappresentante commerciale.
Perché è importante Si tratta del passaggio cruciale dal marketing o dal lead development al team di vendita. Analizzare i tempi e i tassi di conversione a partire da questo punto consente di valutare la qualità dei lead e l'efficienza della fase iniziale del processo di vendita. Dove reperirlo Questo evento può essere identificato verificando che il campo IsConverted dell'oggetto Lead sia impostato su true e che il campo ConvertedOpportunityId sia valorizzato. Il timestamp corrisponde a ConvertedDate. Acquisizione Viene registrato quando un utente converte un record Lead, valorizzando i campi ConvertedDate e ConvertedOpportunityId. Tipo di evento explicit
	Opportunity chiusa con esito negativo	Rappresenta la chiusura negativa di una trattativa di vendita, persa a favore di un concorrente o perché il cliente ha deciso di non acquistare. Viene registrata quando StageName dell'Opportunity viene aggiornato a 'Closed Lost'.
Perché è importante È il principale risultato negativo. Analizzare quando e perché le trattative vengono perse è fondamentale per migliorare la strategia commerciale, la formazione e il posizionamento del prodotto. Dove reperirlo Viene dedotta dalla modifica del campo StageName dell'oggetto Opportunity a 'Closed Lost'. La data è registrata nel campo CloseDate e il timestamp nella cronologia dei campi. Acquisizione Individui da OpportunityFieldHistory il timestamp in cui 'StageName' dell'Opportunity diventa 'Closed Lost'. Tipo di evento inferred
	Opportunity chiusa con esito positivo	Rappresenta la chiusura positiva di una trattativa di vendita, con la vittoria dell'opportunità. Consiste nell'aggiornamento manuale o automatico del campo StageName dell'Opportunity a 'Closed Won'.
Perché è importante È il principale risultato positivo del processo di vendita. Analizzare le tendenze e gli attributi delle trattative vinte è fondamentale per comprendere le prestazioni e la strategia commerciale. Dove reperirlo Viene dedotta dalla modifica del campo StageName dell'oggetto Opportunity a 'Closed Won'. La data dell'evento è acquisita nel campo CloseDate, mentre il timestamp è disponibile nella cronologia dei campi. Acquisizione Individui da OpportunityFieldHistory il timestamp in cui 'StageName' dell'Opportunity diventa 'Closed Won'. Tipo di evento inferred
	Opportunity creata	Rappresenta la creazione di un nuovo record di opportunità di vendita in Salesforce, che indica una potenziale trattativa in grado di generare ricavi. Questo evento viene registrato esplicitamente con un timestamp di creazione al primo salvataggio del record.
Perché è importante Questa attività costituisce l'inizio ufficiale del ciclo di vendita per una determinata opportunità. Rappresenta il punto di partenza per misurare la durata complessiva del ciclo di vendita e la velocità della pipeline. Dove reperirlo Viene acquisito dal campo di sistema CreatedDate dell'oggetto Opportunity. In questo modo si dispone di un timestamp preciso del momento in cui è stato avviato il record dell'opportunità. Acquisizione Utilizzi il campo CreatedDate dell'oggetto Opportunity. Tipo di evento explicit
	Pagamento ricevuto	Questa attività conferma che il pagamento del cliente è stato ricevuto e imputato alla fattura. In genere viene dedotta dalla modifica dello stato di una fattura a 'Paid' o dalla creazione di un record Payment.
Perché è importante È l'attività finale del processo Lead to Cash e rappresenta la realizzazione dei ricavi. La durata dalla fatturazione al pagamento è un KPI fondamentale del flusso di cassa. Dove reperirlo Viene dedotta dalla modifica dello stato di un oggetto Invoice a 'Paid' oppure dalla creazione di un oggetto Payment collegato alla fattura. Questi dati provengono spesso da un sistema finanziario esterno. Acquisizione Individui il momento in cui il campo 'Status' dell'Invoice diventa 'Paid' oppure viene creato un record Payment correlato. Tipo di evento inferred
	Quote accettata dal cliente	Questa attività indica l'accordo del cliente sui termini e sui prezzi del preventivo. In genere viene registrata quando un utente aggiorna lo stato della Quote a 'Accepted'.
Perché è importante Si tratta di un segnale d'acquisto fondamentale e di una tappa importante prima della generazione del contratto. Il tempo tra la presentazione e l'accettazione è un indicatore chiave degli attriti nel ciclo di vendita. Dove reperirlo Viene dedotta dalla modifica del campo Status dell'oggetto Quote a 'Accepted'. Il timestamp deriva dal monitoraggio della cronologia di questa modifica. Acquisizione Individui il timestamp in cui il campo 'Status' della Quote cambia in 'Accepted'. Tipo di evento inferred
	Quote creata	Questa attività rappresenta la generazione di un documento formale di preventivo per il cliente. Viene registrata quando viene creato un nuovo record Quote collegato all'Opportunity.
Perché è importante La creazione di un preventivo è un passaggio significativo verso la chiusura di una trattativa. Analizzare il numero di preventivi e il tempo necessario per crearli aiuta a valutare l'efficienza del team di vendita e l'avanzamento della trattativa. Dove reperirlo Viene acquisita dal campo di sistema CreatedDate dell'oggetto Quote. L'oggetto Quote dispone di una relazione di ricerca con l'Opportunity padre. Acquisizione Utilizzi il campo CreatedDate dell'oggetto Quote associato all'Opportunity. Tipo di evento explicit
	Contratto inviato per la firma	Indica che un contratto formale è stato generato e inviato al cliente per la firma. Spesso viene dedotto da una modifica dello stato dell'oggetto Contract, ad esempio a 'Sent' o 'Out for Signature'.
Perché è importante Questa attività avvia la fase legale e amministrativa finale della chiusura di una trattativa. Monitorarla aiuta a controllare l'efficienza del processo di gestione dei contratti. Dove reperirlo Viene dedotta da una modifica dello stato dell'oggetto Contract, collegato all'Opportunity. È necessario monitorare la cronologia del campo Status del Contract. Acquisizione Individui il timestamp in cui il campo 'Status' del Contract cambia in un valore come 'Sent for Signature'. Tipo di evento inferred
	Fattura generata	Rappresenta la creazione di una fattura per addebitare al cliente i beni o i servizi consegnati. Può essere registrata tramite la creazione di un record Invoice, in Salesforce Billing o in un sistema esterno integrato.
Perché è importante Questa attività avvia la componente finanziaria del ciclo Lead to Cash. La rapidità e l'accuratezza della fatturazione incidono direttamente sul flusso di cassa. Dove reperirlo Richiede Salesforce Billing o un pacchetto equivalente. Viene acquisita dal campo CreatedDate dell'oggetto Invoice, collegato all'Order o all'Account. Acquisizione Utilizzi il campo CreatedDate dell'oggetto Invoice, se disponibile. Tipo di evento explicit
	Ordine creato	Questa attività indica la creazione di un ordine di vendita e avvia formalmente il processo di evasione dopo la chiusura positiva di una trattativa. Viene registrata quando viene creato un nuovo record Order associato all'Opportunity o all'Account.
Perché è importante È il passaggio ufficiale dal processo di vendita al team responsabile dell'evasione degli ordini e delle operations. L'efficienza di questa fase è fondamentale per garantire consegne puntuali e la soddisfazione del cliente. Dove reperirlo Viene acquisita dal campo di sistema CreatedDate dell'oggetto Order. L'Order è generalmente collegato all'Account e/o all'Opportunity di origine. Acquisizione Utilizzi il campo CreatedDate dell'oggetto Order collegato all'Account dell'Opportunity. Tipo di evento explicit
	Ordine evaso	Indica che i prodotti o i servizi inclusi in un ordine sono stati consegnati al cliente. In genere viene dedotto da una modifica dello stato dell'oggetto Order a uno stato finale come 'Fulfilled' o 'Completed'.
Perché è importante Questa tappa indica il completamento della promessa di consegna al cliente. Il tempo dalla creazione dell'ordine alla sua evasione è una metrica chiave dell'efficienza operativa e della soddisfazione del cliente. Dove reperirlo Viene dedotto dalla modifica del campo Status dell'oggetto Order a un valore che indica il completamento. Per acquisire il timestamp dell'evento è necessario monitorare la cronologia dei campi. Acquisizione Individui il timestamp in cui il campo 'Status' dell'Order cambia in 'Fulfilled' o 'Completed'. Tipo di evento inferred
	Quote modificata	Rappresenta un aggiornamento o una revisione di un preventivo esistente, spesso a seguito del feedback del cliente o di una negoziazione. Viene registrata monitorando le modifiche ai campi chiave del record Quote dopo la sua creazione iniziale.
Perché è importante Modifiche frequenti ai preventivi possono indicare inefficienze, lacune nella comunicazione o cicli di negoziazione prolungati. Analizzare questo ciclo di rilavorazione è fondamentale per ridurre la durata della fase da quote a contratto. Dove reperirlo Viene dedotto dal campo LastModifiedDate dell'oggetto Quote oppure, con maggiore granularità, dal monitoraggio della cronologia di campi come TotalPrice o delle voci di riga. Acquisizione Confronti LastModifiedDate con CreatedDate nell'oggetto Quote oppure utilizzi il monitoraggio della cronologia dei campi della Quote. Tipo di evento inferred
	Quote presentata al cliente	Questo evento indica che un preventivo è stato inviato o presentato formalmente al cliente per la revisione. In genere viene dedotto da una modifica dello stato del record Quote, ad esempio da 'Draft' a 'Presented' o 'In Review'.
Perché è importante Questa attività avvia il conteggio dei tempi di negoziazione e approvazione da parte del cliente. Monitorarla consente di misurare i tempi di risposta del cliente e individuare i ritardi nella fase di accettazione del preventivo. Dove reperirlo Viene dedotto dalle modifiche al campo Status dell'oggetto Quote. Per ottenere il timestamp preciso della modifica è necessario monitorare la cronologia di questo campo. Acquisizione Individui il timestamp in cui il campo 'Status' della Quote cambia in 'Presented', 'Sent' o in un valore equivalente. Tipo di evento inferred
	Raggiunto lo stage Proposal	Indica il momento specifico in cui un'opportunità passa allo stage 'Proposal/Price Quote'. L'evento viene dedotto dalla cronologia del campo 'StageName' dell'Opportunity.
Perché è importante Si tratta di una tappa fondamentale, che indica l'identificazione di una potenziale soluzione pronta per essere valorizzata e presentata. È un punto critico per analizzare il tempo impiegato nella definizione della soluzione e nella preparazione del preventivo. Dove reperirlo Viene dedotto dall'oggetto OpportunityFieldHistory, individuando in particolare il timestamp in cui il campo 'StageName' viene aggiornato a 'Proposal/Price Quote' o a un valore di stage personalizzato equivalente. Acquisizione Filtri OpportunityFieldHistory per i record in cui 'Field' è 'StageName' e 'NewValue' corrisponde allo stage della proposta. Tipo di evento inferred
	Stage dell'Opportunity modificato	Questa attività registra qualsiasi modifica allo stage di vendita di un'opportunità, ad esempio il passaggio da 'Qualification' a 'Needs Analysis'. Le modifiche vengono registrate nella cronologia dei campi del sistema, creando una traccia dell'avanzamento dell'opportunità.
Perché è importante Monitorare le modifiche agli stage è essenziale per comprendere la velocità della pipeline di vendita, individuare i colli di bottiglia in cui le trattative si bloccano e analizzare la conformità del processo. Dove reperirlo Viene dedotto dall'oggetto OpportunityFieldHistory, che registra le modifiche al campo StageName dell'oggetto Opportunity. Ogni voce contiene un timestamp e i valori precedente e successivo. Acquisizione Estragga gli eventi di modifica del campo 'StageName' dalla tabella OpportunityFieldHistory. Tipo di evento inferred

Consigliato Facoltativo

Guide all’estrazione

Come ottenere i Suoi dati da Salesforce Sales Cloud

Passaggi

Verifica preliminare: Field History Tracking: prima di iniziare, verifichi con l’amministratore Salesforce che Field History Tracking sia abilitato per i campi chiave dei seguenti oggetti: Opportunity (StageName, Importo), Quote (Status), Contract (Status) e Order (Status). Questo è essenziale per acquisire correttamente le modifiche del processo.
Acceda ai report Salesforce: acceda alla Sua istanza Salesforce. Utilizzi l’App Launcher per trovare e aprire la scheda «Reports». Faccia clic sul pulsante «New Report» per iniziare.
Crei il report della cronologia delle opportunità: questo report acquisirà la creazione delle opportunità, le modifiche di fase e gli eventi di chiusura. Selezioni il tipo di report «Opportunities with Field History». Aggiunga le seguenti colonne: Opportunity ID, Opportunity Name, Created Date, Field/Event, Old Value, New Value, Edit Date ed Edit By. Aggiunga anche gli attributi consigliati: Owner, Importo, Is Won ed eventuali campi relativi agli sconti.
Crei il report sulla conversione dei lead: crei un secondo report utilizzando il tipo di report «Leads». Aggiunga le colonne Lead ID, Converted Date, Converted Opportunity ID e Lead Owner. Applichi un filtro per visualizzare solo i lead per i quali «Converted» è true.
Crei il report sugli eventi dei preventivi: crei un terzo report utilizzando un tipo di report «Quotes», preferibilmente uno che includa la cronologia, se disponibile, ad esempio «Quotes with Field History». Aggiunga le colonne Quote ID, Opportunity ID, CreatedDate, LastModifiedDate e Status. Il report servirà a ricavare la creazione dei preventivi e le modifiche di stato.
Crei report aggiuntivi per contratti, ordini e fatture: seguendo lo stesso modello del report sui preventivi, crei report separati per Contracts, Orders e Invoices, se questi oggetti sono utilizzati nella Sua istanza Salesforce. Per ciascuno includa l’ID del record, l’Opportunity ID correlato, CreatedDate, LastModifiedDate e il campo Status dell’oggetto.
Esegua ed esporti tutti i report: per ogni report creato, imposti un filtro coerente sull’intervallo di date, ad esempio «Opportunity Created Date» negli ultimi 6 mesi. Esegua ciascun report e utilizzi la funzione «Export» per salvare i risultati come file CSV.
Combini i dati in un foglio di calcolo: apra un’applicazione per fogli di calcolo, come Microsoft Excel. Copi i dati di ogni file CSV esportato in un foglio separato all’interno di un’unica cartella di lavoro.
Crei il foglio Event Log finale: crei un nuovo foglio denominato «Event Log». Definisca le intestazioni obbligatorie SalesOpportunity, ActivityName ed EventTimestamp, oltre alle intestazioni consigliate OpportunityOwner, StageName, Importo, IsWon e DiscountPercentage.
Trasformi e consolidi i dati: compili manualmente il foglio «Event Log» elaborando i dati dei fogli di origine. Per ogni riga di origine, crei una riga corrispondente nell’Event Log. Ad esempio, per una riga del foglio Opportunity History in cui «New Value» è «Closed Won», crei una riga nell’Event Log con ActivityName impostato su «Opportunity Closed Won» ed EventTimestamp impostato su «Edit Date». Ripeta il procedimento per tutte le 16 attività richieste nei file di origine.
Esegua la formattazione finale ed esporti: verifichi che la colonna EventTimestamp utilizzi un formato coerente, ad esempio YYYY-MM-DD HH:MI:SS. La colonna SalesOpportunity deve essere valorizzata per ogni riga, utilizzando l’Opportunity ID dei report di origine. Salvi il foglio «Event Log» finale e consolidato come file CSV per il caricamento.

Configurazione

Tipi di report: il tipo di report principale necessario è «Opportunities with Field History». Saranno inoltre necessari report per Lead, Quote, Contract, Order e Invoice. La disponibilità di tipi di report con cronologia per questi oggetti migliora significativamente l’accuratezza dei dati.
Field History Tracking: deve essere preconfigurato da un amministratore Salesforce. È essenziale per monitorare le modifiche a Opportunity Stage, Quote Status, Contract Status e Order Status.
Autorizzazioni: l’utente che esegue i report deve disporre dell’accesso in lettura a tutti gli oggetti pertinenti: Lead, Account, Opportunity, OpportunityFieldHistory, Quote, Contract, Order e, potenzialmente, Invoice e Payment.
Filtro sull’intervallo di date: è fondamentale applicare un filtro coerente sull’intervallo di date in tutti i report, così da garantire la correlazione dei dati. Per mantenere gestibile il volume dei dati, si consiglia di filtrare «Opportunity Created Date» sugli ultimi 3-6 mesi.
Volume dei dati: per le organizzazioni con volumi molto elevati di Opportunity e attività, Report Builder potrebbe diventare lento o raggiungere i limiti di esportazione, generalmente intorno a 100.000 righe, a seconda dell’edizione. In questi casi, il Data Export Service settimanale rappresenta un’alternativa più solida per ottenere i dati grezzi.

a Query di esempio 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]

Passaggi

Prerequisiti: verifichi di disporre di un account utente Salesforce con accesso API e autorizzazioni sufficienti per leggere gli oggetti Opportunity, Lead, Quote, Contract, Order e Invoice, nonché i relativi oggetti Field History. Field History Tracking deve essere abilitato per i campi chiave, ad esempio StageName e Status, di questi oggetti.
Selezioni uno strumento di esecuzione: questa query utilizza clausole UNION ALL, che non sono supportate dalla Developer Console o da Workbench nativi di Salesforce. Deve utilizzare uno strumento esterno in grado di connettersi a Salesforce ed eseguire query in stile SQL, ad esempio uno strumento di Business Intelligence (BI) come Tableau o Power BI, uno strumento ETL come MuleSoft o Informatica oppure uno strumento di interrogazione dati con un connettore Salesforce, come DBeaver o DataGrip.
Stabilisca la connessione a Salesforce: configuri la connessione alla Sua istanza Salesforce nello strumento scelto. In genere Le serviranno nome utente, password e token di sicurezza. Utilizzi l’opzione del connettore Salesforce (API).
Prepari la query: copi la query SOQL completa fornita nella sezione query di questo documento nell’editor di query dello strumento.
Configuri i segnaposto: la query contiene diversi segnaposto che deve sostituire con valori specifici della Sua organizzazione Salesforce. Sono inclusi:
- 'YYYY-MM-DDThh:mm:ssZ': sostituisca tutte le occorrenze con le date di inizio e fine desiderate per il periodo di estrazione, utilizzando il formato ISO 8601.
- [Your_Discount_Field__c]: sostituisca il segnaposto con il nome API del campo personalizzato relativo alla percentuale di sconto nell’oggetto Opportunity.
- [Quote_Presented_Status]: sostituisca il segnaposto con il valore di stato effettivamente utilizzato quando un preventivo viene presentato a un cliente, ad esempio «Presented» o «In Review».
- [Opportunity_Lookup_On_Contract__c]: sostituisca il segnaposto con il nome API del campo di ricerca nell’oggetto Contract che collega all’opportunità.
- [Order_Fulfilled_Status]: sostituisca il segnaposto con il valore di stato che indica che un ordine è stato evaso, ad esempio «Fulfilled», «Shipped» o «Completed».
- [Opportunity_Lookup_On_Invoice__c]: sostituisca il segnaposto con il nome API del campo di ricerca nell’oggetto Invoice che collega all’opportunità.
Esegua la query: esegua la query completa. In base al volume dei dati e allo strumento utilizzato, l’operazione potrebbe richiedere alcuni minuti.
Riveda i risultati: al termine della query, controlli il dataset restituito per verificare che contenga righe per tutte le diverse attività e che le colonne siano valorizzate come previsto.
Gestisca i possibili errori: se la query non viene eseguita, controlli la presenza di errori di battitura nei nomi dei segnaposto sostituiti. Verifichi che l’utente disponga dell’accesso di sicurezza a livello di campo per tutti i campi interrogati. La query potrebbe inoltre andare in timeout o raggiungere i limiti di esecuzione se l’intervallo di date è troppo ampio; provi a ridurlo, ad esempio a un singolo trimestre.
Esporti i dati: esporti il set di risultati finale come file CSV.
Prepari il caricamento: verifichi che le intestazioni del file CSV corrispondano agli attributi obbligatori: SalesOpportunity, ActivityName, EventTimestamp, OpportunityOwner, StageName, Importo, IsWon e DiscountPercentage. Il file è ora pronto per il caricamento in uno strumento di process mining.

Configurazione

Field History Tracking: questa estrazione dipende in modo critico dall’abilitazione di Field History Tracking per gli oggetti Opportunity (StageName), Quote (Status), Contract (Status) e Order (Status). Senza questa funzionalità, le attività relative alle modifiche di stato e di fase non verranno acquisite.
Autorizzazioni dell’utente: l’utente che esegue la query deve disporre dell’accesso API e delle autorizzazioni di lettura per tutti gli oggetti inclusi nella query: Lead, Opportunity, OpportunityFieldHistory, Quote, QuoteHistory, Contract, ContractHistory, Order, OrderHistory, Invoice e InvoiceHistory.
Intervallo di date: è fondamentale definire un intervallo di date specifico utilizzando i segnaposto 'YYYY-MM-DDThh:mm:ssZ'. Per l’analisi iniziale si consiglia un periodo di 3-6 mesi, così da bilanciare il volume dei dati e le prestazioni. Per istanze Salesforce di grandi dimensioni, inizi con un intervallo più breve, ad esempio un mese, per verificare le prestazioni e gli eventuali problemi legati ai governor limits.
Campi e stati personalizzati: la query utilizza segnaposto per campi personalizzati, ad esempio [Your_Discount_Field__c], e valori di stato personalizzati, ad esempio [Quote_Presented_Status]. Deve individuare i nomi API e i valori corretti nella configurazione Salesforce della Sua organizzazione e aggiornare di conseguenza la query.
Disponibilità degli oggetti: la query presuppone l’utilizzo degli oggetti standard Contract e Order, oltre a un oggetto Invoice, comune in Salesforce Billing. Se la Sua organizzazione non utilizza questi oggetti o impiega un pacchetto di fatturazione diverso, le parti corrispondenti della query non verranno eseguite correttamente o non restituiranno dati e dovranno essere rimosse o adattate.

a Query di esempio 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

Passaggi

Prepari l’ambiente: verifichi che sul sistema sia installato Python 3.6 o una versione successiva. Avrà inoltre bisogno di pip, il programma di installazione dei pacchetti Python, per installare le librerie necessarie.
Installi le librerie necessarie: apra la riga di comando o il terminale e installi le librerie simple-salesforce e pandas eseguendo il comando: pip install simple-salesforce pandas.
Configuri l’accesso API Salesforce: acceda al Suo account Salesforce con un profilo amministratore. Acceda a Setup, quindi ad Apps e ad App Manager. Crei una nuova «Connected App». Abiliti le impostazioni OAuth per l’applicazione e assegni l’ambito «Access and manage your data (api)». Dopo il salvataggio, riceverà un «Consumer Key» e un «Consumer Secret». Verifichi inoltre che l’account utente utilizzato dallo script disponga di un Security Token. Può generarlo o reimpostarlo nelle impostazioni personali, alla voce «Reset My Security Token».
Configuri lo script Python: copi lo script Python completo fornito nella sezione Query in un file denominato extract_lead_to_cash.py.
Inserisca le credenziali: apra il file dello script e sostituisca i valori segnaposto di username, password, security_token e instance_url con le credenziali Salesforce specifiche. Non inserisca le credenziali direttamente nel codice in un ambiente di produzione; utilizzi invece un metodo sicuro, come variabili d’ambiente o un file di configurazione.
Definisca il periodo di estrazione: modifichi nello script le variabili start_date e end_date per definire l’intervallo temporale dei dati da estrarre. Utilizzi il formato YYYY-MM-DD.
Comprenda la logica dello script: lo script si connette all’API Salesforce ed esegue una serie di query Salesforce Object Query Language (SOQL). Ogni query è rivolta a un oggetto specifico, ad esempio Opportunity, OpportunityFieldHistory o Preventivo, per acquisire una distinta attività aziendale.
Agregghi i dati: i risultati di ogni query vengono convertiti in una struttura organizzata denominata DataFrame pandas. Questi DataFrame, ciascuno rappresentativo di un’attività, vengono quindi raccolti in un’unica lista.
Trasformi e formatti i dati: lo script concatena tutti i DataFrame in un unico Event Log completo. Rinomina le colonne in modo che corrispondano allo schema richiesto per il Process Mining, ad esempio SalesOpportunity, ActivityName ed EventTimestamp, e verifica che i tipi di dati siano corretti.
Esegua lo script: esegua lo script dal terminale utilizzando il comando python extract_lead_to_cash.py. Lo script si connetterà a Salesforce, eseguirà le query ed elaborerà i dati.
Recuperi l’Event Log: al termine dell’esecuzione, lo script genererà nella stessa directory un file denominato sfdc_lead_to_cash_event_log.csv. Questo CSV è l’Event Log finale, formattato per il caricamento in uno strumento di Process Mining.

Configurazione

Prerequisiti: un account Salesforce con Enterprise, Unlimited o Developer Edition, che dispongono dell’accesso API. Un profilo utente Salesforce con l’autorizzazione «API Enabled» e accesso in lettura ai seguenti oggetti: Lead, Opportunity, OpportunityFieldHistory, Quote, Contract e Order. Anche eventuali oggetti personalizzati per la fatturazione o i pagamenti richiedono l’accesso in lettura.
Autenticazione: lo script utilizza l’autenticazione tramite nome utente, password e token di sicurezza. Per una maggiore sicurezza in produzione, valuti l’implementazione di OAuth 2.0 JWT Bearer Flow, supportato anch’esso da simple-salesforce.
Intervallo di date: le variabili start_date e end_date nello script controllano l’intervallo di estrazione. Per l’analisi iniziale si consiglia un periodo da 3 a 6 mesi, sufficiente a ottenere dati significativi senza generare un volume eccessivo. I filtri sulle date vengono applicati al campo Timestamp principale di ogni attività, ad esempio CreatedDate o ConvertedDate.
Utilizzo dell’API: lo script esegue più query distinte. Ogni query e il successivo recupero di tutti i risultati consumano chiamate API, che vengono conteggiate nei limiti giornalieri della Sua organizzazione. Presti attenzione a questi limiti, soprattutto in ambienti con molte altre integrazioni. Per estrarre milioni di record, lo script dovrebbe essere adattato per utilizzare la Salesforce Bulk API.
Personalizzazioni: lo script presuppone, ove possibile, l’utilizzo dei nomi standard di oggetti e campi. La Sua organizzazione potrebbe utilizzare campi personalizzati, ad esempio Discount_Percentage__c, oggetti personalizzati, ad esempio Invoice__c e Payment__c, o relazioni personalizzate, come una ricerca da Contract a Opportunity. Deve adattare le query SOQL dello script alla configurazione Salesforce specifica della Sua organizzazione.

a Query di esempio 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()

Pronto a iniziare?

Utilizzi questo Template per semplificare la preparazione dei dati e sfruttare appieno il potenziale del Process Mining nelle Sue operations Lead to Cash. Inizi oggi stesso a ottimizzare la Sua efficienza.

Torna alla guida al miglioramento Scarica il Template

Smetta di perdere trattative: ottimizzi subito Lead to Cash

Trasformi il Suo Lead to Cash in Salesforce e ottenga tassi di vittoria superiori del 20%.

Inizi la prova gratuita

Non è richiesta alcuna carta di credito

Il Suo Template dei dati Lead to Cash

Il Suo Template dei dati Lead to Cash

Attributi Lead to Cash

Attività Lead to Cash

Guide all’estrazione

Report Builder di Salesforce e Data Export Service

Passaggi

Configurazione

a Query di esempio sql

Query diretta in Salesforce Object Query Language (SOQL)

Passaggi

Configurazione

a Query di esempio sql

Script Python con Salesforce REST o Bulk API

Passaggi

Configurazione

a Query di esempio python

Pronto a iniziare?

Smetta di perdere trattative: ottimizzi subito Lead to Cash

Il Suo Template dei dati Lead to Cash

Il Suo Template dei dati Lead to Cash

Attributi Lead to Cash

Attività Lead to Cash

Guide all’estrazione

Report Builder di Salesforce e Data Export Service

Passaggi

Configurazione

a Query di esempio sql

Query diretta in Salesforce Object Query Language (SOQL)

Passaggi

Configurazione

a Query di esempio sql

Script Python con Salesforce REST o Bulk API

Passaggi

Configurazione

a Query di esempio python

Pronto a iniziare?

Smetta di perdere trattative: ottimizzi subito Lead to Cash

La Sua privacy è importante