Shopify Flow'n ehdot

Ehto on työnkulun vaihe, jossa päätetään, miten edetään sen perusteella, onko tietty kriteerijoukko täyttynyt. Jokaisessa ehtovaiheessa on kaksi vaihtoehtoa: Tosi, kun kriteerit ovat täyttyneet, ja Epätosi, kun kriteerit eivät ole täyttyneet. Jos et määritä seuraavaa vaihetta kummallekaan vaihtoehdolle valitsemalla toista ehtoa tai toimintoa, työnkulun suoritus pysähtyy.

Jos esimerkiksi työnkulkusi käynnistyy tilauksen luonnin yhteydessä, ehto voi tarkistaa, onko tilauksessa käytetty tiettyä AFFILIATE10-alennuskoodia. Jos koodia on käytetty, Tosi-vaihtoehto voi johtaa toimintoon, joka lähettää kumppanille sähköpostiviestin ja ilmoittaa, että hänen koodiaan on käytetty. Jos koodia ei ole käytetty, Epätosi-vaihtoehto voi olla tyhjä, mikä tarkoittaa, että mitään muuta ei tapahdu ja työnkulun suoritus päättyy.

Työnkulussa voi olla kuinka monta ehtoa tahansa työnkulkusi monimutkaisuudesta riippuen. Ehdot voivat myös linkittyä muihin ehtoihin tai toimintoihin riippuen siitä, mitä haluat työnkulun tekevän. Ehdot voidaan määrittää linkittymään peräkkäin (jos esimerkiksi ehto A on tosi, tarkista ehto B; jos A on epätosi, tarkista C), tai ne voidaan asettaa tapahtumaan samanaikaisesti osana samaa vaihetta (tarkista esimerkiksi, onko A, B vai C tosi).

Ehtojen laatiminen työnkulkuusi

Toisin kuin käynnistimen tai toiminnon, jotka voit valita Shopify Flown käytettävissä olevien vaihtoehtojen ennalta määritetystä luettelosta, ehdot laaditaan alusta alkaen valitsemalla muuttujia, loogisia operaattoreita ja arvoja ehtolausekkeen luomiseksi:

• Muuttuja on paikkamerkki, joka määrittää datan, jota ehto käyttää. Jos ehto esimerkiksi haluaa tarkistaa tietyn alennuskoodin tilauksesta, muuttuja on order.discountCode. Muuttujat käyttävät GraphQL Admin API -pistenotaatiota.
• ​ Looginen operaattori osoittaa, miten työnkulun tulisi määrittää, onko ehto täyttynyt. Loogisia operaattoreita voidaan soveltaa muuttujatasolla tai kun useita muuttujia sisältyy ehdon kokonaiskriteereihin:
  • Muuttujatason vaihtoehtoihin kuuluvat kenttätason operaattorit, kuten Suurempi kuin tai Alkaa merkkijonolla, tai luettelo-operaattorit, kuten Vähintään yksi seuraavista tai Kaikki seuraavista.
  • Ehtotason vaihtoehtoja ovat JA, mikä tarkoittaa, että kaikkien muuttujien on oltava tosia, jotta koko ehto katsotaan todeksi, tai TAI, mikä tarkoittaa, että vähintään yhden muuttujan on oltava tosi, jotta koko ehto katsotaan todeksi.
• Arvo on varsinainen tieto, jota muuttuja etsii. Jos esimerkiksi tietty order.discountCode, jonka haluat työnkulun tarkistavan, on AFFILIATE10, tämä olisi arvo, joka sisällytetään osaksi ehtoa.

Kun valitset muuttujia ja operaattoreita, Shopify Flown työtilan ehtovaihe päivittyy vastaamaan ehtolausekettasi selkokielellä, jotta voit tarkistaa, onko rakentamasi ehto muotoiltu oikein. Voit napsauttaa Lisää kuvaus -painiketta korvataksesi oletusarvoisen ehtolausekkeen omalla kirjoittamallasi kuvauksella.

Lue lisätietoja Shopify Flown ehtojen elementeistä.

Muuttujien ymmärtäminen ehdoissa

Kun laadit työnkulun ehtovaihetta, ensimmäinen vaihe, johon sinua kehotetaan, on Lisää muuttuja. Mutta mikä on muuttuja?

Shopify Flow'ssa muuttuja on paikkamerkki, joka ilmaisee ehdon työnkulussa käyttämän datan. Kun ehdossa lukee ”Jos A on suurempi kuin 10...”, A-osa on muuttuja. Muuttujan valitseminen ehdolle on pohjimmiltaan sitä, että kerrot ehdolle tarkalleen, mitä dataa sen tulee arvioida.

Muuttujat muotoillaan GraphQL Admin API -pistenotaatiolla. Sinun ei tarvitse hallita APIa voidaksesi luoda työnkulkuja Flow-sovelluksella, mutta muuttujien nimien ja niiden määritelmien perustason ymmärrys voi auttaa sinua rakentamaan juuri haluamasi työnkulun logiikan.

Ymmärtääksesi, mitä dataa muuttuja edustaa, tutustu seuraaviin muuttujia koskeviin tietoihin:

• Muuttujan pistenotaation lukeminen.
• Muuttujien datavaatimusten ymmärtäminen.
• Oikean muuttujan paikantaminen haun aikana.

Vinkki: Hae apua muuttujiin Dev Docs Assistantilta

Jos et ole varma, minkä muuttujan valitsisit ehtoa rakentaessasi, harkitse neuvojen kysymistä Shopify Dev Docs Assistantilta. Dev Docs Assistantilla on pääsy kaikkeen GraphQL Admin APIa koskevaan dokumentaatioon, ja se voi tarjota ehdotuksia ehdon muotoilemiseksi Shopify Flow'ssa:

1. Siirry Shopify Dev Docs -sivustolle.
2. Avaa chattipaneeli napsauttamalla Kysy avustajalta.
3. Kirjoita viestikenttään pyyntösi, kuten "Mitä muuttujaa minun kannattaa käyttää Shopify Flow'ssa, jos haluan käyttää asiakkaan tunnistetietoja, kun käynnistimeni on ”Tilaus luotu”?".
4. Paina Enter-näppäintä tai napsauta .

Muuttujien pistenotaation lukeminen

Kun valitset muuttujia, huomaat, että ne on muotoiltu pisteillä erotetuiksi avainsanoiksi, kuten order.customer.tag. Tämä muoto ilmaisee vaiheet, joilla API hakee tiedot, joita haluat käyttää. Muuttujan kukin ”vaihe” on erotettu pisteellä, ja polku tietoihin luetaan vasemmalta oikealle. Muuttujien pituus voi vaihdella sen mukaan, mihin tiedot on tallennettu API-rajapinnassa ja mitä polkua työnkulku käyttää niiden hakemiseen.

Esimerkki:

• order.email: Tarkistaa tilaukseen liittyvän asiakkaan sähköpostiosoitteen. Tämä on samankaltaista kuin jos napsauttaisit tilausta ja tarkistaisit sähköpostiosoitteen tilauksen tiedoista.
• refunds_item.staffMember.name: Tarkistaa tilauksesta tuotteen maksunpalautuksen, siirtyy kyseiseen maksunpalautukseen liittyvän henkilöstön jäsenen tietoihin ja tarkistaa kyseisen henkilöstön jäsenen koko nimen.

Kun valitset muuttujaa, mieti, miten navigoit Shopifyn ohjausnäkymässä löytääksesi haluamasi tiedot. On todennäköistä, että API-rajapinnan on käytettävä samanlaista polkua, mikä voi auttaa sinua määrittämään, miten muuttujasi muotoillaan.

Jos esimerkiksi tarkastelet uutta tilausta ja haluat tietää, missä RFM-ryhmässä tilaukseen liitetty asiakas on, voit napsauttaa tilauksessa olevaa asiakkaan nimeä, jolloin sinut ohjataan asiakkaan tietosivulle Shopifyn ohjausnäkymässä. Tämän jälkeen voit tarkistaa asiakkaan analytiikan yhteenvedosta, mikä arvo näytetään RFM-ryhmä-sarakkeessa.

Muuttuja, jota käyttäisit saman datan palauttamiseen Shopify Flow'ssa, käyttäisi samanlaista polkua: order.customer.statistics.rfmGroup.

Muuttujien tietovaatimukset

Muuttujat vaativat dataa. Jos oikeaa dataa ei ole muuttujan saatavilla, ehto ei toimi ja työnkulku epäonnistuu. Sen mukaan, minkä käynnistimen valitsit työnkulkusi alkuun, ehtoihin lisättävien muuttujien vaihtoehdot muuttuvat vastaamaan käytettävissä olevaan dataan perustuvia mahdollisia vaihtoehtoja.

Jos työnkulkusi alkaa esimerkiksi Tuote luotu -käynnistimellä, ehdot, jotka luot kyseisestä käynnistimestä, rajoittuvat tuotetietoaineistosta saatavilla oleviin muuttujiin. Siksi muuttujat, kuten product.category.name, product.vendor ja variants_item.displayName, ovat kaikki käytettävissä osana ehtoa. Sen sijaan muuttujat, kuten customer.verifiedEmail tai subscriptionContracts_item.status, eivät näy vaihtoehtoina, koska ne eivät liity tuotetietoaineistoon.

Tämä ei kuitenkaan välttämättä tarkoita, että muiden tietoaineistojen sisältämä data olisi täysin saavuttamattomissa. Joihinkin tietoihin pääsee käsiksi useita polkuja pitkin API-rajapinnassa samalla tavalla kuin saatat päästä samalle sivulle Shopifyn ohjausnäkymässä napsauttamalla eri linkkejä. Käytännössä tämä tarkoittaa, että eri käynnistimet vaativat erilaista muuttujanotaatiota saman tiedon palauttamiseksi.

Haluat esimerkiksi, että työnkulkusi tarkistaa asiakasprofiilin tunnisteet. Jos työnkulkusi alkaa Tilaus luotu -käynnistimellä, muuttuja on order.customer.tags, koska työnkulku alkaa tilaustiedoista, tarkistaa sitten tilauksessa olevat asiakastiedot ja lopuksi kyseisen asiakkaan tunnisteet. Jos työnkulkusi alkaa Asiakas luotu -käynnistimellä, muuttuja on yksinkertaisesti customer.tags, koska työnkulku alkaa asiakastiedoista, joten se voi suoraan tarkistaa asiakasprofiilin tunnisteet.

Muuttujan polun tarkistaminen haettaessa avainsanojen perusteella

Shopify Flown pistenotaatiotyylin vuoksi muuttujien haku avainsanojen perusteella ehtoa varten voi tuottaa useita tuloksia. On tärkeää ymmärtää, mitä muuttujan polku ilmaisee, kun määrität, minkä muuttujan valitset ehtoa luodessasi.

Esimerkiksi työnkulkusi käyttää Tilaus luotu -käynnistintä, ja haet muuttujaa avainsanalla tags. Hakusi voi palauttaa seuraavat tulokset, jotka tarkistavat tilauksesta eri tietoja:

• order.tags: Itse tilaukseen lisätyt tunnisteet. Esimerkiksi #kiireellinentilaus tai #lahja.
• order.customer.tags: Tilauksen tehneeseen asiakkaaseen lisätyt tunnisteet. Esimerkiksi #VIP tai #kumppani.
• order.lineItems.product.tags: Tilauksesta ostettuihin tuotteisiin lisätyt tunnisteet. Esimerkiksi #särkyvää tai #vaatii_tunnistautumisen.

Riippuen siitä, minkä tyyppisiä tunnisteita haluat työnkulun tarkistavan, sinun on valittava oikea muuttuja, jotta ehto toimii odotetulla tavalla.

Loogisten operaattoreiden ymmärtäminen ehdoissa

Loogiset operaattorit määrittävät, miten ehtosi toteutetaan, ja niiden tuloksena lauseke on joko tosi tai epätosi. Kun ehto on muotoa ”Jos A on suurempi kuin 10...”, on suurempi kuin -osa on looginen operaattori. Loogisen operaattorin valitseminen ehdolle tarkoittaa pohjimmiltaan sitä, että kerrot ehdolle, miten muuttujaa arvioidaan.

Shopify Flow -työnkuluissa on kolmenlaisia loogisia operaattoreita:

• Kenttätason operaattorit, kuten Suurempi kuin tai Alkaa.
• Luettelo-operaattorit, kuten Vähintään yksi tai Kaikki.
• Ehtotason operaattorit, kuten AND tai OR.

Kenttätason operaattoreita ja luettelo-operaattoreita sovelletaan muuttujatasolla, ja ehtotason operaattoreita sovelletaan koko ehtoon, ja niitä voidaan käyttää useiden muuttujien yhdistämiseen yhdeksi ehdoksi.

Kenttätason operaattorit ovat yleisimpiä operaattorityyppejä, ja niitä käytetään kaikentyyppisissä muuttujalausekkeissa. Kenttätason operaattoreilla voit luoda ehtolausekkeita, kuten ”Jos A on suurempi kuin 10, tee X” tai ”Jos B sisältää 'VIP', tee X”, hallitaksesi tarkemmin, mitkä muuttujan arvot palauttavat tosi-tuloksen. Yhtä suuri kuin on oletusarvoinen looginen operaattori.

Luettelo-operaattoreita voidaan soveltaa vain muuttujiin, jotka voivat palauttaa tulosluettelon. Esimerkiksi muuttuja lineItems_item.variant.price palauttaa tuoteversion hinnan tilauksessa, ja se voi palauttaa tulosluettelon, kun asiakas on ostanut useita tuotteita samassa tilauksessa. Tämä tarkoittaa, että voit soveltaa luettelo-operaattoria, kuten Vähintään yksi, kun haluat, että ehtolauseke, kuten ”lineItems_item.variant.price on suurempi kuin 10 $”, on tosi, kun tilauksessa on vähintään yksi tuoteversio, jonka arvo on yli 10 $. Sitä vastoin luettelo-operaattoreita ei näytetä muuttujille, jotka voivat palauttaa vain yhden tuloksen kerrallaan. Esimerkiksi muuttujalla, kuten order.createdAt, on vain yksi mahdollinen arvo, koska tilaus voidaan luoda vain kerran. Siksi luettelo-operaattoreita ei näytetä vaihtoehtoina kyseisen muuttujan sisältävän lausekkeen muokkaamiseksi.

Ehto-operaattoreiden, kuten AND ja OR, avulla voit sisällyttää useita muuttujia samaan ehtoon. Yksinkertaisen ehtolauseen, kuten ”Jos A on 5, tee X”, sijaan voit muodostaa monimutkaisempia ehtoja. Esimerkiksi ehto ”Jos A on 5 ja B on suurempi kuin 10, tee X” edellyttää, että sekä A- että B-muuttujat ovat tosia. Vastaavasti ehto ”Jos A on 5 tai B on suurempi kuin 10 tai C on pienempi kuin 1, tee X” edellyttää, että vain yksi muuttujista A, B tai C on tosi. Käytä operaattoria AND, kun kaiken työnkulussa on oltava totta. Käytä operaattoria OR, kun ehdon toteutumiseen riittää, että yksikin kriteeri täyttyy.

Miksi tämä on tärkeää: Kun ymmärrät, miten loogiset operaattorit toimivat ehdoissa, voit luoda työnkulkuja, jotka tarkistavat juuri haluamasi kriteerit. Kolmen loogisen operaattorityypin avulla voit laatia yksityiskohtaisia ja monimutkaisia ehtolauseita luodaksesi työnkulkuja, jotka tarkistavat erittäin tarkkoja ehtoja.

Lue tarkempia tietoja aiheesta logical operators in conditions.