Hent artikkeldata

I arbeidsflyter som krever data fra bloggartikler, kan du bruke handlingen Hent artikkeldata for å hente artikkelinformasjon fra Shopify-butikken.

Merk

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

Konfigurasjon

Felt

Handlingen Hent artikkeldata inneholder følgende felt:

Felt som brukes i Hent data-handlingene.

Felt	Beskrivelse
Sorter data etter	Obligatorisk. Parameterne som dataene som returneres av søket, blir sortert etter.
Maksimalt antall resultater	Obligatorisk. Det maksimale antallet 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 å opprette din egen.

Spørringsstreng

Her er en eksempelspørring for å hente artikler som er publisert i løpet av det siste døgnet:

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

Variabelen published_at er et filter som er tilgjengelig i artikkelspørringen, og den kan brukes flere ganger eller kombineres med andre variabler. Liquid-variabelen scheduledAt er tilgjengelig i arbeidsflyter som bruker utløseren Planlagt tidspunkt. Liquid-taggen date_minus er en spesiell Flow-tagg som lar deg trekke tid fra en dato.

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

• Liste over tilgjengelige artikkelfiltre

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

• Feltverdier for spørringer er ikke alltid dokumentert. I noen tilfeller finner du verdiene ved å se i API-dokumentasjonen. Alternativt kan du ofte finne feltverdiene i URL-adressene i administratorpanelet når du filtrerer. Hvis du for eksempel vil finne spørringsverdier for bestillinger, kan du filtrere Ordre-siden i administratorpanelet, og deretter sjekke URL-adressen.

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

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

Returnerte data

Alle Hent data-handlinger returnerer en liste på alt fra 0 til 100 ressurser. Avhengig av bruksområdet, vil du kanskje bruke disse dataene på ulike måter:

• Hvis du må håndtere hvert enkelt element i listen individuelt, for eksempel for å legge til en tagg for hver av dem, kan du bruke handlingen For hver.
• Hvis du trenger å samle opp data, for eksempel for å telle hvor mange resultater som ble returnert, kan du bruke handlingen Tell eller Sum.
• Hvis du trenger å skrive ut listen, for eksempel for å 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 trinnene som følger denne handlingen, bruker du variabelen med navnet Hent artikkeldata, som er en liste over artikler. Du kan bruke denne variabelen i både betingelser og handlinger. For eksempel kan du sende listen over artikler i handlingen Send intern e-post slik som dette:

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

Merk

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

Utløsere

Du kan bruke denne handlingen i enhver arbeidsflyt, inkludert med 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 er en spesifikk hendelse i butikken eller fra en app som starter arbeidsflyten, blir det ikke automatisk inkludert noen data.

API-referanse

For mer informasjon om API-et som brukes i denne handlingen, se artikkelspørringen.