Razumevanje pogojev v Shopify Flow

Pogoj je korak v poteku dela, pri katerem se sprejme odločitev o tem, kako naj se izvajanje nadaljuje glede na to, ali je nabor meril izpolnjen. Vsak pogojni korak ima 2 možnosti: Resnično, ko so merila izpolnjena, in Neresnično, ko merila niso izpolnjena. Če za katero koli od teh možnosti ne določite naslednjega koraka z izbiro drugega pogoja ali dejanja, se izvajanje poteka dela ustavi.

Na primer, če se vaš potek dela sproži, ko je ustvarjeno naročilo, lahko pogoj preveri, ali je bila pri naročilu uporabljena določena koda za popust AFFILIATE10. Če je bila, lahko možnost True privede do dejanja, ki partnerskemu posredniku pošlje e-pošto z obvestilom, da je bila njegova koda uporabljena. Če ni bila, je možnost False lahko prazna, kar pomeni, da se ne zgodi nič več in se zagon poteka dela konča.

Potek dela ima lahko poljubno število pogojev, odvisno od kompleksnosti vašega poteka dela. Pogoji se lahko povežejo tudi z drugimi pogoji ali dejanji glede na to, kaj želite, da potek dela naredi. Pogoje lahko nastavite tako, da se povezujejo v zaporedju (če je na primer pogoj A resničen, preveri pogoj B; če je pogoj A neresničen, preveri C), ali pa jih nastavite tako, da se izvedejo hkrati kot del istega koraka (na primer preveri, ali je resničen A, B ali C).

Ustvarjanje pogojev za potek dela

Za razliko od sprožilca ali dejanja, ki ga lahko izberete z vnaprej določenega seznama razpoložljivih možnosti v aplikaciji Shopify Flow, so pogoji ustvarjeni od začetka z izbiro spremenljivk, logičnih operatorjev in vrednosti za ustvarjanje pogojne izjave:

• Spremenljivka je nadomestno besedilo, ki določa podatke, ki jih uporablja pogoj. Na primer, če želi pogoj pri naročilu preveriti določeno kodo za popust, bi bila spremenljivka order.discountCode. Spremenljivke uporabljajo zapis s piko za GraphQL Admin API.
• ​ Logični operator označuje, kako naj potek dela ugotovi, ali je pogoj izpolnjen. Logični operatorji lahko veljajo na ravni spremenljivke ali pa kadar je več spremenljivk vključenih kot del splošnih meril pogoja:
  • Možnosti na ravni spremenljivke vključujejo operatorje na ravni polja, kot sta Večje od ali Začne se z, ali operatorje seznama, kot sta Vsaj eden od ali Vsi.
  • Možnosti na ravni pogoja vključujejo IN, kar pomeni, da morajo biti vse spremenljivke resnične, da se pogoj na splošno obravnava kot resničen, ali ALI, kar pomeni, da mora biti vsaj 1 spremenljivka resnična, da se pogoj na splošno obravnava kot resničen.
• Vrednost je dejanska informacija, ki jo spremenljivka išče. Na primer, če je določena koda order.discountCode, za katero želite, da jo potek dela preveri, AFFILIATE10, potem bi bila to vrednost, ki jo je treba vključiti kot del pogoja.

Ko izberete spremenljivke in operatorje, se korak pogoja na platnu aplikacije Shopify Flow posodobi, tako da odraža vašo pogojno izjavo v preprostem jeziku in lahko znova preverite, ali je pogoj, ki ga gradite, pravilno oblikovan. Kliknete lahko Dodaj opis, da prepišete privzeto pogojno izjavo z lastnim opisom.

Več informacij o elementih pogojev v aplikaciji Shopify Flow.

Razumevanje spremenljivk v pogojih

Ko ustvarjate korak pogoja v poteku dela, je prvi korak, h kateremu ste pozvani, ta, da Dodate spremenljivko. Toda kaj je spremenljivka?

V aplikaciji Shopify Flow je spremenljivka nadomestno besedilo, ki označuje podatke, ki jih uporablja pogoj v poteku dela. Ko se pogoj glasi "Če je A večji od 10 ...", je del A spremenljivka. Če izberete spremenljivko za pogoj, s tem pogoju v bistvu poveste, katere podatke naj oceni.

Spremenljivke so oblikovane z zapisom s piko za GraphQL Admin API. Za ustvarjanje potekov dela v aplikaciji Flow vam ni treba poglobljeno poznati API-ja, a vam osnovno razumevanje imen spremenljivk in njihovih definicij lahko pomaga zgraditi specifično logiko poteka dela, ki jo želite.

Če želite razumeti, katere podatke predstavlja spremenljivka, upoštevajte naslednje informacije o spremenljivkah:

• Kako brati zapis s piko za spremenljivke.
• Razumevanje zahtev glede podatkov za spremenljivke.
• Iskanje pravilne spremenljivke pri poizvedbi.

Nasvet: Pomoč glede spremenljivk poiščite pri pomočniku za Dev Docs

Če niste prepričani, katero spremenljivko izbrati pri ustvarjanju pogoja, za nasvet prosite pomočnika za Shopify Dev Docs. Pomočnik za Dev Docs ima dostop do celotne dokumentacije v zvezi z vmesnikom GraphQL Admin API in lahko ponudi predloge, kako oblikovati pogoj v aplikaciji Shopify Flow:

1. Pomaknite se na razdelek Shopify Dev Docs.
2. Kliknite Ask Assistant, da odprete podokno za klepet.
3. V polje za sporočilo vnesite svojo zahtevo, na primer "Katero spremenljivko naj uporabim v aplikaciji Shopify Flow, če želim dostopati do podatkov oznake stranke, ko se moj sprožilec začne z "Order created"?".
4. Pritisnite Enter ali kliknite .

Branje zapisa s piko za spremenljivke

Pri izbiri spremenljivk boste opazili, da so oblikovane kot ključne besede, ločene s pikami, na primer order.customer.tag. Ta oblika označuje korake, ki jih API izvede, da pride do podatkov, ki jih želite uporabiti. Vsak »korak« spremenljivke je ločen s piko, pot do podatkov pa se bere z leve proti desni. Spremenljivke se lahko razlikujejo po dolžini, odvisno od tega, kje so podatki shranjeni v API-ju, in poti, ki jo potek dela ubere, da pride do tja.

Na primer:

• order.email: Preveri e-poštni naslov, povezan s stranko za naročilo. To je podobno temu, kot da bi kliknili naročilo in nato preverili e-poštni naslov v podrobnostih naročila.
• refunds_item.staffMember.name: Pri naročilu preveri povračilo za kos, odpre informacije o osebju, povezane s tem povračilom, in preveri polno ime tega člana osebja.

Pri izbiri spremenljivke razmislite, kako bi se pomikali po skrbniku Shopify, da bi našli želene informacije. Verjetno bo moral API ubrati podobno pot, kar vam lahko pomaga pri določanju, kako naj bo spremenljivka oblikovana.

Na primer, če pregledujete novo naročilo in želite ugotoviti, v katero skupino RFM spada stranka, povezana z naročilom, boste morda kliknili ime stranke na naročilu za preusmeritev na stran s podrobnostmi o stranki v skrbniku Shopify, nato pa boste v povzetku analitike stranke preverili vrednost, prikazano v stolpcu RFM group.

Spremenljivka, ki bi jo uporabili za pridobivanje istih podatkov v aplikaciji Shopify Flow, ima podobno pot: order.customer.statistics.rfmGroup.

Podatkovne zahteve za spremenljivke

Spremenljivke zahtevajo podatke. Če ustrezni podatki za spremenljivko niso na voljo, pogoj ne bo deloval in potek dela ne bo uspel. Glede na to, kateri sprožilec ste izbrali za začetek poteka dela, se možnosti spremenljivk, ki jih lahko dodate v pogoje, spremenijo tako, da odražajo možne izbire na podlagi razpoložljivih podatkov.

Na primer, če se vaš potek dela začne s sprožilcem Ustvarjen izdelek, so pogoji, ki jih ustvarite na podlagi tega sprožilca, omejeni na spremenljivke, ki so na voljo v naboru podatkov product. Zato so spremenljivke, kot so product.category.name, product.vendor in variants_item.displayName, na voljo za uporabo kot del pogoja. V nasprotju s tem se spremenljivke, kot sta customer.verifiedEmail ali subscriptionContracts_item.status, ne prikažejo kot možnosti, ker niso povezane z naborom podatkov o izdelku.

Vendar to ne pomeni nujno, da so podatki v drugih naborih podatkov popolnoma nedostopni. Do nekaterih podatkov je mogoče dostopati prek več poti v API-ju, podobno kot lahko kliknete različne povezave, da pridete do iste strani v skrbniku Shopify. V praksi to pomeni, da različni sprožilci zahtevajo različen zapis spremenljivk, da vrnejo iste informacije.

Recimo, da želite, da vaš potek dela preveri oznake v profilu stranke. Če se vaš potek dela začne s sprožilcem Naročilo je ustvarjeno, bi bila spremenljivka order.customer.tags, ker se potek dela začne s podatki o naročilu, nato preveri podatke o stranki v naročilu in nato preveri oznake pri tej stranki. Če se vaš potek dela začne s sprožilcem Stranka je ustvarjena, bi bila spremenljivka preprosto customer.tags, ker se potek dela začne s podatki o stranki in lahko neposredno preveri oznake v profilu stranke.

Preverjanje poti spremenljivke pri iskanju na podlagi ključnih besed

Zaradi sloga zapisa s piko v Shopify Flow lahko iskanje spremenljivk za uporabo v pogoju na podlagi ključnih besed vrne več rezultatov. Razumevanje pomena poti spremenljivke je pomembno pri določanju, katero spremenljivko izbrati pri ustvarjanju pogoja.

Na primer: vaš potek dela uporablja sprožilec Naročilo je ustvarjeno in z uporabo ključne besede tags iščete spremenljivko. Vaše iskanje lahko vrne naslednje rezultate, ki preverjajo različne informacije v naročilu:

• order.tags: oznake, uporabljene pri samem naročilu. Na primer #rush order ali #gift.
• order.customer.tags: oznake, uporabljene pri stranki, ki je oddala naročilo. Na primer #VIP ali #affiliate.
• order.lineItems.product.tags: oznake, uporabljene pri kupljenih izdelkih v naročilu. Na primer #fragile ali #requiresID.

Glede na to, katero vrsto oznak želite preveriti v poteku dela, morate izbrati pravilno spremenljivko, da bo vaš pogoj deloval, kot pričakujete.

Razumevanje logičnih operatorjev v pogojih

Logični operatorji določajo, kako se uporabi vaš pogoj, in dajo rezultat izjave, ki je bodisi resnična bodisi neresnična. Kadar se pogoj glasi »Če je A večji od 10 ...«, je del is greater than logični operator. Z izbiro logičnega operatorja za pogoj dejansko poveste pogoju, kako naj ovrednoti spremenljivko.

V potekih dela Shopify Flow so na voljo 3 vrste logičnih operatorjev:

• Operatorji na ravni polja, kot sta Večje kot ali Začne se z.
• Operatorji seznama, kot sta Vsaj eden od ali Vsi od.
• Operatorji na ravni pogoja, kot sta IN ali ALI.

Operatorji na ravni polja in operatorji seznama se uporabljajo na ravni spremenljivk, operatorji na ravni pogoja pa veljajo za celoten pogoj in jih lahko uporabite za združevanje več spremenljivk v en pogoj.

Operatorji na ravni polja so najpogostejša vrsta operatorjev in se uporabljajo v vseh vrstah izjav s spremenljivkami. Z njimi lahko ustvarite pogojne izjave, kot je »Če je A večji od 10, potem naredi X« ali »Če B vsebuje ‚VIP‘, potem naredi X«, s čimer imate večji nadzor nad tem, katere vrednosti spremenljivke vrnejo resničen rezultat. Privzeti logični operator je Enako kot.

Operatorje seznama lahko uporabite samo za spremenljivke, ki lahko vrnejo seznam rezultatov. Na primer: spremenljivka lineItems_item.variant.price vrne ceno za različico izdelka v naročilu, kar lahko vrne seznam rezultatov, če je stranka v istem naročilu kupila več izdelkov. To pomeni, da bi lahko uporabili operator seznama, kot je Vsaj eden od, kadar želite, da je pogojna izjava, kot je »lineItems_item.variant.price je večje kot 10 $«, resnična, ko je v naročilu vsaj 1 različica izdelka nad 10 $. Nasprotno pa se operatorji seznama ne prikažejo za spremenljivke, ki lahko hkrati vrnejo samo 1 rezultat. Na primer: za spremenljivko order.createdAt obstaja samo 1 možna vrednost, saj je naročilo mogoče ustvariti le enkrat, zato se operatorji seznama ne prikažejo kot možnosti za spreminjanje izjave, ki vsebuje to spremenljivko.

Operatorji na ravni pogoja, kot sta AND in OR, vam omogočajo, da v isti pogoj vključite več spremenljivk. Namesto preproste pogojne izjave, kot je »Če je A enak 5, potem naredi X«, lahko ustvarite zapletenejše pogoje, kot je »Če je A enak 5 in je B večji od 10, potem naredi X«, kar zahteva, da sta resnični spremenljivki A in B, ali »Če je A enak 5 ali je B večji od 10 ali je C manjši od 1, potem naredi X«, kar zahteva, da je resnična samo 1 od spremenljivk A, B ali C. Operator AND uporabite, ko mora biti vse v poteku dela resnično; operator OR uporabite, ko izpolnitev katerega koli 1 kriterija zadostuje, da je pogoj resničen.

Zakaj je to pomembno: razumevanje delovanja logičnih operatorjev v pogojih vam omogoča, da ustvarite poteke dela, ki preverjajo točno tiste kriterije, ki jih želite. S 3 vrstami logičnih operatorjev lahko oblikujete podrobne in zapletene pogojne izjave, s katerimi ustvarite poteke dela, ki preverjajo zelo specifične pogoje.

Preberite več podrobnih informacij o logičnih operatorjih v pogojih.