Gauti dovanų kortelės duomenis

Darbo eigose, kurioms reikalingi dovanų kortelės duomenys, galite naudoti veiksmą Gauti dovanų kortelės duomenis, kad gautumėte dovanų kortelės informaciją iš savo parduotuvės.

Svarbu tai, kad Jūsų parduotuvėje yra ir dovanų kortelių produktai, kurie naudojami dovanų kortelėms generuoti, ir pačios dovanų kortelės, kurias klientai gali naudoti pirkdami. Veiksmas Gauti dovanų kortelės duomenis nuskaito informaciją apie pačias dovanų korteles. Norėdami gauti informacijos apie dovanų kortelių produktus, naudokite veiksmus Gauti produkto duomenis arba Gauti produkto varianto duomenis.

Šiame puslapyje

Konfigūracija

Laukai

Veiksme Gauti dovanų kortelės duomenis yra šie laukai, kurie naudojami užklausai sukurti:

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

Užklausos eilutė

Toliau pateikiamas pavyzdys užklausos, kaip gauti dovanų korteles, kurios buvo atnaujintos per pastarąją dieną:

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

Kintamasis created_at yra filtras, pasiekiamas dovanų kortelių 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, leidžianti atimti laiką iš datos.

Kai teikiate duomenų užklausas, naudinga žinoti:

Galimų dovanų kortelių filtrų sąrašas
Užklausos turi atitikti tam tikrą sintaksę
Užklausos laukų reikšmės ne visada būna dokumentuotos. Kai kuriais atvejais reikšmes galima rasti peržiūrėjus API dokumentus. Taip pat laukų reikšmes dažnai galite rasti administravimo priemonės URL adresuose, kai filtruojate. Pavyzdžiui, norėdami rasti kai kurias užsakymo užklausos reikšmes, administravimo priemonėje filtruokite puslapį „Užsakymai“ ir patikrinkite URL.
Galite paleisti arba išbandyti užklausą savo parduotuvėje, naudodami „Shopify GraphiQL“ programėlę.
Turėkite omenyje, kas nutiks, jei jūsų užklausa nepavyks. Dažnai API grąžins visus rezultatus (o ne 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 naudoti įvairiais būdais:

Jei kiekvieną sąrašo elementą reikia apdoroti atskirai, pavyzdžiui, prie kiekvieno 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 reikia pateikti sąrašą, pavyzdžiui, išsiųsti el. laišką su visais elementais, grąžintus duomenis galite naudoti tiesiogiai vėlesniuose veiksmuose.

Norėdami pasiekti grąžintus duomenis po šio veiksmo atliekamuose etapuose, naudokite kintamąjį Gauti dovanų kortelių duomenis, kuris yra dovanų kortelių sąrašas. Šį kintamąjį galite naudoti ir sąlygose, ir veiksmuose. Pavyzdžiui, dovanų kortelių sąrašą galite nusiųsti atlikdami veiksmą Siųsti vidinį el. laišką, kaip nurodyta toliau:

{% for single_gift_card in GetGiftCardData %}
* {{ single_gift_card.name }}
{% 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 nėra konkretaus įvykio Jūsų parduotuvėje ar programėlėje, kuris paleistų darbo eigą, jokie duomenys automatiškai neįtraukiami.