Impostare e modificare i valori delle variabili

Obiettivi di apprendimento

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

• Modificare il valore della variabile di un flusso.
  
• Utilizzare una variabile per memorizzare dati provenienti da più origini.
  
• Creare più percorsi con singoli elementi Assegnazione.
  

Questo badge è una tappa del percorso di acquisizione della padronanza di Flow Builder. L'itinerario Creare flussi con Flow Builder ti guiderà attraverso tutto il percorso di apprendimento di Flow Builder, dall'inizio alla fine. Segui la sequenza di badge consigliata per acquisire solide competenze di automazione dei processi e diventare un guru di Flow Builder.

Il potere dei cambiamenti

Ogni volta che memorizzi dei dati in un flusso, quei dati sono praticamente perfetti e non c'è mai bisogno di modificarli, giusto? In realtà no: è un'eventualità piuttosto rara. Spesso nei flussi si recuperano dei dati, dunque si aggiunge o si elimina qualcosa o li si modificano in altri modi, e poi quei dati vengono restituiti al record da cui provengono.

I team del Marketing e dell'Abilitazione di Pyroclastic desiderano iniziare a utilizzare l'indirizzo di spedizione per le comunicazioni. In molti account è indicato l'indirizzo di fatturazione obbligatorio, ma non l'indirizzo di spedizione. Flo ti incarica di creare un flusso che innanzitutto chiede agli utenti se desiderano copiare l'indirizzo di fatturazione o inserire un indirizzo di spedizione manualmente e, successivamente, apporta gli opportuni aggiornamenti ai campi dell'indirizzo di spedizione.

Potresti creare un semplice flusso attivato da record con un solo elemento Aggiorna record. Ma c'è un problema. Ricordi quando hai implementato l'aggiornamento della priorità dei casi impostando il valore del campo Priorità? Quel campo veniva aggiornato con un singolo valore.

Nello scenario dell'indirizzo di spedizione, l'indirizzo potrebbe provenire dall'indirizzo di fatturazione o dall'input dell'utente. In teoria, l'elemento Aggiorna record potrebbe avere il seguente aspetto:

Ma questa configurazione non funzionerebbe. Il campo Valore richiede una singola origine dati. Non è possibile utilizzare l'indirizzo di fatturazione oppure l'input utente. Bisogna scegliere l'uno o l'altro.

Serve un contenitore intermedio, una variabile, in cui memorizzare un indirizzo di spedizione a partire dall'indirizzo di fatturazione oppure dall'input utente.

Inoltre, serve un metodo per determinare se l'utente ha deciso di copiare l'indirizzo di fatturazione oppure di inserire un indirizzo manualmente e, quindi, agire di conseguenza. Per quest'ultima operazione puoi utilizzare un elemento Decisione. 

Successivamente, puoi configurare l'elemento Aggiorna record in modo che i valori dell'indirizzo di spedizione vengano aggiornati a partire dalla variabile. Ma come si fa a impostare il valore della variabile?

È qui che l'elemento Assegnazione viene in tuo aiuto. Questo elemento assegna l'indirizzo scelto dall'utente alla variabile, in modo che il relativo valore possa essere utilizzato per aggiornare i campi dell'indirizzo di spedizione.

L'elemento Assegnazione

Per assegnare un valore a una variabile è necessario utilizzare un elemento Assegnazione. Nello scenario dell'indirizzo di spedizione, devi modificare il valore di una variabile per aggiornare un solo campo in un singolo record, ma l'elemento Assegnazione può fare molto di più.

Una variabile è come un contenitore per il pranzo. Quest'ultimo può contenere una varietà di cibi, mentre una variabile può contenere una varietà di valori. 

Per impostare il valore di una variabile, devi assegnarle un valore. Ad esempio: Priorità uguale a Grav 0.

Nell'elemento Assegnazione, il valore di una variabile viene impostato specificando la variabile e il relativo valore. Ciascuna istruzione di assegnazione include anche un operatore che determina in che modo la variabile viene aggiornata. Osserva questo esempio.

In questo caso, l'operatore Equals (Uguale a) sostituisce il valore corrente della variabile con quello specificato. Il risultato è che la variabile Priority (Priorità) memorizza il valore Sev 0 (Grav 0).

In molti elementi, incluso l'elemento Assegnazione, nel campo Valore è possibile inserire testo personalizzato, selezionare risorse presenti nel flusso o entrambi. Ad esempio, se inserisci The color is {!colorForumula} (Il colore è {!colorFormula}) e colorFormula è una formula che restituisce il valore "red" (rosso), nella variabile verrà memorizzato il valore "The color is red" (Il colore è rosso).

Creare un flusso che contiene elementi Assegnazione

Tornando al flusso per la compilazione dell'indirizzo di spedizione richiesto da Flo, creiamo un flusso schermata che Flo potrà incorporare nella pagina Lightning Account, nascondendolo quando i campi dell'indirizzo di spedizione sono compilati.

Potresti non aver ancora imparato cosa sono i flussi schermata. In questo esempio, useremo una schermata semplice, ma se vuoi approfondire l'argomento puoi dare uno sguardo al badge Flussi schermata.

Per creare un flusso schermata, inizia utilizzando quello che hai imparato in questo badge e nel badge Dati e azioni nei flussi.

Creare un flusso schermata e una variabile di testo

1. Crea un flusso selezionando il tipo Screen Flow (Flusso schermata).
   
2. Crea una variabile di testo in cui memorizzare l'ID del record corrente:
   

• API Name (Nome API): recordId
• Data Type (Tipo di dati): Text (Testo)
  
• Available for input (Disponibile per l'input): selezionata
  

In questo esercizio, assegniamo alla variabile il nome recordId per un motivo specifico. Quando un utente esegue un flusso a partire da un pulsante di azione, Salesforce cerca automaticamente una variabile denominata recordId in quel flusso e, se la trova, assegna l'ID del record corrente a quella variabile. Questa speciale configurazione consente ai flussi eseguiti a partire da pulsanti di azione di individuare il record visualizzato dall'utente nel momento in cui fa clic sul pulsante.

Non creeremo il pulsante di azione qui ma, se lo desideri, puoi farlo alla fine. Per ulteriori informazioni, vedi l'unità "Aggiungere un flusso a un record come azione" del badge Distribuzione dei flussi schermata.

Creare elementi Ottieni record, Schermata e Decisione

1. Aggiungi un elemento Get Records (Ottieni record) per recuperare i dettagli del record corrente e memorizzarli in una variabile record.
   

• Label (Etichetta): Get Account Data (Recupera dati account)
• Object (Oggetto): Account
  
• Filter Condition Requirements (Requisiti della condizione del filtro):
  
  • Field (Campo): ID
    
  • Operator (Operatore): Equals (Uguale a)
    
  • Value (Valore): recordId
    
• How Many Record to Store (Quanti record memorizzare): Only the first record (Solo il primo record)
  
• How to Store Record Data (Come archiviare i dati record): Automatically store all fields (Archivia automaticamente tutti i campi)
  

2. Aggiungi un elemento Screen (Schermata) in cui chiedere all'utente di copiare l'indirizzo di fatturazione o di inserire un indirizzo di spedizione.
   

• Nell'area di disegno, dopo l'elemento Get Account Data (Recupera dati account), fai clic su .
  
• Seleziona Screen (Schermata).
  
• In Label (Etichetta), inserisci Enter Address (Inserisci indirizzo).
  
• Seleziona un componente Checkbox (Casella di controllo) nel riquadro Components (Componenti) e trascinalo nell'area di disegno della schermata.
  

• In Label (Etichetta), inserisci Use the billing address for the shipping address (Utilizza l'indirizzo di fatturazione come indirizzo di spedizione).
  
• Nel campo API Name (Nome API), abbrevia il nome predefinito in Use_the_billing_address.
  

• Trascina un componente Address (Indirizzo) nell'area di disegno della schermata, al di sotto della casella di controllo.
  

• In API Name (Nome API), inserisci ScreenShipping.
  
• Nel campo Label (Etichetta), inserisci Shipping Address (Indirizzo di spedizione).
  L'area di disegno della schermata dovrebbe avere il seguente aspetto.
  
  

3. Fai clic su Done (Chiudi).
   
4. Aggiungi un elemento Decision (Decisione) per creare diversi percorsi in base alla scelta dell'utente.
   

• Label (Etichetta): Use Billing Address? (Utilizzare l'indirizzo di fatturazione?)
• Esito 1, Label (Etichetta): Selected (Selezionato)
• Esito 1, Condition Requirements (Requisiti della condizione):
  
  • Resource (Risorsa): Enter Address (Inserisci indirizzo) > Use the Billing Address… (Utilizza l'indirizzo di fatturazione…)
    
  • Operator (Operatore): Equals (Uguale a)
    
  • Value (Valore): True (Vero)
    
• Default Outcome (Esito predefinito), Label (Etichetta): Not Selected (Non selezionato)
• Fai clic su per chiudere il riquadro laterale.
  

5. Salva il flusso. Nel campo Flow Label (Etichetta flusso), inserisci Set Shipping Address (Imposta indirizzo di spedizione).
   

Il flusso dovrebbe avere questo aspetto:

Il flusso che hai appena creato consente all'utente di copiare l'indirizzo di fatturazione o di inserire l'indirizzo manualmente. A prescindere dall'origine scelta dall'utente, devi copiare l'indirizzo di spedizione nella variabile record Get Account Data (Recupera dati account). 

• Se l'utente ha scelto di utilizzare l'indirizzo di fatturazione, il flusso assegna i valori provenienti dai campi dell'indirizzo di fatturazione memorizzati nella variabile record ai relativi campi dell'indirizzo di spedizione.
  
• Se l'utente ha scelto di inserire l'indirizzo di spedizione manualmente, il flusso assegna i valori inseriti nella schermata Enter Address (Inserisci indirizzo) ai campi dell'indirizzo di spedizione della variabile record.
  

Il passaggio successivo consiste nell'aggiornamento dei dati memorizzati nella variabile record dell'elemento Get Account Data (Recupera dati account), ossia Account from Get Account Data (Account da Recupera dati account). Per impostare i valori dei campi della variabile record, devi creare due elementi Assegnazione: uno per copiare l'indirizzo di fatturazione (nel percorso Selected (Selezionato)) e uno per copiare i dati dall'elemento Enter Address (Inserisci indirizzo) della schermata (nel percorso Not Selected (Non selezionato)).

Aggiungere un elemento Assegnazione al percorso Selected (Selezionato)

1. Fai clic su sul percorso Selected (Selezionato).
   
2. Fai scorrere l'elenco fino alla sezione Logic (Logica) e seleziona Assignment (Assegnazione).
   
3. In Label (Etichetta), inserisci Copy Billing Address (Copia indirizzo di fatturazione).
   
4. In Variable (Variabile), seleziona Account from Get Account Data (Account da Recupera dati account), quindi seleziona Shipping City (Città spedizioni).
   
5. In Value (Valore), seleziona Account from Get Account Data (Account da Recupera dati account) e poi seleziona Billing City (Città fatturazione).
   
6. Fai clic su +Add Assignment (+Aggiungi assegnazione) quattro volte, in modo da ottenere cinque righe in tutto.
   Devi impostare ciascun campo dell'indirizzo singolarmente, in modo che sia presente una riga di assegnazione per ciascuno dei cinque campi indirizzo.
   
7. Seleziona i valori seguenti nelle righe di assegnazione aggiunte:
   

• Account from Get Account Data (Account da Recupera dati account) > Shipping Country (Paese spedizioni) Equals (Uguale a) Account from Get Account Data (Account da Recupera dati account) > Billing Country (Paese fatturazione)
  
• Account from Get Account Data (Account da Recupera dati account) > Shipping Zip/Postal Code (CAP Spedizioni) Equals (Uguale a) Account from Get Account Data (Account da Recupera dati account) > Billing Zip/Postal Code (CAP fatturazione)
  
• Account from Get Account Data (Account da Recupera dati account) > Shipping State/Province (Stato/Provincia spedizioni) Equals (Uguale a) Account from Get Account Data (Account da Recupera dati account) > Billing State/Province (Stato/Provincia fatturazione)
  
• Account from Get Account Data (Account da Recupera dati account) > Shipping Street (Via spedizioni) Equals (Uguale a) Account from Get Account Data (Account da Recupera dati account) > Billing Street (Via fatturazione)
  

Quando in un elemento sono presenti più righe, le assegnazioni vengono effettuate nell'ordine in cui sono elencate.

8. Fai clic su per chiudere il riquadro laterale.
   
9. Salva il flusso.
   

Aggiungere un elemento Assegnazione al percorso Not Selected (Non selezionato)

1. Fai clic su nel percorso Not Selected (Non selezionato).
   
2. Fai scorrere l'elenco fino alla sezione Logic (Logica) e seleziona Assignment (Assegnazione).
   
3. Nel campo Label (Etichetta), inserisci Set Address from screen (Imposta indirizzo da schermata).
   
4. Fai clic su +Add Assignment (+Aggiungi assegnazione) quattro volte in modo da ottenere cinque righe in tutto.
   
5. Seleziona i valori seguenti nelle righe di assegnazione:
   

• Account from Get Account Data (Account da Recupera dati account) > Shipping City (Città spedizioni) Equals (Uguale a) Enter Address (Inserisci indirizzo) > ScreenShipping > City Value (Valore città)
  
• Account from Get Account Data (Account da Recupera dati account) > Shipping Country (Paese spedizioni) Equals (Uguale a) Enter Address (Inserisci indirizzo) > ScreenShipping > Country Value (Valore paese)
  
• Account from Get Account Data (Account da Recupera dati account) > Shipping Zip/Postal Code (CAP spedizioni) Equals (Uguale a) Enter Address (Inserisci indirizzo) > ScreenShipping > Postal Code Value (Valore CAP)
  
• Account from Get Account Data (Account da Recupera dati account) > Shipping State/Province (Stato/Provincia spedizioni) Equals (Uguale a) Enter Address (Inserisci indirizzo) > ScreenShipping > State or Province Value (Valore Stato o Provincia)
  
• Account from Get Account Data (Account da Recupera dati account) > Shipping Street (Via spedizioni) Equals (Uguale a) Enter Address (Inserisci indirizzo) > ScreenShipping > Street Value (Valore via)
  

6. Fai clic su per chiudere il riquadro laterale.
   
7. Salva il flusso.
   

Ora il flusso assegna i valori ai campi indirizzo della variabile record. Tuttavia, devi ancora fare in modo che l'indirizzo di spedizione venga inserito nel record dell'account. L'elemento Assegnazione non salva i nuovi valori nel record. Per eseguire questa operazione è necessario un elemento Aggiorna record. Crea un elemento Aggiorna record dopo la convergenza dei percorsi Selected (Selezionato) e Not Selected (Non selezionato) in un unico percorso.

Aggiornare il record dell'account

1. Aggiungi un elemento Aggiorna record sull'area di disegno del flusso, dopo i due elementi Assegnazione.
   
2. In Label (Etichetta), inserisci Update Account (Aggiorna account).
   
3. Sotto How to Find Records to Update and Set Their Values (Come trovare i record da aggiornare e impostare i loro valori) lascia selezionato Use the IDs and all field values from a record or record collection (Usa gli ID e tutti i valori di campo da un record o da una raccolta record)
   Questa impostazione aggiorna il record a partire da una variabile record. L'elemento usa il campo ID della variabile record per determinare quale record deve essere aggiornato e aggiorna i relativi campi in modo che corrispondano a quelli della variabile.
   
4. In Record or Record Collection (Record o raccolta record), seleziona Account from Get Account Data (Account da Recupera dati account).
   
5. Salva il flusso.
   

Fatto! Hai creato un flusso che utilizza cinque tipi di elemento. 

1. L'elemento Ottieni record (Get Account Data (Recupera dati account)) recupera i valori dei campi del record dell'account corrente.
   
2. L'elemento Schermata (Enter Address (Inserisci indirizzo)) chiede all'utente di inserire un indirizzo di spedizione oppure di copiare l'indirizzo di fatturazione.
   
3. L'elemento Decisione (Use Billing Address? (Utilizzare l'indirizzo di fatturazione?)) determina cosa ha scelto l'utente e crea un percorso per ciascuna possibilità.
   
4. I due elementi Assegnazione modificano i campi dell'indirizzo di spedizione della variabile Get Account Data (Recupera dati account) copiando l'indirizzo di fatturazione nell'indirizzo di spedizione (Copy Billing Address (Copia indirizzo di fatturazione)) oppure copiandovi le informazioni inserite manualmente (Set Address From Screen (Imposta indirizzo da schermata)).
   
5. Infine, l'elemento Aggiorna record (Update Account (Aggiorna account)) salva i valori modificati nella variabile record nel record dell'account corrente.
   

Ti starai chiedendo cos'altro si può fare con gli elementi Assegnazione. Continua a leggere.

Risorse

• Trailhead: Nozioni di base di Flow Builder (Conoscere le variabili di flusso)
• Documentazione: Elemento del flusso: Assegnazione