Valori vecchi e nuovi: come un workflow può sfruttarli
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.

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
oldEmaileemail. Invii la notifica aoldEmailtramite 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.tierpassa dasilveragold: l’aggiornamento del metacampo del cliente contienemetafield.previousValueemetafield.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 |


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
- I trigger aggiornati di Flow e le estensioni dei trigger Workflow Trigger Extensions - Confronto tra i trigger aggiornati di Flow e questa app.
- Monitorare più di cinque campi in un unico workflow: monitorare un numero qualsiasi di campi in un unico workflow.
- Modelli di workflow: workflow già pronti basati su valori precedenti e nuovi.
