Извличане на данни за чернова на поръчка

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

Бележка

Това е тип действие „Извличане на данни“. За да разберете как да използвате този тип действие с тригера „Планирано време“ и циклите „За всеки“, вижте Графици, извличане на данни и циклични работни процеси в Shopify Flow.

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

Полета

Действието „Извличане на данни за чернова на поръчка“ съдържа следните полета, които се използват за съставяне на заявката:

Полета, използвани в действията за извличане на данни.

Поле	Описание
Сортиране на данни по	Задължително. Параметрите, по които се сортират данните, върнати от заявката за търсене.
Максимален брой резултати	Задължително. Максималният брой резултати, които могат да бъдат върнати от избраната от Вас заявка за търсене. Можете да върнете до 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 ресурса. В зависимост от Вашия случай на употреба може да искате да използвате тези данни по различни начини:

• Ако трябва да обработите всеки елемент от списъка поотделно, например за да добавите таг към всеки, тогава можете да използвате действието „За всеки“.
• Ако трябва да обобщите данни, например да преброите колко резултати са върнати, тогава можете да използвате действията „Преброяване“ или „Сумиране“.
• Ако трябва да изведете списъка, например да изпратите имейл с всички артикули, тогава можете да използвате върнатите данни директно в последващи действия.

За достъп до върнатите данни в стъпките, които следват това действие, използвайте променливата с име Get draft order data, която представлява списък с чернови на поръчки. Можете да използвате тази променлива както в условия, така и в действия. Например можете да изпратите списъка с чернови на поръчки в действие „Изпращане на вътрешен имейл“ по следния начин:

{% for single_order in GetDraftOrderData %}
* {{ single_order.name }}
{% endfor %}

Бележка

Ако дадено действие „Извличане на данни“ се използва няколко пъти в един работен процес, тогава към името на променливата се добавя число. Например в работен процес, който използва действието „Извличане на данни за поръчка“ два пъти, първата променлива за върнати данни е getOrderData, а втората променлива е getOrderData1. Това име не може да бъде персонализирано.

Тригери

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

Подробности за API

• Ресурс Draft Order
• Филтри за заявка на Draft Order

Шаблони

Изпращане на ежедневно известие с всички отворени чернови на поръчки

Всеки ден извличайте отворените чернови на поръчки, преброявайте ги и изпращайте съобщение в Slack. Използва тригера „Планирано време“ и действията „Извличане на чернови на поръчки“ и „Преброяване“. Преглед на шаблона