Utilizzo dell'editor di flussi di lavoro in Shopify Flow

L’editor del flusso di lavoro è uno strumento che ti consente di personalizzare e modificare la funzionalità dei flussi di lavoro in Shopify Flow. L’editor del flusso di lavoro presenta un’interfaccia basata sul trascinamento della selezione che ti permette di organizzare e progettare i flussi di lavoro aggiungendo passaggi di tipo diverso in un formato verticale, dall’alto verso il basso.

Il primo passaggio che puoi aggiungere a un flusso di lavoro tramite l’editor è sempre un passaggio del trigger. Dopo aver aggiunto il trigger del flusso di lavoro, puoi usare le icone + per aggiungere i passaggi condizione o azione successivi nella sequenza. Le frecce collegano i vari passaggi nell’editor del flusso di lavoro e indicano quali passaggi portano direttamente agli altri in base alle condizioni verificate o alle azioni intraprese.

Per funzionare, tutti i passaggi devono collegarsi ad almeno 1 altro passaggio del flusso di lavoro. Puoi aggiungere passaggi all’esterno del flusso di lavoro in qualsiasi punto dell’editor, ma non saranno coinvolti nel flusso di lavoro a meno che non siano collegati a un altro passaggio da una freccia. Ogni passaggio può avere solo 1 passaggio precedente, perciò la convergenza di più rami del flusso di lavoro in un singolo percorso non è supportata.

Puoi configurare i dettagli dei passaggi di condizione e azione utilizzando il pannello di configurazione sul lato sinistro dell'editor del flusso di lavoro. Il pannello di configurazione viene visualizzato solo quando viene selezionato un passaggio.

Suggerimento

Puoi aggiungere una nota al flusso di lavoro nell'editor del flusso di lavoro. Le note ti consentono di registrare informazioni sul flusso di lavoro usando le tue stesse parole.

Aprire un flusso di lavoro nell'editor del flusso di lavoro

In Shopify Flow, puoi accedere all'editor del flusso di lavoro creando un nuovo flusso di lavoro oppure puoi cliccare su qualsiasi flusso di lavoro esistente e poi su Modifica.

Passaggi:

1. Dal pannello di controllo Shopify, vai su App > Flow.

2. Nella sezione Flussi di lavoro, esegui una delle azioni seguenti:

   • Per aprire l'editor per un nuovo flusso di lavoro vuoto, clicca su Crea flusso di lavoro.
   • Per aprire l'editor per un flusso di lavoro esistente, clicca sul flusso di lavoro, quindi su Modifica.

Aggiunta di un passaggio a un flusso di lavoro

Nell’editor del flusso di lavoro puoi aggiungere un passaggio al flusso di lavoro in uno dei modi seguenti:

• Passa il mouse su un passaggio esistente e clicca sull' + icona per selezionare un passaggio di condizione o azione da aggiungere come connessione successiva nel flusso di lavoro.
  • I passaggi di condizione hanno 2 icone +: una per il percorso Vero quando la condizione è soddisfatta e una per il percorso Falso quando la condizione non è soddisfatta.
  • Anche il passaggio dell'azione Esegui un'iterazione per ogni elemento (iterate) ha 2 icone +: una per Ripeti per ogni articolo, che ti consente di definire i passaggi che si verificano per ogni articolo nell'elenco, e una per Dopo l'ultimo articolo, che ti consente di definire i passaggi che si verificano dopo la restituzione dell'ultimo articolo nell'elenco.
• Clicca su uno spazio vuoto in un punto qualsiasi dell’editor del flusso di lavoro. Se nel flusso di lavoro non è già presente alcun trigger, il pannello di configurazione mostra le opzioni per il passaggio del trigger. Se è già presente un trigger, il pannello di configurazione mostra le opzioni per il passaggio di azione.

Copia e incolla i passaggi in un flusso di lavoro

Creare flussi di lavoro significa spesso ricreare passaggi già configurati altrove. Nell’editor dei flussi di lavoro puoi copiare uno o più passaggi esistenti di tipo azione o condizione e incollarli nello stesso flusso di lavoro o in un altro, anziché ricrearli da zero. I passaggi incollati mantengono i valori dei campi di configurazione dei passaggi copiati e, nel caso dei passaggi di tipo condizione, anche la logica. Sono quindi pronti all’uso con poche modifiche.

Quando copi più passaggi contemporaneamente, i collegamenti tra i passaggi copiati vengono mantenuti. Una condizione e i passaggi dei suoi percorsi Vero e Falso vengono quindi incollati come un unico gruppo collegato. I collegamenti con i passaggi che non hai copiato non vengono mantenuti, quindi il gruppo incollato non è collegato al resto del flusso di lavoro finché non lo colleghi. Se un passaggio copiato utilizza dati restituiti da un altro passaggio copiato, ad esempio un’azione Recupera dati, il passaggio incollato utilizza i dati restituiti dalla copia incollata di quell’azione.

I passaggi di trigger non possono essere copiati. Non è possibile copiare neanche i passaggi che utilizzano una pagina di configurazione personalizzata, come Invia email di marketing. Se la selezione include un passaggio che non può essere copiato, nessuno dei passaggi selezionati viene copiato.

Passaggi:

1. Apri un flusso di lavoro nell'editor del flusso di lavoro.
2. Seleziona i passaggi da copiare:
   • Per copiare un singolo passaggio, clicca sul passaggio di tipo azione o condizione.
   • Per copiare più passaggi, tieni premuto Maiusc sulla tastiera e clicca su ciascun passaggio da copiare oppure tieni premuto Maiusc e trascina per tracciare un riquadro attorno ai passaggi.
3. Copia i passaggi premendo ctrl + C su PC o command + C su Mac.
4. Facoltativo: se vuoi incollare i passaggi in un altro flusso di lavoro, aprilo nell’editor dei flussi di lavoro. Il flusso di lavoro di destinazione deve già contenere un passaggio di trigger.
5. Incolla i passaggi premendo ctrl + V su PC o command + V su Mac. Un singolo passaggio viene aggiunto vicino al cursore. Un gruppo di passaggi viene aggiunto nello spazio vuoto più vicino al cursore, con la stessa disposizione dei passaggi copiati. Il gruppo incollato viene selezionato in modo da poterlo spostare. Se il cursore non si trova sull’editor, i passaggi vengono aggiunti al centro dell’editor.
6. Collega i passaggi incollati al resto del flusso di lavoro prima di attivarlo.

Collegamento dei passaggi in un flusso di lavoro

Per funzionare, tutti i passaggi devono collegarsi ad almeno 1 altro passaggio del flusso di lavoro. L’editor del flusso di lavoro indica quali passaggi si collegano tra loro utilizzando le frecce direzionali. Per impostazione predefinita, i flussi di lavoro procedono verticalmente, dall’alto verso il basso, all’interno dell’editor del flusso di lavoro.

Quando aggiungi un passaggio al flusso di lavoro da un altro passaggio utilizzando l'icona +, il nuovo passaggio si collega automaticamente a quello precedente. Puoi anche creare manualmente una connessione tra i passaggi cliccando e tenendo premuto + sul primo passaggio e trascinando l'estremità della freccia sul secondo. Ogni passaggio può avere una sola connessione al passaggio precedente, quindi non è supportata la convergenza di più rami del flusso di lavoro in un unico percorso.

Puoi rimuovere una connessione tra i passaggi passando con il mouse sulla freccia che desideri rimuovere, quindi cliccando sull'icona .

Disposizione dei passaggi nell’editor del flusso di lavoro

Per organizzare manualmente il layout del flusso di lavoro, puoi spostare i passaggi all’interno dell’editor tramite il trascinamento della selezione. In questo modo è più semplice tracciare il flusso di lavoro durante la creazione. Per impostazione predefinita, i passaggi si collegano tra loro in un formato dall’alto verso il basso, ma puoi spostarli in qualsiasi punto dell’editor tramite il trascinamento della selezione senza interrompere i collegamenti delle frecce tra di essi.

Puoi spostare più passaggi in una sola volta tenendo premuto Maiusc sulla tastiera e cliccando sui passaggi che vuoi selezionare come gruppo. Clicca e trascina qualsiasi passaggio nel riquadro grigio del gruppo per spostare in blocco i passaggi inclusi.

Puoi ripristinare automaticamente il layout del flusso di lavoro con la spaziatura predefinita tra i passaggi per facilitarne la revisione. Clicca sull'icona , quindi clicca su Disponi flusso di lavoro per confermare il ripristino.

Eliminazione di un passaggio da un flusso di lavoro

Nell'editor del flusso di lavoro, puoi eliminare un passaggio dal flusso di lavoro passando il mouse sul passaggio che desideri eliminare, quindi cliccando sull'icona accanto al passaggio. L'eliminazione di un passaggio non può essere annullata.

Puoi eliminare più passaggi in una sola volta tenendo premuto Maiusc sulla tastiera e cliccando sui passaggi che vuoi selezionare come gruppo. Clicca sull’icona sopra il riquadro grigio del gruppo per eliminare i passaggi in blocco.

Se elimini un passaggio a cui ne sono collegati altri, questi ultimi rimangono nell’editor del flusso di lavoro, ma vengono scollegati dai passaggi precedenti. È necessario ricollegare manualmente i passaggi scollegati per continuare a utilizzarli nel flusso di lavoro.

Uso della barra degli strumenti di visualizzazione dell'editor del flusso di lavoro

Nella parte inferiore dell'editor del flusso di lavoro puoi cliccare su una delle seguenti icone nella barra degli strumenti di visualizzazione:

• Usa o per ridurre o aumentare lo zoom del flusso di lavoro.
• Usa per centrare il flusso di lavoro nell’area visibile dell’editor, al livello di zoom che lo mostra per intero.
• Usa per aprire la documentazione del Centro assistenza di Shopify Flow in una nuova scheda del browser.
• Usa per disporre il layout del flusso di lavoro.

Uso del pannello di configurazione del passaggio nell'editor del flusso di lavoro

Quando selezioni un passaggio, il pannello di configurazione viene visualizzato sul lato sinistro dell'editor del flusso di lavoro. Il pannello di configurazione contiene i dettagli del passaggio ed è il punto in cui puoi personalizzare la funzionalità di passaggi specifici, ad esempio impostando variabili, assegnando operatori logici o aggiungendo informazioni sull'azione personalizzata a seconda di ciò che vuoi che il passaggio esegua.

Le opzioni visualizzate nel pannello di configurazione sono direttamente correlate al tipo di passaggio che selezioni.

Aggiunta o modifica della descrizione di un passaggio

Puoi modificare la descrizione di qualsiasi passaggio di tipo condizione o azione dal pannello di configurazione. Clicca su Aggiungi descrizione o Modifica descrizione e inserisci una descrizione del passaggio con parole tue. Questo può aiutare te e i membri del tuo staff a interpretare l'operazione eseguita dal flusso di lavoro in base alla tua descrizione. Puoi eliminare tutto il testo nel campo della descrizione per ripristinare la descrizione del passaggio.

Verifica di un passaggio per contenuto di configurazione mancante

Se in un passaggio mancano dati o dettagli di configurazione che ne compromettono il funzionamento, nella parte superiore del passaggio viene visualizzato un banner Da rivedere. Clicca sul passaggio per aprire il pannello di configurazione e aggiungi i dati mancanti per rimuovere il banner Da rivedere. A meno che un campo non sia indicato come facoltativo, deve essere compilato affinché il passaggio sia considerato completamente configurato.

I passaggi mostrano un banner Da rivedere anche quando non sono collegati ad altri passaggi. Devi collegare il passaggio a un altro passaggio nel flusso di lavoro prima di poter continuare a configurarne i dettagli.

Se un banner Da rivedere non viene risolto prima di tentare di attivare il flusso di lavoro, il passaggio viene visualizzato come un errore e il flusso di lavoro non si attiverà. Devi risolvere tutti gli errori di configurazione in un flusso di lavoro prima che possa essere attivato.

Uso della finestra di dialogo 'Aggiungi una variabile'

Nel pannello di configurazione del passaggio alcuni campi hanno un'opzione Aggiungi una variabile per aggiungere una variabile al contenuto della configurazione. I set di dati visualizzati nella finestra di dialogo Aggiungi una variabile dipendono dai dati restituiti da qualsiasi passaggio precedente nel flusso di lavoro. Ad esempio, per impostazione predefinita, la finestra di dialogo Aggiungi una variabile viene visualizzata con le seguenti opzioni:

• Una barra di ricerca per cercare le variabili per nome o descrizione.
• I set di dati delle variabili predefiniti restituiti dal trigger del flusso di lavoro, che in genere includono le seguenti opzioni:
  • Variabili shop, che sono globali per il negozio.
  • Almeno 1 altro tipo, in base al trigger del flusso di lavoro.

Tuttavia, se aggiungi al flusso di lavoro passaggi che restituiscono dati aggiuntivi, come le azioni Recupera dati o Esegui codice, nella finestra di dialogo verranno visualizzati set di dati di variabili aggiuntivi che potrai selezionare per qualsiasi passaggio successivo nel ramo del flusso di lavoro, poiché i dati aggiuntivi sono ora disponibili in quel punto del flusso di lavoro. I dati restituiti più di recente vengono visualizzati per primi.

Puoi passare a variabili specifiche cliccando sulle diverse opzioni delle variabili. Alcune variabili hanno opzioni nidificate e presentano il simbolo > per indicare che esistono sotto-opzioni in quel percorso API della variabile. Quando raggiungi la fine di un percorso API della variabile, la variabile non ha l'opzione > e mostra un badge del tipo di contenuto della variabile, come String, Boolean, DateTime o Int, per indicare il tipo di informazione restituita dalla variabile.

Suggerimento

Per saperne di più su un particolare elemento di una variabile, passa il mouse sopra la variabile e clicca sull'icona per aprire il relativo articolo di Shopify Dev Docs.