Извличане на данни за страница

В работни процеси, които изискват данни за страницата, можете да използвате действието Get page data, за да извлечете информация за страница от Вашия магазин. Страниците са уеб страниците във Вашия онлайн магазин, които съдържат информация, която рядко се променя, като например страницата „За нас“ или страницата за контакт.

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

Полета

Действието Get page data съдържа следните полета:

Полета, използвани в действията Get data.
ПолеОписание
Сортиране на данните поЗадължително. Параметрите, по които се сортират данните, върнати от заявката за търсене.
Максимален брой резултатиЗадължително. Максималният брой резултати, които могат да бъдат върнати от избраната от Вас заявка за търсене. Можете да върнете до 100 наведнъж.
ЗаявкаЗадължително. Изберете от често срещаните заявки или изберете Advanced, за да създадете Ваша собствена.

Низ на заявката

Това е примерна заявка за извличане на публикувани страници:

published_status:published

Променливата published_status е филтър, наличен в заявката за страници, и може да се използва многократно или да се комбинира с други променливи.

При заявяване на данни е полезно да знаете следното:

  • Списък с налични филтри за страници

  • Заявките трябва да следват определен синтаксис

  • Стойностите на полетата за заявки невинаги са документирани. В някои случаи стойностите могат да бъдат намерени, като прегледате документацията на API. Като алтернатива, често можете да намерите стойностите на полетата в URL адресите в администраторския панел, когато филтрирате. Например, за да намерите някои стойности на заявки за поръчки, филтрирайте страницата „Поръчки“ в администраторския панел и след това проверете URL адреса.

  • Можете да изпълните или тествате заявка във Вашия магазин, като използвате приложението Shopify GraphiQL.

  • Имайте предвид какво се случва, ако заявката Ви е неуспешна. Често API ще върне всички резултати (вместо нито един).

Върнати данни

Всички действия Get data връщат списък с от 0 до 100 ресурса. В зависимост от Вашия случай на употреба, може да искате да използвате тези данни по различни начини:

  • Ако е необходимо да обработите всеки елемент от списъка поотделно, като например да добавите таг към всеки, можете да използвате действието For each.
  • Ако е необходимо да обобщите данни, като например да преброите колко резултати са върнати, можете да използвате действията Count или Sum.
  • Ако е необходимо да изведете списъка, като например да изпратите имейл с всички артикули, тогава можете да използвате върнатите данни директно в последващи действия.

За достъп до върнатите данни в стъпките, които следват това действие, използвайте променливата с име Get page data, която представлява списък със страници. Можете да използвате тази променлива както в условия, така и в действия. Например, можете да изпратите списъка със страници чрез действие Send internal email по подобен начин:

{% for single_page in getPageData %}
  * {{ single_page.title }} - {{ single_page.handle }}
{% endfor %}

Тригери

Можете да използвате това действие във всеки работен процес, включително и в тригера Scheduled time. В работен процес, който използва тригера Scheduled time, работният процес стартира в определено от Вас време, а не в резултат на събитие. Тъй като няма конкретно събитие във Вашия магазин или от приложение, което да стартира работния процес, няма автоматично включени данни.

Справка за API

За повече информация относно API, използван в това действие, вижте заявката за страници.