Gauti straipsnio duomenis

Darbo eigose, kurioms reikalingi tinklaraščio straipsnio duomenys, galite naudoti veiksmą Gauti straipsnio duomenis, kad gautumėte straipsnio informaciją iš savo „Shopify“ parduotuvės.

Pastaba

Tai yra Gauti duomenis tipo veiksmas. Norėdami suprasti, kaip naudoti šio tipo veiksmą su paleidikliu Suplanuotas laikas ir ciklais Kiekvienam, žr. Grafikai, duomenų gavimas ir ciklinės darbo eigos programėlėje „Shopify Flow“.

Konfigūracija

Laukai

Veiksmą Gauti straipsnio duomenis sudaro šie laukai:

Laukai, naudojami veiksmuose „Gauti duomenis“.

Laukas	Aprašymas
Rūšiuoti duomenis pagal	Būtina. Parametrai, pagal kuriuos rūšiuojami paieškos užklausos grąžinti duomenys.
Maksimalus rezultatų skaičius	Būtina. Maksimalus rezultatų, kuriuos gali grąžinti Jūsų pasirinkta paieškos užklausa, kiekis. Vienu metu galite gauti iki 100 rezultatų.
Užklausa	Būtina. Pasirinkite iš įprastų užklausų arba pasirinkite Išplėstinė, kad sukurtumėte savo.

Užklausos eilutė

Tai yra pavyzdinė užklausa norint gauti straipsnius, paskelbtus per pastarąją dieną:

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

Kintamasis published_at yra filtras, pasiekiamas straipsnių užklausoje, ir gali būti naudojamas kelis kartus arba derinamas su kitais kintamaisiais. „Liquid“ kintamasis scheduledAt pasiekiamas darbo eigose, kurios naudoja paleidiklį Suplanuotas laikas. „Liquid“ žyma date_minus yra speciali „Flow“ žyma, leidžianti iš datos atimti laiką.

Pateikiant užklausas duomenims gauti, naudinga žinoti:

• Pasiekiamų straipsnių filtrų sąrašas

• Užklausos turi atitikti tam tikrą sintaksę

• Užklausos laukų reikšmės ne visada yra dokumentuotos. Kai kuriais atvejais reikšmes galima rasti peržiūrėjus API dokumentaciją. Taip pat laukų reikšmes dažnai galite rasti administratoriaus skydelyje esančiuose URL adresuose, kai filtruojate. Pavyzdžiui, norėdami rasti užsakymo užklausos reikšmes, filtruokite puslapį Užsakymai administratoriaus skydelyje ir tada patikrinkite URL adresą.

• Savo parduotuvėje užklausą galite paleisti arba išbandyti naudodami programėlę „Shopify GraphiQL“.

• Turėkite omenyje, kas nutinka, jei Jūsų užklausa nepavyksta. Dažnai API grąžina visus rezultatus (užuot negrąžinusi nė vieno).

Grąžinti duomenys

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

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

Norėdami pasiekti grąžintus duomenis po šio veiksmo einančiuose veiksmuose, naudokite kintamąjį, pavadintą Gauti straipsnio duomenis, kuris yra straipsnių sąrašas. Šį kintamąjį galite naudoti tiek sąlygose, tiek veiksmuose. Pavyzdžiui, galite išsiųsti straipsnių sąrašą naudodami veiksmą Siųsti vidinį el. laišką panašiai į tai:

{% for single_article in GetArticleData %}
    * {{ single_article.title }}
    {% endfor %}

Pastaba

Jei veiksmas Gauti duomenis vienoje darbo eigoje naudojamas kelis kartus, prie kintamojo pavadinimo pridedamas skaičius. Pavyzdžiui, darbo eigoje, kurioje dukart naudojamas veiksmas Gauti užsakymo duomenis, pirmasis grąžintų duomenų kintamasis yra getOrderData, o antrasis – getOrderData1. Šio pavadinimo negalima tinkinti.

Paleidikliai

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

API nuoroda

Daugiau informacijos apie šiame veiksme naudojamą API rasite straipsnių užklausoje.