Hent metaobjekt-oppføringer
Du kan bruke handlingen Hent metaobjektoppføringer til å hente en liste over oppføringer for et metaobjekt fra butikken din basert på den valgfrie spørringen. Se dokumentasjonen for metaobjekter for mer informasjon.
På denne siden
Konfigurasjon
Felter
Handlingen Hent metaobjektoppføringer inneholder en rullegardin for å spesifisere metaobjektdefinisjonen, samt følgende felt, som brukes til å bygge spørringen:
Felt | Beskrivelse |
---|---|
Sorter data etter | Påkrevd. Parameterne dataene som returneres av søket sorteres etter. |
Maksimalt antall resultater | Obligatorisk. Det maksimale antallet resultater som kan returneres av spørringen du velger. Du kan returnere opptil 100 av gangen. |
Spørring | Obligatorisk. Velg mellom vanlige spørringer, eller velg Avansert for å utforme din egen. |
Spørringsstreng
Dette er et eksempelspørsmål for å få metaobjektoppføringer hvis verdien av et email
-felt samsvarer med e-postadressen på en ordre:
{{fields.email}}:"{{order.email}}"
Dette er et eksempelspørsmål for å få metaobjektoppføringer som ble oppdatert den siste dagen:
updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'
updated_at
Variabelen er et filter som er tilgjengelig for Metaobjekt-spørringen, og den kan brukes flere ganger eller kombineres med andre variabler. Liquid-variabelen scheduledAt
er tilgjengelig i arbeidsflyter som har brukt utløseren Planlagt tid. Liquid-taggen date_minus
er en spesiell Flow-tagg som lar deg trekke fra tid fra en dato.
Når du henter data, er det nyttig å vite:
- Liste over tilgjengelige metaobjektfiltre
- Spørring av metaobjekter etter feltverdi krever at metaobjektet har filtrering aktivert, noe som kan aktiveres i Shopify-administrator alternativer for tilpassede data. - Spørringer må følge en bestemt syntaks
- Spørringsfeltverdier er ikke alltid dokumentert. I noen tilfeller kan du finne verdiene ved å se i API-dokumentasjonen. Alternativt finner du ofte feltverdier i URL-adressene i administrator når du filtrerer. For å finne noen bestillingsspørringsverdier, kan du for eksempel filtrere Bestillinger-siden i administrator og kontrollere URL-adressen.
- Du kan kjøre eller teste en spørring i butikken ved å bruke Shopify GraphiQL-appen.
- Vær oppmerksom på hva som skjer hvis spørringen mislykkes. API-et returnerer ofte alle resultater (i stedet for ingen).
Returnerte data
Alle handlinger av typen Hent data returnerer en liste på mellom 0 og 100 ressurser. Avhengig av bruksområdet kan disse dataene brukes på ulike måter:
- Hvis du har behov for å håndtere hvert listeelement individuelt, som å legge til en tagg for hvert element, kan du bruke handlingen For each.
- Hvis du har behov for å aggregere data, som å telle hvor mange resultater som er returnert, kan du bruke handlingene Count eller Sum.
- Hvis du har behov for å returnere listen, som å sende en e-postmelding med alle elementer, kan du bruke returnerte data direkte i påfølgende handlinger.
For å få tilgang til de returnerte dataene i trinn som følger denne handlingen, kan du bruke variabelen Hent metaobjektoppføringer, som er en liste over metaobjektoppføringer. Denne variabelen kan brukes i både betingelser og handlinger. Du kan for eksempel sende listen over nøkkelverdipar for metaobjektoppføringene i en Send intern e-post-handling som denne:
{% 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 %}
Utløsere
Du kan bruke denne handlingen i alle arbeidsflyter, inkludert utløseren Planlagt tid. I en arbeidsflyt som bruker utløseren Planlagt tid starter arbeidsflyten på et tidspunkt du bestemmer, og ikke som et resultat av en hendelse. Fordi det ikke er noen bestemt hendelse i butikken eller fra en app som starter arbeidsflyten, er ingen informasjon automatisk inkludert.