Извличане на записи на метаобекти

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

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

Полета

Действието Извличане на записи на метаобекти съдържа падащо меню за указване на дефиницията на метаобекта, както и следните полета, които се използват за съставяне на заявката:

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

Това е примерна заявка за получаване на записи на метаобекти, ако стойността на полето 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

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