Argumentumokkal rendelkező API-mezők használata a Shopify Flow-ban változók létrehozásához

Bizonyos változók további paramétereket igényelnek ahhoz, hogy megfelelően működjenek egy Shopify Flow-munkafolyamatban. Ezek a paraméterek olyan argumentumok, amelyek értékét meg kell adnia, mielőtt a változó teljessé és a munkafolyamat számára használhatóvá válna.

Például a product.inCollection mező határozza meg, hogy egy termék szerepel-e egy adott kollekcióban, és logikai (Boolean) true (igaz) vagy false (hamis) eredményt ad vissza. A kollekció id argumentumát azonban meg kell adni ennél a mezőnél, mert ellenkező esetben a változó nem fogja tudni, hogy konkrétan melyik kollekciót kell vizsgálnia. A mező megfelelő használatához az argumentumot a mező részeként kell szerepeltetnie. Például, ha a product.inCollection(id: "gid://shopify/Collection/123456") lekérdezést futtatja, a Flow meg tudja határozni, hogy a termék az 123456 azonosítójú kollekcióban található-e, és az elvárásoknak megfelelően a true vagy a false értéket adja vissza. Amikor a Shopify Flow-ban változókat hoz létre, nem kell olyan értékeket keresnie, mint a termék- vagy kollekcióazonosítók. A Flow egy erőforrás-választót biztosít a kívánt érték megadásához, az azonosító kitöltése pedig automatikusan megtörténik.

Az argumentumokkal rendelkező mezők lekérdezésének egyszerűsítése érdekében a Shopify Flow-ban a mezőből és az argumentumból létrehozott változóhoz egy új változónevet is hozzárendelhet. Például, ha az 123456 azonosítójú kollekció neve Summer Bestsellers, akkor az inCollection(id: "gid://shopify/Collection/123456") változónak az egyszerűbb inSummerBestsellers nevet is adhatja. Ezt követően a munkafolyamat összes további lépésében elegendő a product.inSummerBestsellers változót használnia.

Mivel az argumentumok a hozzájuk rendelt értékektől függően eltérőek, egyetlen, argumentumot igénylő mezőből több új változót is létrehozhat. Például, csak a product.inCollection mezőből is létrehozhat 3 egyedi változót:

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

A Shopify Flow által támogatott GraphQL Admin API-mezők

A Shopify Flow a GraphQL Admin API következő, kötelező argumentumokkal rendelkező mezőit támogatja:

• 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 darab translations típusú mező, mint például a collection.translations és a product.translations

A Shopify Flow által nem támogatott GraphQL Admin API-mezők

A Shopify Flow a következő mezőket nem támogatja:

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

Ha e nem támogatott mezők adatait szeretné használni a munkafolyamatban, a HTTP-kérés küldése műveletet kell használnia.

Változó létrehozása argumentummal rendelkező mezőből

A Shopify Flow-ban bármilyen támogatott, argumentumot igénylő mezőhöz létrehozhat változót. A változót egy adott munkafolyamatban csak egyszer kell létrehoznia, mivel ez a munkafolyamat összes további lépésében elérhető lehetőségként megmarad.

A létrehozott változó nem osztható meg más munkafolyamatokkal, így ha egy másik munkafolyamatban szeretné használni, abban a másik munkafolyamatban ismét hozzá kell adnia.

Lépések:

1. Egy Shopify Flow-munkafolyamatban kattintson a Változó hozzáadása gombra egy műveletben vagy feltételben.
2. Válasszon ki egy olyan mezőt, amelyhez argumentum szükséges. Ezeknél a mezőknél egy + gomb látható. Ezután kattintson a + Változó létrehozása gombra.
3. A(z) Változó létrehozása párbeszédpanelen hajtsa végre a következő lépéseket:
   1. A kiválasztott mező alapján állítson be egy értéket a kötelező argumentumhoz.
   2. Opcionális: Az Új változó neve mezőben testreszabhatja, hogyan is nevezzék az új változót. Ez a név csak az aktuális munkafolyamatra vonatkozik.
   3. A változóválasztó panel frissítéséhez kattintson a Hozzáadás gombra.

Miután hozzáadta az új változót egy munkafolyamathoz, a változó továbbra is elérhető marad mezőopcióként, és a későbbi lépésekben gyorsan hivatkozhat rá. A Változó hozzáadása lehetőség választásakor ez az eredeti mezőopció alatt egymásba ágyazva jelenik meg a mezők listájában.

Változó létrehozása egy metamezőből a Shopify Flow alkalmazásban

A metamezők egy olyan típusú változók, amelyek argumentumokat igénylő mezőkkel rendelkeznek. A metamezőadatok lekérése egy Shopify Flow-munkafolyamatban némileg eltér a normál mezőadatok lekérésétől más változók esetében, mivel Ön hozza létre és határozza meg a metamező namespace és key mezőértékeit, így azok mindig egyediek az üzletében.

Például a product.inCollection mező mindig az id argumentumot igényli, függetlenül attól, hogy melyik üzletben dolgozik. Mivel azonban Ön állítja be a névteret és a kulcsot minden olyan metamezőhöz, amelyet az üzletében hoz létre, a kötelező argumentumok egyediek lesznek. Így egy termékmetamezőhöz tartozó változó, amely egy nyári ruházati termék kezelési útmutatóját rögzíti, a product.careGuideSummer.value is lehet, vagy egy termékmetamező változója, amely a termékhez tartozó korcsoport azonosítóját rögzíti, lehet a product.ageGroup.value_item.taxonomyReference.id. A mezőneveket és az argumentumokat teljes egészében Ön határozza meg.

További információ a Shopify Flow metamezőiről.