Utilizzare dati dai passaggi precedenti
Le mappature dei campi permettono a ogni esecuzione di usare il proprio destinatario, messaggio o dato decisionale. Una connessione sceglie il passaggio successivo; una mappatura sceglie un valore per l'input di quel passaggio.
Automations is in Early access. Your workspace permissions determine which actions you can perform.
Scegliere il valore di un campo
Collega il passaggio da configurare dopo la sua origine dati. Il selettore dell'origine dipende dal passaggio selezionato e dai percorsi che possono raggiungerlo.
Le modalità disponibili dipendono dal campo:
| Modalità | Scopo |
|---|---|
| Fisso | Inserisci un valore che resta uguale in ogni esecuzione. |
| Valore | Seleziona dati dal trigger, da un passaggio precedente o da una variabile. |
| Testo | Combina testo con valori inseriti, ad esempio un saluto e il nome di un cliente. |
| fx | Inserisci un'espressione Common Expression Language (CEL) per un calcolo o una condizione. |
| Lista | Configura una lista quando il campo accetta valori multipli. |
Per usare un valore precedente:
- Seleziona il passaggio di destinazione nel canvas.
- Apri il controllo del valore del campo e scegli l'origine che ti serve.
- Verifica che il campo selezionato abbia il tipo corretto, ad esempio testo per un indirizzo email.
- Controlla Step preview con dati di esempio per vedere l'input risolto.
Un'espressione mantiene il proprio tipo di risultato. Testo con valori inseriti produce testo. Un valore di testo che contiene cifre non diventa automaticamente un numero.
Esempio: personalizzare un saluto
Parti da una bozza del template di notifica SMS e scegli un mittente. Il trigger include un campo Customer name.
- Seleziona Send SMS notification e apri Edit message.
- In Message, mantieni la modalità Text e sostituisci il contenuto esistente con
Hiseguito da uno spazio. - Seleziona Insert data e scegli Customer name sotto Notification requested. Aggiungi
, your appointment is confirmed.dopo il valore inserito. - Espandi Test with sample data e usa un campione del trigger con
customer_nameimpostato suAda. - Seleziona Preview step, oppure Refresh preview se un risultato è già visibile. Il messaggio preparato mostra
Hi Ada, your appointment is confirmed.
Modificando il nome del campione e selezionando Refresh preview si aggiorna il saluto. Il campo inserito fornisce il nome per ogni esecuzione.
Comprendere le origini
| Origine | Esempio di utilizzo |
|---|---|
| Dati del trigger | L'ID appuntamento o il destinatario fornito all'avvio dell'esecuzione. |
| Output di un passaggio precedente | Il contatto restituito da Get contact o l'ID messaggio restituito da Send SMS. |
| Errore di un passaggio precedente | Le informazioni sull'errore usate nel percorso di fallimento di un'azione. |
| Variabili | Valori con nome creati da Set values. |
Set values è utile quando i passaggi successivi necessitano dello stesso calcolo. Ad esempio, prepara il nome visualizzato di un cliente una sola volta, poi inserisci quella variabile in più messaggi.
Gestire dati mancanti e condizionali
Un campo può essere assente, vuoto o avere esplicitamente nessun valore. Decidi cosa deve fare il workflow in ciascun caso. Per un nome mancante, un saluto generico può essere appropriato. Per un destinatario mancante, scegli un altro percorso o termina l'esecuzione.
Dopo una diramazione, un output esiste quando l'esecuzione ha seguito il percorso che lo ha prodotto. Se un percorso email e un percorso SMS si ricongiungono, il passaggio condiviso non può dare per scontato che entrambi gli invii siano avvenuti.
Usa una condizione prima di leggere dati opzionali, oppure assegna una variabile condivisa su ogni percorso in ingresso. Il selettore dell'origine distingue i valori disponibili solo su alcuni percorsi. Un campione che mostra un percorso riuscito non rende il suo output disponibile su un altro percorso.
Le espressioni CEL avanzate usano nomi come trigger.data.data, steps.lookup.output e variables.customer_name. L'ID del passaggio in un'espressione deve corrispondere al passaggio di origine effettivo. Preferisci il selettore quando disponibile, così seleziona l'origine al posto tuo.
Verificare i valori calcolati
Visualizza in anteprima un input tipico, un campo opzionale mancante e ogni diramazione pertinente. Un input preparato può comunque fallire durante un'esecuzione reale se i dati in arrivo hanno un tipo diverso o manca un valore obbligatorio.
Un output precedente è il valore registrato quando quel passaggio è stato eseguito. Riutilizzarlo dopo un ritardo non recupera di nuovo il contatto o il messaggio. Aggiungi un altro passaggio di lettura se la decisione richiede dati aggiornati.