Использование полей 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 называется Summer Bestsellers, то переменной 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.