Отримати дані про статтю

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

Примітка

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

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

Поля

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

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

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

Рядок запиту

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

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

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

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

• Перелік доступних фільтрів для статей

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

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

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

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

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

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

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

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

{% for single_article in GetArticleData %}
    * {{ single_article.title }}
    {% endfor %}

Примітка

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

Тригери

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

Довідка API

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