Използване на API полета с аргументи в Shopify Flow за създаване на променливи

Някои променливи изискват допълнителни параметри, за да функционират правилно в работен процес в Shopify Flow. Тези параметри са аргументи, които трябва да имат стойности, декларирани от Вас, преди променливата да се счита за завършена и използваема от работния процес.

Например полето product.inCollection определя дали даден продукт е в определена колекция и връща булев резултат true или false. Аргументът id на колекцията обаче трябва да бъде включен за това поле, защото в противен случай променливата няма да знае коя конкретна колекция да провери. За да използвате полето правилно, трябва да включите аргумента като част от полето. Например, заявяване на product.inCollection(id: "gid://shopify/Collection/123456"), така че Flow да може да определи дали продуктът е в колекцията с идентификатор 123456, и след това да върне true или false според очакванията. Когато създавате променливи в Shopify Flow, не е необходимо да търсите стойности като идентификатори на продукти или колекции. Flow предоставя елемент за избор на ресурси, за да изберете желаната стойност, и идентификаторът се попълва автоматично.

За да опростите работата със заявки към полета с аргументи, можете да присвоите ново име на променливата, която създавате от полето и аргумента в Shopify Flow. Например, ако името на колекцията с идентификатор 123456 е Летни бестселъри, тогава бихте могли да присвоите на променливата inCollection(id: "gid://shopify/Collection/123456") по-простото име inSummerBestsellers. След това във всички следващи стъпки на работния процес можете просто да използвате променливата product.inSummerBestsellers.

Тъй като аргументите се различават в зависимост от това какви стойности са им присвоени, можете да създадете няколко нови променливи от едно поле, изискващо аргументи. Например бихте могли да създадете 3 уникални променливи само от полето product.inCollection:

• product.inCollection(id: "gid://shopify/Collection/123456") може да бъде product.inSummerBestsellers.
• product.inCollection(id: "gid://shopify/Collection/654321") може да бъде product.inSwimwear.
• product.inCollection(id: "gid://shopify/Collection/112233") може да бъде product.inBeachAccessories.

Поддържани полета на GraphQL Admin API в Shopify Flow

Shopify Flow поддържа следните полета в GraphQL Admin API със задължителни аргументи:

• 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, като collection.translations и product.translations

Неподдържани полета на GraphQL Admin API в Shopify Flow

Shopify Flow не поддържа следните полета:

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

За да използвате данни от тези неподдържани полета във Вашия работен процес, трябва да използвате действие Изпращане на HTTP заявка.

Създаване на променлива от поле с аргумент

Можете да създадете променлива в Shopify Flow за всяко поддържано поле, което изисква аргумент. Трябва да създадете променливата само веднъж в рамките на един работен процес, тъй като тя остава налична като опция във всички негови следващи стъпки.

Променливата, която създавате, не се споделя с никакви други работни процеси, така че, за да я използвате в друг работен процес, трябва да я добавите отново в него.

Стъпки:

1. В работен процес в Shopify Flow щракнете върху Добавяне на променлива в действие или условие.
2. Изберете поле, което изисква аргумент. Тези полета показват бутон +. След това щракнете върху + Създаване на променлива.
3. В диалоговия прозорец „ Създаване на променлива “, изпълнете следните стъпки:
   1. Въз основа на полето, което сте избрали, задайте стойност за необходимия аргумент.
   2. По избор: В полето Ново име на променлива персонализирайте как искате да се нарича новата променлива. Това име се прилага само за текущия работен процес.
   3. Щракнете върху Добавяне, за да опресните панела за избор на променливи.

След като добавите новата променлива към работен процес, тя остава налична като опция за поле и можете бързо да я реферирате в следващите стъпки. Когато изберете Добавяне на променлива, тя се показва вложена под първоначалната опция за поле в списъка с полета.

Създаване на променлива от метаполе в Shopify Flow

Метаполетата са вид променлива с полета, които изискват аргументи. Получаването на данни от метаполе в работен процес в Shopify Flow се различава леко от получаването на данни от стандартни полета в други променливи, тъй като Вие създавате и дефинирате стойностите на полетата namespace и key на метаполето, така че те винаги са уникални за Вашия магазин.

Например полето product.inCollection винаги изисква аргумента id независимо в кой магазин работите. Тъй като обаче задавате пространството от имена и ключа за всяко метаполе, което създавате в магазина си, необходимите аргументи са персонализирани. Така че променлива за метаполе на продукт, която улавя инструкциите за грижа за продукт от лятното облекло, може да бъде product.careGuideSummer.value, или променлива за метаполе на продукт, която записва идентификатора на възрастовата група, за която е предназначен продуктът, може да бъде product.ageGroup.value_item.taxonomyReference.id. Имената на полетата и аргументите се определят изцяло от Вас.

Научете повече за метаполетата в Shopify Flow.