Usare i campi formula

Obiettivi di apprendimento

Al completamento di questa unità, sarai in grado di:

• Creare un campo formula personalizzato e utilizzare l'editor formule.
  
• Spiegare perché i campi formula sono utili.
  
• Illustrare almeno un caso d'uso dei campi formula.
  
• Creare semplici formule.
  

Nota

Stai seguendo la formazione in italiano? In questo badge, la convalida delle sfide pratiche di Trailhead funziona in inglese. Le traduzioni sono fornite tra parentesi come riferimento. Nel tuo Trailhead Playground, accertati di (1) selezionare Stati Uniti per le impostazioni internazionali, (2) impostare la lingua su Inglese e (3) copiare e incollare soltanto i valori in lingua inglese. Segui le istruzioni qui.

Visita il badge Trailhead nella tua lingua per scoprire come usufruire dell'esperienza di Trailhead in altre lingue.

Accessibilità

Questa unità richiede alcune istruzioni aggiuntive per gli utenti di screen reader. Per accedere a una versione dettagliata per screen reader di questa unità, fai clic sul link riportato di seguito:

Apri le istruzioni di Trailhead per screen reader.

Introduzione ai campi formula

Nella tua organizzazione ci sono molti dati. Gli utenti devono poter accedere a quei dati e capirli a colpo d'occhio, senza dover fare un sacco di calcoli a mente. Ecco che entrano in scena i campi formula, potente strumento che permette di controllare le modalità di visualizzazione dei dati.

Supponiamo che tu voglia prendere due campi numerici in un record e dividerli per creare una percentuale. O che tu voglia trasformare un campo in un collegamento ipertestuale selezionabile per accedere facilmente a informazioni importanti dal layout di pagina di un record. O magari vuoi prendere due date e calcolare il numero di giorni che le separano. Tutte queste cose e altre ancora sono possibili utilizzando i campi formula.

Esaminiamo un esempio specifico. E se volessi calcolare quanti giorni mancano alla data di chiusura di un'opportunità? Puoi creare un semplice campo formula che calcoli automaticamente quel valore. Aggiungendo il valore al layout della pagina opportunità, gli utenti possono accedere rapidamente a queste informazioni chiave. Questo campo può essere aggiunto anche ai rapporti e alle visualizzazioni elenco per consentire un accesso immediato.

Quando stai imparando le formule, è meglio iniziare con calcoli semplici e poi passare a scenari più complessi. Ma persino le formule più semplici possono fornire informazioni preziose.

In questa unità ti spieghiamo le basi dell'utilizzo dell'editor formule e ti introduciamo alla sintassi delle formule attraverso alcuni semplici esempi. Parleremo anche della risoluzione dei problemi con i campi formula. Ora divertiamoci!

Iniziare a fare esperienza pratica con le formule

Avvia subito il tuo Trailhead Playground per seguire e provare i passaggi illustrati in questo modulo. Per aprire il tuo Trailhead Playground, scorri verso il basso fino alla sfida pratica e fai clic su Launch (Avvia). Il playground viene utilizzato anche per completare le sfide pratiche.

Trovare l'editor formule

Prima di immergerci nella scrittura delle formule, individuiamo l'editor formule e scopriamone le funzioni.

Puoi creare campi formula personalizzati in qualsiasi oggetto sia standard che personalizzato. Per iniziare, creeremo una formula nell'oggetto Opportunity (Opportunità). Segui questi passaggi per accedere all'editor formule.

1. In Setup (Imposta), apri Object Manager (Gestore oggetti) e fai clic su Opportunity (Opportunità).
   
2. Nella barra laterale sinistra, fai clic su Fields & Relationships (Campi e relazioni).
   
3. Fai clic su New (Nuovo).
   
4. Seleziona Formula e fai clic su Next (Avanti).
   
5. In Field Label (Etichetta campo), digita My Formula Field (Il mio campo formula). Nota che il valore di Field Name (Nome campo) viene compilato automaticamente.
   
6. Seleziona il tipo di dati che desideri sia restituito dalla formula. Ad esempio, se vuoi scrivere una formula che calcoli la commissione ricevuta da un venditore su una vendita, seleziona Currency (Valuta). Per ora, scegli Text (Testo).
   
7. Fai clic su Next (Avanti). Eccoti giunto all'editor formule! È il momento del tour.
   

Usare l'editor formule

In questa immagine sono evidenziate le parti più importanti dell'editor formule.

1. L'editor formule è disponibile in due varianti: semplice e avanzato. La tentazione di usare l'editor semplice è forte, ma noi consigliamo sempre di usare l'editor avanzato. Avanzato non significa più complicato. Significa dotato di un maggior numero di strumenti per la creazione di formule efficaci.
   
2. Il pulsante Insert Field (Inserisci campo) consente di aprire un menu per la selezione dei campi da utilizzare nella formula. L'inserimento da questo menu genera automaticamente la sintassi corretta per accedere ai campi.
    
   
3. Il pulsante Insert Operator (Inserisci operatore) consente di aprire un elenco a discesa degli operatori matematici e logici disponibili.
   
   
   
4. Il menu Functions (Funzioni) è lo spazio che permette di visualizzare e inserire le funzioni di formula. Le funzioni sono operazioni più complicate, preimplementate da Salesforce. Alcune funzioni possono essere utilizzate così come sono (ad esempio, la funzione TODAY() che restituisce la data corrente), mentre altre richiedono informazioni aggiuntive, chiamate parametri. La funzione LEN(testo), ad esempio, determina la lunghezza del testo inserito come parametro. La formula LEN("Hello") restituisce un valore pari a 5.
   
   
5. L'area di testo è quella in cui inserire la formula. Quando scrivi le formule, tieni presente che:
   

• Gli spazi bianchi non contano. Puoi inserire tutti gli spazi e le interruzioni di riga che desideri senza influire sull'esecuzione della formula.
  
• Le formule fanno distinzione tra maiuscole e minuscole. Fai attenzione alle lettere maiuscole e minuscole dei nomi dei campi e degli oggetti.
  
• Quando si lavora con i numeri, vale l'ordine standard delle operazioni.
  

6. Una volta scritta una formula, è possibile utilizzare il pulsante Check Syntax (Controlla sintassi) per assicurarsi che tutto sia corretto prima di salvare. Se la formula presenta dei problemi, lo strumento di controllo della sintassi segnala i problemi specifici.
   

Dato che non abbiamo bisogno di continuare a creare questo campo formula, fai clic su Cancel (Annulla). Adesso che sai come muoverti, usiamo l'editor con alcuni semplici esempi.

Esempio 1: visualizzare un campo account nella pagina dei dettagli del referente

Le pagine dei dettagli dei record contengono una marea di informazioni, ma non sempre sono sufficienti. A volte ne servono di più! Per la prima formula, facciamo qualcosa di semplice. Prendiamo un singolo campo di un account e facciamo in modo che venga mostrato in un Referente utilizzando la cosiddetta formula oggetti incrociata. Diamo un'occhiata.

Per prima cosa crea un Referente. Se non hai mai creato un referente prima d'ora, fai clic sull'App Launcher (Programma di avvio app) () e seleziona Contacts (Referenti). Nella scheda Contacts (Referenti), fai clic su New (Nuovo). In Last Name (Cognome), inserisci un valore qualsiasi. In Account Name (Nome account), inserisci un account esistente, ad esempio United Oil & Gas Corp. Fai clic su Save (Salva). Adesso creiamo una formula per visualizzare il numero dell'account nella pagina del referente.

1. In Setup (Imposta), apri Object Manager (Gestore oggetti) e fai clic su Contact (Referente).
   
2. Nella barra laterale sinistra, fai clic su Fields & Relationships (Campi e relazioni).
   
3. Fai clic su New (Nuovo).
   
4. Per il tipo di campo, seleziona Formula e fai clic su Next (Avanti).
   
5. Assegna al campo il nome Account Number (Numero account) e, in Formula Return Type (Tipo di risultato formula), seleziona Text (Testo). Fai clic su Next (Avanti).
   
6. Nell'editor Advanced Formula (Formula avanzata), fai clic su Insert Field (Inserisci campo). Seleziona Contact (Referente) | Account | Account Number (Numero account), quindi fai clic su Insert (Inserisci). Fai clic su Check Syntax (Controlla sintassi). Se non ci sono errori di sintassi, fai clic su Next (Avanti). È improbabile che tu possa trovare un errore di sintassi in una formula semplice come questa, ma è consigliabile prendere l'abitudine di controllare la sintassi di ogni formula.
   
   
   
7. Fai clic su Next (Avanti) per accettare le impostazioni di sicurezza a livello di campo, quindi fai clic su Save (Salva).
   

Congratulazioni, hai scritto la tua prima formula! Adesso vediamo cosa hai fatto. Apri la pagina dei dettagli dell'oggetto Contact (Referente) che hai appena creato e individua il nuovo campo formula Account Number (Numero account). Ottimo!

Esempio 2: visualizzare su un rapporto quanti giorni mancano alla chiusura di un'opportunità

Puoi utilizzare i campi formula anche nei rapporti per aumentare la visibilità delle informazioni importanti. Supponiamo, ad esempio, che tu voglia visualizzare in una colonna del rapporto il numero di giorni che mancano alla chiusura di un'opportunità. Per prima cosa, crea un'opportunità per testare la formula.

Se non hai mai creato un'opportunità, fai clic su e seleziona Opportunities (Opportunità). Vai alla scheda Opportunities (Opportunità) e fai clic su New (Nuovo). In Opportunity Name (Nome opportunità), inserisci un valore qualsiasi, quindi seleziona un valore qualunque in Stage (Fase) e imposta Close Date (Data chiusura) su una data che cada almeno 3 giorni dopo la data corrente. Fai clic su Save (Salva).

Successivamente, segui questi passaggi per creare un campo formula personalizzato chiamato "Days to Close on the Opportunities object" (Giorni mancanti alla chiusura dell'oggetto Opportunità) con il tipo di risultato Number (Numero).

1. In Setup (Imposta), apri Object Manager (Gestore oggetti) e fai clic su Opportunity (Opportunità).
   
2. Nella barra laterale sinistra, fai clic su Fields & Relationships (Campi e relazioni).
   
3. Fai clic su New (Nuovo).
   
4. Seleziona Formula e fai clic su Next (Avanti).
   
5. Nell'area di testo Field Label (Etichetta campo), digita Days to Close (Giorni alla chiusura).
   
6. Seleziona il pulsante di opzione Number (Numero).
   
7. Fai clic su Next (Avanti) per aprire l'editor formule.
   
8. Per trovare la differenza tra la data di chiusura dell'opportunità e la data odierna, sottrai l'una all'altra.
   

• Fai clic su Insert Field (Inserisci campo) e seleziona Opportunity | Close Date (Opportunità | Data chiusura), quindi fai clic su Insert (Inserisci).
  
• Dal menu Insert Operator (Inserisci operatore) seleziona - Subtract (- Sottrai).
  

9. Ma come facciamo a dire alla formula che serve la data odierna? Fortunatamente esiste una funzione chiamata TODAY() che si aggiorna in base alla data corrente.
   

• Nel menu Functions (Funzioni) sul lato destro dell'editor seleziona TODAY.
  
• Fai clic su Insert Selected Function (Inserisci funzione selezionata). 
  

10. Fai clic su Check Syntax (Controlla sintassi). Se non ci sono errori di sintassi, fai clic su Next (Avanti).
    
    
11. Fai clic su Next (Avanti) per accettare le impostazioni di sicurezza a livello di campo, quindi fai clic su Save (Salva).
    

Adesso è il momento di inserire il nuovo campo formula in un rapporto. 

1. Da , apri la scheda Reports (Rapporti) e fai clic su New Report (Nuovo rapporto).
   
2. Nel campo Search Report Types… (Cerca tipi di rapporto…), inserisci Opportunities (Opportunità). Seleziona Opportunities (Opportunità) e fai clic su Start Report (Avvia rapporto). L'opportunità viene visualizzata nel riquadro di anteprima del rapporto.
   
3. Assicurati che l'opzione Update Preview Automatically (Aggiorna anteprima automaticamente) sia abilitata.
   
4. Nel campo Add column... (Aggiungi colonna…) sul lato sinistro della pagina, inserisci Days to Close (Giorni alla chiusura).  Questo è il campo formula che hai appena creato. Una colonna con il campo contenente il valore calcolato viene aggiunta automaticamente al rapporto.
   

Per questa unità non avrai più bisogno di questo rapporto. Puoi eliminarlo e passare all'esempio successivo.

Debug delle formule

Gli errori di sintassi sono un aspetto inevitabile del lavoro con le formule. Il pulsante Check Syntax (Controlla sintassi) dell'editor è uno strumento importante per il debug delle formule. Lo strumento di controllo della sintassi indica l'errore riscontrato e la sua posizione all'interno della formula. Ecco alcuni degli errori di sintassi più comuni.

1. Missing parentheses (Parentesi mancanti): questo errore si verifica il più delle volte quando il numero di parentesi aperte non corrisponde al numero di parentesi chiuse. Può essere particolarmente difficile evitare questo errore se si stanno utilizzando più funzioni contemporaneamente. Prova a suddividere la funzione su più righe: in questo modo sarà più facile individuare l'accoppiamento dei diversi gruppi di parentesi.
   Questo errore viene visualizzato anche se dimentichi una virgola tra due parametri di una funzione. Si tratta di un errore che crea confusione perché il problema reale non corrisponde a quanto segnalato dallo strumento di controllo della sintassi. Se hai la certezza che le parentesi siano corrette, controlla che lo siano anche le virgole della funzione.
   
2. Incorrect parameter type (Tipo di parametro errato): se assegni a una funzione un parametro numerico quando questa si aspetta un contenuto testuale (o un'altra combinazione di tipi di dati), questo è l'errore che viene visualizzato. Controlla sempre il testo della guida o la documentazione per stabilire che tipo di parametri vengono accettati da una funzione.
   
   
3. Incorrect number of parameters for function (Numero errato di parametri per la funzione): se in una funzione vengono inseriti troppi o troppo pochi parametri, lo strumento di controllo della sintassi lo segnala. Anche in questo caso, consulta il testo della guida o la documentazione per avere indicazioni sull'inserimento dei parametri in funzioni specifiche.
   
   
4. Formula result is incompatible with formula return type (Il risultato della formula è incompatibile con il tipo di dati del valore restituito dalla formula): questo errore viene visualizzato se si seleziona un tipo di dati quando si crea il campo formula, ma si scrive una formula che restituisce un tipo di dati diverso. Nell'esempio riportato di seguito, puoi vedere che la formula My Account (Il mio account) prevede di restituire un numero (indicato tra parentesi accanto al nome della formula). Tuttavia, la funzione TODAY() restituisce una data. L'errore indica il tipo di dati previsto, ma per evitarlo puoi sempre consultare preventivamente la documentazione.
   
   
5. Field does not exist (Campo inesistente): questo errore indica che nella formula è stato inserito un campo non supportato dall'oggetto. In questo caso, controlla l'ortografia e le maiuscole/minuscole. Se non trovi alcun errore, prova a inserire nuovamente il campo dal menu Insert Field (Inserisci campo) per avere la certezza che il riferimento sia corretto.
    Questo errore può verificarsi anche se dimentichi di mettere le virgolette intorno a un elemento testuale o a un collegamento ipertestuale.
   
6. Unknown function (Funzione sconosciuta): in questo caso, verifica che Salesforce supporti le funzioni che stai utilizzando. Questo errore si verifica anche per le funzioni inserite in modo errato.
   
   

Altri esempi

Esaminiamo qualche altro esempio. Puoi provare a creare queste formule autonomamente o limitarti a leggerle.

1. La formula crea un collegamento ipertestuale a un sito web esterno utilizzando la funzione HYPERLINK(). L'aggiunta di collegamenti ipertestuali ai layout di pagina aiuta gli utenti ad accedere rapidamente alle informazioni importanti a partire dalle pagine dei dettagli.
   
   
2. Se vuoi applicare uno sconto all'ammontare di un'opportunità, puoi utilizzare la formula seguente. In questo caso, applichiamo uno sconto del 12% e poi arrotondiamo il risultato a due cifre decimali utilizzando la funzione ROUND().
   
   
3. Quella seguente è una formula casella di controllo che determina se una particolare opportunità è una "grossa" opportunità. Controlla se il numero di dipendenti dell'azienda associata all'account dell'opportunità è superiore a 1.000 E se l'ammontare dell'opportunità è superiore a 10.000 dollari. Se entrambe le affermazioni sono vere, il campo viene visualizzato come una casella selezionata nel layout di pagina dell'opportunità. In caso contrario, viene visualizzato come una casella non selezionata.
   
   

La documentazione relativa alle formule contiene numerosi esempi per diversi casi d'uso. Quando scorri quegli esempi, tieni presente che molti contengono concetti avanzati che non sono stati trattati in questa unità. Prima di affrontare quelle formule, assicurati di sentirti a tuo agio con le informazioni fornite in questa pagina.

Risorse

• Guida di Salesforce: Calcolo dei valori dei campi con le formule
  
• PDF: Formulas Quick Reference (Guida di riferimento rapido sulle formule)