Hämta katalogdata

I arbetsflöden som kräver katalogdata kan du använda åtgärden Hämta katalogdata för att hämta information om B2B-kataloger från din butik. Kataloger är grupper av produkter med anpassad prissättning för specifika B2B-kunder eller företagsplatser.

Observera

Detta är en typ av Hämta data-åtgärd. För att förstå hur du använder den här typen av åtgärd med utlösaren Schemalagd tid och För varje-loopar, se Scheman, hämta data och loopa arbetsflöden i Shopify Flow.

Konfiguration

Fält

Åtgärden Hämta katalogdata innehåller följande fält:

Fält som används i Hämta data-åtgärder.

Fält	Beskrivning
Sortera data efter	Krävs. Parametrarna som den returnerade datan från sökfrågan sorteras efter.
Maximalt antal resultat	Krävs. Det maximala antalet resultat som kan returneras av sökfrågan som du väljer. Du kan returnera upp till 100 åt gången.
Sökfråga	Krävs. Välj bland vanliga sökfrågor eller välj Avancerat för att skapa en egen.

Sökfrågesträng

Detta är ett exempel på en sökfråga för att hämta alla aktiva kataloger:

status:ACTIVE

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

När du söker efter data är det bra att veta följande:

• Lista över tillgängliga katalogfilter

• Sökfrågor måste följa en viss syntax

• Värden för sökfrågefält ä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 en ordersökfråga filtrerar du sidan Ordrar i adminpanelen och kontrollerar sedan URL:en.

• Du kan köra eller testa en sökfråga i din butik genom att använda appen Shopify GraphiQL.

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

Returnerade data

Alla Hämta data-åtgärder returnerar en lista med allt från 0 till 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 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 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 returnerade data direkt i efterföljande åtgärder.

För att komma åt de returnerade data i de steg som följer efter den här åtgärden använder du variabeln Hämta katalogdata, som är en lista över kataloger. Du kan använda den här variabeln i både villkor och åtgärder. Du kan till exempel skicka listan över kataloger i en åtgärd för Skicka internt e-postmeddelande som ser ut ungefär så här:

{% for single_catalog in getCatalogData %}
  * {{ single_catalog.title }}
{% endfor %}

Observera

Om en Hämta data-åtgärd används flera gånger i ett och samma arbetsflöde läggs en siffra 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, 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

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