Hent salgsplangruppedata

I arbeidsflyter som krever data om salgsplangrupper, kan du bruke handlingen Hent salgsplangruppedata til å hente bestillingsinformasjon fra butikken din.

Konfigurasjon

Felt

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

Felt som brukes i Hent data-handlinger.
FeltBeskrivelse
Sorter data etterObligatorisk. Parametrene dataene som returneres av søket skal 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 mellom vanlige søk eller velg Avansert for å lage ditt eget.

Søkestreng

Dette er et eksempel på et søk for å hente salgsplangrupper som ble oppdatert i løpet av det siste døgnet:

name='Subscribe & Save'

Variabelen category er et filter som er tilgjengelig for søk i salgsplangruppe og kan brukes til å velge bestemte kategorier av salgsplangrupper.

Når du søker etter data, kan det være nyttig å vite om:

  • Liste over tilgjengelige filtre for salgsplangrupper
  • Søk må følge en bestemt syntaks
  • Verdiene 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 søkeverdier for bestillinger 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. Ofte vil API-et returnere alle resultatene (i stedet for ingen).

Returnerte data

Alle Hent data-handlinger returnerer en liste med alt fra 0 til 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 element i listen 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 for å telle hvor mange resultater som ble returnert, kan du bruke handlingene Tell eller Summer.
  • Hvis du trenger å sende listen, for eksempel i 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 trinn som følger etter denne handlingen, bruker du variabelen med navnet Hent salgsplangruppedata, som er en liste over salgsplangrupper. Du kan bruke denne variabelen i både betingelser og handlinger. Du kan for eksempel sende listen over salgsplangrupper i en Send intern e-post-handling slik som dette:

{% for getSellingPlanGroupData_item in getSellingPlanGroupData %}
  {{getSellingPlanGroupData_item.name}}
{% endfor %}

Eksempel

En arbeidsflyt er for eksempel planlagt til å kjøre hver søndag kl. 09.00. Handlingen Hent salgsplangruppedata brukes til å samle inn data for salgsplangrupper som er opprettet den siste uken. Hvis produktene som er knyttet til salgsplangruppene er bestselgerne dine, kan posisjonen til salgsplangruppen økes.

API-referanse