Recupera voci di metaobject

Puoi utilizzare l’azione Recupera voci di metaobject per recuperare un elenco di voci per un metaobject dal tuo negozio in base alla query facoltativa. Per maggiori informazioni, consulta la documentazione sui metaobject.

Configurazione

Campi

L’azione Recupera voci di metaobject contiene un menu a discesa per specificare la definizione del metaobject e i seguenti campi, che vengono utilizzati per creare la query:

Stringa di query

Questo è un esempio di query per ottenere le voci del metaobject se il valore di un campo email corrisponde all'indirizzo email di un ordine:

{{fields.email}}:"{{order.email}}"

Questo è un esempio di query per ottenere le voci del metaobject aggiornate nell'ultimo giorno:

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

La variabile updated_at è un filtro disponibile nella query Metaobjects 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 è uno speciale tag di Flow che consente di sottrarre tempo da una data.

Quando esegui query sui dati, è utile sapere che:

• Elenco dei filtri dei metaobject disponibili
• L'esecuzione di query sui metaobject in base al valore del campo richiede che per il metaobject sia abilitata la funzionalità di filtro, che può essere abilitata nel pannello di controllo Shopify nelle opzioni per i dati personalizzati.
• 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 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 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.
• Fai attenzione a cosa succede se la query non va a buon fine. Spesso, l'API restituirà tutti i risultati (anziché nessuno).

Dati restituiti

Tutte le azioni Recupera dati restituiscono un elenco che può contenere da 0 a 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 ognuno, 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 esportare 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 voci metaobject, che è un elenco di voci di metaobject. Puoi utilizzare questa variabile sia nelle condizioni che nelle azioni. Ad esempio, puoi inviare l'elenco di coppie chiave-valore per le voci del metaobject in un'azione Invia email interna in questo modo:

{% for getMetaobjectEntries_item in getMetaobjectEntries %}
Key-value pairs for entry:
  {% for fields_item in getMetaobjectEntries_item.system.fields %}
    {{fields_item.key}}:{{fields_item.value}}
  {% endfor %}
{% 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'ora da te specificata, 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.

Dettagli API

• Risorsa metaobject
• Filtri di query per metaobject
• Esecuzione di query sui metaobject in base al valore del campo