Извличане на данни за местоположение

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

Бележка

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

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

Полета

Действието Извличане на данни за местоположение съдържа следните полета.

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

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

Низ на заявка

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

pickup_in_store:enabled

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

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

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

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

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

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

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

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

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

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

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

{% for single_location in GetLocationData %}
* {{ single_location.id }}
{% endfor %}

Бележка

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

Тригери

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

Справка за API

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