Vysvetlenie podmienok v Shopify Flow

Podmienka je krok v pracovnom postupe, v ktorom sa rozhoduje o ďalšom postupe na základe toho, či bol splnený súbor kritérií. Každý krok podmienky má 2 možnosti: Pravda, keď sú kritériá splnené, a Nepravda, keď kritériá splnené nie sú. Ak pre niektorú z možností nedefinujete ďalší krok výberom inej podmienky alebo akcie, spustenie pracovného postupu sa zastaví.

Napríklad, ak sa pracovný postup spustí pri vytvorení objednávky, podmienka môže skontrolovať, či sa v objednávke použil konkrétny zľavový kód AFFILIATE10. Ak áno, možnosť Pravda môže viesť k akcii, ktorá affiliate partnerovi odošle e-mail s informáciou, že sa použil jeho kód. Ak nie, možnosť Nepravda môže ostať prázdna, čo znamená, že sa nevykoná žiadna ďalšia akcia a spustenie pracovného postupu sa ukončí.

Pracovný postup môže mať ľubovoľný počet podmienok v závislosti od jeho zložitosti. Podmienky sa dajú prepojiť aj s inými podmienkami alebo akciami podľa toho, čo má pracovný postup vykonávať. Podmienky možno nastaviť tak, aby na seba nadväzovali (napríklad, ak je podmienka A pravdivá, skontroluje sa podmienka B; ak je A nepravdivá, skontroluje sa podmienka C), alebo ich môžete nastaviť tak, aby prebiehali súčasne v rámci toho istého kroku (napríklad kontrola, či platí A, B alebo C).

Tvorba podmienok pre pracovný postup

Na rozdiel od spúšťača alebo akcie, ktoré si môžete vybrať z vopred pripraveného zoznamu dostupných možností v aplikácii Shopify Flow, podmienky sa tvoria úplne od nuly výberom premenných, logických operátorov a hodnôt na vytvorenie podmieňovacieho príkazu:

  • Premenná je zástupný symbol, ktorý definuje údaje, ktoré podmienka používa. Ak chce napríklad podmienka skontrolovať konkrétny zľavový kód v objednávke, premenná bude order.discountCode. Premenné používajú bodkovú notáciu rozhrania GraphQL Admin API.
  • Výraz logický operátor určuje, ako má pracovný postup vyhodnotiť splnenie podmienky. Logické operátory sa môžu vzťahovať na úroveň premennej, alebo sa použijú, keď sú viaceré premenné zahrnuté ako súčasť celkových kritérií podmienky:
    • Možnosti na úrovni premennej zahŕňajú operátory na úrovni poľa (napríklad Väčšie ako alebo Začína na), prípadne operátory zoznamu (napríklad Aspoň jedno z alebo Všetky z).
    • Možnosti na úrovni podmienky zahŕňajú operátor A (AND), čo znamená, že všetky premenné musia byť pravdivé, aby sa podmienka celkovo považovala za pravdivú, alebo operátor ALEBO (OR), čo znamená, že aspoň 1 premenná musí byť pravdivá, aby sa podmienka celkovo považovala za pravdivú.
  • Hodnota predstavuje konkrétne informácie, ktoré premenná hľadá. Ak napríklad chcete, aby pracovný postup skontroloval konkrétny kód order.discountCode s hodnotou AFFILIATE10, práve túto hodnotu zahrniete do podmienky.

Pri výbere premenných a operátorov sa krok podmienky na plátne aplikácie Shopify Flow aktualizuje tak, aby v bežnom jazyku odrážal váš podmieňovací príkaz. Vďaka tomu si môžete overiť správnosť formátu vytváranej podmienky. Kliknutím na Pridať popis môžete predvolený podmieňovací príkaz prepísať vlastným textom.

Získajte podrobnejšie informácie o prvkoch podmienok v aplikácii Shopify Flow.

Vysvetlenie premenných v podmienkach

Pri tvorbe kroku podmienky v pracovnom postupe sa najprv zobrazí výzva na akciu Pridať premennú. Čo je to však premenná?

V aplikácii Shopify Flow je premenná zástupný symbol určujúci údaje, ktoré podmienka v pracovnom postupe používa. Ak podmienka znie „Ak je hodnota A väčšia ako 10…“, časť A je premenná. Výberom premennej pre podmienku v podstate hovoríte, ktoré konkrétne údaje sa majú vyhodnotiť.

Premenné sa formátujú pomocou bodkovej notácie rozhrania GraphQL Admin API. Na vytváranie pracovných postupov pomocou aplikácie Flow nemusíte dokonale ovládať API. Základné znalosti o názvoch premenných a ich definíciách vám však pomôžu vytvoriť presne takú logiku pracovného postupu, akú potrebujete.

Ak chcete lepšie pochopiť, aké údaje premenná predstavuje, zoznámte sa s nasledujúcimi informáciami o premenných:

Tip: Získajte pomoc s premennými od asistenta Dev Docs

Ak si nie ste istí, ktorú premennú máte pri tvorbe podmienky vybrať, skúste požiadať o radu asistenta Dev Docs spoločnosti Shopify. Asistent Dev Docs má prístup k celej dokumentácii týkajúcej sa rozhrania GraphQL Admin API a dokáže vám navrhnúť, ako naformátovať podmienku v aplikácii Shopify Flow:

  1. Prejdite do časti Shopify Dev Docs.
  2. Kliknutím na Opýtať sa asistenta otvorte panel chatu.
  3. Do poľa pre správu zadajte svoju požiadavku, napríklad „Ktorú premennú mám použiť v aplikácii Shopify Flow, ak chcem získať prístup k údajom o štítku zákazníka, keď je môj spúšťač nastavený na ‚Vytvorenie objednávky‘?“.
  4. Stlačte kláves Enter alebo kliknite na ikonu Odoslať.

Čítanie bodkovej notácie premenných

Pri výbere premenných si všimnete, že sú formátované ako kľúčové slová oddelené bodkami, napríklad order.customer.tag. Tento formát označuje kroky, ktoré rozhranie API vykonáva, aby sa dostalo k údajom, ktoré chcete použiť. Každý „krok“ premennej je oddelený bodkou a cesta k údajom sa číta zľava doprava. Dĺžka premenných sa môže líšiť v závislosti od toho, kde sú údaje v rozhraní API uložené, a od cesty, ktorou sa k nim pracovný postup dostane.

Napríklad:

  • order.email: Skontroluje e‑mailovú adresu priradenú k zákazníkovi pri danej objednávke. Je to podobné, ako keď kliknete na objednávku a skontrolujete e‑mailovú adresu v detailoch objednávky.
  • refunds_item.staffMember.name: Skontroluje objednávku z hľadiska vrátenia peňazí za položku, prejde na informácie o členovi personálu, ktorý je s týmto vrátením peňazí spojený, a skontroluje jeho celé meno.

Pri výbere premennej zvážte, ako by ste postupovali v administrátorovi Shopify, ak by ste chceli nájsť požadované informácie. Je pravdepodobné, že rozhranie API bude musieť prejsť podobnou cestou, čo vám pomôže určiť, ako by mohla byť vaša premenná formátovaná.

Ak napríklad kontrolujete novú objednávku a chcete zistiť, do akej skupiny RFM patrí zákazník priradený k objednávke, pravdepodobne kliknete na meno zákazníka v objednávke, čím sa presmerujete na stránku s detailmi o zákazníkovi v administrátorovi Shopify. Následne si môžete v analytickom súhrne zákazníka pozrieť, aká hodnota je zobrazená v stĺpci Skupina RFM.

Premenná, ktorú by ste použili na vrátenie rovnakých údajov v aplikácii Shopify Flow, by využívala podobnú cestu: order.customer.statistics.rfmGroup.

Požiadavky na údaje pre premenné

Premenné vyžadujú údaje. Ak premenná nemá k dispozícii správne údaje, podmienka nebude fungovať a pracovný postup zlyhá. V závislosti od toho, aký spúšťač ste vybrali na začiatku pracovného postupu, sa možnosti premenných pridávaných do podmienok menia tak, aby odrážali dostupné údaje.

Ak sa napríklad váš pracovný postup začína spúšťačom Vytvorenie produktu, podmienky, ktoré na základe tohto spúšťača vytvoríte, sú obmedzené na premenné dostupné zo súboru údajov produktu. Ako súčasť podmienky sa preto môžu použiť premenné ako product.category.name, product.vendor a variants_item.displayName. Naopak, premenné ako customer.verifiedEmail alebo subscriptionContracts_item.status by sa v možnostiach nezobrazili, pretože s daným súborom údajov nesúvisia.

To však nutne neznamená, že údaje v iných súboroch údajov sú úplne nedostupné. K niektorým údajom sa dá v rozhraní API dostať z viacerých ciest, podobne ako keď v administrátorovi Shopify prejdete na rovnakú stránku prostredníctvom rôznych odkazov. V praxi to znamená, že rôzne spúšťače vyžadujú rôzny zápis premenných, aby vrátili rovnaké informácie.

Napríklad chcete, aby váš pracovný postup kontroloval štítky v zákazníckom profile. Ak sa váš pracovný postup začína spúšťačom Vytvorená objednávka, premenná bude order.customer.tags, pretože pracovný postup sa začína údajmi o objednávke, následne skontroluje informácie o zákazníkovi v objednávke a potom štítky u tohto zákazníka. Ak sa pracovný postup začína spúšťačom Vytvorený zákazník, premenná bude len customer.tags, pretože pracovný postup sa začína údajmi o zákazníkovi, takže môže priamo prejsť na kontrolu štítkov v zákazníckom profile.

Z dôvodu štýlu bodkového zápisu v aplikácii Shopify Flow môže vyhľadávanie premenných, ktoré sa majú použiť v podmienke, na základe kľúčových slov vrátiť viacero výsledkov. Pri určovaní premennej, ktorú si pri vytváraní podmienky vyberiete, je dôležité pochopiť, čo naznačuje cesta premennej.

Napríklad váš pracovný postup používa spúšťač Vytvorená objednávka a hľadáte premennú pomocou kľúčového slova tags. Vyhľadávanie môže vrátiť nasledujúce výsledky, ktoré v objednávke kontrolujú rôzne informácie:

  • order.tags: Štítky použité v samotnej objednávke. Napríklad #rush order alebo #gift.
  • order.customer.tags: Štítky použité u zákazníka, ktorý zadal objednávku. Napríklad #VIP alebo #affiliate.
  • order.lineItems.product.tags: Štítky použité pri produktoch zakúpených v objednávke. Napríklad #fragile alebo #requiresID.

Na základe toho, aký typ štítkov má pracovný postup skontrolovať, je potrebné vybrať správnu premennú, aby vaša podmienka fungovala podľa očakávania.

Vysvetlenie logických operátorov v podmienkach

Logické operátory definujú, ako sa podmienka uplatní, a ich výsledkom je pravdivý alebo nepravdivý výrok. Keď podmienka znie „Ak je A väčšie ako 10...“, časť je väčšie ako je logický operátor. Výber logického operátora pre podmienku v podstate hovorí podmienke, ako má vyhodnotiť premennú.

V pracovných postupoch Shopify Flow existujú 3 typy logických operátorov:

  • Operátory na úrovni poľa, ako napríklad Väčšie ako alebo Začína sa na.
  • Operátory zoznamu, napríklad Aspoň jeden z alebo Všetky z.
  • Operátory na úrovni podmienky, ako napríklad A alebo ALEBO.

Operátory na úrovni poľa a operátory zoznamu sa uplatňujú na úrovni premennej. Operátory na úrovni podmienky sa uplatňujú na celkovú podmienku a môžu sa použiť na skombinovanie viacerých premenných do jednej podmienky.

Operátory na úrovni poľa sú najbežnejším typom operátorov a používajú sa v každom type výroku s premennou. Pomocou operátorov na úrovni poľa môžete vytvárať podmienečné výroky, ako napríklad „Ak je A väčšie ako 10, vykonaj X“ alebo „Ak B obsahuje ‚VIP‘, vykonaj X“, čím získate väčšiu kontrolu nad tým, ktoré hodnoty premennej vrátia pravdivý výsledok. Predvoleným logickým operátorom je Rovná sa.

Operátory zoznamu sa môžu použiť iba pre premenné, ktoré môžu vrátiť zoznam výsledkov. Napríklad premenná lineItems_item.variant.price vráti cenu za variant produktu v objednávke, čo môže vrátiť zoznam výsledkov, keď si zákazník v rovnakej objednávke kúpil viacero produktov. To znamená, že ak chcete, aby bol podmienečný výrok ako „lineItems_item.variant.price je väčšia ako 10 USD“ pravdivý, keď je v objednávke aspoň 1 variant produktu nad 10 USD, môžete použiť operátor zoznamu ako Aspoň jeden z. Operátory zoznamu sa naopak nezobrazujú pri premenných, ktoré môžu vrátiť naraz iba 1 výsledok. Napríklad pre premennú ako order.createdAt existuje iba 1 možná hodnota, pretože objednávku možno vytvoriť len raz, takže operátory zoznamu sa nezobrazujú ako možnosti úpravy výroku obsahujúceho túto premennú.

Operátory na úrovni podmienky, ako napríklad AND a OR, umožňujú zahrnúť do tej istej podmienky viacero premenných. Napríklad namiesto jednoduchého podmienečného výroku, ako je „Ak sa A rovná 5, vykonaj X“, môžete vytvoriť zložitejšie podmienky, napríklad „Ak sa A rovná 5 a B je väčšie ako 10, vykonaj X“, čo vyžaduje, aby boli premenné A aj B pravdivé, alebo „Ak sa A rovná 5 alebo B je väčšie ako 10, alebo C je menšie ako 1, vykonaj X“, čo si vyžaduje, aby bola pravdivá iba 1 z premenných A, B alebo C. Operátor AND použite vtedy, keď musí byť v pracovnom postupe všetko pravdivé; operátor OR použite vtedy, keď na splnenie podmienky stačí splnenie aspoň 1 kritéria.

Prečo je to dôležité: Keď pochopíte, ako fungujú logické operátory v podmienkach, budete môcť vytvárať pracovné postupy, ktoré budú kontrolovať presne vami požadované kritériá. Pomocou 3 typov logických operátorov môžete zostavovať podrobné a komplexné podmienečné výroky na vytvorenie pracovných postupov, ktoré kontrolujú veľmi špecifické podmienky.

Získajte podrobnejšie informácie o logických operátoroch v podmienkach.