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 platser där du har lager, säljer produkter eller levererar eller distribuerar ordrar.

Observera

Detta är en typ av Hämta data-åtgärd. För att förstå hur du använder denna typ av åtgärd med utlösaren Schemalagd tid och För varje-loopar, se denna guide.

Konfiguration

Fält

Åtgärden Hämta platsdata 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. De parametrar som datan som returneras av sökfrågan sorteras efter.
Maximalt antal resultat	Krävs. Maximalt antal resultat som kan returneras av den sökfråga du väljer. Du kan returnera upp till 100 åt gången.
Fråga	Krävs. Välj bland vanliga frågor eller välj Avancerat för att skapa din egen.

Frågesträng

Det här är en exempelfråga för att ta fram platser som har aktiverat hämtning i butik:

pickup_in_store:enabled

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

När du efterfrågar data är det användbart att ha kännedom om:

• Lista över tillgängliga platsfilter

• Frågor måste följa en viss syntax

• Fältvärden för fråga dokumenteras inte alltid. I vissa fall kan värdena hittas genom att titta på API-dokument. Alternativt kan du ofta hitta fältvärdena i URL:er i Shopify-admin när du filtrerar. Om du till exempel vill hitta några orderfrågevärden filtrerar du ordersidan i Shopify-admin och markerar sedan 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 kommer API:n att returnera alla resultat (istället för inga).

Returnerade data

Alla åtgärder för att Hämta data returnerar en lista över allt från 0 och 100 resurser. Beroende på 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 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 Antal eller Summa.
• 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. Använd variabeln Hämta platsdata, som är en lista över platser, för att komma åt returnerade data i de steg som följer på denna åtgärd. Du kan använda denna variabel i både villkor och åtgärder. Du kan till exempel skicka listan över platser i en Skicka intern e-post-åtgärd så här:

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

Observera

Om åtgärden Hämta data används flera gånger i ett och samma arbetsflöde, läggs ett nummer till i variabelnamnet. Till exempel, i ett arbetsflöde som använder åtgärden Hämta orderdata två gånger, är den första variabeln för returnerade data getOrderData och den andra variabeln getOrderData1. Namnet kan inte anpassas.

Utlösare

Du kan använda den här åtgärden i alla arbetsflöden, inklusive utlösaren för schemalagd tid. I ett arbetsflöde som använder utlösaren för 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 ingår ingen data automatiskt.

API-referens

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