Ottieni voci metaobject

Puoi utilizzare l'azione Ottieni voci 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 Ottieni voci metaobject contiene un menu a discesa per specificare la definizione del metaobject e i seguenti campi, che vengono utilizzati per creare la query:

Campi utilizzati nelle azioni Get data (Ottieni dati).
CampoDescrizione
Sort data by (Ordina dati per)Obbligatorio. I parametri secondo i quali vengono ordinati i dati restituiti dalla query di ricerca.
Maximum number of results (Numero massimo di risultati)Obbligatorio. Il numero massimo di risultati che possono essere restituiti dalla query di ricerca selezionata. Possono esserne restituiti fino a 100 alla volta.
QueryObbligatorio. Scegli tra le query più comuni o seleziona Advanced (Avanzato) per crearne di nuove.

Stringa di query

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

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

Questa è una query di esempio per ottenere le voci 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 sui metaobject 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 Scheduled time (Orario programmato). Il tag Liquid date_minus è un tag Flow speciale che ti consente di sottrarre del tempo da una data.

Quando si eseguono query sui dati, è utile conoscere quanto segue:

Dati restituiti

Tutte le azioni Get data (Ottieni dati) restituiscono un elenco contenente da 0 a 100 risorse. A seconda del tuo caso d'uso, potresti utilizzare questi dati in diversi modi:

  • Se devi gestire singolarmente ogni voce di elenco, ad esempio per aggiungere un tag per ogni voce, puoi utilizzare l'azione For each (Per ogni).
  • Se devi aggregare i dati, ad esempio contare quanti risultati sono stati restituiti, puoi utilizzare le azioni Count (Conta) o Sum (Somma).
  • Se hai bisogno di generare l'elenco, ad esempio per inviare un'email con tutte le voci, puoi utilizzare i dati restituiti direttamente nelle azioni successive.

Per accedere ai dati restituiti nei passaggi che seguono questa azione, utilizza la variabile denominata Ottieni voci metaobject, che è un elenco di voci metaobject. Puoi utilizzare questa variabile sia nelle condizioni che nelle azioni. Ad esempio, puoi inviare l'elenco delle 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, compreso il trigger Scheduled time (Orario programmato). Un flusso di lavoro che utilizza il trigger Scheduled time (Orario programmato) inizia nel momento da te specificato, anziché a seguito di un evento. Poiché nel tuo negozio o in un'app non c'è un evento specifico che avvii il flusso di lavoro, non ci sono dati inclusi automaticamente.

Dettagli API

Non trovi le risposte che stai cercando? Siamo qui per aiutarti.