Hämta siddata

I arbetsflöden som kräver siddata kan du använda åtgärden Hämta siddata för att hämta sidinformation från din butik. Sidor är de webbsidor i din webbshop som innehåller information som sällan ändras, till exempel en Om oss-sida eller en kontaktsida.

Obs!

Det här är en typ av åtgärd för Hämta data. Om du vill veta 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 loopa arbetsflöden i Shopify Flow.

Konfiguration

Fält

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

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

Fält	Beskrivning
Sortera data efter	Krävs. Parametrarna som den data som returneras av sökfrågan sorteras efter.
Maximalt antal resultat	Krävs. Det maximala antalet resultat som kan returneras av den sökfråga som du väljer. Du kan returnera upp till 100 åt gången.
Sökfråga	Krävs. Välj bland vanliga sökfrågor eller välj Avancerat för att skapa en egen.

Frågesträng

Det här är en exempelsökfråga för att hämta publicerade sidor:

published_status:published

Variabeln published_status är ett filter som är tillgängligt för sidsökfrågan och kan användas flera gånger eller kombineras med andra variabler.

När du gör sökfrågor för data är det bra att veta följande:

• Lista över tillgängliga sidfilter

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

• Sökfrågefältens vä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 en ordersökfråga filtrerar du sidan Ordrar i adminpanelen och kontrollerar sedan URL:en.

• Du kan köra eller testa en sökfråga i din butik med hjälp av appen Shopify GraphiQL.

• Tänk på vad som händer om sökfrågan misslyckas. API:et returnerar ofta alla resultat (i stället för inga alls).

Returnerad data

Alla åtgärder för Hämta data returnerar en lista med allt från 0 till 100 resurser. Beroende på ditt användningsfall kanske du vill använda den här datan på olika sätt:

• Om du behöver hantera varje listobjekt individuellt, till exempel 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 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 returnerad data direkt i efterföljande åtgärder.

För att få åtkomst till returnerad data i steg som följer efter den här åtgärden använder du variabeln Hämta siddata, vilket är en lista över sidor. Du kan använda den här variabeln i både villkor och åtgärder. Du kan till exempel skicka listan över sidor i åtgärden Skicka internt e-postmeddelande ungefär så här:

{% for single_page in getPageData %}
  * {{ single_page.title }} - {{ single_page.handle }}
{% endfor %}

Obs!

Om åtgärden Hämta data används flera gånger i ett enda arbetsflöde läggs ett nummer till i variabelnamnet. I ett arbetsflöde som använder åtgärden Hämta orderdata två gånger är till exempel den första variabeln för returnerad data getOrderData och den andra variabeln 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 ingår ingen data automatiskt.

API-referens

Mer information om det API som används i den här åtgärden finns i sidsökfrågan.