Hent data for ordrekladde
I workflows, der bruger data om ordrekladder, kan du bruge handlingen Hent data for ordrekladde til at hente oplysninger om ordrekladder fra din butik.
Konfiguration
Felter
Handlingen Hent data for ordrekladde indeholder følgende felter, som bruges til at opbygge forespørgslen:
| Felt | Beskrivelse |
|---|---|
| Sortér data efter | Påkrævet. De parametre, som de data, der returneres af 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 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
Dette er et eksempel på en forespørgsel til at hente ordrekladder, der blev opdateret inden for den seneste dag:
updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'updated_at-variablen er et filter, der er tilgængeligt for forespørgslen om ordrekladder, og kan bruges flere gange eller kombineres med andre variabler. scheduledAt-Liquid-variablen er tilgængelig i workflows, der bruger udløseren Planlagt tidspunkt. date_minus-Liquid-tagget er et særligt Flow-tag, der giver dig mulighed for at trække tid fra en dato.
Når du forespørger på data, er det nyttigt at vide:
- Liste over tilgængelige ordrefiltre
- Forespørgsler skal følge en bestemt syntaks
- Værdier for forespørgselsfelter er ikke altid dokumenterede. I nogle tilfælde kan værdierne findes ved at kigge i API-dokumentationen. Alternativt kan du ofte finde feltværdierne i webadresserne i administratorpanelet, når du filtrerer. Hvis du f.eks. vil finde nogle forespørgselsværdier for ordrer, skal du filtrere siden Ordrer i administratorpanelet 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. 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 anvendelsesformål kan du bruge disse data på forskellige måder:
- Hvis du har brug for at håndtere hvert listeelement individuelt, f.eks. for at føje et tag til hver, kan du bruge handlingen For each.
- Hvis du har brug for at aggregere data, f.eks. for at tælle, hvor mange resultater der blev returneret, kan du bruge handlingerne Tæl eller Sum.
- Hvis du skal bruge listen, f.eks. til at sende en mail med alle varerne, kan du bruge de returnerede data direkte i efterfølgende handlinger.
Hvis du vil have adgang til de returnerede data i trin, der følger efter denne handling, skal du bruge variablen med navnet Hent data for ordrekladde, som er en liste over ordrekladder. Du kan bruge denne variabel i både betingelser og handlinger. Du kan f.eks. sende listen over ordrekladder i en Send intern mail-handling som denne:
{% for single_order in GetDraftOrderData %}
* {{ single_order.name }}
{% 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, medtages der ikke automatisk nogen data.
API-detaljer
Skabeloner
Send daglig notifikation med alle åbne ordrekladder
Hent åbne ordrekladder hver dag, tæl dem, og send en Slack-besked. Bruger udløseren Planlagt tidspunkt samt handlingerne Hent ordrekladder og Tæl. Se skabelon