Hent metaobjektposter

Du kan bruge handlingen Hent metaobjektposter til at hente en liste over poster for et metaobjekt fra din butik baseret på den valgfrie forespørgsel. Se dokumentationen til metaobjekter for at få mere at vide.

Konfiguration

Felter

Handlingen Hent metaobjektposter indeholder en rullemenu til at angive metaobjektdefinitionen samt følgende felter, der bruges til at opbygge forespørgslen:

Forespørgselsstreng

Dette er et eksempel på en forespørgsel til at hente metaobjektposter, hvis værdien i et email-felt matcher mailadressen for en ordre:

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

Dette er et eksempel på en forespørgsel til at hente metaobjektposter, der er blevet opdateret inden for det seneste døgn:

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

Variablen updated_at er et filter, der er tilgængeligt i forespørgslen Metaobjekter, og kan bruges flere gange eller kombineres med andre variabler. scheduledAt-Liquid-variablen er tilgængelig i workflows, der bruger udløseren Planlagt tid. date_minus-Liquid-tagget er et særligt Flow-tag, som giver dig mulighed for at trække tid fra en dato.

Når du forespørger om data, er det nyttigt at vide:

• Liste over tilgængelige filtre for metaobjekter
• Forespørgsel om metaobjekter efter feltværdi kræver, at metaobjektet har filtrering aktiveret, hvilket kan slås til i indstillingerne for tilpassede data i Shopify-administratoren.
• Forespørgsler skal følge en bestemt syntaks
• Feltværdier for forespørgsler er ikke altid dokumenterede. I nogle tilfælde kan værdierne findes ved at kigge i API-dokumentationen. Alternativt kan du ofte finde feltværdierne i webadresserne i administratoren, når du filtrerer. Hvis du f.eks. vil finde nogle forespørgselsværdier for ordrer, skal du filtrere siden Ordrer i administratoren og derefter tjekke webadressen.
• Du kan køre eller teste en forespørgsel i din butik ved hjælp af Shopify GraphiQL-appen.
• Vær opmærksom på, hvad der sker, hvis din forespørgsel mislykkes. Ofte returnerer API'en alle resultater (i stedet for ingen).

Returnerede data

Alle handlinger af typen Hent data returnerer en liste med mellem 0 og 100 ressourcer. Afhængigt af dit anvendelsesformål kan du bruge disse data på forskellige måder:

• Hvis du har brug for at håndtere hvert listeelement individuelt, f.eks. for at tilføje et tag til hvert enkelt, kan du bruge handlingen For each.
• Hvis du har brug for at samle data, f.eks. tælle, hvor mange resultater der blev returneret, kan du bruge handlingerne Count eller Sum.
• Hvis du har brug for at få listen som output, f.eks. ved at sende en mail med alle varerne, kan du bruge de returnerede data direkte i efterfølgende handlinger.

For at få adgang til de returnerede data i trin, der følger efter denne handling, skal du bruge variablen Get metaobject entries, som er en liste over metaobjektposter. Du kan bruge denne variabel i både betingelser og handlinger. Du kan f.eks. sende listen over nøgleværdipar for metaobjektposterne i handlingen Send intern mail på denne måde:

{% 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 %}

Udløsere

Du kan bruge denne handling i ethvert workflow, herunder udløseren Planlagt tid. I et workflow, der bruger udløseren Planlagt tid, starter workflowet på et tidspunkt, du har angivet, i stedet for som resultat af en hændelse. Da der ikke er nogen specifik hændelse i din butik eller fra en app, der starter workflowet, medtages der ikke automatisk nogen data.

API-oplysninger

• Metaobjektressource
• Forespørgselsfiltre for metaobjekter
• Forespørgsel om metaobjekter efter feltværdi