Hämta orderdata för din distribution

Du kan använda åtgärden Hämta orderdata för din distribution för att hämta orderinformation för distribution från din butik.

Konfiguration

Fält

Åtgärden Hämta data för distributionsorder innehåller följande fält, som används för att skapa frågan:

Fält som används i åtgärderna Hämta data.
FältBeskrivning
Sortera data efterKrävs. De parametrar som datan som returneras av sökfrågan sorteras efter.
Maximalt antal resultatKrä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ågaKrä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 hämta ordrar för distribution som för närvarande är i vänteläge:

status:ON_HOLD

Variabeln status är ett filter som finns tillgängligt i frågan om Ordrar för distribution 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 filter för ordrar för distribution - Frågor måste följa en viss syntax
  • Frågeältnamn för för alla frågor finns i utvecklardokumenten för QueryRoot-objekt.
  • 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.

Om du vill få åtkomst till returnerade data i steg som följer denna åtgärd så använder du variabeln med namnet Hämta data för distributionsorder, vilken är en lista över distributionsordrar. Du kan använda denna variabel i både villkor och åtgärder. Du kan till exempel skicka listan över distributionsordrar i åtgärden Skicka intern e-post så här:

{% for fulfillment_order in GetFulfillmentOrderData %}
- Order: {{ fulfillment_order.order.name }} Location: {{ fulfillment_order.assignedLocation.name }}
{% endfor %}

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.

Exempel

Exempel på ett arbetsflöde som upprepas en gång om dagen, kontrollerar ordrar för distribution och skickar en e-postsammanfattning

I det här exempelarbetsflödet är ett arbetsflöde schemalagt att köras varje dag kl. 16.34. Åtgärden Hämta orderdata för din distribution används för att samla in data för ordrar som är satta i vänteläge.En lista över ordrar som är satta i vänteläge skickas via e-post till personer som arbetar i din butik.

API-referens

Hittar du inte de svar du letar efter? Vi finns här för att hjälpa till!