Valori vecchi e nuovi: come un workflow può sfruttarli

Valori vecchi e nuovi: come un workflow può sfruttarli

Copia pagina

Shopify Flow

I trigger aggiornati di Shopify Flow trasmettono al workflow il record così com’è in quel momento. Le pagine di assistenza di Shopify lo specificano chiaramente per ciascuno di essi: sono disponibili solo i valori attuali, mentre quelli precedenti alla modifica non lo sono. Per un avviso che segnala che qualcosa è cambiato, ciò è sufficiente.

Molti workflow richiedono ulteriori informazioni. "Il prezzo è sceso di oltre il 10%" richiede il prezzo precedente. "L'handle è cambiato, reindirizzare il vecchio URL" richiede il vecchio handle. "Il cliente si è disiscritto" richiede di sapere che in precedenza era iscritto. Ogni trigger di modifica di questa app contiene entrambi i valori; pertanto, questi workflow consistono in una condizione e in un’azione, senza codice e senza necessità di inserire dati manualmente.

Da dove proviene il valore indicato in precedenza

L'app memorizza l'ultimo valore noto dei campi che monitora, per ogni record. Quando Shopify segnala un aggiornamento, l'app effettua un confronto e, qualora un campo monitorato risulti diverso, attiva il trigger con entrambi i valori. Nella pratica, sono due i dettagli rilevanti:

  • La prima volta che l’app rileva un record, si limita a memorizzarlo. Non viene attivata alcuna azione, poiché non vi è alcun dato con cui effettuare il confronto. Quando si attiva un trigger, l’app legge i record esistenti una sola volta in background, in modo che la prima modifica effettiva attivi già il trigger. Per gli ordini, per impostazione predefinita vengono letti i dati degli ultimi 60 giorni, ma è possibile estendere tale intervallo dall’interno dell’app.
  • I valori si riferiscono al momento in cui si verifica la modifica. Un workflow associato a un trigger “Flow aggiornato” legge il record al momento dell’esecuzione del workflow stesso. Se il record subisce un’ulteriore modifica un secondo dopo, oppure viene eliminato, tale workflow rileva lo stato più recente oppure non riesce a caricare il record. Un evento di questa app mantiene i valori con cui è stato creato. È possibile consultarli in un secondo momento nella Cronologia eventi dell’app.
È stato creato un evento nella Cronologia eventi, contrassegnato come “Riuscito”, con il prezzo precedente e quello attuale
Un evento, visualizzato nella Cronologia eventi dell'app: il prezzo prima e dopo la modifica.

Ciò che si può costruire solo utilizzando il valore precedente

Workflow Trigger La condizione che richiede il valore precedente Pronto all’uso
Reindirizzare il vecchio URL quando un prodotto o una collezione viene rinominato/a Modifica della denominazione del prodotto, modifica della denominazione della collezione nessuno: il reindirizzamento avviene da oldHandle a newHandle Reindirizzare i vecchi URL dei prodotti quando cambia l'identificativo di un prodotto, Reindirizzare i vecchi URL delle collezioni quando cambia l'identificatore di una collezione
Contrassegnare i prodotti il cui prezzo è diminuito del 10% o più Modifica del prezzo di una variante del prodotto priceChange.percentChange è minore o uguale a -10 Contrassegnare i prodotti quando il prezzo di una variante scende del 10% o più
Contrassegnare un prodotto come in offerta e rimuovere nuovamente il contrassegno Modifica del prezzo di una variante del prodotto priceChange.oldCompareAtPrice.amount è vuoto mentre priceChange.newCompareAtPrice.amount non lo è, o viceversa Contrassegnare i prodotti come in offerta quando viene aggiunto un prezzo di confronto, Rimuova l'etichetta di saldo quando viene rimosso il prezzo di confronto
Eseguire l'evasione di un ordine al ricevimento di un pagamento in sospeso Modifica dello stato finanziario dell'ordine oldFinancialStatus è pari a pending e newFinancialStatus è pari a paid Contrassegnare gli ordini al ricevimento di un pagamento in sospeso
Avvisare il magazzino qualora l’indirizzo dovesse cambiare dopo la checkout Modifica dell'indirizzo di spedizione dell'ordine nessuno: il messaggio riporta oldShippingAddress e shippingAddress Contrassegnare gli ordini quando l'indirizzo di spedizione cambia dopo il checkout
Contrassegnate i clienti che annullano l'iscrizione e rimuovete il tag quando tornano Modifica del consenso dei clienti all’email marketing consentState è pari a unsubscribed; oldConsentState indica quale fosse il valore precedente Assegnate un tag ai clienti quando annullano l'iscrizione alle e-mail di marketing
Mantenete lo SKU precedente per il vostro ERP o feed Modifica del codice articolo (SKU) della variante del prodotto nessuno: skuChange.oldSku viene scritto in un metacampo Salvare lo SKU precedente quando lo SKU di una variante subisce una modifica
Verifichi il margine quando un costo aumenta Modifica del costo di una variante del prodotto variantCostChange.percentChange maggiore di 5 Contrassegnare i prodotti per una revisione dei margini qualora il costo di una variante aumenti
Contrassegnare un prodotto come “scorte in esaurimento” una sola volta, quando supera la soglia Variazione del livello dell'inventario presso la sede inventoryLevel.oldAvailable è maggiore o uguale a 5 e inventoryLevel.newAvailable è minore di 5 Contrassegnare i prodotti come “scorte in esaurimento” quando l’inventario scende al di sotto di cinque

Altri tre modelli che i merchant realizzano autonomamente:

  • Quando l’indirizzo e-mail di un cliente cambia, comunichi il vecchio indirizzo. L’evento “Customer Email Changed” contiene i campi oldEmail e email. Invii la notifica a oldEmail tramite un’azione e-mail che accetti una variabile come destinatario, ad esempio Workflow Transactional Email. Senza il vecchio indirizzo, non rimane nessuno a cui inviare l’avviso.
  • Reagire a una fase in uno stato personalizzato. Un metacampo loyalty.tier passa da silver a gold: l’aggiornamento del metacampo del cliente contiene metafield.previousValue e metafield.value, pertanto il workflow può congratularsi in caso di passaggio a un livello superiore e non intervenire in caso di passaggio a un livello inferiore.
  • Agire su un tag rimosso. Una volta rimosso un tag, un record appare come se non lo avesse mai avuto. I tag "Ordine", "Cliente", "Prodotto" e "Bozza d'ordine rimossi" indicano i tag rimossi. Si veda Eseguire un workflow quando viene aggiunto o rimosso un tag specifico.

Ogni valore precedente e successivo, in base al trigger

Ordini

Trigger Prima e dopo
Tag dell'ordine aggiunti, tag dell'ordine rimossi addedTags, removedTags, previousTags, currentTags
Modifica della nota d'ordine oldNote, newNote
Modifica dello stato finanziario dell'ordine oldFinancialStatus, newFinancialStatus
Modifica nell'evasione degli ordini oldFulfillmentStatus, newFulfillmentStatus e, per riga o spedizione, in changes.items: evaso, non evaso, tracciamento aggiornato con numero, URL e azienda
Modifica dello stato di visualizzazione dell'ordine oldDisplayFulfillmentStatus, newDisplayFulfillmentStatus
Modifica degli attributi dell'ordine changes.items con changeType, key, oldValue, newValue
Modifiche agli articoli d’ordine changes.items, con changeType (aggiunto, rimosso, quantità, prezzo o variante modificata) e la quantità, il prezzo e la variante precedenti e attuali
Modifica dell'indirizzo di spedizione dell'ordine shippingAddress e oldShippingAddress, anch’essi come campi distinti
Aggiornamento dell'ordine dei metacampi metafield.value, metafield.previousValue
Aggiornamento sull'ordine changes.fields e changes.items con field, oldValue, newValue per lo stato finanziario, lo stato di evasione, i tag, le note, gli articoli e gli attributi personalizzati

Clienti

Trigger Prima e dopo
Tag cliente aggiunti, tag cliente rimossi addedTags, removedTags, previousTags, currentTags
Modifica della nota del cliente oldNote, newNote
Modifica dello stato del cliente oldState, newState
Modifica del nome del cliente firstName, lastName, oldFirstName, oldLastName
Modifica dell'indirizzo e-mail del cliente email, oldEmail
Modifica del numero di telefono del cliente phone, oldPhone
Modifica dell'indirizzo del cliente address e oldAddress, ciascuno dei quali costituisce inoltre un campo a sé stante
Modifica del consenso alla campagna di marketing via e-mail per i clienti, modifica del consenso alla campagna di marketing via SMS per i clienti consentState, optInLevel, oldConsentState, oldOptInLevel
Aggiornamento dei metacampi del cliente metafield.value, metafield.previousValue
Aggiornamento per i clienti changes.fields e changes.items per i tag, le note e lo stato

Prodotti e varianti

Trigger Prima e dopo
Tag prodotto aggiunti, tag prodotto rimossi addedTags, removedTags, previousTags, currentTags
Modifica di titolo del prodotto, identificativo, descrizione, stato, fornitore e tipo il valore precedente e quello nuovo, ad esempio oldTitle e newTitle
Prodotto pubblicato sul canale, prodotto rimosso dal canale channels.added, channels.removed, channels.current
Modifica del prezzo di una variante del prodotto priceChange.oldPrice, newPrice, oldCompareAtPrice, newCompareAtPrice, delta, percentChange, direction
Modifica del prezzo unitario di una variante del prodotto unitPriceChange.oldUnitPrice, newUnitPrice, delta, percentChange, direction
Modifica del costo di una variante del prodotto variantCostChange.oldCost, newCost, delta, percentChange, direction
Modifica del codice articolo (SKU) della variante del prodotto skuChange.oldSku, newSku
Modifica del codice a barre di una variante del prodotto barcodeChange.oldBarcode, newBarcode, gli elenchi dei codici a barre precedenti e attuali, added, removed
Aggiornamento dei metacampi del prodotto, aggiornamento dei metacampi delle varianti del prodotto metafield.value, metafield.previousValue
Aggiornamento sul prodotto changes.fields e changes.items per titolo, identificativo, descrizione, stato, fornitore, tipo di prodotto e tag; per ogni variante, invece, per prezzo, prezzo di confronto, SKU, codice a barre, politica di gestione dell’inventario, assoggettabilità all’imposta, titolo, opzioni e immagine

Scorte, collezioni, sedi e altro ancora

Trigger Prima e dopo
Variazione dell'inventario, esaurimento dell'inventario e ripristino dell'inventario presso la sede inventoryLevel.oldAvailable``newAvailable``delta``percentChange``direction, con l'ubicazione
Titolo, identificativo e descrizione della collezione modificati il valore precedente e quello attuale
Aggiornamento della sede, Aggiornamento dell'azienda, Aggiornamento della sede aziendale, Aggiornamento degli sconti, Aggiornamento del blog, Aggiornamento di un post sul blog, Aggiornamento della pagina changes.fields e changes.items nel record, sempre
Aggiornamento sulla raccolta, aggiornamento sulla bozza d’ordine, aggiornamento sul mercato lo stesso elenco changes, quando l'opzione Invia valori vecchi e nuovi è attiva
I dieci fattori scatenanti delle bozze d'ordine lo stesso schema degli ordini: tag, note, attributi, articoli, stato, e-mail e indirizzi
Aggiornamento dei metacampi per 15 tipi di record metafield.value, metafield.previousValue

Guida completa ai trigger elenca ogni trigger con tutti i relativi campi.

I numeri sono già calcolati

Le condizioni di Flow effettuano un confronto, non un calcolo, e gli importi monetari vengono inseriti in Flow sotto forma di testo. Pertanto, l’espressione «diminuito di oltre il 10%» non può essere elaborata all’interno di un workflow a partire da due prezzi. I trigger relativi a prezzo, prezzo unitario, costo e giacenza inviano quindi il risultato sotto forma di numeri:

Campo Significato Esempio
delta nuovo valore meno vecchio valore -5
percentChange la variazione espressa in percentuale rispetto al valore precedente -12.5 significa che è diminuito del 12,5 per cento
direction increase, decrease o unchanged decrease
Il selettore di variabili di Shopify Flow per la modifica del prezzo delle varianti del prodotto con i campi oldPrice, newPrice, delta, percentChange e direction
Le variabili relative alla variazione di prezzo delle varianti del prodotto nel selettore di Shopify Flow.
Condizione di Shopify Flow: priceChange.percentChange è inferiore a -10
Una condizione relativa alla percentuale calcolata dall'app. Non è necessario alcun passaggio di programmazione.
Shopify Flow fornisce il valore precedente di un campo?

Non con i propri trigger aggiornati. Le pagine di assistenza di Shopify relative ai trigger “Prodotto aggiornato”, “Ordine aggiornato”, “Cliente aggiornato” e agli altri trigger di aggiornamento indicano che nel workflow sono disponibili solo i valori attuali. I trigger di questa app inviano invece il valore precedente e quello successivo.

È possibile calcolare il valore precedente all’interno di Shopify Flow?

Solo se l’avete memorizzato voi stessi prima della modifica, ad esempio copiando un valore in un metacampo tramite un altro workflow e poi rileggendo tale valore. Tale copia deve esistere prima della prima modifica ed essere mantenuta aggiornata per ogni record. L’applicazione si occupa di questa gestione per i campi che monitora.

Il valore precedente è disponibile per i metacampi?

Sì. Ogni trigger metacampo di questa app include metafield.previousValue oltre a metafield.value, per 15 tipi di record. Si veda Modifiche ai metacampi in Shopify Flow: i trigger aggiornati e i trigger dei metacampi.

Perché non si è attivato nulla al primo cambio di disco?

L'app necessita di un punto di partenza. Quando viene attivato un trigger, l'app esegue una lettura in background dei record esistenti. Qualsiasi modifica apportata prima che tale lettura raggiungesse il record viene semplicemente registrata. La modifica successiva attiva il trigger. Cronologia degli eventi e risoluzione dei problemi mostra lo stato di tale sincronizzazione.

Prossimi passi