Ottieni dati catalogo

Nei flussi di lavoro che richiedono i dati del catalogo, puoi usare l’azione Ottieni dati catalogo per recuperare le informazioni sui cataloghi B2B dal negozio. I cataloghi sono gruppi di prodotti con prezzi personalizzati per determinati clienti B2B o sedi aziendali.

Nota

Questo è un tipo di azione Ottieni dati. Per capire come usare questo tipo di azione con il trigger Orario programmato e i cicli Per ogni, fai riferimento a Programmazioni, recupero dei dati e flussi di lavoro in loop in Shopify Flow.

Configurazione

Campi

L’azione Ottieni dati catalogo contiene i campi seguenti:

Campi utilizzati nelle azioni Ottieni 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. Il numero massimo 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 Avanzata per crearne una tua.

Stringa di query

Questo è un esempio di query per ottenere tutti i cataloghi attivi:

status:ACTIVE

La variabile status è un filtro disponibile in Query dei cataloghi e può essere utilizzata più volte o in combinazione con altre variabili.

Quando esegui query sui dati, è utile sapere che:

• Elenco dei filtri del catalogo disponibili

• Le query devono seguire una sintassi specifica

• I valori del campo della query non sono sempre documentati. In alcuni casi, i valori si possono trovare consultando la documentazione API. In alternativa, spesso puoi trovare i valori dei campi negli URL del pannello di controllo quando applichi i filtri. Ad esempio, per trovare alcuni valori della query dell'ordine, filtra la pagina Ordini nel pannello di controllo, quindi controlla l'URL.

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

• Fai attenzione a cosa succede se la tua query non va a buon fine. Spesso le API restituiscono tutti i risultati (invece di nessuno).

Dati restituiti

Tutte le azioni Ottieni dati restituiscono un elenco compreso tra 0 e 100 risorse. A seconda del caso d'uso, potresti voler utilizzare questi dati in vari modi:

• Se devi gestire ciascun elemento dell'elenco singolarmente, ad esempio per aggiungere un tag per ognuno di essi, puoi utilizzare l'azione Per ciascuno.
• Se devi aggregare i dati, ad esempio per contare quanti risultati sono stati restituiti, puoi utilizzare le azioni Conteggio o Somma.
• Se devi generare l'elenco in output, ad esempio per inviare un'email con tutti gli elementi, puoi utilizzare i dati restituiti direttamente nelle azioni successive.

Per accedere ai dati restituiti nei passaggi successivi a questa azione, utilizza la variabile Ottieni dati del catalogo, che è un elenco di cataloghi. Puoi utilizzare questa variabile sia nelle condizioni sia nelle azioni. Ad esempio, puoi inviare l'elenco dei cataloghi in un'azione Invia email interna simile alla seguente:

{% for single_catalog in getCatalogData %}
  * {{ single_catalog.title }}
{% endfor %}

Nota

Se in un unico flusso di lavoro viene utilizzata più volte un'azione Ottieni dati, al nome della variabile viene aggiunto un numero. Ad esempio, in un flusso di lavoro in cui l'azione Ottieni dati ordine è utilizzata due volte, 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 Orario programmato. In un flusso di lavoro che utilizza il trigger Orario programmato, il flusso di lavoro viene avviato in un orario da te specificato, anziché in seguito a un evento. Dato che non ci sono eventi specifici nel tuo negozio o da un'app che avviano il flusso di lavoro, non vi è alcun dato incluso automaticamente.

Riferimento API

Per maggiori informazioni sulle API utilizzate in questa azione, consulta Query dei cataloghi.