Hent data om lagervare

I arbeidsflyter som krever data om lagervarer, kan du bruke handlingen Hent data om lagervare for å hente informasjon om lagervarer fra butikken din. Lagervarer representerer de faktiske lagerenhetene som spores for produktvarianter.

Konfigurasjon

Felt

Handlingen Hent data om lagervare inneholder følgende felt:

Spørringsstreng

Dette er en eksempelspørring for å hente lagervarer som spores:

tracked:true

Variabelen tracked er et filter som er tilgjengelig i spørringen for lagervarer, 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 lagervarefiltre

• 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 trenger å sende ut listen, for eksempel sende en e-post med alle varene, kan du bruke de returnerte dataene direkte i påfølgende handlinger.

For å få tilgang til de returnerte dataene i trinn som følger etter denne handlingen, bruker du variabelen med navnet Hent lagervaredata, som er en liste over lagervarer. Du kan bruke denne variabelen i både betingelser og handlinger. Du kan for eksempel sende listen over lagervarer i en Send intern e-post-handling på denne måten:

{% for single_inventory_item in getInventoryItemData %}
  * SKU: {{ single_inventory_item.sku }} - Cost: {{ single_inventory_item.unitCost.amount }}
{% endfor %}

Utløsere

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

API-referanse

For mer informasjon om API-et som brukes i denne handlingen, kan du se spørringen for lagervarer.