Trigger del metacampo "Trasferimento di magazzino"

Trigger del metacampo "Trasferimento di magazzino"

Copia pagina

Avvia un workflow Shopify Flow quando cambia un metacampo di un trasferimento di inventario e ottieni il valore precedente e quello nuovo.

Un commerciante trasferisce le scorte da un magazzino all’altro e inserisce il numero di tracciamento del trasportatore nel metacampo di trasferimento Riferimento del vettore (custom.carrier_reference). Non appena tale campo viene compilato, il magazzino di destinazione dovrebbe riceverlo.

Questa pagina illustra come avviare un workflow Shopify Flow ogni volta che un metacampo di un trasferimento di inventario subisce una modifica, utilizzando Workflow Trigger Extensions. I passaggi sono gli stessi per ogni metacampo di questo tipo di risorsa; l’esempio utilizza il riferimento al corriere (custom.carrier_reference).

Cosa vi serve

  • Una definizione di metacampo. La crei nella Sua area di amministrazione di Shopify alla voce Impostazioni > Metacampi e metaoggetti > Trasferimenti. Un metacampo privo di definizione non può essere monitorato.
  • L'autorizzazione Trasferimenti di inventario - Accesso ai dati. La si conceda nella pagina Autorizzazioni dell'app; si veda Autorizzazioni e accesso ai dati.

1. Monitorare il metacampo

  1. Apra la sezione Trigger dei metacampi nell'app e faccia clic su Aggiungi trigger.
  2. Selezioni il tipo di risorsa Trasferimento.
  3. Selezioni il metacampo, in questo caso Riferimento operatore. È 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 “Trasferimento” e il metacampo “Riferimento vettore”, custom.carrier_reference, selezionato
Tipo di risorsa: Trasferimento, con il metacampo selezionato. L’opzione “Tutti i metacampi” tiene invece traccia di tutti i metacampi di quel tipo.

Il trigger si attiva immediatamente. La prima volta che l’app legge un trasferimento di magazzino, memorizza il valore corrente senza avviare un workflow; ogni modifica successiva ne avvia uno.

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 TRANSFER
resourceId L'ID del trasferimento dell'inventario, ad esempio gid://shopify/InventoryTransfer/1234567890
metafieldKey Spazio dei nomi e chiave, in questo caso custom.carrier_reference
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

3. Creare il workflow

  1. In Shopify Flow, crei un workflow e selezioni il trigger Aggiornamento metacampo delle estensioni Workflow Trigger Extensions.
  2. metafieldKey è uguale a custom.carrier_reference. L'aggiornamento dei metacampi viene avviato per ogni tipo di risorsa che si tiene traccia, pertanto questa condizione limita il workflow ai trasferimenti di inventario. Qualora si tenga traccia di diversi metacampi di tale tipo, aggiunga come secondo criterio che metafieldKey sia uguale a custom.carrier_reference.
  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 TRANSFER 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 la condizione "il campo metafield.previousValue è vuoto" affinché la reazione avvenga solo quando il campo di riferimento viene compilato per la prima volta.
  • Invii il riferimento al sistema del magazzino destinatario tramite la funzione Invia richiesta HTTP.
  • Aggiunga una condizione relativa a metafieldKey quando tiene traccia di diversi metacampi relativi ai trasferimenti.

Con quale rapidità reagisce

Shopify non invia alcuna notifica al riguardo, pertanto l’app legge i metacampi monitorati circa una volta al minuto. Il workflow dovrebbe avviarsi entro uno o due minuti.

Buono a sapersi

  • Vengono monitorati i trasferimenti creati negli ultimi 90 giorni. La modifica di un metacampo su un trasferimento più vecchio non avvia alcun workflow.
  • Un nuovo trasferimento viene rilevato per la prima volta entro circa un minuto. Il valore che il metacampo possiede già in quel momento costituisce il suo valore iniziale e non avvia alcun workflow; ogni modifica successiva, invece, lo fa.

Altro