Gauti metaobjekto įrašus
Galite naudoti veiksmą Gauti metaobjekto įrašus, kad gautumėte metaobjekto įrašų sąrašą iš Jūsų parduotuvės pagal pasirenkamąją užklausą. Daugiau informacijos rasite metaobjektų dokumentacijoje.
Konfigūracija
Laukai
Veiksmas Gauti metaobjekto įrašus apima išskleidžiamąjį meniu, skirtą metaobjekto apibrėžimui nurodyti, taip pat šiuos laukus, kurie naudojami užklausai sukurti:
| Laukas | Aprašas |
|---|---|
| Rikiuoti duomenis pagal | Būtina. Parametrai, pagal kuriuos rikiuojami 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, skaičius. Vienu metu galite grąžinti iki 100. |
| Užklausa | Privaloma. Pasirinkite iš įprastų užklausų arba pasirinkite Išplėstinis, kad sukurtumėte savo. |
Užklausos eilutė
Štai pavyzdinė užklausa, kaip gauti metaobjektų įrašus, kai lauko email vertė sutampa su užsakyme nurodytu el. pašto adresu:
{{fields.email}}:"{{order.email}}"Štai pavyzdinė užklausa, kaip gauti metaobjektų įrašus, kurie buvo atnaujinti per pastarąją dieną:
updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'Kintamasis updated_at yra filtras, pasiekiamas metaobjektų užklausoje, ir gali būti naudojamas kelis kartus arba derinamas su kitais kintamaisiais. „Liquid“ kintamasis scheduledAt pasiekiamas darbo eigose, kuriose naudojamas suplanuoto laiko paleidiklis. „Liquid“ date_minus žyma yra speciali „Flow“ žyma, leidžianti iš datos atimti laiką.
Teikiant duomenų užklausas, naudinga žinoti:
- Galimų metaobjektų filtrų sąrašas
- Norint teikti užklausas metaobjektams pagal lauko vertę, metaobjektui turi būti įjungtas filtravimas, kurį galima įjungti „Shopify“ administratoriaus skydelio pasirinktinių duomenų parinktyse.
- Užklausos turi atitikti tam tikrą sintaksę
- Užklausų laukų vertės ne visada yra dokumentuotos. Kai kuriais atvejais vertes galima rasti peržiūrint API dokumentus. Arba laukų vertes dažnai galite rasti administratoriaus skydelio URL, kai filtruojate. Pavyzdžiui, norėdami rasti kai kurias užsakymo užklausos vertes, filtruokite puslapį „Užsakymai“ administratoriaus skydelyje, tada patikrinkite URL.
- Galite paleisti arba išbandyti užklausą savo parduotuvėje naudodami „Shopify GraphiQL“ programėlę.
- Atkreipkite dėmesį, kas nutinka, jei Jūsų 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šą, kuriame yra nuo 0 iki 100 išteklių. Priklausomai nuo Jūsų naudojimo atvejo, šiuos duomenis galite 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 viso sąrašo, pavyzdžiui, norint išsiųsti el. laišką su visais daiktais, tuomet grąžintus duomenis galite tiesiogiai naudoti vėlesniuose veiksmuose.
Norėdami pasiekti grąžintus duomenis veiksmuose, kurie seka po šio veiksmo, naudokite kintamąjį, pavadintą Gauti metaobjektų įrašus, kuris yra metaobjektų įrašų sąrašas. Šį kintamąjį galite naudoti tiek sąlygose, tiek veiksmuose. Pavyzdžiui, galite išsiųsti metaobjektų įrašų rakto ir vertės porų sąrašą veiksme Siųsti vidinį el. laišką, kaip parodyta toliau:
{% for getMetaobjectEntries_item in getMetaobjectEntries %}
Key-value pairs for entry:
{% for fields_item in getMetaobjectEntries_item.system.fields %}
{{fields_item.key}}:{{fields_item.value}}
{% endfor %}
{% endfor %}Paleidikliai
Šį veiksmą galite naudoti bet kurioje darbo eigoje, įskaitant paleidiklį Suplanuotas laikas. Darbo eigoje, kurioje naudojamas paleidiklis Suplanuotas laikas, darbo eiga pradedama Jūsų nurodytu laiku, o ne dėl įvykio. Kadangi darbo eigos nepradeda joks konkretus įvykis Jūsų parduotuvėje ar programėlėje, jokie duomenys nėra automatiškai įtraukiami.