Hämta produktdata
I arbetsflöden som använder produktdata kan du använda åtgärden Hämta produktdata för att hämta produktinformation från din butik.
På den här sidan
Konfiguration
Fält
Åtgärden Hämta produktdata innehåller följande fält, som används för att bygga frågan:
| Fält | Beskrivning |
|---|---|
| Sortera data efter | Obligatoriskt. Parametrarna som styr sorteringen av de data som sökfrågan returnerar. |
| Maximalt antal resultat | Obligatoriskt. Det maximala antalet resultat som kan returneras av sökfrågan du väljer. Du kan returnera upp till 100 åt gången. |
| Fråga | Obligatoriskt. Välj bland vanliga frågor eller välj Avancerat för att skapa en egen. |
Frågesträng
Detta är ett exempel på en fråga för att hämta produkter som uppdaterades under det senaste dygnet:
updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'Variabeln updated_at är ett filter som är tillgängligt för Produktfrågan och kan användas flera gånger eller kombineras med andra variabler. scheduledAt Liquid-variabeln ä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 gör datafrågor är det bra att veta:
- Lista över tillgängliga produktfilter
- Frågor måste följa en viss syntax
- Frågefältvärden ä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 värden för orderfrågor filtrerar du sidan Ordrar i adminpanelen och kontrollerar sedan URL:en.
- Du kan köra eller testa en fråga i din butik med hjälp av Shopify GraphiQL-appen.
- Var medveten om vad som händer om din fråga misslyckas. API:et returnerar ofta alla resultat (istället för inga).
Returnerade data
Alla Hämta data-åtgärder returnerar en lista med mellan 0 och 100 resurser. Beroende på ditt användningsfall kan du vilja använda dessa data på olika sätt:
- Om du behöver hantera varje listobjekt 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 Antal eller Summa.
- 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änd variabeln Hämta produktdata, som är en lista över produkter. Du kan använda den här variabeln i både villkor och åtgärder. Du kan till exempel skicka produktlistan i en Skicka internt e-postmeddelande-åtgärd så här:
{% for single_product in GetProductData %}
* {{ single_product.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
Lägg till produkter med en tagg i en produktserie vid ett senare tillfälle
Vid ett senare tillfälle hämtas alla produkter med en viss tagg och läggs sedan till i en produktserie. Visa mall
Radera inaktiva produkter
Radera produkter utan lager som inte har uppdaterats på ett år. Visa mall
Publicera produkter med en viss tagg vid ett senare tillfälle
På ett framtida datum hämtas produkter med en viss tagg och publiceras. Använder utlösaren Schemalagd tid och åtgärden Hämta produktdata. Visa mall
Ta bort den nya produkttaggen 90 dagar efter att produkten har skapats
Varje dag hämtas upp till 100 produkter som skapades för mer än 90 dagar sedan och som fortfarande har taggen ”ny”. Arbetsflödet tar sedan bort dessa taggar för varje produkt. Visa mall
Schemalägg att produkter ska tas bort från Webbshopen vid angivet datum och tid
Vid ett enda framtida datum tas produkter bort från webbshoppen efter tagg, id eller SKU. Använder utlösaren Schemalagd tid, åtgärden Hämta produktdata och För varje-loopen. Visa mall
Skicka en daglig e-postsammanfattning med produkter som är slut i lager
Varje dag hämtas alla produkter som har lagersaldo 0 och en e-postsammanfattning skickas. Använder Hämta produktdata, utlösaren Schemalagd tid. Visa mall
Skicka e-postavisering när en variant med dubblerad SKU läggs till
När en ny variant läggs till kontrolleras det om andra varianter använder samma SKU. Om så är fallet skickas ett internt e-postmeddelande med länkar till de berörda produkterna och varianterna. Visa mall
Spåra produktvarianter som är på rea med hjälp av ett produktmetafält
Anger ett metafält för en produkt om minst en av dess varianter är på rea. Detta kan vara användbart för att spåra vilka produkter som för närvarande är på rea. Visa mall