Informazioni sulle condizioni in Shopify Flow

Una condizione è un passaggio di un flusso di lavoro in cui viene presa una decisione su come procedere, a seconda che una serie di criteri sia stata soddisfatta o meno. Ogni passaggio della condizione ha 2 possibilità: Vero, quando i criteri sono stati soddisfatti, e Falso, quando i criteri non sono stati soddisfatti. Se non definisci un passaggio successivo per una delle due possibilità scegliendo un’altra condizione o azione, l’esecuzione del flusso di lavoro si interrompe.

Ad esempio, se il tuo flusso di lavoro si attiva quando viene creato un ordine, una condizione potrebbe verificare se sull’ordine è stato utilizzato uno specifico codice sconto AFFILIATE10. In caso affermativo, l’opzione Vero potrebbe portare a un’azione che invia un’email all’affiliato per informarlo che il suo codice è stato utilizzato. In caso negativo, l’opzione Falso potrebbe essere vuota, a indicare che non accadrà nient’altro e che l’esecuzione del flusso di lavoro terminerà.

Un flusso di lavoro può avere un numero qualsiasi di condizioni, a seconda della sua complessità. Le condizioni possono anche collegarsi ad altre condizioni o azioni, a seconda di ciò che vuoi che il flusso di lavoro faccia. Le condizioni possono essere impostate per collegarsi in sequenza (ad esempio, se la condizione A è vera, controlla la condizione B; se A è falsa, controlla C) oppure puoi impostarle in modo che si verifichino contemporaneamente come parte dello stesso passaggio (ad esempio, controlla se A, B o C è vera).

Creazione di condizioni per il flusso di lavoro

A differenza di un trigger o di un’azione, che puoi selezionare da un elenco preimpostato di opzioni disponibili in Shopify Flow, le condizioni vengono create da zero selezionando variabili, operatori logici e valori per creare l’istruzione condizionale:

• Una variabile è un segnaposto che definisce i dati utilizzati dalla condizione. Ad esempio, se una condizione deve verificare la presenza di un codice sconto specifico su un ordine, la variabile sarà order.discountCode. Le variabili utilizzano la notazione a punti della GraphQL Admin API.
• Un operatore logico indica in che modo il flusso di lavoro deve determinare se la condizione è soddisfatta. Gli operatori logici possono essere applicati a livello di variabile o quando più variabili vengono incluse come parte dei criteri generali della condizione:
  • Le opzioni a livello di variabile includono operatori a livello di campo come Maggiore di o Inizia con oppure operatori di elenco come Almeno uno di o Tutti.
  • Le opzioni a livello di condizione includono AND, ovvero tutte le variabili devono essere vere affinché la condizione sia considerata complessivamente vera, oppure OR, ovvero almeno 1 variabile deve essere vera affinché la condizione sia considerata complessivamente vera.
• Un valore è l'informazione effettiva che la variabile sta cercando. Ad esempio, se lo specifico order.discountCode che vuoi che il flusso di lavoro verifichi è AFFILIATE10, quello sarà il valore da includere come parte della condizione.

Man mano che selezioni le variabili e gli operatori, il passaggio della condizione nell'area di lavoro di Shopify Flow si aggiorna per riflettere l’istruzione condizionale in un linguaggio semplice, in modo che tu possa ricontrollare se la condizione che stai creando è formattata correttamente. Puoi cliccare su Aggiungi descrizione per sovrascrivere l'istruzione condizionale predefinita con la tua descrizione.

Scopri informazioni più dettagliate sugli elementi delle condizioni in Shopify Flow.

Informazioni sulle variabili nelle condizioni

Quando crei un passaggio di condizione in un flusso di lavoro, il primo passaggio che ti viene richiesto di eseguire è Aggiungi una variabile. Ma cos'è una variabile?

In Shopify Flow, una variabile è un segnaposto che indica i dati utilizzati dalla condizione nel flusso di lavoro. Quando una condizione recita “Se A è maggiore di 10...”, la parte A è la variabile. Scegliere una variabile per una condizione equivale essenzialmente a indicare alla condizione quali dati specifici valutare.

Le variabili sono formattate utilizzando la notazione a punti della GraphQL Admin API. Non è necessario avere familiarità con l'API per creare flussi di lavoro con l'app Flow, ma una conoscenza di base dei nomi e delle definizioni delle variabili può aiutarti a creare la logica specifica del flusso di lavoro che desideri.

Per capire quali dati rappresenta una variabile, considera le seguenti informazioni sulle variabili:

• Come leggere la notazione a punti delle variabili.
• Informazioni sui requisiti dei dati per le variabili.
• Individuazione della variabile corretta durante una ricerca.

Suggerimento: ricevi assistenza per le variabili dall'Assistente Dev Docs

Se non sai quale variabile selezionare durante la creazione della condizione, valuta la possibilità di chiedere consiglio all'Assistente Dev Docs di Shopify. L'Assistente Dev Docs ha accesso a tutta la documentazione relativa alla GraphQL Admin API e può offrire suggerimenti su come formattare una condizione in Shopify Flow:

1. Vai a Shopify Dev Docs.
2. Clicca su Chiedi all’assistente per aprire il pannello della chat.
3. Nel campo del messaggio, inserisci la richiesta, ad esempio «Quale variabile dovrei usare in Shopify Flow se volessi accedere ai dati dei tag del cliente quando il trigger inizia con “Ordine creato”?».
4. Premi Invio o clicca su .

Lettura della notazione con punti delle variabili

Quando selezioni le variabili, noterai che sono formattate come parole chiave separate da punti, ad esempio order.customer.tag. Questo formato indica i passaggi che l'API compie per arrivare ai dati che vuoi utilizzare. Ogni “passaggio” di una variabile è separato da un punto e il percorso verso i dati viene letto da sinistra a destra. La lunghezza delle variabili può variare a seconda di dove sono archiviati i dati nell'API e del percorso che il flusso di lavoro segue per raggiungerli.

Ad esempio:

• order.email: controlla l'indirizzo email associato al cliente per l'ordine. È simile a come potresti cliccare su un ordine e quindi controllare l'indirizzo email nei dettagli dell'ordine.
• refunds_item.staffMember.name: controlla l'ordine per il rimborso di un articolo, passa alle informazioni del membro dello staff associate a quel rimborso e controlla il nome completo di quel membro dello staff.

Quando scegli una variabile, considera come navigheresti nel pannello di controllo Shopify per trovare le informazioni che desideri. È probabile che l'API debba intraprendere un percorso simile, il che può aiutarti a determinare come potrebbe essere formattata la variabile.

Ad esempio, se stai esaminando un nuovo ordine e vuoi sapere in quale gruppo RFM si trova il cliente associato all'ordine, allora potresti pensare di cliccare sul nome del cliente nell'ordine per essere reindirizzato alla pagina dei dettagli del cliente nel pannello di controllo Shopify e quindi potresti controllare il riepilogo delle analisi del cliente per leggere quale valore viene visualizzato nella colonna Gruppo RFM.

La variabile che useresti per restituire gli stessi dati in Shopify Flow utilizzerebbe un percorso simile: order.customer.statistics.rfmGroup.

Requisiti dei dati per le variabili

Le variabili richiedono dati. Se i dati giusti non sono disponibili per la variabile, la condizione non funzionerà e il flusso di lavoro avrà esito negativo. A seconda del trigger che hai selezionato come inizio del flusso di lavoro, le opzioni per le variabili da aggiungere alle condizioni cambiano per riflettere le opzioni possibili in base ai dati disponibili.

Ad esempio, se il flusso di lavoro inizia con il trigger Prodotto creato, le condizioni che crei da quel trigger sono limitate alle variabili disponibili dal set di dati prodotto. Pertanto, variabili come product.category.name, product.vendor e variants_item.displayName sono tutte disponibili per l'uso come parte della condizione. Al contrario, variabili come customer.verifiedEmail o subscriptionContracts_item.status non verrebbero visualizzate come opzioni, perché non sono associate al set di dati del prodotto.

Tuttavia, questo non significa necessariamente che i dati contenuti in altri set di dati siano completamente inaccessibili. È possibile accedere ad alcuni dati da più percorsi nell'API, nello stesso modo in cui potresti cliccare su link diversi per raggiungere la stessa pagina nel pannello di controllo Shopify. In pratica, ciò significa che trigger diversi richiedono una notazione di variabile diversa per restituire le stesse informazioni.

Ad esempio, vuoi che il flusso di lavoro controlli i tag sul profilo di un cliente. Se il flusso di lavoro inizia con il trigger Ordine creato, la variabile sarà order.customer.tags, perché il flusso di lavoro inizia con i dati dell'ordine, quindi controlla le informazioni del cliente nell'ordine e infine controlla i tag su quel cliente. Se il flusso di lavoro inizia con il trigger Cliente creato, la variabile sarà semplicemente customer.tags, perché il flusso di lavoro inizia con i dati del cliente e può quindi passare direttamente al controllo dei tag sul profilo cliente.

Controlla il percorso di una variabile durante la ricerca in base alle parole chiave

A causa dello stile di notazione con punti in Shopify Flow, la ricerca di variabili da utilizzare in una condizione basata su parole chiave può restituire più risultati. Capire cosa indica il percorso della variabile è importante per determinare quale variabile scegliere quando crei la condizione.

Ad esempio, il flusso di lavoro utilizza il trigger Ordine creato e cerchi una variabile utilizzando la parola chiave tags. La ricerca potrebbe restituire i seguenti risultati, che controllano informazioni diverse nell'ordine:

• order.tags: i tag applicati all'ordine stesso. Ad esempio, #ordineurgente o #regalo.
• order.customer.tags: i tag applicati al cliente che ha effettuato l'ordine. Ad esempio, #VIP o #affiliato.
• order.lineItems.product.tags: i tag applicati ai prodotti acquistati nell'ordine. Ad esempio, #fragile o #richiedeID.

A seconda del tipo di tag che vuoi che il flusso di lavoro controlli, devi selezionare la variabile corretta in modo che la condizione funzioni come previsto.

Comprensione degli operatori logici nelle condizioni

Gli operatori logici definiscono il modo in cui viene applicata una condizione e fanno in modo che un'istruzione risulti vera o falsa. Quando una condizione recita “Se A è maggiore di 10...”, la parte è maggiore di è l'operatore logico. La scelta di un operatore logico per una condizione equivale essenzialmente a indicare alla condizione come valutare la variabile.

Nei flussi di lavoro di Shopify Flow, esistono 3 tipi di operatori logici:

• Operatori a livello di campo, come Maggiore di o Inizia con.
• Operatori di elenco, come Almeno uno di o Tutti.
• Operatori a livello di condizione, come E o O.

Gli operatori a livello di campo e gli operatori di elenco si applicano a livello di variabile, mentre gli operatori a livello di condizione si applicano alla condizione generale e possono essere utilizzati per combinare più variabili in un'unica condizione.

Gli operatori a livello di campo sono i tipi di operatore più comuni, utilizzati in ogni tipo di istruzione di variabile. Con gli operatori a livello di campo, puoi creare istruzioni condizionali come “Se A è maggiore di 10, allora esegui X” o “Se B contiene ‘VIP’, allora esegui X” per avere un maggiore grado di controllo su quali valori di una variabile restituiscono un risultato vero. Uguale a è l'operatore logico predefinito.

Gli operatori di elenco si applicano solo alle variabili che possono restituire un elenco di risultati. Ad esempio, la variabile lineItems_item.variant.price restituisce il prezzo di una variante di prodotto nell'ordine, che può restituire un elenco di risultati quando il cliente acquista più prodotti nello stesso ordine. Ciò significa che puoi applicare un operatore di elenco come Almeno uno di quando vuoi che un'istruzione condizionale come “lineItems_item.variant.price è maggiore di 10 $” sia vera se nell'ordine è presente almeno una variante di prodotto con un prezzo superiore a 10 $. Al contrario, gli operatori di elenco non vengono visualizzati per le variabili che possono restituire un solo risultato alla volta. Ad esempio, esiste un solo valore possibile per una variabile come order.createdAt perché un ordine può essere creato una sola volta, quindi gli operatori di elenco non vengono visualizzati come opzioni per modificare l'istruzione che contiene tale variabile.

Gli operatori a livello di condizione come AND e OR ti consentono di includere più variabili nella stessa condizione. Ad esempio, anziché una semplice istruzione condizionale come «Se A è uguale a 5, allora esegui X», puoi creare condizioni più complesse come «Se A è uguale a 5 e B è maggiore di 10, allora esegui X», che richiede che entrambe le variabili A e B siano vere, oppure «Se A è uguale a 5 o B è maggiore di 10 o C è minore di 1, allora esegui X», che richiede che solo 1 tra A, B o C sia vera. Usa AND quando tutti gli elementi in un flusso di lavoro devono essere veri; usa OR quando è sufficiente che un solo criterio sia soddisfatto perché la condizione sia vera.

Perché è importante: capire come funzionano gli operatori logici nelle condizioni ti consente di creare flussi di lavoro che verificano esattamente i criteri desiderati. Con i 3 tipi di operatori logici, puoi creare istruzioni condizionali dettagliate e complesse per creare flussi di lavoro che verificano condizioni molto specifiche.

Scopri informazioni più dettagliate sugli operatori logici nelle condizioni.