Извличане на данни за каталог

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

Забележка

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

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

Полета

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

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

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

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

Това е примерна заявка за извличане на всички активни каталози:

status:ACTIVE

Променливата status е филтър, наличен в заявката за каталози, и може да се използва многократно или да се комбинира с други променливи.

Когато извличате данни чрез заявки, е полезно да знаете следното:

• Списък с налични филтри за каталози

• Заявките трябва да следват определен синтаксис

• Стойностите на полетата на заявката не винаги са документирани. В някои случаи стойностите могат да бъдат намерени, като прегледате документацията на API. Алтернативно, често можете да намерите стойностите на полетата в URL адресите в администраторския панел, когато филтрирате. Например, за да намерите някои стойности на заявка за поръчка, филтрирайте страницата „Поръчки“ в администраторския панел и след това проверете URL адреса.

• Можете да изпълните или тествате заявка във Вашия магазин, като използвате приложението Shopify GraphiQL.

• Имайте предвид какво се случва, ако заявката Ви е неуспешна. Често API връща всички резултати (вместо нито един).

Върнати данни

Всички действия от типа Извличане на данни връщат списък с от 0 до 100 ресурса. В зависимост от Вашия случай на употреба, може да искате да използвате тези данни по различни начини:

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

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

{% for single_catalog in getCatalogData %}
  * {{ single_catalog.title }}
{% endfor %}

Забележка

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

Тригери

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

Справка за API

За повече информация относно API, използван в това действие, вижте заявката за каталози.