Používanie polí API s argumentmi v Shopify Flow na vytváranie premenných

Niektoré premenné vyžadujú dodatočné parametre, aby v pracovnom postupe Shopify Flow fungovali správne. Tieto parametre sú argumenty, pri ktorých musíte deklarovať ich hodnoty, aby sa premenná považovala za úplnú a mohla sa použiť v pracovnom postupe.

Napríklad pole product.inCollection určuje, či sa produkt nachádza v zadanej kolekcii, a vracia booleovský výsledok true alebo false. V prípade tohto poľa však musí byť zahrnutý argument kolekcie id, inak by premenná nevedela, ktorú konkrétnu kolekciu má skontrolovať. Ak chcete pole používať správne, musíte argument zahrnúť ako súčasť poľa. Dopyt product.inCollection(id: "gid://shopify/Collection/123456") napríklad umožní, aby aplikácia Flow zistila, či sa produkt nachádza v kolekcii s ID 123456, a potom podľa očakávania vrátila výsledok true alebo false. Pri vytváraní premenných v Shopify Flow nemusíte vyhľadávať hodnoty, ako sú ID produktov alebo kolekcií. Aplikácia Flow poskytuje výber zdroja, pomocou ktorého môžete vybrať požadovanú hodnotu, pričom sa ID vyplní automaticky.

Ak si chcete zjednodušiť dopytovanie polí s argumentmi, môžete premennej vytvorenej z poľa a argumentu v Shopify Flow priradiť nový názov. Ak je napríklad názov kolekcie s ID 123456 Summer Bestsellers, premennej inCollection(id: "gid://shopify/Collection/123456") môžete priradiť jednoduchší názov inSummerBestsellers. Vo všetkých nasledujúcich krokoch pracovného postupu už potom môžete jednoducho použiť premennú product.inSummerBestsellers.

Keďže argumenty sa líšia v závislosti od hodnôt, ktoré sú k nim priradené, z jedného poľa vyžadujúceho argumenty môžete vytvoriť viacero nových premenných. Zo samotného poľa product.inCollection by ste napríklad mohli vytvoriť 3 jedinečné premenné:

• product.inCollection(id: "gid://shopify/Collection/123456") by mohlo byť product.inSummerBestsellers.
• product.inCollection(id: "gid://shopify/Collection/654321") by mohlo byť product.inSwimwear.
• product.inCollection(id: "gid://shopify/Collection/112233") by mohlo byť product.inBeachAccessories.

Podporované polia rozhrania GraphQL Admin API v aplikácii Shopify Flow

Aplikácia Shopify Flow podporuje v rozhraní GraphQL Admin API nasledujúce polia s povinnými argumentmi:

• 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 polí typu translations, napríklad collection.translations a product.translations

Nepodporované polia rozhrania GraphQL Admin API v aplikácii Shopify Flow

Aplikácia Shopify Flow nepodporuje nasledujúce polia:

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

Ak chcete v pracovnom postupe použiť údaje z týchto nepodporovaných polí, musíte použiť akciu Odoslať požiadavku HTTP.

Vytvorenie premennej z poľa s argumentom

V aplikácii Shopify Flow môžete vytvoriť premennú pre ľubovoľné podporované pole, ktoré vyžaduje argument. V rámci jedného pracovného postupu stačí premennú vytvoriť len raz, pretože zostane k dispozícii ako možnosť vo všetkých nasledujúcich krokoch daného pracovného postupu.

Vami vytvorená premenná sa nezdieľa s inými pracovnými postupmi. Ak ju chcete použiť v inom pracovnom postupe, musíte ju doň pridať znova.

Postup:

1. V pracovnom postupe Shopify Flow kliknite v rámci akcie alebo podmienky na možnosť Pridať premennú.
2. Vyberte pole, ktoré vyžaduje argument. Pri týchto poliach sa zobrazuje tlačidlo +. Potom kliknite na možnosť + Vytvoriť premennú.
3. V dialógovom okne Vytvoriť premennú postupujte takto:
   1. Na základe vybratého poľa nastavte hodnotu pre požadovaný argument.
   2. Voliteľné: V poli Názov novej premennej si upravte názov novej premennej. Tento názov platí len pre aktuálny pracovný postup.
   3. Kliknutím na Pridať obnovte panel výberu premenných.

Po pridaní novej premennej do pracovného postupu zostane táto premenná k dispozícii ako jedna z možností poľa a v nasledujúcich krokoch na ňu môžete rýchlo odkazovať. Pri výbere možnosti Pridať premennú sa zobrazí vnorená pod pôvodnou možnosťou poľa v zozname polí.

Vytvorenie premennej z metapoľa v aplikácii Shopify Flow

Metapolia sú typom premennej s poľami, ktoré vyžadujú argumenty. Získavanie údajov metapoľa v pracovnom postupe Shopify Flow sa mierne líši od získavania údajov štandardného poľa v iných premenných, pretože vy vytvárate a definujete hodnoty polí namespace a key pre dané metapole, takže sú pre váš obchod vždy jedinečné.

Napríklad pole product.inCollection vždy vyžaduje argument id bez ohľadu na to, v ktorom obchode pracujete. Keďže však pre každé metapole, ktoré vo svojom obchode vytvoríte, nastavujete menný priestor a kľúč vy, požadované argumenty sú vlastné. Takže premenná pre produktové metapole s pokynmi na údržbu letného oblečenia môže byť product.careGuideSummer.value, alebo premenná pre produktové metapole so záznamom o ID vekovej skupiny, pre ktorú je produkt určený, môže byť product.ageGroup.value_item.taxonomyReference.id. Názvy polí a argumenty určujete výlučne vy.

Ďalšie informácie o metapoliach v aplikácii Shopify Flow.