Hämta företagsplatsdata
I arbetsflöden som använder företagsplatsdata kan du använda åtgärden Hämta företagsplatsdata för att hämta information om företagsplatser från din butik.
På den här sidan
Konfiguration
Fält
Åtgärden Hämta företagsplatsdata innehåller följande fält, som används för att bygga frågan:
| Fält | Beskrivning |
|---|---|
| Sortera data efter | Obligatoriskt. De parametrar som returnerad data från 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 en exempelfråga för att hämta företagsplatser som uppdaterades under det senaste dygnet:
updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'Variabeln updated_at är ett filter som är tillgängligt för frågan för företagsplatser och 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 gör datafrågor kan det vara bra att veta:
- Lista över tillgängliga filter för företagsplatser
- Frågor måste följa en viss syntax
- Fältvärden för frågor är inte alltid dokumenterade. I vissa fall kan värdena hittas i API-dokumenten. 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 frågevärden för Order 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 (istället för inga).
Returnerad data
Alla åtgärder för att hämta data returnerar en lista med 0 till 100 resurser. Beroende på ditt användningsfall kan du använda dessa data på olika sätt:
- Om du behöver hantera varje artikel i listan 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 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 komma åt returnerad data i steg som följer denna åtgärd, använd variabeln med namnet Hämta företagsplatsdata, som är en lista över företagsplatser. Du kan använda variabeln i både villkor och åtgärder. Du kan till exempel skicka listan med platser i åtgärden Skicka internt e-postmeddelande så här:
{% for single_company in GetCompanyLocationData %}
* {{ single_company.name }}
{% endfor %}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 ingen data automatiskt.