Hjelp
Logg på

Hent data om bedriftssted

I arbeidsflyter som bruker data om bedriftssteder, kan du bruke handlingen Hent data om bedriftssted til å hente informasjon om bedriftssteder fra butikken din.

På denne siden

Konfigurasjon

Felt

Handlingen Hent data om bedriftssted inneholder følgende felt, som brukes til å bygge søket:

Felt som brukes i Hent data-handlingene.
FeltBeskrivelse
Sorter data etterObligatorisk. Parameterne som dataene som returneres av søket sorteres etter.
Maksimalt antall resultaterObligatorisk. Det maksimale antallet resultater som kan returneres av søket du velger. Du kan returnere opptil 100 om gangen.
SøkObligatorisk. Velg fra vanlige søk eller velg Avansert for å lage ditt eget.

Søkestreng

Dette er et eksempelsøk for å hente bedriftssteder som ble oppdatert i løpet av 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 søk etter bedriftssteder, og kan brukes flere ganger eller kombineres med andre variabler. scheduledAt Liquid-variabelen er tilgjengelig i arbeidsflyter som bruker utløseren Planlagt tidspunkt. date_minus Liquid-taggen er en spesiell Flow-tagg som lar deg trekke tid fra en dato.

Når du søker etter data, er det nyttig å vite følgende:

  • Liste over tilgjengelige filtre for bedriftssteder
  • Søk må følge en bestemt syntaks
  • Verdier for søkefelt er ikke alltid dokumentert. I noen tilfeller kan du finne verdiene ved å se på API-dokumentasjonen. Alternativt kan du ofte finne feltverdiene i URL-adressene i administratorpanelet når du filtrerer. For å finne noen ordre-søkeverdier kan du for eksempel filtrere Ordre-siden i administratorpanelet og deretter sjekke URL-adressen.
  • Du kan kjøre eller teste et søk i butikken din ved å bruke Shopify GraphiQL-appen.
  • Vær oppmerksom på hva som skjer hvis søket mislykkes. API-et vil ofte 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 være du ønsker å bruke disse dataene på ulike måter:

  • Hvis du trenger å håndtere hvert listeelement individuelt, for eksempel for å legge til en tagg for hvert av dem, kan du bruke For hver-handlingen.
  • Hvis du trenger å aggregere data, for eksempel telle hvor mange resultater som ble returnert, kan du bruke handlingene Tell eller Summer.
  • Hvis du trenger å sende ut listen, 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 denne handlingen, kan du bruke variabelen kalt Hent data om bedriftssted, som er en liste over bedriftssteder. Du kan bruke denne variabelen i både betingelser og handlinger. Du kan for eksempel sende listen over steder i en Send intern e-post-handling, som dette:

{% for single_company in GetCompanyLocationData %}
* {{ 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, blir ingen data inkludert automatisk.

API-referanse