Hämta presentkortsdata
I arbetsflöden som kräver presentkortsdata kan du använda åtgärden Hämta presentkortsdata för att hämta presentkortsinformation från din butik.
Det är viktigt att komma ihåg att din butik har både presentkortsprodukter, som används för att generera presentkort, och själva presentkorten, som är de faktiska presentkort som kunder kan använda för att göra inköp. Åtgärden Hämta presentkortsdata hämtar information om själva presentkorten. Om du vill ha information om presentkortsprodukter använder du åtgärderna Hämta produktdata eller Hämta produktvariantdata.
På den här sidan
Konfiguration
Fält
Åtgärden Hämta presentkortsdata innehåller följande fält, som används för att skapa sökfrågan:
| Fält | Beskrivning |
|---|---|
| Sortera data efter | Obligatoriskt. De parametrar som data från sökfrågan sorteras efter. |
| 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 bland vanliga sökfrågor eller välj Avancerat för att skapa en egen. |
Sökfrågesträng
Det här är ett exempel på en sökfråga för att hämta presentkort som uppdaterades under det senaste dygnet:
created_at:<='{{ scheduledAt }}' AND created_at:>'{{ scheduledAt | date_minus: "1 day" }}'Variabeln created_at är ett filter som är tillgängligt för sökfrågan för presentkort 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 särskild Flow-tagg som gör att du kan subtrahera tid från ett datum.
När du söker efter data är det bra att känna till:
Frågor måste följa en viss syntax
Fältvärden för frågor är inte alltid dokumenterade. I vissa fall kan värdena hittas i API-dokumenten. Alternativt kan du ofta hitta fältvärdena i URL:erna i din adminpanel när du filtrerar. För att till exempel hitta frågevärden för Order kan du filtrera sidan Ordrar i din adminpanel och sedan kontrollera URL:en.
Du kan köra eller testa en fråga i din butik genom att använda Shopify GraphiQL-appen.
Tänk på vad som händer om din frå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 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 varje, kan du använda åtgärden För varje.
- Om du behöver aggregera data, till exempel för att 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 för att 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 presentkortsdata, som är en lista över presentkort. Du kan använda den här variabeln i både villkor och åtgärder. Du kan till exempel skicka listan med presentkort i en Skicka internt e-postmeddelande-åtgärd så här:
{% for single_gift_card in GetGiftCardData %}
* {{ single_gift_card.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, i stället för 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.