Le variabili dei workflow contengono dei valori che potranno essere utilizzati nel contesto di una sessione.
In genere le variabili possono essere utilizzate nei nodi di verifica oppure nel contenuto di un messaggio.
Definisci la variabile
Apri la scheda del workflow e fai clic su Modifica nella card di Impostazioni.
Alla sezione Variabili puoi consultare le variabili disponibili ed inserirne di nuove.
I tipi di valore disponibili sono:
- numero intero: esempio, i punti del programma fedeltà all'inizio del flusso
- stringa: per i valori di testo;
- data e orario: esempio, la data di emissione di un buono o la scadenza di un abbonamento;
- Sì/No: esempio, il contatto è iscritto a un servizio;
- elenco di valori;
- numero decimale: esempio, importo dell'ultima donazione effettuata.
Il nome descrive l'etichetta della variabile, mentre l'ID corrisponde all'identificativo utilizzato nel codice e nelle espressioni - pertanto non potrà ammettere spazi o caratteri speciali.
Assegna un valore
All'interno del designer del workflow, utilizza il nodo Aggiorna variabile per assegnare un valore.
Spesso il valore è assegnato all'inizio sessione, in modo da conservare il valore iniziale di un campo, oppure per calcolare un valore che sarà utilizzato successivamente per tutta la sessione del workflow.
In questo esempio, viene dichiarata una variabile di fine promozione pari a 30gg dopo la data di compleanno del contatto. Questa data potrà essere utilizzata sia in un nodo di verifica condizione, sia nel contenuto di un messaggio.
Inserisci l'espressione per calcolare il valore della variabile:
- per utilizzare il valore di un campo del contatto: contact.values.NAME;
- per utilizzare il valore di una variabile del workflow: workflow.values.NOMEVAR;
- per assegnare un valore a un numero utilizza il punto come separatore decimale (non la virgola);
- per assegnare un valore a un tipo Vero/Falso sono accettati solo: true/false, yes/no;
- per i tipi a scelta singola o multipla, se indichi un valore non esistente, la variabile non sarà valorizzata;
- per assegnare un valore testuale a una variabile, devi racchiuderlo tra apici: 'color'.
Esempio di espressione: per aggiungere 1 al valore di una variabile numerica, usa workflow.values.NOMEVAR + 1.
Verifica quali funzioni puoi utilizzare per manipolare numeri, date o stringhe di testo. Nell'esempio fn.today() esprime la data odierna.
Utilizza la variabile
Sfrutta il contenuto della variabile nei messaggi del workflow.
Il segnaposto da inserire nel testo è del tipo [workflow:IDvariabile]
Non c'è bisogno di ricordarsi della nomenclatura, utilizza l'icona per inserire un segnaposto e invece di campo contatto seleziona nella prima tendina Variabili del workflow.
Test del contenuto della variabile
Per effettuare una prova avvia una sessione di test del workflow.
Apri il dettaglio della sessione in corso e accedi alla sezione delle Variabili.
Troverai le variabili valorizzate con il valore corrente.