API laukų su argumentais naudojimas programėlėje Shopify Flow kuriant kintamuosius

Kai kuriems kintamiesiems reikia papildomų parametrų, kad jie tinkamai veiktų Shopify Flow darbo eigoje. Šie parametrai yra argumentai, kurių reikšmes turite nurodyti, kad kintamasis būtų laikomas išbaigtu ir tinkamu naudoti darbo eigoje.

Pavyzdžiui, laukas product.inCollection nustato, ar produktas yra nurodytoje kolekcijoje, ir grąžina loginę reikšmę true arba false. Tačiau šiam laukui turi būti įtrauktas kolekcijos id argumentas, nes kitaip kintamasis nežinos, kurią konkrečią kolekciją reikia patikrinti. Norėdami tinkamai naudoti lauką, argumentą turite įtraukti kaip lauko dalį. Pavyzdžiui, pateikus užklausą product.inCollection(id: "gid://shopify/Collection/123456"), programėlė Flow gali nustatyti, ar produktas yra kolekcijoje, kurios ID yra 123456, ir tuomet grąžinti true arba false. Kuriant kintamuosius programėlėje Shopify Flow, jums nereikia ieškoti tokių reikšmių, kaip produkto ar kolekcijos ID. Programėlėje Flow pateikiamas išteklių rinkėjas, leidžiantis pasirinkti norimą reikšmę, o ID užpildomas automatiškai.

Norėdami supaprastinti laukų su argumentais užklausų pateikimą, kintamajam, kurį programėlėje Shopify Flow sukuriate iš lauko ir argumento, galite priskirti naują pavadinimą. Pavyzdžiui, jei kolekcijos, kurios ID yra 123456, pavadinimas yra Summer Bestsellers, kintamajam inCollection(id: "gid://shopify/Collection/123456") galite priskirti paprastesnį pavadinimą inSummerBestsellers. Tuomet visuose vėlesniuose darbo eigos žingsniuose galėsite tiesiog naudoti kintamąjį product.inSummerBestsellers.

Kadangi argumentai skiriasi priklausomai nuo to, kokios reikšmės jiems priskiriamos, iš vieno lauko, kuriam reikia argumentų, galite sukurti kelis naujus kintamuosius. Pavyzdžiui, iš vieno product.inCollection lauko galite sukurti 3 unikalius kintamuosius:

• product.inCollection(id: "gid://shopify/Collection/123456") galėtų būti product.inSummerBestsellers.
• product.inCollection(id: "gid://shopify/Collection/654321") galėtų būti product.inSwimwear.
• product.inCollection(id: "gid://shopify/Collection/112233") galėtų būti product.inBeachAccessories.

Palaikomi GraphQL Admin API laukai programėlėje Shopify Flow

Programėlė Shopify Flow palaiko šiuos GraphQL Admin API laukus su būtinaisiais argumentais:

• 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 tipo laukų, tokių kaip collection.translations ir product.translations

Nepalaikomi GraphQL Admin API laukai programėlėje Shopify Flow

Programėlė Shopify Flow nepalaiko šių laukų:

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

Norėdami naudoti duomenis iš šių nepalaikomų laukų savo darbo eigoje, turite naudoti veiksmą Siųsti HTTP užklausą.

Kintamojo kūrimas iš lauko su argumentu

Programėlėje Shopify Flow galite sukurti kintamąjį bet kokiam palaikomam laukui, kuriam reikia argumento. Kintamąjį vienoje darbo eigoje reikia sukurti tik kartą, nes jis išlieka pasiekiamas kaip parinktis visuose tolesniuose darbo eigos žingsniuose.

Jūsų sukurtas kintamasis nėra bendrinamas su jokiomis kitomis darbo eigomis, todėl norėdami jį naudoti kitoje darbo eigoje, turite jį ten pridėti dar kartą.

Žingsniai:

1. „Shopify Flow“ darbo eigoje veiksmo ar sąlygos skiltyje spustelėkite Pridėti kintamąjį.
2. Pasirinkite lauką, kuriam reikalingas argumentas. Prie šių laukų rodomas mygtukas +. Tada spustelėkite + Sukurti kintamąjį.
3. Dialogo lange „ Sukurti kintamąjį “ atlikite šiuos veiksmus:
   1. Pagal pasirinktą lauką nustatykite reikiamo argumento vertę.
   2. Pasirenkama: lauke Naujo kintamojo pavadinimas galite tinkinti naujo kintamojo pavadinimą. Šis pavadinimas taikomas tik dabartinei darbo eigai.
   3. Spustelėkite Pridėti, kad atnaujintumėte kintamųjų pasirinkimo skydelį.

Pridėjus naują kintamąjį į darbo eigą, jis išlieka pasiekiamas kaip lauko parinktis ir vėlesniuose žingsniuose galite greitai juo remtis. Pasirinkus Pridėti kintamąjį, laukų sąraše jis rodomas įdėtas po pradine lauko parinktimi.

Kintamojo kūrimas iš metalauko programėlėje „Shopify Flow“

Metalaukai yra kintamųjų tipas su laukais, kuriems reikalingi argumentai. Metalauko duomenų gavimas „Shopify Flow“ darbo eigoje šiek tiek skiriasi nuo standartinių laukų duomenų gavimo kituose kintamuosiuose, nes Jūs sukuriate ir apibrėžiate metalauko namespace ir key laukų vertes, todėl jos visada yra unikalios Jūsų parduotuvei.

Pavyzdžiui, laukui product.inCollection visada reikalingas argumentas id, neatsižvelgiant į tai, kurioje parduotuvėje dirbate. Tačiau, kadangi kiekvienam parduotuvėje kuriamam metalaukui Jūs nustatote vardų sritį ir raktą, reikalingi argumentai yra pritaikyti. Taigi, produkto metalauko kintamasis, fiksuojantis vasarinių drabužių priežiūros instrukcijas, gali būti product.careGuideSummer.value, o produkto metalauko kintamasis, nurodantis amžiaus grupės, kuriai skirtas produktas, ID, gali būti product.ageGroup.value_item.taxonomyReference.id. Laukų pavadinimus ir argumentus visiškai nustatote Jūs.

Sužinokite daugiau apie metalaukus programėlėje „Shopify Flow“.