Gauti katalogo duomenis

Darbo eigose, kurioms reikalingi katalogo duomenys, galite naudoti veiksmą Gauti katalogo duomenis, kad atgautumėte B2B katalogo informaciją iš savo parduotuvės. Katalogai – tai produktų grupės, kuriose taikoma pritaikyta kainodara konkretiems verslo klientams (B2B) ar įmonės padaliniams.

Pastaba

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

Konfigūracija

Laukai

Veiksmas Gauti katalogo 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ūtina. Didžiausias rezultatų, kuriuos gali grąžinti Jūsų pasirinkta paieškos užklausa, skaičius. Vienu metu galima 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, skirta gauti visus aktyvius katalogus:

status:ACTIVE

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

Teikiant duomenų užklausas naudinga žinoti:

• Galimų katalogų filtrų sąrašas

• Užklausos turi atitikti tam tikrą sintaksę

• Užklausų laukų reikšmės ne visada dokumentuojamos. Kai kuriais atvejais reikšmes galima rasti peržiūrėjus API dokumentaciją. Be to, dažnai laukų reikšmes galite rasti administratoriaus skydelio URL adresuose, kai naudojate filtrus. Pavyzdžiui, norėdami rasti užsakymų užklausos reikšmes, administratoriaus skydelyje išfiltruokite puslapį Užsakymai ir patikrinkite URL.

• Savo parduotuvėje užklausą galite paleisti arba išbandyti naudodami Shopify GraphiQL app.

• Turėkite omenyje, kas nutinka nepavykus užklausai. Dažnai API pateiks visus rezultatus (o ne nė vieno).

Grąžinami duomenys

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

• Jei reikia apdoroti kiekvieną sąrašo elementą atskirai, pavyzdžiui, kiekvienam pridėti ž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 išvesti sąrašą, pavyzdžiui, išsiųsti el. laišką su visais elementais, grąžinamus duomenis galite naudoti tiesiogiai tolesniuose veiksmuose.

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

{% for single_catalog in getCatalogData %}
  * {{ single_catalog.title }}
{% 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 su paleidikliu Suplanuotas laikas. Darbo eigoje, naudojančioje paleidiklį Suplanuotas laikas, darbo eiga prasideda Jūsų nurodytu laiku, o ne kaip įvykio rezultatas. Kadangi Jūsų parduotuvėje arba programėlėje nėra konkretaus įvykio, kuris paleistų darbo eigą, jokie duomenys nėra įtraukiami automatiškai.

API žinynas

Daugiau informacijos apie šiame veiksme naudojamą API rasite skiltyje Katalogų užklausa.