Gauti kolekcijos duomenis

Darbo eigose, kurioms reikalingi kolekcijos duomenys, galite naudoti veiksmą Gauti kolekcijos duomenis, kad nuskaitytumėte kolekcijos informaciją iš savo parduotuvės.

Konfigūracija

Laukai

Veiksme Gauti kolekcijos duomenis yra šie laukai.

Laukai, naudojami veiksmuose „Gauti duomenis“.
LaukasAprašas
Rūšiuoti duomenis pagalPrivaloma. Parametrai, pagal kuriuos rūšiuojami paieškos užklausos grąžinti duomenys.
Maksimalus rezultatų skaičiusPrivaloma. Maksimalus rezultatų, kuriuos gali grąžinti Jūsų pasirinkta paieškos užklausa, skaičius. Vienu metu galite grąžinti iki 100.
UžklausaBūtina. Rinkitės iš dažniausių užklausų arba pasirinkite Išplėstinė, kad sukurtumėte savo.

Užklausos eilutė

Tai yra pavyzdinė užklausa, kaip gauti kolekcijas, kurios buvo atnaujintos per pastarąją dieną:

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

Kintamasis updated_at yra filtras, pasiekiamas kolekcijų užklausoje, ir gali būti naudojamas kelis kartus arba derinamas su kitais kintamaisiais. „Liquid“ kintamasis scheduledAt yra pasiekiamas darbo eigose, kuriose naudojamas paleidiklis „Suplanuotas laikas“. „Liquid“ žyma date_minus yra speciali „Flow“ žyma, kuri leidžia atimti laiką iš datos.

Teikiant duomenų užklausą, naudinga žinoti:

  • Galimų kolekcijų filtrų sąrašas
  • Užklausos laukų reikšmės ne visada yra dokumentuotos. Kai kuriais atvejais reikšmes galima rasti peržiūrėjus API dokumentus. Arba laukų reikšmes dažnai galite rasti URL adresuose administratoriaus skydelyje, kai filtruojate. Pavyzdžiui, norėdami rasti kai kurias užsakymo užklausos reikšmes, filtruokite puslapį „Užsakymai“ administratoriaus skydelyje ir patikrinkite URL.
  • Savo parduotuvėje galite paleisti arba išbandyti užklausą naudodami „Shopify GraphiQL“ programėlę.
  • Atkreipkite dėmesį, kas nutinka, jei užklausa nepavyksta. Dažnai API grąžins visus rezultatus (o ne nė vieno).

Grąžinti duomenys

Visi veiksmai Gauti duomenis grąžina sąrašą nuo 0 iki 100 išteklių. Priklausomai nuo Jūsų naudojimo atvejo, šiuos duomenis galite norėti naudoti įvairiais būdais:

  • Jei reikia apdoroti kiekvieną sąrašo elementą atskirai, pavyzdžiui, pridėti kiekvienam žymą, galite naudoti veiksmą Kiekvienam.
  • Jei reikia apibendrinti duomenis, pavyzdžiui, suskaičiuoti, kiek rezultatų buvo grąžinta, galite naudoti veiksmus Skaičiuoti arba Sumuoti.
  • Jei Jums reikia panaudoti sąrašą, pavyzdžiui, išsiųsti el. laišką su visais daiktais, tuomet grąžintus duomenis galite tiesiogiai naudoti tolesniuose veiksmuose.

Norėdami pasiekti grąžintus duomenis veiksmuose, kurie seka po šio, naudokite kintamąjį pavadinimu Gauti kolekcijos duomenis, kuris yra kolekcijų sąrašas. Šį kintamąjį galite naudoti tiek sąlygose, tiek veiksmuose. Pavyzdžiui, galite nusiųsti kolekcijų sąrašą veiksmu Siųsti vidinį el. laišką, kaip parodyta čia:

{% for single_collection in GetCollectionData %}
* {{ single_collection.title }}
{% endfor %}

Paleidikliai

Šį veiksmą galite naudoti bet kurioje darbo eigoje, įskaitant paleidiklį Suplanuotas laikas. Darbo eigoje, kurioje naudojamas paleidiklis Suplanuotas laikas, darbo eiga prasideda Jūsų nurodytu laiku, o ne dėl įvykio. Kadangi Jūsų parduotuvėje ar programėlėje nėra konkretaus įvykio, kuris paleistų darbo eigą, jokie duomenys automatiškai neįtraukiami.

API nuoroda