Hjelp
Logg på

Hent bedriftsdata

I arbeidsflyter som bruker bedriftsdata, kan du bruke Hent bedriftsdata-handlingen til å hente bedriftsinformasjon fra butikken din.

På denne siden

Konfigurasjon

Felter

Hent bedriftsdata-handlingen inneholder følgende felt, som brukes til å bygge spørringen:

Felt som brukes i Hent data-handlingene.
FeltBeskrivelse
Sorter data etterPåkrevd. Parametrene som dataene som returneres av søket skal sorteres etter.
Maksimalt antall resultaterPåkrevd. Det maksimale antallet resultater som kan returneres av søket du velger. Du kan returnere opptil 100 om gangen.
SpørringPå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 bedrifter 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 bedriftsspø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 bedriftsfiltre
  • 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 for å telle hvor mange resultater som ble returnert, kan du bruke handlingene Antall eller Sum.
  • Hvis du trenger å sende ut listen, for eksempel sende en e-post med alle varene, kan du bruke de returnerte dataene direkte i påfølgende handlinger.

For å få tilgang til returnerte data i steg som følger etter denne handlingen, bruker du variabelen med navnet Hent bedriftsdata, som er en liste over bedrifter. Du kan bruke denne variabelen i både betingelser og handlinger. Du kan for eksempel sende listen over bedrifter i handlingen Send intern e-post på denne måten:

{% for single_company in GetCompanyData %}
* {{ single_company.name }}
{% endfor %}

Utløsere

Du kan bruke denne handlingen i enhver arbeidsflyt, inkludert Planlagt tidspunkt-utløseren. I en arbeidsflyt som bruker Planlagt tidspunkt-utløseren, starter arbeidsflyten på et tidspunkt du har angitt, i stedet for som et resultat av en hendelse. Siden det ikke er noen spesifikk hendelse i butikken din eller fra en app som starter arbeidsflyten, inkluderes ingen data automatisk.

API-referanse