Recupera dati della collezione
Nei flussi di lavoro che richiedono i dati della collezione, puoi utilizzare l'azione Recupera dati della collezione per recuperare le informazioni sulla collezione dal tuo negozio.
In questa pagina
Configurazione
Campi
L'azione Recupera dati della collezione contiene i seguenti campi.
| 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 restituire fino a 100 risultati 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 collezioni aggiornate nell'ultimo giorno:
updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'La variabile updated_at è un filtro disponibile nella query Collections e può essere utilizzata più volte o combinata con altre variabili. La variabile Liquid scheduledAt è disponibile nei flussi di lavoro che hanno utilizzato il trigger Orario programmato. Il tag Liquid date_minus è un tag speciale di Flow che ti consente di sottrarre del tempo da una data.
Quando esegui una query sui dati, è utile sapere quanto segue:
- Elenco dei filtri collezione disponibili
- Le query devono seguire una certa sintassi
- I valori dei campi delle query non sono sempre documentati. In alcuni casi, i valori si possono trovare consultando la documentazione API. In alternativa, puoi trovare spesso i valori dei campi negli URL del pannello di controllo quando applichi un filtro. Ad esempio, per trovare alcuni valori della query Order, filtra la pagina Orders nel pannello di controllo, quindi controlla l'URL.
- Puoi eseguire o testare una query nel tuo negozio usando l'app Shopify GraphiQL.
- Tieni presente cosa succede se la query non riesce. Spesso l'API restituirà tutti i risultati (invece di nessuno).
Dati restituiti
Tutte le azioni Recupera dati restituiscono un elenco da 0 a 100 risorse. A seconda del caso d'uso, potresti voler utilizzare questi dati in vari modi:
- Se devi gestire ogni articolo dell'elenco singolarmente, ad esempio per aggiungere un tag a ciascuno, puoi utilizzare l'azione Per ogni.
- Se hai bisogno di aggregare i dati, ad esempio per contare quanti risultati sono stati restituiti, puoi utilizzare le azioni Conteggio o Somma.
- Se hai bisogno di generare l'elenco come output, 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 collezione, che è un elenco di collezioni. Puoi utilizzare questa variabile sia nelle condizioni che nelle azioni. Ad esempio, puoi inviare l'elenco di collezioni in un'azione Invia email interna in questo modo:
{% for single_collection in GetCollectionData %}
* {{ single_collection.title }}
{% endfor %}Trigger
Puoi utilizzare questa azione in qualsiasi flusso di lavoro, incluso il trigger Orario programmato. In un flusso di lavoro che utilizza il trigger Orario programmato, il flusso di lavoro si avvia a un orario specificato da te, anziché in seguito a un evento. Poiché non c'è nessun evento specifico nel tuo negozio o da un'app che avvii il flusso di lavoro, non vengono inclusi dati automaticamente.