Hent data om kollektioner
I workflows, der kræver data om kollektioner, kan du bruge handlingen Hent data om kollektioner til at hente oplysninger om kollektioner fra din butik.
På denne side
Konfiguration
Felter
Handlingen Hent data om kollektioner indeholder følgende felter.
| Felt | Beskrivelse |
|---|---|
| Sortér data efter | Kræves. Parametrene, der bruges til at sortere de data, som søgeforespørgslen returnerer. |
| Maksimalt antal resultater | Kræves. Det maksimale antal resultater, der kan returneres af den søgeforespørgsel, du vælger. Du kan returnere op til 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
Her er et eksempel på en forespørgsel til at hente kollektioner, der blev 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 Kollektioner, og kan bruges flere gange eller kombineres med andre variabler. Liquid-variablen scheduledAt er tilgængelig i workflows, der bruger udløseren Planlagt tidspunkt. Liquid-tagget date_minus er et særligt Flow-tag, der giver dig mulighed for at trække tid fra en dato.
Når du forespørger om data, er det nyttigt at kende til:
- Liste over tilgængelige filtre for kollektioner
- Forespørgsler skal følge en bestemt syntaks
- Værdier for forespørgselsfelter 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 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 0 til 100 ressourcer. Afhængigt af hvad du skal bruge dem til, vil du måske bruge disse data på forskellige måder:
- Hvis du har brug for at håndtere hvert element på listen enkeltvist, f.eks. for at tilføje et tag til hvert element, kan du bruge handlingen For hver.
- Hvis du har brug for at aggregere data, f.eks. tælle hvor mange resultater der blev returneret, kan du bruge handlingerne Tæl eller Sum.
- Hvis du har brug for at få vist listen, f.eks. til at sende en mail med alle varerne, kan du bruge returnerede data direkte i efterfølgende handlinger.
For at få adgang til de returnerede data i de trin, der følger denne handling, skal du bruge variablen med navnet Hent kollektionsdata, som er en liste over kollektioner. Du kan bruge denne variabel i både betingelser og handlinger. Du kan f.eks. sende listen over kollektioner i handlingen Send intern mail på følgende måde:
{% for single_collection in GetCollectionData %}
* {{ single_collection.title }}
{% endfor %}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 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, er der ingen data, der inkluderes automatisk.