Hämta artikeldata

I arbetsflöden som kräver data för bloggartiklar kan du använda åtgärden Hämta artikeldata för att hämta artikelinformation från din Shopify-butik.

Observera

Detta är en typ av Hämta data-åtgärd. För att förstå hur du använder den här typen av åtgärd med utlösaren Schemalagd tid och För varje-loopar, se Scheman, hämta data och loopande arbetsflöden i Shopify Flow.

Konfiguration

Fält

Åtgärden Hämta artikeldata innehåller följande fält:

Fält som används i Hämta data-åtgärderna.

Fält	Beskrivning
Sortera data efter	Obligatoriskt. Parametrarna som används för att sortera data som returneras av sökfrågan.
Maximalt antal resultat	Obligatoriskt. Det maximala antalet resultat som kan returneras av den valda sökfrågan. 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.

Frågesträng

Detta är ett exempel på en sökfråga för att hämta artiklar som publicerats under det senaste dygnet:

published_at:<='{{ scheduledAt }}' AND published_at:>'{{ scheduledAt | date_minus: "1 day" }}'

Variabeln published_at är ett filter som är tillgängligt för sökfrågan för artiklar och det 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 veta följande:

• Lista över tillgängliga artikelfilter

• Sökfrågor måste följa en viss syntax

• Sökfrågans fältvärden är inte alltid dokumenterade. I vissa fall kan värdena hittas genom att titta i API-dokumentationen. Alternativt kan du ofta hitta fältvärdena i URL:erna i adminpanelen när du filtrerar. För att till exempel hitta vissa värden för ordersökfrågor filtrerar du sidan Ordrar i adminpanelen och kontrollerar sedan URL:en.

• Du kan köra eller testa en sökfråga i din butik genom att använda appen Shopify GraphiQL.

• Tänk på 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 mellan 0 och 100 resurser. Beroende på ditt användningsfall kanske du vill använda dessa data på olika sätt:

• Om du behöver hantera varje post i listan individuellt, till exempel för att lägga till en tagg för varje post, kan du använda åtgärden För varje.
• 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 Summa.
• Om du behöver mata ut listan, till exempel för att skicka ett e-postmeddelande med alla objekt, kan du använda returnerade data direkt i efterföljande åtgärder.

För att komma åt de returnerade data i steg som följer efter den här åtgärden använder du variabeln Hämta artikeldata, som är en lista med artiklar. Du kan använda den här variabeln i både villkor och åtgärder. Du kan till exempel skicka listan med artiklar i åtgärden Skicka internt e-postmeddelande, liknande det här:

{% for single_article in GetArticleData %}
    * {{ single_article.title }}
    {% endfor %}

Observera

Om en Hämta data-åtgärd används flera gånger i ett och samma arbetsflöde läggs en siffra till i variabelnamnet. Om du till exempel använder åtgärden Hämta orderdata två gånger i ett arbetsflöde är den första variabeln för returnerade data getOrderData och den andra variabeln är getOrderData1. Detta namn kan inte anpassas.

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.

API-referens

För mer information om det API som används i denna åtgärd, se sökfrågan för artiklar.