A feltételek megértése a Shopify Flow-ban

A feltétel egy lépés a munkafolyamatban, ahol döntés születik a továbblépésről annak alapján, hogy egy kritériumrendszer teljesült-e. Minden feltétellépésnek két kimenetele lehet: Igaz, ha a kritériumok teljesültek, és Hamis, ha nem. Ha egyik lehetőséghez sem határozol meg következő lépést egy másik feltétel vagy művelet kiválasztásával, akkor a munkafolyamat futtatása leáll.

Például, ha a munkafolyamat egy rendelés létrehozásakor aktiválódik, akkor egy feltétel ellenőrizheti, hogy egy adott AFFILIATE10 kedvezménykódot használtak-e a rendelésnél. Ha igen, akkor az Igaz lehetőség egy olyan művelethez vezethet, amely e-mailt küld a partnernek, tájékoztatva őt, hogy a kódját felhasználták. Ha nem, akkor a Hamis lehetőség üresen maradhat, jelezve, hogy semmi további nem történik, és a munkafolyamat futtatása véget ér.

Egy munkafolyamat a bonyolultságától függően tetszőleges számú feltételt tartalmazhat. A feltételek más feltételekhez vagy műveletekhez is kapcsolódhatnak, attól függően, hogy mit szeretnél, hogy a munkafolyamat tegyen. A feltételeket be lehet állítani szekvenciális kapcsolatra (például ha az A feltétel igaz, akkor ellenőrizd a B feltételt; ha az A hamis, akkor ellenőrizd a C-t), vagy beállíthatod őket úgy, hogy egyidejűleg, ugyanazon lépés részeként fussanak le (például ellenőrizd, hogy A, B vagy C igaz-e).

Feltételek létrehozása a munkafolyamathoz

A kiváltókkal és a műveletekkel ellentétben, amelyeket a Shopify Flow-ban egy előre beállított listából választhatsz ki, a feltételeket az alapoktól kell létrehozni változók, logikai operátorok és értékek kiválasztásával a feltételes utasítás megalkotásához:

• A változó egy helyőrző, amely meghatározza az adatokat, amelyeket a feltétel használ. Például, ha egy feltétel egy adott kedvezménykódot szeretne ellenőrizni egy rendelésnél, akkor a változó az order.discountCode lenne. A változók GraphQL Admin API pontjelölést használnak.
• Az logikai operátor azt jelzi, hogy a munkafolyamatnak hogyan kell meghatároznia, hogy a feltétel teljesül-e. A logikai operátorok alkalmazhatók változószinten, vagy ha több változó szerepel a teljes feltételkritérium részeként:
  • A változószintű opciók közé tartoznak a mezőszintű operátorok, mint például a Nagyobb mint vagy a Ezzel kezdődik, illetve a listaszintű operátorok, mint a Legalább az egyike vagy a Mindegyike.
  • A feltételszintű opciók közé tartozik az ÉS, ami azt jelenti, hogy az összes változónak igaznak kell lennie ahhoz, hogy a feltétel összességében igaznak minősüljön, vagy a VAGY, ami azt jelenti, hogy legalább egy változónak igaznak kell lennie ahhoz, hogy a feltétel összességében igaznak minősüljön.
• Az érték a tényleges információ, amelyet a változó keres. Például, ha a munkafolyamat által ellenőrizendő konkrét order.discountCode a(z) AFFILIATE10, akkor ezt az értéket kell a feltétel részeként megadni.

Ahogy kiválasztod a változókat és az operátorokat, a Shopify Flow vásznán lévő feltétellépés frissül, hogy közérthető nyelven tükrözze a feltételes utasítást, így ellenőrizheted, hogy a létrehozott feltétel helyesen van-e formázva. Az Leírás hozzáadása gombra kattintva felülírhatod az alapértelmezett feltételes utasítást a saját írásos leírásoddal.

Tudj meg többet a Shopify Flow feltételeinek elemeiről.

A változók ismertetése a feltételekben

Amikor egy feltétellépést hozol létre egy munkafolyamatban, az első lépés, amire a rendszer felszólít, a Változó hozzáadása. De mi is az a változó?

A Shopify Flow-ban a változó egy helyőrző, amely a munkafolyamatban a feltétel által használt adatokat jelöli. Amikor egy feltétel így szól: „Ha A nagyobb, mint 10…”, akkor az A rész a változó. A feltételhez tartozó változó kiválasztása lényegében azt jelenti, hogy megmondod a feltételnek, hogy pontosan milyen adatokat értékeljen ki.

A változók a GraphQL Admin API pontjelölését használják. Nem kell jártasnak lenned az API-ban ahhoz, hogy munkafolyamatokat hozz létre a Flow alkalmazással, de a változónevek és definícióik alapvető ismerete segíthet a kívánt munkafolyamat-logika felépítésében.

Ahhoz, hogy megértsd, milyen adatokat képvisel egy változó, vedd figyelembe a következő információkat a változókról:

• Hogyan kell olvasni a változók pontjelölését.
• A változókra vonatkozó adatkövetelmények ismertetése.
• A megfelelő változó megkeresése a keresés során.

Tipp: Kérj segítséget a változókkal kapcsolatban a Dev Docs Assistanttől

Ha nem vagy biztos benne, hogy melyik változót válaszd a feltétel létrehozásakor, kérj tanácsot a Shopify Dev Docs Assistanttől. A Dev Docs Assistant hozzáfér a GraphQL Admin API-val kapcsolatos összes dokumentációhoz, és javaslatokat tehet a Shopify Flow-ban lévő feltételek formázására:

1. Látogass el a Shopify Dev Docs oldalra.
2. Kattintson az „Asszisztens megkérdezése” lehetőségre a csevegőpanel megnyitásához.
3. Az üzenetmezőbe írja be a kérelmét, például: „Melyik változót használjam a Shopify Flow-ban, ha a vásárlói címke adataihoz szeretnék hozzáférni, és a kiváltó esemény a „Rendelés létrehozva”?”.
4. Nyomja le az Enter billentyűt, vagy kattintson a ikonra.

A változók pontokkal tagolt jelölésének értelmezése

A változók kiválasztásakor észreveheti, hogy azok pontokkal elválasztott kulcsszavakból állnak, például order.customer.tag. Ez a formátum azokat a lépéseket jelöli, amelyeket az API tesz meg a használni kívánt adatok eléréséhez. A változó minden „lépését” egy pont választja el, az adatokhoz vezető útvonal pedig balról jobbra olvasandó. A változók hossza eltérő lehet attól függően, hogy az adatok hol tárolódnak az API-ban, és hogy a munkafolyamat milyen útvonalon éri el őket.

Például:

• order.email: Ellenőrzi a rendeléshez tartozó vásárlóhoz társított e-mail-címet. Ez hasonló ahhoz, mintha egy rendelésre kattintana, majd ellenőrizné az e-mail-címet a rendelés részleteinél.
• refunds_item.staffMember.name: Ellenőrzi a rendelésben a tétel-visszatérítést, megkeresi az ahhoz a visszatérítéshez társított személyzeti tag adatait, majd ellenőrzi az adott személyzeti tag teljes nevét.

A változó kiválasztásakor gondolja át, hogyan navigálna a Shopify adminisztrációs felületén a kívánt információ megkereséséhez. Valószínű, hogy az API-nak is hasonló útvonalat kell bejárnia, ami segíthet meghatározni a változó formátumát.

Például, ha egy új rendelést tekint át, és tudni szeretné, hogy a rendeléshez társított vásárló melyik RFM-csoportba tartozik, akkor valószínűleg a rendelésen a vásárló nevére kattintana, hogy a Shopify adminisztrációs felületén átjusson a vásárló adatlapjára. Ezután megnézné a vásárló elemzési összefoglalóját, hogy leolvassa az RFM-csoport oszlopban megjelenő értéket.

A Shopify Flow-ban ugyanennek az adatnak a lekéréséhez használt változó hasonló útvonalat követne: order.customer.statistics.rfmGroup.

Változókra vonatkozó adatkövetelmények

A változóknak adatokra van szükségük. Ha egy változóhoz nem áll rendelkezésre a megfelelő adat, akkor a feltétel nem teljesül, és a munkafolyamat meghiúsul. A munkafolyamat elején kiválasztott kiváltótól függ, hogy milyen változókat adhat hozzá a feltételekhez, mivel a választható lehetőségek a rendelkezésre álló adatokat tükrözik.

Például, ha a munkafolyamat a Termék létrehozva kiváltóval indul, akkor az ebből a kiváltóból létrehozott feltételek a termék adathalmazból elérhető változókra korlátozódnak. Ezért az olyan változók, mint a product.category.name, a product.vendor és a variants_item.displayName, mind rendelkezésre állnak a feltétel részeként. Ezzel szemben az olyan változók, mint a customer.verifiedEmail vagy a subscriptionContracts_item.status, nem jelennek meg lehetőségként, mert azok nem a termék adathalmazhoz kapcsolódnak.

Ez azonban nem feltétlenül jelenti azt, hogy a más adathalmazokban lévő adatok teljesen hozzáférhetetlenek. Egyes adatok az API-ban több útvonalon is elérhetők, ugyanúgy, ahogyan a Shopify adminisztrációs felületén különböző hivatkozásokra kattintva is eljuthat ugyanarra az oldalra. A gyakorlatban ez azt jelenti, hogy a különböző kiváltók különböző változójelölést igényelnek ugyanazon információ lekéréséhez.

Tegyük fel például, hogy azt szeretné, hogy a munkafolyamat ellenőrizze a címkéket egy vásárló profilján. Ha a munkafolyamat a Rendelés létrehozva kiváltóval indul, akkor a változó az order.customer.tags lesz, mert a munkafolyamat a rendelési adatokkal kezdődik, majd ellenőrzi a rendelésben szereplő vásárlói információkat, végül pedig az adott vásárlóhoz tartozó címkéket. Ha a munkafolyamat a Vásárló létrehozva kiváltóval indul, akkor a változó egyszerűen customer.tags lesz, mert a munkafolyamat a vásárlói adatokkal kezdődik, így közvetlenül a vásárlóprofilon lévő címkéket tudja ellenőrizni.

A változó útvonalának ellenőrzése kulcsszavas kereséskor

A Shopify Flow-ban használt pontokkal tagolt jelölési stílus miatt a feltételben használandó változókra való kulcsszavas keresés több találatot is eredményezhet. A feltétel létrehozásakor fontos megérteni, hogy a változó útvonala mire utal, hogy a megfelelő változót válassza ki.

Például a munkafolyamat a Rendelés létrehozva kiváltót használja, és Ön a tags kulcsszóval keres egy változóra. A keresés a következő találatokat adhatja, amelyek különböző információkat ellenőriznek a rendelésben:

• order.tags: Magára a rendelésre alkalmazott címkék. Például: #sürgős rendelés vagy #ajándék.
• order.customer.tags: A rendelést leadó vásárlóra alkalmazott címkék. Például: #VIP vagy #partner.
• order.lineItems.product.tags: A rendelésben megvásárolt termékekre alkalmazott címkék. Például: #törékeny vagy #igazolványköteles.

Attól függően, hogy milyen típusú címkéket szeretne ellenőriztetni a munkafolyamattal, ki kell választania a megfelelő változót, hogy a feltétel az elvártaknak megfelelően működjön.

A logikai operátorok értelmezése a feltételekben

A logikai operátorok határozzák meg a feltétel alkalmazásának módját, és eredményükül egy állítás vagy igaz, vagy hamis lesz. Amikor egy feltétel így szól: „Ha A nagyobb, mint 10…”, akkor a nagyobb, mint rész a logikai operátor. A feltételhez tartozó logikai operátor kiválasztásával lényegében megmondja a feltételnek, hogyan értékelje ki a változót.

A Shopify Flow munkafolyamataiban 3 típusú logikai operátor létezik:

• Mezőszintű operátorok, például Nagyobb, mint vagy Ezzel kezdődik.
• Listaoperátorok, például Legalább az egyik vagy Mindegyik.
• Feltételszintű operátorok, például ÉS vagy VAGY.

A mezőszintű operátorok és a listaoperátorok a változó szintjén, a feltételszintű operátorok pedig a teljes feltétel szintjén érvényesülnek, és több változó egyetlen feltétellé való egyesítésére használhatók.

A mezőszintű operátorok a leggyakoribb operátortípusok, amelyeket minden típusú változó-utasításban használnak. A mezőszintű operátorokkal olyan feltételes utasításokat hozhat létre, mint például „Ha A nagyobb, mint 10, akkor tedd meg X-et” vagy „Ha B tartalmazza a „VIP” értéket, akkor tedd meg X-et”, hogy nagyobb mértékben szabályozhassa, hogy egy változó mely értékei adnak igaz eredményt. Az alapértelmezett logikai operátor az Egyenlő.

A listaoperátorok csak olyan változókra alkalmazhatók, amelyek eredmények listáját adhatják vissza. Például a lineItems_item.variant.price változó a rendelésben szereplő termékváltozat árát adja vissza, ami eredmények listáját is visszaadhatja, ha a vásárló több terméket vásárolt ugyanabban a rendelésben. Ez azt jelenti, hogy alkalmazhat egy olyan listaoperátort, mint a Legalább az egyik, ha azt szeretné, hogy egy olyan feltételes utasítás, mint a „lineItems_item.variant.price nagyobb, mint 10 USD”, akkor legyen igaz, ha a rendelésben van legalább egy 10 USD-nál drágább termékváltozat. Ezzel szemben a listaoperátorok nem jelennek meg olyan változók esetében, amelyek egyszerre csak egy eredményt adhatnak vissza. Például egy olyan változónak, mint az order.createdAt, csak egy lehetséges értéke van, mivel egy rendelést csak egyszer lehet létrehozni, így a listaoperátorok nem jelennek meg opcióként az adott változót tartalmazó utasítás módosítására.

A feltételekben használható operátorok, mint például az AND és az OR, lehetővé teszik, hogy több változót is belefoglaljon ugyanabba a feltételbe. Például egy egyszerű feltételes utasítás helyett, mint a „Ha az A egyenlő 5-tel, akkor hajtsd végre az X-et”, összetettebb feltételeket is létrehozhat, mint például: „Ha az A egyenlő 5-tel és a B nagyobb mint 10, akkor hajtsd végre az X-et”, amely megköveteli, hogy az A és a B változó is igaz legyen, vagy „Ha az A egyenlő 5-tel, vagy a B nagyobb mint 10, vagy a C kisebb mint 1, akkor hajtsd végre az X-et”, amelyhez elegendő, ha az A, B vagy C változók közül csak az egyik igaz. Használja az AND operátort, ha egy munkafolyamaton belül mindennek igaznak kell lennie, és az OR operátort, ha a feltétel teljesüléséhez elegendő egyetlen kritérium teljesülése.

Miért fontos ez? Annak megértése, hogy a logikai operátorok hogyan működnek a feltételekben, lehetővé teszi, hogy pontosan az Ön által kívánt kritériumokat ellenőrző munkafolyamatokat hozzon létre. A háromféle logikai operátorral részletes és összetett feltételes utasításokat alkothat, hogy nagyon specifikus feltételeket ellenőrző munkafolyamatokat hozzon létre.

Tudjon meg többet a feltételekben használt logikai operátorokról.