„Shopify Flow“ naudojamų API duomenų peržiūra
Dauguma darbo eigų pasiekia duomenis iš Jūsų parduotuvės, kad galėtumėte juos naudoti sąlygose ir veiksmuose. „Shopify Flow“ pasiekia parduotuvės duomenis kreipdamasi į GraphQL Admin API ir taip suteikia Jums prieigą prie beveik visų API laukų.
Kurdami darbo eigą, dažnai susidursite su laukų pavadinimais ir aprašais, pagrįstais API, tačiau Jums gali prireikti žinoti tų duomenų vertes. Pavyzdžiui, galbūt norėsite sužinoti programėlės, kurioje buvo sukurtas užsakymas iš juodraštinio užsakymo, pavadinimą. Be to, galbūt norėsite įsitikinti, kad Jūsų darbo eiga pateikia duomenis, kurių tikitės, arba tokia forma, kokios tikitės.
Norėdami peržiūrėti duomenų vertes, „Shopify Flow“ suteikia kelias parinktis.
Šiame puslapyje
Lauko radimas „Shopify“ administratoriaus skydelyje
Daugeliu atvejų duomenis galite rasti „Shopify“ administratoriaus skydelyje. Pavyzdžiui, product.title yra nurodytas puslapyje „Produktas“.
Gauti pavyzdinius duomenis
Kurdami darbo eigą, pavyzdinių duomenų galite gauti tiesiogiai „Flow“ redagavimo priemonėje. Kadangi „Flow“ duomenys gaunami iš įvykių, norėdami gauti tikslius pavyzdinius duomenis, pirmiausia turite pasirinkti atitinkamą įvykį:
- „Flow“ redagavimo priemonėje atverkite veiksmą, kuriame norite naudoti duomenis, ir spustelėkite „Pridėti kintamąjį“. Arba sąlygoje spustelėkite „Pridėti kriterijų“.
- Spustelėkite „Konfigūruoti pavyzdinius duomenis“.
- „Flow“ rodo ankstesnius įvykius pagal darbo eigos paleidiklį. Spustelėkite „Atnaujinti įvykius“, kad gautumėte įvykius iš naujausių paleidimų, arba spustelėkite „Pradėti stebėti tiesioginius įvykius“ ir tada rankiniu būdu paleiskite įvykį administratoriaus skydelyje arba atitinkamoje programėlėje (paleidikliams pagal programėlę).
- Įvykus įvykiui, „Flow“ parodys išsamią informaciją apie jį. Pasirinkite įvykį, kurį norite naudoti pavyzdiniams duomenims gauti. Spustelėkite „Naudoti šį paleidiklio įvykį“.
- Dabar, kai naršote įvykius, kiekvienam kintamajam turėtų būti rodomi pavyzdiniai duomenys.
Apribojimai:
- Dėl vietos apribojimų, sąraše esantiems duomenims „Flow“ rodys tik pirmojo sąrašo elemento duomenis.
- „Flow“ vienu metu saugos iki 5 įvykių vienai darbo eigai.
- „Flow“ negali gauti įvykių iš naujausių paleidimų kai kuriems paleidikliams, pvz., „Suplanuotas laikas“, „Sukurtas metaobjekto įrašas“, „Klientas prisijungė prie segmento“ arba „Klientas paliko segmentą“.
Lauko naudojimas veikiančioje darbo eigoje
Galite saugiai naudoti laukus darbo eigoje, pasinaudodami veiksmu „Registruoti išvestį“. Paleidus darbo eigą, veiksmas „Registruoti išvestį“ išspausdins bet kokių kintamųjų ir teksto išvestį puslapyje „Paleidimų istorija“. Taip pat galite naudoti pranešimų veiksmus, pvz., „Siųsti vidinį el. laišką“.
„Registruoti išvestį“ naudojimo veiksmai:
- Pasirinkite paleidiklį, kurį galima paleisti rankiniu būdu.
- Pridėkite veiksmą „Registruoti išvestį“ prie darbo eigos ir prijunkite jį prie paleidiklio.
- „Registruoti išvestį“ konfigūracijoje spustelėkite „Pridėti kintamąjį“, kad norimus patikrinti kintamuosius pridėtumėte į skiltį „Išvestis“.
- Baigę spustelėkite „Įjungti darbo eigą“.
- Paleiskite darbo eigą, paleisdami ją rankiniu būdu arba suaktyvindami paleidiklį. Pavyzdžiui, jei naudojate paleidiklį „Sukurtas užsakymas“, sukurkite bandomąjį užsakymą.
- Kai darbo eiga bus paleista, patikrinkite kintamuosius veiklos žurnale.
Resurso JSON puslapio naudojimas
Dauguma „Shopify“ administratoriaus skydelio resursų puslapių, pvz., „Užsakymas“, „Produktas“ arba „Klientas“, leidžia peržiūrėti duomenis, kuriuos naudoja puslapis. Šių duomenų pavadinimai ir formatas nėra visiškai tokie patys, kokius naudoja „Shopify Flow“, tačiau vertės atitinka esančias „GraphQL Admin API“. Norėdami peržiūrėti duomenis, prie URL pridėkite .json.
Pavyzdžiui, eikite į užsakymą atidarę „Shopify“ administratoriaus skydelio puslapį „Užsakymai“ ir spustelėję užsakymą. Naršyklės adreso juostoje esantį puslapio adresą pakeiskite iš:
https://https://admin.shopify.com/store/<shopname>/orders/3804849891234
Į šį:
https://https://admin.shopify.com/store/<shopname>/orders/3804849891234.json
„GraphiQL“ arba trečiosios šalies API įrankio naudojimas
Galite tiesiogiai pateikti užklausą API naudodami trečiosios šalies API įrankį, pvz., „Postman“, arba nemokamą „Shopify“ teikiamą įrankį „GraphiQL“. Ši parinktis pateikia tiksliausius rezultatus, tačiau tam reikia šiek tiek išmanyti, kaip kurti „GraphQL“ užklausas.
Kalbant apie „GraphiQL“, „Shopify“ siūlo tiek žiniatinklio „GraphiQL“ naršyklę su bendriniais duomenimis, tiek „GraphiQL“ programėlę. Su „GraphiQL“ galite sukurti „GraphQL“ užklausą, kuri tiksliai atitinka laukų pavadinimus „Shopify Flow“. Naudojant programėlę, vertės taip pat tiksliai atitiks Jūsų parduotuvės duomenis.
Naudodami šį įrankį, galite tiksliai nustatyti, kokius duomenis naudoja „Shopify Flow“, kartu su realiais Jūsų parduotuvės duomenimis. Pavyzdžiui, sukuriate šią užklausą:
{
orders(first:5, reverse:true) {
nodes {
createdAt
app {
name
}
channelInformation {
app {
title
}
}
}
}
}Toliau pateiktuose rezultatuose kintamasis order / app / name rodo užsakymo programėlės pavadinimą. Šiuo atveju užsakymas buvo sukurtas iš juodraštinių užsakymų programėlės, todėl vertė yra „Juodraštiniai užsakymai“. Kanalo informacija pasiekiama tik programėlėje „Point of Sale“.
{
"data": {
"orders": {
"nodes": [
{
"createdAt": "2023-04-10T12:32:41Z",
"app": {
"name": "Draft Orders"
},
"channelInformation": null
},
{
"createdAt": "2023-04-10T12:29:12Z",
"app": {
"name": "Draft Orders"
},
"channelInformation": null
},
{
"createdAt": "2023-03-17T20:23:10Z",
"app": {
"name": "Draft Orders"
},
"channelInformation": null
},
{
"createdAt": "2023-03-17T20:20:53Z",
"app": {
"name": "Draft Orders"
},
"channelInformation": null
},
{
"createdAt": "2023-03-17T15:45:15Z",
"app": {
"name": "Point of Sale"
},
"channelInformation": {
"app": {
"title": "Point of Sale"
}
}
}
]
}
}