Recupera dati sede

Nei flussi di lavoro che richiedono dati sulla sede, puoi utilizzare l'azione Recupera dati sede per recuperare le informazioni sulla sede dal tuo negozio Shopify. Le sedi sono tutti i luoghi in cui immagazzini le scorte, vendi prodotti oppure spedisci o evadi gli ordini.

Nota

Questo è un tipo di azione Recupera dati. Per capire come utilizzare questo tipo di azione con il trigger Ora pianificata e i loop Per ogni, consulta Pianificazioni, recupero dati e flussi di lavoro ciclici in Shopify Flow.

Configurazione

Campi

L'azione Recupera dati sede contiene i seguenti campi.

Campi utilizzati nelle azioni Recupera dati.

Campo	Descrizione
Ordina dati per	Obbligatorio. I parametri in base ai quali vengono ordinati i dati restituiti dalla query di ricerca.
Numero massimo di risultati	Obbligatorio. La quantità massima di risultati che possono essere restituiti dalla query di ricerca selezionata. Puoi restituirne fino a 100 alla volta.
Query	Obbligatorio. Scegli tra le query comuni o seleziona Avanzate per crearne una personalizzata.

Stringa di query

Questo è un esempio di query per ottenere le sedi in cui è abilitato il ritiro in negozio:

pickup_in_store:enabled

La variabile pickup_in_store è un filtro disponibile nella query Locations e può essere utilizzata più volte o combinata con altre variabili.

Quando si esegue una query sui dati, è utile sapere quanto segue:

• Elenco dei filtri di sede disponibili

• Le query devono seguire una certa sintassi

• I valori dei campi delle query non sono sempre documentati. In alcuni casi, i valori possono essere trovati consultando la documentazione API. In alternativa, spesso puoi trovare i valori dei campi negli URL nel pannello di controllo quando applichi un filtro. Ad esempio, per trovare alcuni valori di query per gli ordini, filtra la pagina Ordini nel pannello di controllo, quindi controlla l'URL.

• Puoi eseguire o testare una query nel tuo negozio utilizzando l'app Shopify GraphiQL.

• Presta attenzione a ciò che accade se la query non riesce. Spesso l’API restituirà tutti i risultati (anziché nessuno).

Dati restituiti

Tutte le azioni Recupera dati restituiscono un elenco da 0 a 100 risorse. A seconda del tuo caso d’uso, potresti voler utilizzare questi dati in vari modi:

• Se devi gestire singolarmente ogni articolo dell'elenco, ad esempio per aggiungere un tag a ciascuno, puoi utilizzare l'azione Per ogni.
• Se devi aggregare i dati, ad esempio per contare il numero di risultati restituiti, puoi utilizzare le azioni Conteggio o Somma.
• Se devi produrre l'elenco, ad esempio per inviare un'email con tutti gli articoli, puoi utilizzare i dati restituiti direttamente nelle azioni successive.

Per accedere ai dati restituiti nei passaggi che seguono questa azione, utilizza la variabile denominata Recupera dati sede, che è un elenco di sedi. Puoi utilizzare questa variabile sia nelle condizioni che nelle azioni. Ad esempio, puoi inviare l'elenco di sedi in un'azione Invia email interna in questo modo:

{% for single_location in GetLocationData %}
* {{ single_location.id }}
{% endfor %}

Nota

Se un'azione Recupera dati viene utilizzata più volte in un singolo flusso di lavoro, al nome della variabile viene aggiunto un numero. Ad esempio, in un flusso di lavoro che utilizza due volte l'azione Recupera dati ordine, la prima variabile per i dati restituiti è getOrderData e la seconda è getOrderData1. Questo nome non può essere personalizzato.

Trigger

Puoi utilizzare questa azione in qualsiasi flusso di lavoro, incluso il trigger Ora pianificata. In un flusso di lavoro che utilizza il trigger Ora pianificata, il flusso di lavoro si avvia a un'ora specificata, anziché in seguito a un evento. Poiché non vi è alcun evento specifico nel tuo negozio o da un'app che avvia il flusso di lavoro, non vengono inclusi dati automaticamente.

Riferimento API

Per maggiori informazioni sull'API utilizzata in questa azione, consulta la query Locations.