Отримати дані каталогу

У робочих процесах, які потребують даних каталогу, можна використовувати дію Отримати дані каталогу, щоб отримувати з магазину інформацію про каталог B2B. Каталоги — це групи товарів із персоналізованим ціноутворенням для певних B2B-клієнтів або розташувань компанії.

Примітка

Це дія типу Отримати дані. Щоб дізнатися, як використовувати цей тип дії з тригером Запланований час і циклами перебору Для кожного, перегляньте статтю Розклади, отримання даних і цикли в робочих процесах Shopify Flow.

Налаштування

Поля

Дія Отримати дані каталогу містить такі поля:

Поля, що використовуються в діях отримання даних.

Поле	Опис
Сортувати дані за	Обов'язкове поле. Параметри, за якими сортуються дані, повернені пошуковим запитом.
Максимальна кількість результатів	Обов'язкове поле. Максимальна кількість результатів, які може повернути вибраний пошуковий запит. Одночасно можна повернути до 100 результатів.
Запит	Обов'язкове поле. Виберіть один зі стандартних запитів або натисніть Додатково, щоб створити власний.

Рядок запиту

Це приклад запиту для отримання всіх активних каталогів:

status:ACTIVE

Змінна status — це фільтр, доступний для запиту Catalogs, який можна використовувати кілька разів або поєднувати з іншими змінними.

Під час запиту даних корисно знати таке:

• Список доступних фільтрів каталогів

• Запити мають відповідати певному синтаксису

• Значення полів запиту не завжди задокументовані. У деяких випадках значення можна знайти, переглянувши документацію щодо API. Крім того, часто можна знайти значення полів в URL-адресах на панелі адміністрування під час фільтрування. Наприклад, щоб знайти деякі значення для запиту в розділі «Замовлення», відфільтруйте сторінку «Замовлення» на панелі адміністрування, а потім перевірте URL-адресу.

• Ви можете запустити або перевірити запит у своєму магазині, використовуючи застосунок Shopify GraphiQL.

• Пам'ятайте про те, що станеться в разі збою запиту. Часто API повертає всі результати (замість жодного).

Повернені дані

Усі дії отримання даних повертають список від 0 до 100 ресурсів. Залежно від варіанта використання ви можете працювати з цими даними по-різному:

• Якщо потрібно обробляти кожен елемент списку окремо, наприклад додати тег для кожного, можна використати дію Для кожного.
• Якщо вам потрібно звести дані, наприклад, підрахувати кількість отриманих результатів, ви можете використати дії Підрахунок або Сума.
• Якщо потрібно вивести список, наприклад, надіслати електронний лист з усіма елементами, ви можете використовувати отримані дані безпосередньо в наступних діях.

Щоб отримати доступ до повернених даних у кроках, що йдуть після цієї дії, використовуйте змінну Get catalog data (Отримати дані каталогу), яка містить список каталогів. Ви можете використовувати цю змінну як в умовах, так і в діях. Наприклад, ви можете надіслати список каталогів у дії Надіслати внутрішній електронний лист приблизно так:

{% for single_catalog in getCatalogData %}
  * {{ single_catalog.title }}
{% endfor %}

Примітка

Якщо дія отримання даних використовується кілька разів в одному робочому процесі, до назви змінної додається число. Наприклад, у робочому процесі, який використовує дію Get order data (Отримати дані замовлення) двічі, першою змінною для повернених даних буде getOrderData, а другою — getOrderData1. Цю назву змінити неможливо.

Тригери

Цю дію можна використовувати в будь-якому робочому процесі, включно з тригером Запланований час. У робочому процесі, який використовує тригер Запланований час, запуск відбувається у визначений вами час, а не внаслідок певної події. Оскільки немає конкретної події в магазині або із застосунку, яка запускала б робочий процес, жодні дані не додаються автоматично.

Довідник з API

Додаткову інформацію про API, що використовується в цій дії, див. у розділі Запит каталогів.