Trigger del metacampo "Sede dell'azienda"
Come avviare un workflow Shopify Flow quando cambia un metacampo della sede aziendale B2B, con il valore precedente e quello nuovo.
Un cliente B2B dispone di diverse filiali e ciascuna di esse accetta le consegne in orari diversi. Gli orari sono memorizzati nel metacampo Finestra di consegna (custom.delivery_window) relativo alla sede dell’azienda e il reparto logistico deve essere informato di eventuali modifiche prima che venga pianificata la spedizione successiva.
In questa pagina viene illustrato come avviare un workflow Shopify Flow ogni volta che un metacampo relativo alla sede di un’azienda subisce una modifica, utilizzando Workflow Trigger Extensions. I passaggi sono gli stessi per ogni metacampo di questo tipo di risorsa; nell’esempio viene utilizzato il metacampo Finestra di consegna (custom.delivery_window).
Cosa vi serve
- Una definizione di metacampo. La crei nella Sua area di amministrazione di Shopify alla voce Impostazioni > Metacampi e metaoggetti > Sedi aziendali. Un metacampo privo di definizione non può essere monitorato.
- L'autorizzazione Accesso ai dati relativi alle aziende e alle loro sedi (B2B). La si concede nella pagina Autorizzazioni dell'app; si veda Autorizzazioni e accesso ai dati.
- Le sedi aziendali fanno parte della sezione B2B su Shopify. Questo tipo di risorsa è utile solo in un negozio che gestisce aziende.
1. Monitorare il metacampo
- Apra la sezione Trigger dei metacampi nell'app e faccia clic su Aggiungi trigger.
- Selezioni il tipo di risorsa Sede dell’azienda.
- Selezioni il metacampo, in questo caso Fascia oraria di consegna. È possibile selezionarne più di uno contemporaneamente oppure utilizzare l’opzione Seleziona tutto.
- 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 i singoli campi, quindi fate clic su Monitora tutti i metacampi.

Il nuovo trigger mostra il messaggio Inizializzazione mentre l’app legge il valore corrente del metacampo relativo alle sedi aziendali esistenti, per poi passare allo stato Attivo. È proprio grazie a questa prima lettura che la primissima modifica viene già fornita 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 |
COMPANYLOCATION |
resourceId |
L'ID della sede dell'azienda, ad esempio gid://shopify/CompanyLocation/1234567890 |
metafieldKey |
Spazio dei nomi e chiave, in questo caso custom.delivery_window |
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
- In Shopify Flow, crei un workflow e selezioni il trigger Aggiornamento metacampo delle estensioni Workflow Trigger Extensions.
- Aggiunga una condizione:
resourceTypeè uguale aCOMPANYLOCATION. L'aggiornamento dei metacampi viene avviato per ogni tipo di risorsa che monitorate, pertanto questa condizione limita il workflow alle sedi aziendali. Qualora monitoriate diversi metacampi di questo tipo, aggiungete come secondo criterio chemetafieldKeysia uguale acustom.delivery_window. - Aggiunga l'azione desiderata. Nell'esempio viene inviata un'e-mail interna contenente il valore precedente e quello nuovo.

Si parta dall'esempio
- Scarichi il file
.flowallegato in fondo a questa pagina. - Nella dashboard di Shopify, apra Shopify Flow, faccia clic su Importa e selezioni il file.
- Apra la fase Invia e-mail interna e inserisca il destinatario. Il file non contiene alcun indirizzo, intenzionalmente.
- Attivi il workflow.
Lo renda suo
- Invii la nuova finestra al Suo operatore o al Suo strumento di pianificazione tramite la funzione Invia richiesta HTTP.
- Aggiunga una condizione relativa a
metafieldKeyquando monitora diversi metacampi relativi alle sedi delle aziende. - Inserisca il valore precedente nell'e-mail tramite
metafield.previousValue, in modo che nessuno debba cercarlo.
Con quale rapidità reagisce
Shopify invia una notifica all’app quando viene salvata una sede aziendale. Nel caso di una modifica che riguarda esclusivamente un metacampo, talvolta non viene inviata alcuna notifica; pertanto, l’app verifica automaticamente le sedi aziendali circa una volta al minuto. Il workflow dovrebbe avviarsi nel giro di pochi secondi e, al più tardi, entro uno o due minuti.
Altro
- Trigger dei metacampi: come funzionano i trigger dei metacampi, per ogni tipo di risorsa.
- Cronologia degli eventi e risoluzione dei problemi: visualizza tutti gli eventi inviati dall'app, con il valore precedente e quello nuovo.
