Довідка
Увійти

Отримати дані чернетки замовлення

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

На цій сторінці

Конфігурація

Поля

Дія Отримати дані чернетки замовлення містить такі поля, що використовуються для створення запиту:

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

Рядок запиту

Це приклад запиту для отримання чернеток замовлень, які були оновлені за останній день:

updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'

Змінна updated_at — це фільтр, доступний у запиті чернеток замовлень, який можна використовувати кілька разів або поєднувати з іншими змінними. Змінна Liquid scheduledAt доступна в робочих процесах, які використовували тригер «Запланований час». Тег Liquid date_minus — це спеціальний тег Flow, який дозволяє віднімати час від дати.

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

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

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

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

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

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

{% for single_order in GetDraftOrderData %}
* {{ single_order.name }}
{% endfor %}

Тригери

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

Відомості про API

Шаблони

Щоденно надсилати сповіщення з усіма відкритими чернетками замовлень

Щодня отримувати відкриті чернетки замовлень, підраховувати їх і надсилати повідомлення у Slack. Використовує тригер «Запланований час», а також дії «Отримати чернетки замовлень» і «Підрахувати». Переглянути шаблон