Gauti puslapio duomenis

Darbo eigose, kurioms reikia puslapio duomenų, galite naudoti veiksmą Gauti puslapio duomenis, kad gautumėte puslapio informaciją iš savo parduotuvės. Puslapiai – tai jūsų internetinės parduotuvės tinklalapiai, kuriuose yra retai besikeičiančios informacijos, pavyzdžiui, puslapis „Apie mus“ ar „Kontaktai“.

Pastaba

Tai yra veiksmo Gauti duomenis tipas. Norėdami suprasti, kaip naudoti šio tipo veiksmą su paleidikliu Suplanuotas laikas ir ciklais Kiekvienam, žr. Tvarkaraščiai, duomenų gavimas ir darbo eigų ciklai „Shopify Flow“.

Konfigūracija

Laukai

Veiksmas Gauti puslapio duomenis turi šiuos laukus:

Laukai, naudojami veiksmuose „Gauti duomenis“.

Laukas	Aprašymas
Rūšiuoti duomenis pagal	Būtinas. Parametrai, pagal kuriuos rūšiuojami paieškos užklausos grąžinti duomenys.
Maksimalus rezultatų skaičius	Būtinas. Maksimalus rezultatų, kuriuos gali grąžinti jūsų pasirinkta paieškos užklausa, skaičius. Vienu metu galima grąžinti iki 100.
Užklausa	Būtinas. Pasirinkite iš įprastų užklausų arba spustelėkite Išplėstinė (Advanced), kad sukurtumėte savo.

Užklausos eilutė

Tai paskelbtų puslapių gavimo užklausos pavyzdys:

published_status:published

Kintamasis published_status yra filtras, pasiekiamas Puslapių užklausoje, jį galima naudoti kelis kartus arba derinti su kitais kintamaisiais.

Teikiant duomenų užklausą naudinga žinoti:

• Galimų puslapio filtrų sąrašas

• Užklausos turi atitikti tam tikrą sintaksę

• Užklausų 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 administravimo priemonės URL adresuose, kai filtruojate. Pavyzdžiui, norėdami rasti kai kurias užsakymų užklausų reikšmes, filtruokite puslapį „Užsakymai“ administravimo priemonėje ir tada patikrinkite URL adresą.

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

• Turėkite omenyje, kas nutinka, jei 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 sąrašą, kuriame yra nuo 0 iki 100 išteklių. Priklausomai nuo naudojimo atvejo, šiuos duomenis galite naudoti įvairiais būdais:

• Jei reikia apdoroti kiekvieną sąrašo elementą atskirai, pavyzdžiui, pridėti po ž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 norite 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 tolesniuose šio veiksmo žingsniuose, naudokite kintamąjį pavadinimu Get page data (Gauti puslapio duomenis), kuris yra puslapių sąrašas. Šį kintamąjį galite naudoti ir sąlygose, ir veiksmuose. Pavyzdžiui, puslapių sąrašą galite siųsti veiksme Send internal email (Siųsti vidinį el. laišką) panašiai į tai:

{% for single_page in getPageData %}
  * {{ single_page.title }} - {{ single_page.handle }}
{% endfor %}

Pastaba

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

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 įvykus įvykiui. Kadangi nėra konkretaus įvykio jūsų parduotuvėje ar programėlėje, kuris paleistų darbo eigą, jokie duomenys nėra įtraukiami automatiškai.

API žinynas

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