Hent sidedata

I workflows, der kræver sidedata, kan du bruge handlingen Hent sidedata til at hente sideoplysninger fra din butik. Sider er de websider på din webshop, der indeholder oplysninger, som sjældent ændres, f.eks. en Om os-side eller en kontaktside.

Bemærk

Dette er en type Hent data-handling. Hvis du vil forstå, hvordan du bruger denne type handling med udløseren Planlagt tidspunkt og For hver-løkker, kan du se Tidsplaner, hent data og workflows med løkker i Shopify Flow.

Konfiguration

Felter

Handlingen Hent sidedata indeholder følgende felter:

Felter, der bruges i Hent data-handlingerne.

Felt	Beskrivelse
Sortér data efter	Påkrævet. De parametre, som de returnerede data fra søgeforespørgslen sorteres efter.
Maksimalt antal resultater	Påkrævet. Det maksimale antal resultater, der kan returneres af den søgeforespørgsel, du vælger. Du kan højst returnere 100 ad gangen.
Forespørgsel	Påkrævet. Vælg mellem almindelige forespørgsler, eller vælg Avanceret for at oprette din egen.

Forespørgselsstreng

Dette er en eksempelforespørgsel til hentning af udgivne sider:

published_status:published

Variablen published_status er et filter, der er tilgængeligt i Pages-forespørgslen, og som kan bruges flere gange eller kombineres med andre variabler.

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

• Liste over tilgængelige sidefiltre

• Forespørgsler skal følge en bestemt syntaks

• Forespørgselsfeltværdier er ikke altid dokumenteret. I nogle tilfælde kan værdierne findes ved at se 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 en ordre, skal du filtrere siden Ordrer i administratoren og derefter tjekke webadressen.

• Du kan køre eller teste en forespørgsel i din butik ved at bruge appen Shopify GraphiQL.

• Vær opmærksom på, hvad der sker, hvis din forespørgsel mislykkes. API'en returnerer ofte alle resultater (i stedet for ingen).

Returnerede data

Alle Hent data-handlinger returnerer en liste med mellem 0 og 100 ressourcer. Afhængigt af dit formål vil du muligvis 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 for hvert enkelt, kan du bruge handlingen For hver.
• Hvis du har brug for at samle data, f.eks. for at tælle, hvor mange resultater der blev returneret, kan du bruge handlingerne Tæl eller Sum.
• Hvis du har brug for et output af listen, f.eks. for at sende en mail med alle elementerne, kan du bruge de returnerede data direkte i efterfølgende handlinger.

Hvis du vil have adgang til de returnerede data i de trin, der følger efter denne handling, skal du bruge den variabel, der hedder Hent sidedata, som er en liste over sider. Du kan bruge denne variabel i både betingelser og handlinger. Du kan f.eks. sende listen over sider i en Send intern mail-handling i stil med denne:

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

Bemærk

Hvis en Hent data-handling bruges flere gange i et enkelt workflow, tilføjes der et tal til variabelnavnet. I et workflow, der f.eks. bruger handlingen Hent ordredata to gange, er den første variabel for returnerede data getOrderData, og den anden variabel er getOrderData1. Dette navn kan ikke tilpasses.

Udløsere

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

API-reference

Du kan finde flere oplysninger om den API, der bruges i denne handling, under Pages-forespørgslen.