Hjälp
Logga in

Hämta företagsdata

I workflows som använder företagsdata kan du använda åtgärden Hämta företagsdata för att hämta företagsinformation från din butik.

På den här sidan

Konfiguration

Fält

Åtgärden Hämta företagsdata innehåller följande fält, som används för att bygga sökfrågan:

Fält som används i Hämta data-åtgärderna.
FältBeskrivning
Sortera data efterObligatoriskt. De parametrar efter vilka data som returneras av sökfrågan sorteras.
Maximalt antal resultatObligatoriskt. Det maximala antalet resultat som kan returneras av den sökfråga du väljer. Du kan returnera upp till 100 åt gången.
SökfrågaObligatoriskt. Välj bland vanliga sökfrågor eller välj Avancerat för att skapa en egen.

Sökfrågesträng

Det här är en exempelsökfråga för att hämta företag som har uppdaterats 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 sökfrågan Företag och kan användas flera gånger eller kombineras med andra variabler. Liquid-variabeln scheduledAt är tillgänglig i workflows 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 sökfrågor efter data är det bra att veta följande:

  • Lista över tillgängliga företagsfilter
  • Sökfrågor måste följa en viss syntax
  • Fältvärden för sökfrågor ä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 sökfrågevärden för Ordrar 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 Shopify GraphiQL-appen.
  • Var medveten om vad som händer om din sökfråga misslyckas. API:et returnerar ofta 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 kan du vilja 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 sammanställa data, till exempel räkna hur många resultat som returnerades, kan du använda åtgärderna Antal eller Summa.
  • Om du behöver använda hela listan, till exempel för att skicka ett e-postmeddelande med alla artiklar, kan du använda den returnerade datan direkt i efterföljande åtgärder.

För att komma åt den returnerade datan i steg som följer den här åtgärden använder du variabeln med namnet Hämta företagsdata, som är en lista över företag. Du kan använda den här variabeln i både villkor och åtgärder. Du kan till exempel skicka listan över företag i åtgärden Skicka internt e-postmeddelande så här:

{% for single_company in GetCompanyData %}
* {{ single_company.name }}
{% endfor %}

Utlösare

Du kan använda den här åtgärden i valfritt arbetsflöde, 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 inkluderas inga data automatiskt.

API-referens