Muuttujien luominen argumentteja sisältävien API-kenttien avulla Shopify Flow'ssa

Jotkin muuttujat edellyttävät lisäparametreja toimiakseen oikein Shopify Flow -työnkulussa. Nämä parametrit ovat argumentteja, joille sinun on määritettävä arvot, ennen kuin muuttuja katsotaan valmiiksi ja työnkulun käytettävissä olevaksi.

Esimerkiksi product.inCollection-kenttä määrittää, onko tuote tietyssä kokoelmassa, ja palauttaa totuusarvon true tai false. Kokoelman id-argumentti on kuitenkin sisällytettävä tähän kenttään, koska muutoin muuttuja ei tiedä, mikä tietty kokoelma sen tulee tarkistaa. Jotta voit käyttää kenttää oikein, argumentti on sisällytettävä kenttään. Voit esimerkiksi tehdä kyselyn product.inCollection(id: "gid://shopify/Collection/123456"), jotta Flow voi määrittää, onko tuote kokoelmassa, jonka tunnus on 123456, ja palauttaa sitten arvon true tai false odotetusti. Kun luot muuttujia Shopify Flow'ssa, sinun ei tarvitse etsiä tuotteiden tai kokoelmien tunnusten kaltaisia arvoja. Flow tarjoaa resurssivalitsimen haluamasi arvon valitsemiseen, ja tunnus täytetään automaattisesti.

Argumentteja sisältävien kenttien kyselyjen yksinkertaistamiseksi voit antaa uuden muuttujan nimen muuttujalle, jonka luot kentästä ja argumentista Shopify Flow'ssa. Jos esimerkiksi kokoelman, jonka tunnus on 123456, nimi on Summer Bestsellers, voit antaa inCollection(id: "gid://shopify/Collection/123456")-muuttujalle yksinkertaisemman nimen inSummerBestsellers. Tämän jälkeen voit käyttää muuttujaa product.inSummerBestsellers kaikissa työnkulun myöhemmissä vaiheissa.

Koska argumentit vaihtelevat niille määritettyjen arvojen mukaan, voit luoda yhdestä argumentteja vaativasta kentästä useita uusia muuttujia. Voit esimerkiksi luoda 3 yksilöllistä muuttujaa pelkästä product.inCollection-kentästä:

• product.inCollection(id: "gid://shopify/Collection/123456") voisi olla product.inSummerBestsellers.
• product.inCollection(id: "gid://shopify/Collection/654321") voisi olla product.inSwimwear.
• product.inCollection(id: "gid://shopify/Collection/112233") voisi olla product.inBeachAccessories.

Tuetut GraphQL Admin API -kentät Shopify Flow'ssa

Shopify Flow tukee seuraavia pakollisia argumentteja sisältäviä GraphQL Admin API -kenttiä:

• channel.hasCollection
• collection.hasProduct
• collection.publishedOnChannel
• collection.publishedOnPublication
• companyLocation.inCatalog
• inventoryItem.inventoryLevel
• location.inventoryLevel
• metaobject.field
• market.assignedCustomization
• marketLocalizableResource.marketLocalizations
• product.inCollection
• product.publishedOnChannel
• product.publishedOnPublication
• product.restrictedForResource
• publication.hasCollection
• publishable.publishedOnChannel
• publishable.publishedOnPublication
• sellingPlanGroup.appliesToProduct
• sellingPlanGroup.appliesToProductVariant
• sellingPlanGroup.appliesToProductVariants
• 20 translations-tyyppistä kenttää, kuten collection.translations ja product.translations

Ei-tuetut GraphQL Admin API -kentät Shopify Flow'ssa

Shopify Flow ei tue seuraavia kenttiä:

• deliveryCarrierService.availableServicesForCountries
• inventoryLevel.quantities
• return.suggestedFinancialOutcome
• return.suggestedRefund
• shop.search

Jos haluat käyttää näiden ei-tuettujen kenttien tietoja työnkulussasi, sinun on käytettävä Lähetä HTTP-pyyntö -toimintoa.

Muuttujan luominen argumentin sisältävästä kentästä

Voit luoda Shopify Flow'ssa muuttujan mille tahansa tuetulle kentälle, joka edellyttää argumenttia. Muuttuja tarvitsee luoda yksittäisessä työnkulussa vain kerran, sillä se on sen jälkeen valittavissa kaikissa työnkulun myöhemmissä vaiheissa.

Luomaasi muuttujaa ei jaeta muiden työnkulkujen kanssa, joten jos haluat käyttää sitä toisessa työnkulussa, sinun on lisättävä se siihen uudelleen.

Vaiheet:

1. Napsauta Shopify Flow -työnkulussa toiminnon tai ehdon kohdalla Lisää muuttuja.
2. Valitse kenttä, joka vaatii argumentin. Näissä kentissä näkyy +-painike. Napsauta sitten + Luo muuttuja.
3. Tee Luo muuttuja -valintaikkunassa seuraavat vaiheet:
   1. Määritä vaaditulle argumentille arvo valitsemasi kentän perusteella.
   2. Valinnainen: Muokkaa uuden muuttujan nimeä Uuden muuttujan nimi -kentässä. Tämä nimi koskee vain nykyistä työnkulkua.
   3. Päivitä muuttujien valintapaneeli napsauttamalla Lisää.

Kun olet lisännyt uuden muuttujan työnkulkuun, se on edelleen käytettävissä kenttävalintana ja voit viitata siihen nopeasti myöhemmissä vaiheissa. Kun valitset Lisää muuttuja, se näkyy kenttäluettelossa sisennettynä alkuperäisen kenttävalinnan alle.

Muuttujan luominen metakentästä Shopify Flow'ssa

Metakentät ovat muuttujatyyppi, jolla on argumentteja vaativia kenttiä. Metakentän tietojen hakeminen Shopify Flow -työnkulussa eroaa hieman vakiokenttien tietojen hakemisesta muissa muuttujissa, koska luot ja määrität itse metakentän namespace- ja key-kenttien arvot, joten ne ovat aina yksilöllisiä kaupallesi.

Esimerkiksi kenttä product.inCollection vaatii aina id-argumentin riippumatta siitä, missä kaupassa työskentelet. Koska kuitenkin määrität nimiavaruuden ja avaimen jokaiselle kauppaasi luomallesi metakentälle, vaaditut argumentit ovat mukautettuja. Esimerkiksi kesävaatteen hoito-ohjeet tallentavan tuotemetakentän muuttuja voisi olla product.careGuideSummer.value, tai tuotteen ikäryhmän tunnuksen tallentavan tuotemetakentän muuttuja voisi olla product.ageGroup.value_item.taxonomyReference.id. Kenttien nimet ja argumentit ovat täysin sinun päätettävissäsi.

Lue lisää metakentistä Shopify Flow'ssa.