Отримати дані розташування

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

Примітка

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

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

Поля

Дія Отримати дані розташування містить зазначені нижче поля.

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

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

Рядок запиту

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

pickup_in_store:enabled

Змінна pickup_in_store є фільтром, доступним у запиті щодо розташувань, який можна використовувати кілька разів або поєднувати з іншими змінними.

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

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

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

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

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

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

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

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

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

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

{% for single_location in GetLocationData %}
* {{ single_location.id }}
{% endfor %}

Примітка

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

Тригери

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

Довідник з API

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