Hämta platsdata

I arbetsflöden som kräver platsdata kan du använda åtgärden Hämta platsdata för att hämta platsinformation från din Shopify-butik. Platser är alla ställen där du lagrar lager, säljer produkter eller levererar eller distribuerar ordrar.

Obs

Det här är en typ av åtgärden Hämta data. Information om hur du använder den här typen av åtgärd med utlösaren Schemalagd tid och För varje-loopar finns i Scheman, hämta data och loopande arbetsflöden i Shopify Flow.

Konfiguration

Fält

Åtgärden Hämta platsdata innehåller följande fält.

Fält som används i åtgärder för att hämta data.

Fält	Beskrivning
Sortera data efter	Obligatoriskt. De parametrar som de data som returneras av 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.
Fråga	Obligatoriskt. Välj bland vanliga frågor eller välj Avancerat för att skapa din egen.

Frågesträng

Det här är ett exempel på en fråga för att hämta platser som har aktiverat hämta i butik:

pickup_in_store:enabled

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

När du gör dataförfrågningar är det bra att veta:

• Lista över tillgängliga platsfilter

• 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-dokumentationen. 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.

• Tänk på vad som händer om din fråga misslyckas. Ofta returnerar API:et alla resultat (i stället för inga).

Returnerad 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 listobjekt individuellt, till exempel för att lägga till en tagg för vart och ett, 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 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 platsdata, som är en lista över platser. Du kan använda den här variabeln i både villkor och åtgärder. Du kan till exempel skicka listan över platser i en Skicka internt e-postmeddelande-åtgärd så här:

{% for single_location in GetLocationData %}
* {{ single_location.id }}
{% endfor %}

Obs

Om en Hämta data-åtgärd används flera gånger i ett enda arbetsflöde läggs ett nummer till i variabelnamnet. I ett arbetsflöde som till exempel använder åtgärden Hämta orderdata två gånger är den första variabeln för returnerade data getOrderData och den andra variabeln är getOrderData1. Det här namnet 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, 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-referens

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