Hent katalogdata

I workflows, der kræver katalogdata, kan du bruge handlingen Hent katalogdata til at hente oplysninger om B2B-kataloger fra din butik. Kataloger er produktgrupper med tilpassede priser til specifikke B2B-kunder eller firmalokationer.

Bemærk

Dette er en type Hent data-handling. Du kan få mere at vide om, hvordan du bruger denne type handling med udløseren Planlagt tidspunkt og For each-løkker i Tidsplaner, hentning af data og workflows med løkker i Shopify Flow.

Konfiguration

Felter

Handlingen Hent katalogdata indeholder følgende felter:

Felter, der bruges i Hent data-handlingerne.

Felt	Beskrivelse
Sortér data efter	Kræves. De parametre, som de data, der returneres af søgeforespørgslen, sorteres efter.
Maksimalt antal resultater	Påkrævet. Det maksimale antal resultater, som kan returneres af den valgte søgeforespørgsel. Du kan højst få returneret 100 ad gangen.
Forespørgsel	Påkrævet. Vælg mellem almindelige forespørgsler, eller vælg Avanceret for at oprette din egen.

Forespørgselsstreng

Dette er et eksempel på en forespørgsel til at hente alle aktive kataloger:

status:ACTIVE

Variablen status er et filter, der er tilgængeligt for katalogforespørgslen, og det kan bruges flere gange eller kombineres med andre variabler.

Når du forespørger på data, er det nyttigt at vide følgende:

• Liste over tilgængelige katalogfiltre

• Forespørgsler skal følge en bestemt syntaks

• Værdier for forespørgselsfelter er ikke altid dokumenterede. I nogle tilfælde kan værdierne findes ved at kigge i API-dokumentationen. Alternativt kan du ofte finde feltværdierne i webadresserne i din administrator, når du filtrerer. Du kan f.eks. finde værdierne for ordreforespørgsler ved at filtrere siden Ordrer i din administrator og derefter tjekke webadressen.

• Du kan køre eller teste en forespørgsel i din butik ved hjælp af Shopify GraphiQL-appen.

• Vær opmærksom på, hvad der sker, hvis din forespørgsel mislykkes. Ofte returnerer API'en alle resultater (i stedet for ingen).

Returnerede data

Alle handlinger af typen Hent data returnerer en liste på mellem 0 og 100 ressourcer. Afhængigt af dit anvendelsesscenarie kan du bruge disse data på forskellige måder:

• Hvis du har brug for at håndtere hvert enkelt element på listen individuelt, som f.eks. at tilføje et tag for hvert element, kan du bruge handlingen For hver.
• Hvis du har brug for at samle data sammen, f.eks. for at tælle det returnerede antal resultater, kan du bruge handlingerne Tæl eller Sum.
• Hvis du har brug for at udskrive listen, f.eks. for at sende en mail med alle elementerne, kan du bruge de returnerede data direkte i de efterfølgende handlinger.

Du kan få adgang til de returnerede data i de efterfølgende trin ved at bruge variablen Hent katalogdata, som er en liste over kataloger. Du kan bruge denne variabel i både betingelser og handlinger. Du kan f.eks. sende listen over kataloger via handlingen Send intern mail på følgende måde:

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

Bemærk

Hvis en handling af typen Hent data bruges flere gange i et enkelt workflow, føjes der et tal til variabelnavnet. I et workflow, der f.eks. bruger handlingen Hent ordredata to gange, er den første variabel for de returnerede data getOrderData, og den anden variabel er getOrderData1. Dette navn kan ikke tilpasses.

Udløsere

Du kan bruge denne handling i alle workflows, herunder udløseren Planlagt tidspunkt. I et workflow, der bruger udløseren Planlagt tidspunkt, starter workflowet på et tidspunkt, som du har angivet, i stedet for som et resultat af en hændelse. Fordi der ikke er nogen specifik hændelse i din butik eller fra en app, der starter workflowet, inkluderes der ikke automatisk nogen data.

API-reference

Du kan få flere oplysninger om den API, der bruges i denne handling, i katalogforespørgslen.