Hent katalogdata

I arbeidsflyter som krever katalogdata, kan du bruke handlingen Hent katalogdata for å hente B2B-kataloginformasjon fra butikken. Kataloger er grupper av produkter med tilpassede priser for spesifikke B2B-kunder eller bedriftssteder.

Merk

Dette er en type Hent data-handling. For å forstå hvordan du bruker denne typen handling med utløseren Planlagt tidspunkt og For hver-løkker, kan du se Tidsplaner, innhenting av data og løkkearbeidsflyter i Shopify Flow.

Konfigurasjon

Felt

Handlingen Hent katalogdata inneholder følgende felt:

Felt brukt i Hent data-handlingene.

Felt	Beskrivelse
Sorter data etter	Obligatorisk. Parameterne som dataene returnert av søket skal sorteres etter.
Maksimalt antall resultater	Obligatorisk. Maksimalt antall resultater som kan returneres av søket du velger. Du kan returnere opptil 100 om gangen.
Spørring	Obligatorisk. Velg blant vanlige spørringer, eller velg Avansert for å lage din egen.

Spørringsstreng

Dette er en eksempelspørring for å hente alle aktive kataloger:

status:ACTIVE

Variabelen status er et filter som er tilgjengelig i katalogspørringen, og kan brukes flere ganger eller kombineres med andre variabler.

Når du gjør spørringer etter data, er det nyttig å vite følgende:

• Liste over tilgjengelige katalogfiltre

• Spørringer må følge en bestemt syntaks

• Verdier for spørringsfelt er ikke alltid dokumentert. I noen tilfeller finner du verdiene ved å se på API-dokumentasjonen. Alternativt kan du ofte finne feltverdiene i URL-adressene i administratorpanelet når du filtrerer. For å for eksempel finne noen verdier for bestillingsspørringer, kan du filtrere siden Ordre i administratorpanelet og deretter sjekke URL-adressen.

• Du kan kjøre eller teste en spørring i butikken din ved å bruke appen Shopify GraphiQL.

• Vær oppmerksom på hva som skjer hvis spørringen mislykkes. API-et vil ofte returnere alle resultater (i stedet for ingen).

Returnerte data

Alle handlinger for Hent data returnerer en liste med mellom 0 og 100 ressurser. Avhengig av brukstilfellet kan du bruke disse dataene på ulike måter:

• Hvis du må håndtere hvert listeelement individuelt, for eksempel for å legge til en tagg for hver av dem, kan du bruke handlingen For hver.
• Hvis du må aggregere data, for eksempel for å telle hvor mange resultater som ble returnert, kan du bruke handlingen Tell eller Sum.
• Hvis du må ta ut listen, for eksempel ved å sende en e-post med alle elementene, kan du bruke de returnerte dataene direkte i påfølgende handlinger.

For å få tilgang til de returnerte dataene i trinn som følger denne handlingen, bruker du variabelen med navnet Hent katalogdata, som er en liste over kataloger. Du kan bruke denne variabelen i både betingelser og handlinger. Du kan for eksempel sende listen over kataloger i handlingen Send intern e-post, omtrent slik som dette:

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

Merk

Hvis en Hent data-handling brukes flere ganger i én enkelt arbeidsflyt, legges det til et tall i variabelnavnet. I for eksempel en arbeidsflyt som bruker handlingen Hent bestillingsdata to ganger, er den første variabelen for returnerte data getOrderData, og den andre variabelen er getOrderData1. Dette navnet kan ikke tilpasses.

Utløsere

Du kan bruke denne handlingen i enhver arbeidsflyt, inkludert utløseren Planlagt tidspunkt. I en arbeidsflyt som bruker utløseren Planlagt tidspunkt, starter arbeidsflyten på et tidspunkt du har angitt, i stedet for som et resultat av en hendelse. Siden det ikke finnes en spesifikk hendelse i butikken din, eller fra en app som starter arbeidsflyten, blir ingen data inkludert automatisk.

API-referanse

Hvis du vil ha mer informasjon om API-et som brukes i denne handlingen, kan du se katalogspørringen.