Ottieni dati articolo

Nei flussi di lavoro che richiedono i dati di un articolo del blog, puoi utilizzare l’azione Ottieni dati articolo per recuperare le informazioni sull'articolo dal negozio Shopify.

In questa pagina

Configurazione

Campi

L’azione Ottieni dati articolo 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. La quantità massima di risultati che può essere restituita 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 personalizzata.

Stringa di query

Questo è un esempio di query per ottenere gli articoli pubblicati nell'ultimo giorno:

published_at:<='{{ scheduledAt }}' AND published_at:>'{{ scheduledAt | date_minus: "1 day" }}'

La variabile published_at è un filtro disponibile nella query Articles e può essere utilizzata più volte o in combinazione con altre variabili. La variabile Liquid scheduledAt è disponibile nei flussi di lavoro che utilizzano il trigger Orario programmato. Il tag Liquid date_minus è uno speciale tag di Shopify Flow che ti consente di sottrarre tempo a una data.

Quando si interrogano i dati, è utile sapere che:

Elenco dei filtri per gli articoli disponibili
Le query devono seguire una determinata sintassi
I valori dei campi di query non sono sempre documentati. In alcuni casi, i valori possono essere trovati consultando la documentazione sulle API. In alternativa, spesso puoi trovare i valori dei campi negli URL nel pannello di controllo, quando applichi i filtri. Ad esempio, per trovare i valori di query di un ordine, filtra la pagina Ordini nel pannello di controllo, quindi controlla l'URL.
Puoi eseguire o testare una query nel negozio utilizzando l'app Shopify GraphiQL.
Presta attenzione a ciò che accade se la query fallisce. Spesso l'API restituirà tutti i risultati (anziché 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 hai bisogno di gestire ogni elemento dell'elenco individualmente, ad esempio per aggiungere un tag a ciascuno, puoi usare l'azione Per ognuno.
Se devi aggregare i dati, ad esempio per contare quanti risultati sono stati restituiti, puoi utilizzare le azioni Conta o Somma.
Se hai bisogno di generare l'elenco, ad esempio per inviare un'email con tutti gli elementi, puoi usare i dati restituiti direttamente nelle azioni successive.

Per accedere ai dati restituiti nei passaggi che seguono questa azione, utilizza la variabile Ottieni dati articolo, che è un elenco di articoli. Puoi usare questa variabile sia nelle condizioni sia nelle azioni. Ad esempio, puoi inviare l'elenco degli articoli in un'azione Invia email interna simile a questa:

{% for single_article in GetArticleData %}
    * {{ single_article.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 inizia in un momento specificato da te, invece che in seguito a un evento. Poiché non c'è un evento specifico nel negozio o da un'app che avvia il flusso di lavoro, non ci sono dati inclusi automaticamente.

Riferimento API

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