Помощ
Влизане

Извличане на данни за договор за абонамент

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

На тази страница

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

Полета

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

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

Низ на заявка

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

status: ACTIVE

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

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

  • Списък с налични филтри
  • Заявките трябва да следват определен синтаксис
  • Стойностите на полетата за заявки невинаги са документирани. В някои случаи стойностите могат да бъдат намерени, като прегледате документацията на API. Алтернативно, често можете да намерите стойностите на полетата в URL адресите в администраторския панел, когато филтрирате. Например, за да намерите някои стойности за заявка за поръчка, филтрирайте страницата „Поръчки“ в администраторския панел и след това проверете URL адреса.
  • Можете да изпълните или тествате заявка във Вашия магазин, като използвате приложението Shopify GraphiQL app.
  • Имайте предвид какво се случва, ако заявката Ви е неуспешна. Често API ще върне всички резултати (вместо нито един).

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

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

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

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

{% for single_contract in GetSubscriptionContractData %}
* {{ single_contract.name }}
{% endfor %}

Тригери

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

API справка