Получить данные страницы

В рабочих процессах, требующих данных страницы, можно использовать действие Получить данные страницы, чтобы извлечь информацию о странице из вашего магазина. Страницы — это веб-страницы в вашем интернет-магазине, которые содержат редко изменяющуюся информацию, например страницы «О нас» или «Контакты».

Примечание

Это тип действия Получить данные. Чтобы понять, как использовать этот тип действия с триггером Запланированное время и циклами Для каждого, обратитесь к разделу Расписания, получение данных и циклические рабочие процессы в Shopify Flow.

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

Поля

Действие Получить данные страницы содержит следующие поля:

Поля, используемые в действиях «Получить данные».

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

Строка запроса

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

published_status:published

Переменная published_status — это фильтр, доступный в запросе страниц, который можно использовать несколько раз или комбинировать с другими переменными.

При запросе данных полезно знать следующее:

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

• Запросы должны следовать определенному синтаксису

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

• Вы можете выполнить или протестировать запрос в своем магазине с помощью приложения Shopify GraphiQL.

• Учитывайте, что произойдет в случае сбоя запроса. Часто API возвращает все результаты (вместо того чтобы не возвращать ничего).

Возвращенные данные

Все действия Получить данные возвращают список, содержащий от 0 до 100 ресурсов. В зависимости от вашего сценария использования вы можете применять эти данные различными способами:

• Если вам нужно обработать каждый элемент списка по отдельности, например добавить тег для каждого из них, вы можете использовать действие Для каждого.
• Если вам нужно агрегировать данные, например подсчитать количество возвращенных результатов, вы можете использовать действия Количество или Сумма.
• Если вам нужно вывести список, например, чтобы отправить по электронной почте все элементы, вы можете использовать возвращенные данные напрямую в последующих действиях.

Чтобы получить доступ к возвращенным данным в шагах, следующих за этим действием, используйте переменную Получить данные страницы, которая представляет собой список страниц. Эту переменную можно использовать как в условиях, так и в действиях. Например, вы можете отправить список страниц в действии Отправить внутреннее электронное письмо следующим образом:

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

Примечание

Если действие Получить данные используется несколько раз в одном рабочем процессе, к имени переменной добавляется число. Например, в рабочем процессе, где действие Получить данные заказа используется дважды, первой переменной для возвращенных данных будет getOrderData, а второй — getOrderData1. Это имя нельзя изменить.

Триггеры

Это действие можно использовать в любом рабочем процессе, включая триггер Запланированное время. В рабочем процессе, использующем триггер Запланированное время, рабочий процесс запускается в указанное вами время, а не в результате какого-либо события. Поскольку в вашем магазине или из приложения не происходит конкретного события, запускающего рабочий процесс, данные не включаются автоматически.

Справочник API

Дополнительную информацию об API, используемом в этом действии, см. в запросе страниц.