Hent metaobjektoppføringer
Du kan bruke handlingen Hent metaobjektoppføringer for å 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
Felt
Handlingen Hent metaobjektoppføringer inneholder en rullegardinmeny for å spesifisere metaobjektdefinisjonen, i tillegg til følgende felt som brukes til å bygge spørringen:
| Felt | Beskrivelse |
|---|---|
| Sorter data etter | Påkrevd. Parameterne som dataene returnert av søket skal sorteres etter. |
| Maksimalt antall resultater | Påkrevd. Maksimalt antall resultater som kan returneres av søket du velger. Du kan returnere opptil 100 om gangen. |
| Spørring | Påkrevd. Velg fra vanlige spørringer, eller velg Avansert for å lage din egen. |
Spørringsstreng
Dette er et eksempel på en spørring for å hente metaobjektoppføringer hvis verdien i et e-post-felt samsvarer med e-postadressen i en bestilling:
{{fields.email}}:"{{order.email}}"Dette er et eksempel på en spørring for å hente metaobjektoppføringer som ble oppdatert det siste døgnet:
updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'updated_at-variabelen er et filter som er tilgjengelig i metaobjektspørringen, og kan brukes flere ganger eller kombineres med andre variabler. scheduledAt Liquid-variabelen er tilgjengelig i arbeidsflyter som bruker Tidsplanlagt tid-utløseren. Liquid-taggen date_minus er en spesiell Flow-tagg som lar deg trekke fra tid fra en dato.
Når du utfører spørringer mot data, er det nyttig å vite følgende:
- Liste over tilgjengelige metaobjektfiltre
- For å spørre mot metaobjekter etter feltverdi må metaobjektet ha filtrering aktivert, noe som kan aktiveres i alternativene for egendefinerte data i Shopify-administratorpanelet.
- Spørringer må følge en bestemt syntaks
- Feltverdier for spørringer er ikke alltid dokumentert. I noen tilfeller kan verdiene finnes ved å se i API-dokumentasjonen. Alternativt kan du ofte finne feltverdiene i URL-adressene i administratorpanelet når du filtrerer. Hvis du for eksempel vil finne noen spørringsverdier for bestillinger, kan du filtrere Ordre-siden i administratorpanelet og deretter sjekke URL-adressen.
- Du kan kjøre eller teste en spørring i butikken din ved hjelp av Shopify GraphiQL-appen.
- Vær oppmerksom på hva som skjer hvis spørringen mislykkes. API-et vil ofte returnere alle resultater (i stedet for ingen).
Returnerte data
Alle Hent data-handlinger returnerer en liste med alt fra 0 til 100 ressurser. Avhengig av bruksområdet ditt kan du bruke disse dataene på ulike måter:
- Hvis du må håndtere hvert listeelement enkeltvis, for eksempel for å legge til en tagg for hvert av dem, kan du bruke For hver-handlingen.
- Hvis du må aggregere data, for eksempel for å telle hvor mange resultater som ble returnert, kan du bruke handlingene Antall eller Sum.
- Hvis du vil bruke listen i utdata, for eksempel til å sende en e-post med alle varene, kan du bruke de returnerte dataene direkte i påfølgende handlinger.
For å få tilgang til de returnerte dataene i trinn som følger etter denne handlingen, bruker du variabelen kalt Hent metaobjektoppføringer, som er en liste over metaobjektoppføringer. Du kan bruke denne variabelen i både betingelser og handlinger. Du kan for eksempel sende listen over nøkkel-verdi-par for metaobjektoppføringene i en Send intern e-post-handling slik som dette:
{% 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 enhver arbeidsflyt, inkludert Tidsplanlagt tid-utløseren. I en arbeidsflyt som bruker Tidsplanlagt tid-utløseren, starter arbeidsflyten på et tidspunkt du har angitt, i stedet for som et resultat av en hendelse. Fordi det ikke er noen bestemt hendelse i butikken din eller fra en app som starter arbeidsflyten, inkluderes ingen data automatisk.