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

Получаване на данни за статия

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

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

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

Полета

Действието Получаване на данни за статия съдържа следните полета:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

{% for single_article in GetArticleData %}
    * {{ single_article.title }}
    {% endfor %}

Тригери

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

Справка за API

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