Извличане на данни за колекция
В работни процеси, които изискват данни за колекция, можете да използвате действието „Извличане на данни за колекция“ за извличане на информация за колекции от Вашия магазин.
На тази страница
Конфигурация
Полета
Действието „Извличане на данни за колекция“ съдържа следните полета.
| Поле | Описание |
|---|---|
| Сортиране на данни по | Задължително. Параметрите, по които се сортират данните, върнати от заявката за търсене. |
| Максимален брой резултати | Задължително. Максималният брой резултати, които могат да бъдат върнати от избраната от Вас заявка за търсене. Можете да върнете до 100 наведнъж. |
| Заявка | Задължително. Изберете от често срещани заявки или изберете Разширени, за да създадете своя собствена. |
Низ на заявка
Това е примерна заявка за получаване на колекции, които са били актуализирани през последния ден:
updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'Променливата updated_at е филтър, наличен в заявката за колекции, и може да се използва многократно или в комбинация с други променливи. Променливата на Liquid scheduledAt е налична в работни процеси, които използват тригера по зададено време. Тагът на Liquid date_minus е специален таг на Flow, който Ви позволява да изваждате време от дата.
Когато правите заявки за данни, е полезно да знаете:
- Списък с налични филтри за колекции
- Заявките трябва да следват определен синтаксис
- Стойностите на полетата за заявки невинаги са документирани. В някои случаи стойностите могат да бъдат намерени, като прегледате документацията на API. Алтернативно, често можете да намерите стойностите на полетата в URL адресите в администраторския панел, когато прилагате филтри. Например, за да намерите някои стойности на заявки за поръчки, филтрирайте страницата „Поръчки“ в администраторския панел и след това проверете URL адреса.
- Можете да изпълните или тествате заявка във Вашия магазин, като използвате приложението Shopify GraphiQL.
- Имайте предвид какво се случва, ако заявката Ви е неуспешна. Често API ще върне всички резултати (вместо нито един).
Върнати данни
Всички действия от тип Извличане на данни връщат списък с от 0 до 100 ресурса. В зависимост от Вашия случай на употреба, може да искате да използвате тези данни по различни начини:
- Ако трябва да обработвате всеки елемент от списъка поотделно, например за да добавите таг към всеки, тогава можете да използвате действието За всеки.
- Ако трябва да обобщите данни, например да преброите колко резултата са върнати, тогава можете да използвате действията Преброяване или Сумиране.
- Ако трябва да изведете списъка, например за да изпратите имейл с всички артикули, тогава можете да използвате върнатите данни директно в последващи действия.
За достъп до върнатите данни в стъпки, които следват това действие, използвайте променливата с име Извличане на данни за колекция, която представлява списък с колекции. Можете да използвате тази променлива както в условия, така и в действия. Например можете да изпратите списъка с колекции в действие Изпращане на вътрешен имейл по следния начин:
{% for single_collection in GetCollectionData %}
* {{ single_collection.title }}
{% endfor %}Тригери
Можете да използвате това действие във всеки работен процес, включително тригера По зададено време. В работен процес, който използва тригера По зададено време, работният процес започва във време, което сте посочили, а не в резултат на събитие. Тъй като няма конкретно събитие във Вашия магазин или от приложение, което да стартира работния процес, няма автоматично включени данни.