Trigger del metacampo del prodotto

Trigger del metacampo del prodotto

Copia pagina

Avviare un workflow Shopify Flow quando cambia un metacampo del prodotto e ottenere il valore precedente e quello nuovo con Workflow Trigger Extensions.

Un produttore registra la fase di produzione nel metacampo del prodotto denominato Stato di produzione (custom.production_status). Ogni volta che la fase cambia, ad esempio da in_production a quality_check, il team responsabile della fase successiva dovrebbe esserne informato.

In questa pagina viene illustrato come avviare un workflow Shopify Flow ogni volta che un metacampo di un prodotto subisce una modifica, utilizzando Workflow Trigger Extensions. I passaggi sono gli stessi per ogni metacampo di questo tipo di risorsa; nell’esempio viene utilizzato lo stato di produzione (custom.production_status).

Cosa vi serve

  • Una definizione di metacampo. La crei nella Sua area di amministrazione di Shopify alla voce Impostazioni > Metacampi e metaoggetti > Prodotti. Un metacampo privo di definizione non può essere monitorato.
  • L'autorizzazione Accesso ai dati relativi a prodotti, varianti e collezioni. La si concede nella pagina Autorizzazioni dell'app; si veda Autorizzazioni e accesso ai dati.

1. Monitorare i metacampi

  1. Apra la sezione Trigger dei metacampi nell'app e faccia clic su Aggiungi trigger.
  2. Selezioni il tipo di risorsa Prodotto.
  3. Selezioni il metacampo, in questo caso Stato di produzione. È possibile selezionarne più di uno alla volta oppure utilizzare l’opzione Seleziona tutto.
  4. Fare clic su Aggiungi trigger.

Per monitorare tutti i metacampi di questo tipo di risorsa, compresi quelli che creerete in seguito, selezionate Tutti i metacampi anziché spuntare quelli singoli, quindi fate clic su Monitora tutti i metacampi.

La finestra di dialogo “Aggiungi trigger metafield” con il tipo di risorsa “Prodotto” e il metacampo “Stato di produzione” (custom.production_status) selezionato
Tipo di risorsa: Prodotto, con il metacampo selezionato. L’opzione “Tutti i metacampi” tiene invece traccia di tutti i metacampi di quel tipo.

Il nuovo trigger mostra il messaggio Inizializzazione mentre l’app legge il valore corrente del metacampo sui vostri prodotti esistenti, per poi passare allo stato Attivo. È proprio grazie a quella prima lettura che la primissima modifica arriva già con il valore precedente corretto.

Se il metacampo non è presente nell'elenco, faccia clic su Aggiorna metacampo nella pagina "Trigger dei metacampi": l'app memorizza l'elenco delle definizioni per un'ora.

2. Cosa riceve il workflow

Ogni modifica attiva il trigger Metacampo Update in Shopify Flow con i seguenti valori:

Variabile Valore
resourceType PRODUCT
resourceId L'ID del prodotto, ad esempio gid://shopify/Product/1234567890
metafieldKey Spazio dei nomi e chiave, in questo caso custom.production_status
metafield.value Il nuovo valore
metafield.previousValue Il valore precedente alla modifica; vuoto quando il metacampo è stato impostato per la prima volta
metafield.type Il tipo del metacampo, ad esempio single_line_text_field

Aggiornamento metacampo prodotto è un secondo trigger per la stessa modifica. Si avvia in aggiunta all’aggiornamento metacampo e gestisce il prodotto come riferimento nativo di Flow, pertanto le azioni relative al prodotto di Shopify funzionano su di esso senza necessità di un passaggio di ricerca. Entrambi condividono un unico evento, pertanto il loro utilizzo non viene conteggiato due volte. Attivatelo dalla pagina Trigger dell’app oppure attivate un workflow che lo utilizzi.

3. Creare il workflow

  1. In Shopify Flow, crei un workflow e selezioni il trigger Aggiornamento metacampo delle estensioni Workflow Trigger Extensions.
  2. Aggiunga una condizione: resourceType è uguale a PRODUCT. L'aggiornamento dei metacampi viene avviato per ogni tipo di risorsa che monitora, pertanto questa condizione limita il workflow ai prodotti. Qualora monitori diversi metacampi di questo tipo, aggiunga come secondo criterio che metafieldKey sia uguale a custom.production_status.
  3. Aggiunga l'azione desiderata. Nell'esempio viene inviata un'e-mail interna contenente il valore precedente e quello nuovo.
Il workflow di esempio in Shopify Flow: Aggiornamento del metacampo, una condizione relativa al tipo di risorsa PRODOTTO e invio di un’e-mail interna
Esempio di workflow: il trigger, la condizione relativa al tipo di risorsa e un’azione.

Si parta dall'esempio

  1. Scarichi il file .flow allegato in fondo a questa pagina.
  2. Nella dashboard di Shopify, apra Shopify Flow, faccia clic su Importa e selezioni il file.
  3. Apra la fase Invia e-mail interna e inserisca il destinatario. Il file non contiene alcun indirizzo, intenzionalmente.
  4. Attivi il workflow.

Lo renda suo

  • Aggiunga una seconda condizione su metafield.value per assegnare ciascuna fase a un team diverso.
  • Aggiunga invece un tag al prodotto: selezioni l’azione Aggiungi tag al prodotto e inserisca {{resourceId}} nel campo relativo al prodotto.
  • Confronti metafield.previousValue con metafield.value per reagire solo quando un valore aumenta o diminuisce.

Con quale rapidità reagisce

Shopify invia una notifica all'app quando un prodotto viene salvato, pertanto il workflow si avvia solitamente nel giro di pochi secondi.

Altro