Hämta data om orderutkast
I arbetsflöden som använder data om orderutkast kan du använda åtgärden Hämta data om orderutkast för att hämta information om orderutkast från din butik.
På den här sidan
Konfiguration
Fält
Åtgärden Hämta data om orderutkast innehåller följande fält, som används för att skapa sökfrågan:
| Fält | Beskrivning |
|---|---|
| Sortera data efter | Obligatoriskt. Parametrarna som används för att sortera de data som returneras av sökfrågan. |
| Maximalt antal resultat | Obligatoriskt. Det maximala antalet resultat som kan returneras av den sökfråga du väljer. Du kan returnera upp till 100 åt gången. |
| Sökfråga | Obligatoriskt. Välj från vanliga sökfrågor eller välj Avancerat för att skapa din egen. |
Sökfrågesträng
Det här är ett exempel på en sökfråga för att hämta orderutkast som uppdaterades under den senaste dagen:
updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'Variabeln updated_at är ett filter som är tillgängligt för sökfrågan för orderutkast och kan användas flera gånger eller kombineras med andra variabler. Liquid-variabeln scheduledAt är tillgänglig i arbetsflöden som använder utlösaren Schemalagd tid. Liquid-taggen date_minus är en speciell Flow-tagg som låter dig dra ifrån tid från ett datum.
När du söker efter data är det bra att veta följande:
- Lista över tillgängliga orderfilter
- Sökfrågor måste följa en viss syntax
- Fältvärden för sökfrågor är inte alltid dokumenterade. I vissa fall kan värdena hittas genom att titta i API-dokumenten. Alternativt kan du ofta hitta fältvärdena i URL:erna i adminpanelen när du filtrerar. Om du till exempel vill hitta några sökfrågevärden för ordrar kan du filtrera sidan Ordrar i adminpanelen och sedan kontrollera URL:en.
- Du kan köra eller testa en sökfråga i din butik med hjälp av Shopify GraphiQL-appen.
- Var medveten om vad som händer om din sökfråga misslyckas. Ofta returnerar API:et alla resultat (i stället för inga).
Returnerade data
Alla Hämta data-åtgärder returnerar en lista med 0 till 100 resurser. Beroende på ditt användningsfall kan du vilja använda dessa data på olika sätt:
- Om du behöver hantera varje artikel i listan individuellt, till exempel för att lägga till en tagg för var och en, kan du använda åtgärden For each.
- Om du behöver aggregera data, till exempel räkna hur många resultat som returnerades, kan du använda åtgärderna Räkna eller Summera.
- Om du behöver mata ut listan, till exempel skicka ett e-postmeddelande med alla artiklar, kan du använda returnerade data direkt i efterföljande åtgärder.
För att komma åt returnerade data i steg som följer efter den här åtgärden använder du variabeln Hämta data om orderutkast, som är en lista över orderutkast. Du kan använda den här variabeln i både villkor och åtgärder. Du kan till exempel skicka listan med orderutkast i åtgärden Skicka internt e-postmeddelande så här:
{% for single_order in GetDraftOrderData %}
* {{ single_order.name }}
{% endfor %}Utlösare
Du kan använda den här åtgärden i alla arbetsflöden, inklusive utlösaren Schemalagd tid. I ett arbetsflöde som använder utlösaren Schemalagd tid startar arbetsflödet vid en tidpunkt som du har angett, snarare än som ett resultat av en händelse. Eftersom det inte finns någon specifik händelse i din butik eller från en app som startar arbetsflödet, inkluderas inga data automatiskt.
API-detaljer
Mallar
Skicka dagligt meddelande med alla öppna orderutkast
Hämta öppna orderutkast varje dag, räkna dem och skicka ett Slack-meddelande. Använder utlösaren Schemalagd tid samt åtgärderna Hämta data om orderutkast och Räkna. Visa mall