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 è un'area di lavoro con trascinamento della selezione che ti permette di aggiungere, organizzare e progettare i flussi di lavoro aggiungendo passaggi di diversi tipi in un formato verticale, dall'alto verso il basso.

Attenzione

Tutti i flussi di lavoro esistenti creati prima del 10 dicembre 2025 manterranno il formato legacy da sinistra a destra. A gennaio 2026, tutti i flussi di lavoro verranno aggiornati al formato dall'alto verso il basso. Se desideri aggiornare i tuoi flussi di lavoro esistenti da sinistra a destra per utilizzare il formato verticale prima di gennaio 2026, puoi riorganizzare automaticamente il flusso di lavoro nell'area di lavoro per renderlo dall'alto verso il basso. Questa azione non può essere annullata.

Il primo passaggio che puoi aggiungere a un flusso di lavoro utilizzando l'editor del flusso di lavoro è sempre un passaggio del trigger. Dopo aver aggiunto il trigger del flusso di lavoro, puoi utilizzare le icone + per aggiungere passaggi di condizione o azione che si verificano successivamente nella sequenza del flusso di lavoro. Le frecce collegano i diversi passaggi nell'area di lavoro dell'editor e indicano quali passaggi portano direttamente ad altri passaggi in base alle condizioni soddisfatte o alle azioni intraprese.

Tutti i passaggi devono essere collegati ad almeno un altro passaggio del flusso di lavoro per funzionare. Puoi aggiungere passaggi al di fuori del flusso di lavoro in qualsiasi punto dell'area di lavoro dell'editor, ma questi non verranno coinvolti nel flusso di lavoro a meno che non siano collegati a un altro passaggio da una freccia. Ogni passaggio può avere un solo passaggio precedente, quindi non è supportata la convergenza di più rami del flusso di lavoro in un unico percorso.

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 all'area di lavoro del 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 qualsiasi punto dell'area di lavoro del flusso di lavoro. Se non ci sono trigger esistenti nell'area di lavoro, il pannello di configurazione mostra le opzioni del passaggio del trigger. Se nell'area di lavoro è presente un trigger, il pannello di configurazione mostra le opzioni del passaggio dell'azione.

Collegamento dei passaggi in un flusso di lavoro

Tutti i passaggi devono essere collegati ad almeno un altro passaggio del flusso di lavoro per funzionare. L'editor del flusso di lavoro indica quali passaggi si collegano tra loro utilizzando frecce direzionali. Per impostazione predefinita, i flussi di lavoro scorrono verticalmente dall'alto verso il basso nell'area 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 sul canvas del flusso di lavoro

Puoi utilizzare l'area di lavoro con trascinamento della selezione dell'editor del flusso di lavoro per organizzare manualmente la visualizzazione del flusso di lavoro. Questo ti aiuta a tenere traccia più facilmente del flusso di lavoro mentre lo crei. Per impostazione predefinita, i passaggi si collegano tra loro in un formato dall'alto verso il basso, ma puoi trascinare e rilasciare i passaggi in qualsiasi punto dell'area di lavoro senza interrompere le connessioni tramite freccia tra i passaggi.

Puoi spostare più passaggi contemporaneamente tenendo premuto Maiusc sulla tastiera e cliccando sui passaggi che desideri 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.

Attenzione

Se ripristini automaticamente un flusso di lavoro esistente che utilizza il formato legacy da sinistra a destra, il layout del flusso di lavoro verrà aggiornato e sarà dall'alto verso il basso. Questa azione non può essere annullata.

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 contemporaneamente tenendo premuto Maiusc sulla tastiera e cliccando sui passaggi che desideri 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 rimarranno sul canvas del flusso di lavoro ma verranno scollegati da tutti i passaggi precedenti. Dovrai 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 al centro del canvas visibile, al livello di zoom che mostra l'intero flusso di lavoro.
• 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.