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

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

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

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

Полета

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

Низ на заявка

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

created_at:<='{{ scheduledAt }}' AND created_at:>'{{ scheduledAt | date_minus: "1 day" }}'

Променливата created_at е филтър, наличен в заявката за подаръчни карти, и може да се използва многократно или да се комбинира с други променливи. Променливата на Liquid scheduledAt е налична в работни процеси, които използват тригера „Планирано време“. Тагът на Liquid date_minus е специален таг на Flow, който ви позволява да изваждате време от дата.

При отправяне на заявка за данни е полезно да знаете:

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

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

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

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

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

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

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

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

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

{% for single_gift_card in GetGiftCardData %}
* {{ single_gift_card.name }}
{% endfor %}

Тригери

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

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

• Ресурс за подаръчна карта
• Филтри за заявка за подаръчна карта