Hent lagervaredata

I workflows, der kræver data om lagervarer, kan du bruge handlingen Hent lagervaredata til at hente oplysninger om lagervarer fra din butik. Lagervarer repræsenterer de faktiske lagerenheder, der spores for produktvarianter.

Bemærk

Dette er en type Hent data-handling. Få mere at vide om, hvordan du bruger denne type handling sammen med udløseren Planlagt tidspunkt og For hver-løkker, i Tidsplaner, hent data og workflows med løkker i Shopify Flow.

Konfiguration

Felter

Handlingen Hent lagervaredata indeholder følgende felter:

Felter, der bruges i handlinger af typen Hent data.

Felt	Beskrivelse
Sortér data efter	Påkrævet. De parametre, som de returnerede data fra 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 hentning af lagervarer, der spores:

tracked:true

Variablen tracked er et filter, der er tilgængeligt for forespørgslen for lagervarer, 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 lagervarefiltre

• 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 et output af listen, f.eks. til at sende en mail med alle varerne, kan du bruge de returnerede data direkte i efterfølgende handlinger.

Hvis du vil have adgang til de returnerede data i de trin, der følger efter denne handling, skal du bruge den variabel, der hedder Hent data for lagervarer, som er en liste over lagervarer. Du kan bruge denne variabel i både betingelser og handlinger. Du kan f.eks. sende listen over lagervarer i en Send intern mail-handling i stil med denne:

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

Bemærk

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

Udløsere

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

API-reference

Du kan finde flere oplysninger om den API, der bruges i denne handling, under forespørgslen Inventory items.