Получить записи метаобъекта

С помощью действия «Получить записи метаобъекта» можно извлечь из вашего магазина список записей для метаобъекта на основе необязательного запроса. Дополнительную информацию см. в документации по метаобъектам.

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

Поля

Действие «Получить записи метаобъекта» содержит раскрывающийся список для указания определения метаобъекта, а также следующие поля, которые используются для составления запроса:

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

Это пример запроса для получения записей метаобъектов, если значение поля email совпадает с адресом электронной почты в заказе:

{{fields.email}}:"{{order.email}}"

Это пример запроса для получения записей метаобъектов, обновлённых за последний день:

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

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

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

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

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

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

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

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

{% for getMetaobjectEntries_item in getMetaobjectEntries %}
Key-value pairs for entry:
  {% for fields_item in getMetaobjectEntries_item.system.fields %}
    {{fields_item.key}}:{{fields_item.value}}
  {% endfor %}
{% endfor %}

Триггеры

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

Сведения об API

• Ресурс метаобъекта
• Фильтры запросов метаобъектов
• Запрос метаобъектов по значению поля