Hent produktinformasjon
I arbeidsflyter som bruker produktdata kan du bruke handlingen Hent produktinformasjon for å hente produktinformasjon fra butikken.
På denne siden
Konfigurasjon
Felter
Handlingen Hent produktdata inneholder følgende felter, som brukes til å sette sammen spørringen:
Felt | Beskrivelse |
---|---|
Sorter data etter | Påkrevd. Parameterne dataene som returneres av søket sorteres etter. |
Maksimalt antall resultater | Obligatorisk. Det maksimale antallet resultater som kan returneres av spørringen du velger. Du kan returnere opptil 100 av gangen. |
Spørring | Obligatorisk. Velg mellom vanlige spørringer, eller velg Avansert for å utforme din egen. |
Spørringsstreng
Dette er en eksempelspørring for å hente produkter som er oppdatert i løpet av det siste døgnet:
updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'
Variabelen updated_at
er et filter som er tilgjengelig for Produkter-spørringen, og som kan brukes flere ganger eller kombineres med andre variabler. Liquid-variabelen scheduledAt
er tilgjengelig i arbeidsflyter som har brukt utløseren Planlagt tid. Liquid-taggen date_minus
er en spesiell Flow-tagg som lar deg trekke fra tid fra en dato.
Når du henter data, er det nyttig å vite:
- En liste over tilgjengelige produktfiltre - Spørringer må følge en bestemt syntaks
- Spørringsfeltverdier er ikke alltid dokumentert. I noen tilfeller kan du finne verdiene ved å se i API-dokumentasjonen. Alternativt finner du ofte feltverdier i URL-adressene i administrator når du filtrerer. For å finne noen bestillingsspørringsverdier, kan du for eksempel filtrere Bestillinger-siden i administrator og kontrollere URL-adressen.
- Du kan kjøre eller teste en spørring i butikken ved å bruke Shopify GraphiQL-appen.
- Vær oppmerksom på hva som skjer hvis spørringen mislykkes. API-et returnerer ofte alle resultater (i stedet for ingen).
Returnerte data
Alle handlinger av typen Hent data returnerer en liste på mellom 0 og 100 ressurser. Avhengig av bruksområdet kan disse dataene brukes på ulike måter:
- Hvis du har behov for å håndtere hvert listeelement individuelt, som å legge til en tagg for hvert element, kan du bruke handlingen For each.
- Hvis du har behov for å aggregere data, som å telle hvor mange resultater som er returnert, kan du bruke handlingene Count eller Sum.
- Hvis du har behov for å returnere listen, som å sende en e-postmelding med alle elementer, kan du bruke returnerte data direkte i påfølgende handlinger.
For å bruke de returnerte dataene i trinn som etterfølger denne handlingen kan du bruke variabelen Hent produktdata, som er en liste over produkter. Du kan bruke denne variabelen i både betingelser og handlinger. Du kan for eksempel sende listen over bestillinger i handlingen Send en intern e-postmelding slik som dette:
{% for single_product in GetProductData %}
- {{ single_product.name }}
{% endfor %}
Utløsere
Du kan bruke denne handlingen i alle arbeidsflyter, inkludert utløseren Planlagt tid. I en arbeidsflyt som bruker utløseren Planlagt tid starter arbeidsflyten på et tidspunkt du bestemmer, og ikke som et resultat av en hendelse. Fordi det ikke er noen bestemt hendelse i butikken eller fra en app som starter arbeidsflyten, er ingen informasjon automatisk inkludert.
API-detaljer
Maler
Legg til produkter med en tagg i en samling i fremtiden
På et fremtidig tidspunkt kan du hente alle produkter med en bestemt tagg og deretter legge dem til i en samling. Vis mal
Slett inaktive produkter
Slett produkter uten lagerbeholdning som ikke er oppdatert på et år. Vis mal
Publiser produkter med en bestemt tagg i fremtiden
Hent produkter med en bestemt tagg og publiser dem på en fremtidig dato. Bruker utløseren for planlagt tid og handlingen Hent produktdata. Vis mal
Fjern taggen for nytt produkt 90 dager etter at produktet ble opprettet
Henter hver dag inntil 100 produkter som ble opprettet for mer enn 90 dager siden, og som fortsatt har taggen «ny». Arbeidsflyten fjerner deretter disse taggene for hvert produkt. Vis mal
Planlegg fjerning av produkter fra nettbutikken til angitt dato og klokkeslett
Fjern produkter fra nettbutikken etter tagg, ID eller SKU på en enkeltdato i fremtiden. Bruker utløseren Planlagt tid, handlingen Hent produktdata, For Each-løkke. Vis mal
Send et daglig e-postsammendrag med produkter som ikke er på lager
Henter hver dag alle produkter med 0 i lagerbeholdning og sender et e-postsammendrag. Bruker Hent produktdata og utløseren Planlagt tid. Vis mal
Send et e-postvarsel når varianter legges til med duplisert SKU
Når en ny variant legges til, kontrolleres det om andre varianter bruker samme SKU. Hvis dette er tilfelle, sendes en intern e-postmelding med koblinger til produktene og variantene som er påvirket. Vis mal
Spor produktvarianter som er på salg, med et produktmetafelt
Angir et metafelt på en produkt hvis minst én av variantene er på salg. Dette kan være nyttig for å spore hvilke produkter som er på salg. Vis mal