Hent artikeldata

I workflows, der kræver data fra en blogartikel, kan du bruge handlingen Hent artikeldata til at hente artikeloplysninger fra din Shopify-butik.

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 each-løkker, i Tidsplaner, hentning af data og looping af workflows i Shopify Flow.

Konfiguration

Felter

Handlingen Hent artikeldata indeholder følgende felter:

Felter, der bruges i Hent data-handlingerne.

Felt	Beskrivelse
Sortér data efter	Påkrævet. De parametre, som data, der returneres af søgeforespørgslen, sorteres efter.
Maksimalt antal resultater	Påkrævet. Det maksimale antal resultater, der kan returneres af den valgte søgeforespørgsel. Du kan få returneret op til 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

Her er et eksempel på en forespørgsel til at hente artikler, der er udgivet inden for det seneste døgn:

published_at:<='{{ scheduledAt }}' AND published_at:>'{{ scheduledAt | date_minus: "1 day" }}'

Variablen published_at er et filter, der er tilgængeligt for artikelforespørgslen, og den kan bruges flere gange eller kombineres med andre variabler. Liquid-variablen scheduledAt er tilgængelig i workflows, der bruger udløseren Planlagt tidspunkt. Liquid-tagget date_minus er et særligt Flow-tag, der giver dig mulighed for at trække tid fra en dato.

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

• Liste over tilgængelige artikelfiltre

• Forespørgsler skal følge en bestemt syntaks

• Forespørgselsfeltværdier er ikke altid dokumenteret. I nogle tilfælde kan værdierne findes i API-dokumentationen. Alternativt kan du ofte finde feltværdierne i webadresserne i administratoren, når du filtrerer. Hvis du f.eks. vil finde nogle forespørgselsværdier for ordrer, skal du filtrere siden Ordrer i administratoren 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. API'et vil ofte returnere alle resultater (i stedet for ingen).

Returnerede data

Alle Hent data-handlinger returnerer en liste over alt fra 0 til 100 ressourcer. Afhængigt af dit behov vil du måske bruge disse data på forskellige måder:

• Hvis du har brug for at håndtere hvert listeelement individuelt, f.eks. for at tilføje et tag til hvert af dem, kan du bruge handlingen For each.
• Hvis du har brug for at aggregere data, f.eks. for at tælle, hvor mange resultater der blev returneret, kan du bruge handlingerne Count eller Sum.
• Hvis du skal bruge listen som output, f.eks. for at sende en mail med alle elementerne, kan du bruge de returnerede data direkte i efterfølgende handlinger.

For at få adgang til de returnerede data i trin, der følger efter denne handling, skal du bruge variablen Hent artikeldata, som er en liste over artikler. Du kan bruge denne variabel i både betingelser og handlinger. Du kan f.eks. sende listen over artikler i en Send intern mail-handling på denne måde:

{% for single_article in GetArticleData %}
    * {{ single_article.title }}
    {% endfor %}

Bemærk

Hvis en Hent data-handling bruges flere gange i et enkelt workflow, føjes der et tal til variabelnavnet. I f.eks. et workflow, der 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 et hvilket som helst workflow, 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. Da der ikke er en 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 artikelforespørgslen.