Dohvati podatke o članku

U tijekovima rada za koje su potrebni podaci za članak na blogu, možete upotrijebiti radnju Dohvati podatke o članku da biste dohvatili informacije o članku iz svoje trgovine Shopify.

Konfiguracija

Polja

Radnja Dohvati podatke o članku sadrži sljedeća polja:

Polja koja se upotrebljavaju u radnjama Dohvati podatke.
PoljeOpis
Razvrstaj podatke premaObavezno. Parametri prema kojima se razvrstavaju podaci vraćeni upitom za pretraživanje.
Maksimalan broj rezultataObavezno. Maksimalan broj rezultata koje odabrani upit za pretraživanje može vratiti. Moguće je vratiti najviše 100 odjednom.
UpitObavezno. Odaberite jedan od uobičajenih upita ili odaberite Napredno kako biste izradili vlastiti.

Niz upita

Ovo je primjer upita za dohvaćanje članaka objavljenih tijekom proteklog dana:

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

Varijabla published_at jest filtar dostupan za Upit o člancima i može se upotrijebiti više puta ili u kombinaciji s drugim varijablama. Varijabla Liquid scheduledAt dostupna je za tijekove rada koji se koriste pokretačem Zakazano vrijeme. Oznaka Liquid date_minus posebna je oznaka za aplikaciju Flow kojom se omogućuje oduzimanje vremena od datuma.

Prilikom postavljanja upita o podacima korisno je znati sljedeće:

  • Popis dostupnih filtara članaka

  • Upiti se moraju pridržavati određene sintakse

  • Vrijednosti polja upita nisu uvijek dokumentirane. U nekim se slučajevima te vrijednosti mogu pronaći pregledom dokumentacije za API. S druge strane, tijekom filtriranja vrijednosti polja često možete pronaći i u URL-ovima na administratorskoj ploči. Na primjer, kako biste pronašli neke vrijednosti upita za narudžbe, filtrirajte stranicu Narudžbe na administratorskoj ploči, a zatim provjerite URL.

  • U svojoj trgovini možete pokrenuti ili testirati upit upotrebom aplikacije Shopify GraphiQL.

  • Imajte na umu što se događa ako vaš upit ne uspije. Često će API vratiti sve rezultate (umjesto nijednog).

Vraćeni podaci

Sve radnje Dohvati podatke vraćaju popis s bilo kojim brojem resursa od 0 do 100. Ovisno o vašem slučaju upotrebe, ove ćete podatke možda htjeti upotrijebiti na različite načine:

  • Ako svakom stavkom na popisu morate rukovati pojedinačno, primjerice kako biste svakoj dodali oznaku, onda možete upotrijebiti radnju Za svaku.
  • Ako morate prikupiti podatke, na primjer prebrojiti koliko je rezultata vraćeno, možete upotrijebiti radnju Broji ili Zbroji.
  • Ako popis morate izvesti, na primjer poslati e-poruku sa svim stavkama, vraćene podatke možete upotrijebiti izravno u kasnijim radnjama.

Kako biste pristupili vraćenim podacima u koracima koji slijede nakon ove radnje, upotrijebite varijablu Dohvati podatke o članku, koja sadržava popis članaka. Ovu varijablu možete upotrijebiti u uvjetima i u radnjama. Na primjer, popis članaka možete poslati u radnji Pošalji internu e-poruku slično ovomu:

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

Pokretači

Ovu radnju možete upotrijebiti u bilo kojem tijeku rada, uključujući pokretač Scheduled time. U tijeku rada koji upotrebljava pokretač Scheduled time tijek rada započinje u vrijeme koje ste odredili, a ne kao rezultat događaja. Budući da u vašoj trgovini ili iz aplikacije ne postoji specifičan događaj koji pokreće tijek rada, podaci nisu automatski uključeni.

Referenca za API

Za više informacija o API-ju koji se upotrebljava u ovoj radnji pogledajte Articles query.