Hent samlingsdata

I arbeidsflyter som krever samlingsdata, kan du bruke handlingen Hent samlingsdata for å hente samlingsinformasjon fra butikken din.

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, henting av data og arbeidsflyter med løkker i Shopify Flow.

Konfigurasjon

Felt

Handlingen Hent samlingsdata inneholder følgende felt.

Felt som brukes i Hent data-handlinger.

Felt	Beskrivelse
Sorter data etter	Obligatorisk. Parameterne dataene som returneres 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	Påkrevd. Velg fra vanlige spørringer eller velg Avansert for å opprette din egen.

Spørringsstreng

Dette er et eksempel på en spørring for å hente samlinger som ble oppdatert det siste døgnet:

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

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

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

• Liste over tilgjengelige samlingsfiltre
  • Spørringer må følge en bestemt syntaks
• Feltverdier for spørringer er ikke alltid dokumentert. I noen tilfeller kan du finne verdiene ved å se i API-dokumentasjonen. Alternativt kan du ofte finne feltverdiene i URL-adressene i administratorpanelet når du filtrerer. For å finne noen spørringsverdier for bestillinger kan du for eksempel filtrere Ordre-siden i administratorpanelet og deretter sjekke URL-adressen.
• Du kan kjøre eller teste en spørring i butikken din ved hjelp av Shopify GraphiQL-appen.
• 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 med mellom 0 og 100 ressurser. Avhengig av bruksområdet ditt kan det hende du vil bruke disse dataene på ulike måter:

• Hvis du trenger å håndtere hvert listeelement individuelt, for eksempel for å legge til en tagg for hver, kan du bruke For hver-handlingen.
• Hvis du trenger å aggregere data, for eksempel telle hvor mange resultater som ble returnert, kan du bruke Tell- eller Summer-handlingene.
• Hvis du trenger å sende listen som utdata, for eksempel sende en e-post med alle varene, kan du bruke returnerte data direkte i påfølgende handlinger.

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

{% for single_collection in GetCollectionData %}
* {{ single_collection.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 Hent bestillingsdata-handlingen 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 Planlagt tid-utløseren. I en arbeidsflyt som bruker Planlagt tid-utløseren, starter arbeidsflyten på et tidspunkt du har angitt, i stedet for som et resultat av en hendelse. Siden det ikke er noen bestemt hendelse i butikken din eller fra en app som starter arbeidsflyten, inkluderes ingen data automatisk.

API-referanse

• Samlingsressurs
• Spørringsfiltre for samlinger