Hent sidedata

I arbeidsflyter som krever sidedata, kan du bruke handlingen Hent sidedata for å hente sideinformasjon fra butikken din. Sider er nettsidene i nettbutikken som inneholder informasjon som sjelden endres, for eksempel en Om oss-side eller kontaktside.

Merk

Dette er en type Hent data-handling. For å forstå hvordan du bruker denne typen handling med utløseren Planlagt tidspunkt og For hver-løkker, kan du se Tidsplaner, henting av data og gjentakende arbeidsflyter i Shopify Flow.

Konfigurasjon

Felt

Handlingen Hent sidedata inneholder følgende felt:

Felt som brukes i Hent data-handlingene.

Felt	Beskrivelse
Sorter data etter	Obligatorisk. Parameterne som dataene som returneres av søket sorteres etter.
Maksimalt antall resultater	Obligatorisk. Det maksimale antallet resultater som kan returneres fra søket du velger. Du kan returnere opptil 100 om gangen.
Spørring	Obligatorisk. Velg fra vanlige spørringer eller velg Avansert for å opprette dine egne.

Spørringsstreng

Dette er en eksempelspørring for å hente publiserte sider:

published_status:published

Variabelen published_status er et filter som er tilgjengelig i sidespørringen, og den kan brukes flere ganger eller kombineres med andre variabler.

Når du sender forespørsler om data, er det nyttig å vite følgende:

• Liste over tilgjengelige sidefiltre

• Spørringer må følge en bestemt syntaks

• Verdier for spørringsfelt er ikke alltid dokumentert. I noen tilfeller kan du finne verdiene ved å se i API-dokumentasjonen. Alternativt kan du ofte finne feltverdiene i URL-adressene i administratorpanelet når du filtrerer. For eksempel, for å finne noen verdier for bestillingsspørringer, filtrerer du Ordre-siden i administratorpanelet og sjekker URL-adressen.

• Du kan kjøre eller teste en spørring i butikken din ved å bruke 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 på mellom 0 og 100 ressurser. Avhengig av brukstilfellet ditt, vil du kanskje bruke disse dataene på ulike måter:

• Hvis du må håndtere hvert listeelement individuelt, for eksempel for å legge til en tagg for hver av dem, kan du bruke handlingen For hver.
• Hvis du må samle data, for eksempel for å telle hvor mange resultater som ble returnert, kan du bruke handlingen Tell eller Sum.
• Hvis du trenger å sende ut listen, for eksempel sende en e-post med alle elementene, 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 med navnet Hent sidedata, som er en liste over sider. Du kan bruke denne variabelen i både betingelser og handlinger. Du kan for eksempel sende listen over sider i en Send intern e-post-handling på denne måten:

{% for single_page in getPageData %}
  * {{ single_page.title }} - {{ single_page.handle }}
{% endfor %}

Merk

Hvis en Hent data-handling brukes flere ganger i en enkelt arbeidsflyt, legges et tall til variabelnavnet. I en arbeidsflyt som for eksempel bruker handlingen Hent bestillingsdata to ganger, vil den første variabelen for returnerte data være getOrderData, og den andre variabelen være getOrderData1. Dette navnet kan ikke tilpasses.

Utløsere

Du kan bruke denne handlingen i enhver arbeidsflyt, inkludert Planlagt tidspunkt-utløseren. I en arbeidsflyt som bruker Planlagt tidspunkt-utløseren, starter arbeidsflyten på et tidspunkt du har angitt, i stedet for som et resultat av en hendelse. Fordi det ikke er noen spesifikk hendelse i butikken din eller fra en app som starter arbeidsflyten, inkluderes det ingen data automatisk.

API-referanse

For mer informasjon om API-et som brukes i denne handlingen, kan du se sidespørringen.