Ottieni dati pagina

Nei flussi di lavoro che richiedono i dati della pagina, puoi utilizzare l'azione Ottieni dati pagina per recuperare le informazioni della pagina dal tuo negozio. Le pagine sono pagine web del tuo negozio online che contengono informazioni che cambiano raramente, come ad esempio la pagina Chi siamo o la pagina Contatti.

In questa pagina

Configurazione

Campi

L'azione Ottieni dati pagina contiene i seguenti campi:

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 può essere restituito 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 pagine pubblicate:

published_status:published

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

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

Elenco dei filtri di pagina disponibili
Le query devono seguire una sintassi specifica
I valori dei campi della 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 del pannello di controllo quando applichi un filtro. Ad esempio, per trovare alcuni valori delle query di Ordine, filtra la pagina Ordini nel pannello di controllo e controlla l'URL.
Puoi eseguire o testare una query nel tuo negozio utilizzando l'app Shopify GraphiQL.
Fai attenzione a ciò che accade se la query non va a buon fine. Spesso l'API restituisce 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 tuo 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 di essi, puoi utilizzare l'azione Per ogni.
Se devi aggregare i dati, ad esempio per contare quanti risultati sono stati restituiti, puoi utilizzare le azioni Conteggio o Somma.
Se devi restituire in output 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 successivi a questa azione, usa la variabile denominata Ottieni dati pagina, che corrisponde a un elenco di pagine. Puoi usare questa variabile sia nelle condizioni sia nelle azioni. Ad esempio, puoi inviare l'elenco di pagine in un'azione Invia email interna simile a questa:

{% for single_page in getPageData %}
  * {{ single_page.title }} - {{ single_page.handle }}
{% endfor %}

Trigger

Puoi utilizzare questa azione in qualsiasi flusso di lavoro, compreso il trigger Orario programmato. In un flusso di lavoro che utilizza il trigger Orario programmato, il flusso di lavoro viene avviato in un orario specificato, invece che come risultato di un evento. Poiché non esiste 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 sulle pagine.