L'editor è il luogo in cui costruisce ciò che un'automazione fa. Posiziona un trigger su un canvas, aggiunge i passaggi che seguono, li collega con delle linee e compila ogni passaggio. Questo articolo percorre l'editor dal primo trigger fino a una versione pubblicata.
Aprire l'editor
Nell'elenco delle automazioni, clicchi su un'automazione oppure scelga Modifica nel suo menu. Per partire da zero, crei una nuova automazione e scelga Automazione vuota.
Una nuova automazione parte con un nodo segnaposto chiamato Seleziona un trigger per iniziare e il nome Automazione senza titolo. Clicchi sul nome in alto per cambiarlo. Serve un nome prima di poter salvare.
L'editor ha quattro aree:
- La barra in alto con il nome, l'interruttore Attivo, gli strumenti, Salva e un menu con altre azioni.
- La libreria a sinistra con tutto ciò che può aggiungere.
- Il canvas al centro con il Suo flusso.
- L'inspector a destra, che si apre quando seleziona un nodo.
Clicchi su Automazioni in alto a sinistra per tornare all'elenco. Con modifiche non salvate, Le viene chiesto se vuole uscire comunque.
La libreria
La libreria ha due schede: Trigger e Azioni.
- Trigger elenca ciò che può avviare un'automazione, per esempio un nuovo membro, un ordine pagato o una lezione completata.
- Azioni elenca ciò che l'automazione fa. La sezione Controllo viene per prima: sono i blocchi che danno forma al flusso, come condizioni, ritardi, rami e cicli. Dopo vengono le azioni vere e proprie.
Entrambe le schede sono raggruppate per origine. La prima origine contiene i blocchi integrati della Sua piattaforma, e le integrazioni seguono in ordine alfabetico. Il numero accanto a un'origine conta i suoi blocchi. Clicchi su un'origine per aprirla; le origini più grandi sono suddivise in categorie come Membri, Pagamenti o Corsi. La freccia in alto La riporta indietro.
La sezione Recenti mostra gli ultimi quattro blocchi che ha posizionato dalla scheda aperta, così quelli che Le servono di più sono sempre a portata di mano.
Per trovare rapidamente un blocco, digiti nel campo di ricerca sopra le schede. Cerca in nomi e descrizioni in tutte le origini della scheda aperta.
La freccia accanto al titolo della libreria riduce la libreria a una striscia stretta per dare più spazio al canvas. Clicchi sull'icona nella striscia per riaprirla. Su un telefono la libreria parte ridotta.
Aggiungere e collegare nodi
Ci sono due modi per aggiungere un blocco:
- Lo trascini dalla libreria sul canvas e lo rilasci dove lo vuole.
- Ci clicchi o lo tocchi. L'editor lo posiziona a destra del Suo flusso.
Il primo trigger che aggiunge sostituisce il segnaposto Seleziona un trigger per iniziare e ne prende il posto. Può anche selezionare il segnaposto e scegliere l'evento in Tipo di trigger nell'inspector. Un'automazione può avere più di un trigger; ognuno avvia i nodi collegati a esso.
Ogni nodo ha un punto a sinistra per la linea in entrata e uno o più punti a destra per le linee in uscita. Per collegare due nodi, trascini da un punto a destra del primo nodo al punto a sinistra del successivo. Valgono alcune regole:
- Un trigger non ha una linea in entrata, e nulla può seguire un nodo Fine.
- Un nodo non può collegarsi a se stesso.
- Una linea non può tornare a un nodo che viene prima nel flusso. L'editor non Le permette di tracciarla. Per ripetere dei passaggi, usi Ciclo.
- Un ingresso accetta una sola linea. Se traccia una seconda linea nello stesso ingresso, questa sostituisce la prima. Solo i trigger possono condividere un ingresso.
Per spostare una linea, trascini una delle sue estremità su un altro punto. Valgono le stesse regole, e se rilascia altrove la linea resta dov'era.
Per rimuovere una linea o un nodo, ci clicchi e prema il tasto Backspace. Ctrl+Z annulla l'ultima modifica, e Ctrl+Maiusc+Z la ripristina. Su un Mac, usi Cmd invece di Ctrl.
Riordinare e muoversi
Layout automatico nella barra in alto dispone tutti i nodi da sinistra a destra lungo i loro collegamenti e adatta il flusso alla vista. È il modo più rapido per riordinare un flusso dopo aver aggiunto diversi passaggi.
Il punto interrogativo accanto apre Aiuto, una breve guida per muoversi sul canvas, con una scheda per il mouse e una per il trackpad:
- Spostare la vista: trascini il canvas con il tasto sinistro del mouse o con un dito.
- Zoom: usi la rotella del mouse o avvicini le dita sul trackpad.
- Selezionare più nodi: tenga premuto Ctrl (Cmd su un Mac) e ci clicchi.
Su uno schermo più piccolo, Layout automatico e gli altri strumenti si spostano nel menu accanto a Salva.
Integrazioni non ancora collegate
I blocchi di un'integrazione che non ha ancora collegato compaiono sbiaditi nella libreria con il chip Collega. Non può trascinarli. Ci clicchi, e si apre la finestra per collegare quel servizio. Non appena il collegamento funziona, il blocco viene aggiunto subito al canvas.
Aggiungi integrazione in fondo alla libreria apre la stessa finestra senza un blocco, per esempio per collegare un servizio prima di iniziare a costruire.
Se un nodo sul canvas appartiene a un'integrazione non collegata, il suo inspector mostra Non collegata con un link Collega, e il nodo conta come problema (veda sotto). Per le azioni che richiedono un account, lo scelga in Integrazione nell'inspector. Se non ce n'è ancora nessuno, il pulsante Aggiungi integrazione ne collega uno.
Configurare un nodo nell'inspector
Clicchi su un nodo per aprire l'inspector a destra. La sua intestazione mostra il tipo di nodo, per esempio Trigger o Azione, e il suo nome. Sotto compila le impostazioni di quel nodo. I campi obbligatori sono contrassegnati da un asterisco. I nodi senza impostazioni, come Fine, mostrano "Nessun campo da configurare".
In fondo all'inspector:
- Elimina rimuove il nodo e le sue linee.
- L'icona di copia (Duplica) posiziona sul canvas una copia del nodo con le stesse impostazioni, leggermente spostata.
- Salva salva l'intera automazione.
Prema Esc o la croce nell'intestazione per chiudere l'inspector. Su un telefono, l'inspector termina sopra la barra di navigazione, così questi pulsanti restano a portata di mano.
Un trigger ha i propri campi nell'inspector. Alcuni lo restringono a un elemento, per esempio Corso o Giorni di inattività. Si trovano subito sotto Tipo di trigger, prima di Condizioni.
I campi di testo di molte azioni, per esempio l'oggetto e il corpo di
un'email, accettano segnaposto come o [|First Name|]. Quando
l'automazione viene eseguita, vengono sostituiti con i dati del membro. I nodi
di controllo lavorano con valori del trigger, scritti come {{key}}. Quali
campi ha ogni trigger e ogni azione, e l'elenco completo dei segnaposto, si
trovano nell'articolo su trigger e azioni.
La scheda Esecuzione
Quando apre un'esecuzione da Esecuzioni, il canvas passa a un replay di sola lettura di quell'esecuzione. L'inspector ha allora due schede: Impostazioni mostra le impostazioni del nodo com'erano, ed Esecuzione mostra il suo stato, i suoi orari e i dati in entrata e in uscita.
Test e cronologia delle esecuzioni
Risolvere i problemi
L'editor controlla il Suo flusso mentre lavora. Un nodo con un problema riceve un segnale di avviso, e nella barra in alto compare un triangolo giallo con il numero di problemi. Passi con il mouse sul triangolo per vedere l'elenco; ci clicchi per saltare al primo nodo con un problema. L'inspector di quel nodo elenca i suoi problemi in alto.
Problemi tipici sono:
- "Il trigger non ha nessun tipo di evento selezionato."
- "«Giorni di inattività» deve essere almeno 1."
- "L'azione non ha nessun tipo selezionato."
- "L'integrazione richiesta non è collegata."
- "Il ritardo non ha una durata."
- "Nessun workflow selezionato in "Esegui workflow"."
- "Nessun collegamento in entrata. Questo nodo non è raggiungibile."
L'elenco completo con cosa fare si trova in Test e cronologia delle esecuzioni.
Il salvataggio funziona anche con problemi aperti, così può fermarsi a metà e tornare più tardi. L'automazione però potrebbe non funzionare come previsto finché non sono risolti. Se il flusso ha un errore strutturale, per esempio quando ha eliminato tutti i trigger, il salvataggio si interrompe con "Il flusso ha un errore strutturale e non è stato possibile salvarlo."
Salvare e attivare
Clicchi su Salva, oppure prema Ctrl+S (⌘S su un Mac). Il tooltip del pulsante e il tour introduttivo indicano la scorciatoia per il Suo dispositivo. Il pulsante mostra Salvato per un momento. Finché ha modifiche non salvate, il pulsante è evidenziato, e il Suo browser chiede conferma prima di chiudere la scheda.
L'interruttore Attivo nella barra in alto decide se l'automazione viene eseguita. Una nuova automazione parte disattivata. L'interruttore ha effetto al salvataggio.
Quando lo attiva mentre ci sono problemi aperti, Le viene chiesto di confermare e vede l'elenco dei problemi. Attivare la attiva comunque. Il salvataggio con l'interruttore attivo si interrompe con un messaggio se un nodo richiede un'integrazione non collegata, oppure se l'automazione è archiviata.
Versioni, pubblicazione e ripristino
Ogni salvataggio crea una nuova versione. Solo una versione alla volta è attiva: quella pubblicata. Così può lavorare su un flusso senza cambiare ciò che accade per i Suoi membri finché non è pronto.
- Il primo salvataggio di un'automazione viene pubblicato subito.
- Ogni salvataggio successivo è una bozza. Una nota in cima al canvas dice "Salvata come bozza. Queste modifiche non sono ancora attive." Clicchi su Pubblica in quella nota per rendere attiva la bozza. La nota compare dopo il salvataggio, dopo un ripristino e ogni volta che apre un'automazione la cui ultima versione non è pubblicata.
- Nell'elenco delle automazioni, un'icona a matita gialla segnala un'automazione con Modifiche non pubblicate.
Un'esecuzione di prova usa sempre l'ultima versione salvata, così può provare una bozza prima di pubblicarla.
Il pannello Versioni
Versioni nella barra in alto elenca fino alle ultime 100 versioni, dalla più recente, con l'orario e il membro del team che l'ha salvata. Delle etichette mostrano quale versione è quale:
- In modifica: la versione che vede nell'editor.
- Pubblicato: la versione che viene eseguita.
- Bozza: una versione mai pubblicata.
Selezioni una versione per confrontarla con ciò che si trova ora sul canvas. Il confronto elenca che cosa cambierebbe ripristinando quella versione, ordinato in Blocco aggiunto, Blocco rimosso, Tipo di blocco modificato, Blocco riconfigurato, Connessione aggiunta e Connessione rimossa. Se non c'è nessuna differenza, vede "Queste versioni sono identiche."
Sotto il confronto ci sono due pulsanti:
- Pubblica rende attiva la versione selezionata. Manca quando la versione è già quella pubblicata. La pubblicazione si interrompe con un messaggio se la versione usa un'integrazione non collegata.
- Ripristina questa versione copia la versione selezionata in una nuova versione e la carica nell'editor. Per la versione che sta modificando, il pulsante riporta Versione corrente e non è cliccabile.
Un ripristino sostituisce il canvas. Se ha modifiche non salvate, Le viene chiesto prima: "Hai modifiche non salvate. Il ripristino le sostituisce con questa versione. Ripristinare comunque?" La nuova versione è una bozza e non diventa attiva da sola. Clicchi su Pubblica nella nota in cima al canvas, oppure riapra Versioni, selezioni la versione contrassegnata come In modifica e clicchi su Pubblica.
Duplicare ed eliminare
Il menu accanto a Salva ha altre due azioni:
- Duplica crea una copia dell'automazione dalla sua ultima versione salvata e la apre nell'editor. La copia riceve "(Copy)" dopo il nome, parte disattivata e ha quella versione già pubblicata. Le modifiche non salvate non vengono copiate, quindi salvi prima.
- Elimina chiede "Eliminare questa automazione? Verrà spostata nel cestino. Puoi ripristinarla in Impostazioni, Cestino." Dopo la Sua conferma, La riporta all'elenco. Può ripristinare l'automazione in Impostazioni > Cestino.
Entrambe sono disponibili non appena l'automazione è stata salvata.
Il tour introduttivo
La prima volta che apre l'editor, una piccola scheda in fondo al canvas chiamata Tour dell'editor La guida in quattro passaggi: trascinare un trigger, trascinare un'azione, collegarli e salvare. La scheda avanza da sola man mano che completa ogni passaggio e si chiude poco dopo l'ultimo. Salta la nasconde subito. In entrambi i casi da quel momento resta nascosta in quel browser.
Su un telefono, la scheda si trova a destra della striscia della libreria e sopra la barra di navigazione, così ogni passaggio resta leggibile.