Obține date despre articol

În fluxurile de lucru care necesită date despre articolele de blog, puteți utiliza acțiunea Obține date despre articol pentru a recupera informații despre articole din magazinul dvs. Shopify.

Pe această pagină

Configurare

Câmpuri

Acțiunea Obține date despre articol conține următoarele câmpuri:

Câmpuri utilizate în acțiunile de obținere a datelor.
Câmp	Descriere
Sortează datele după	Obligatoriu. Parametrii după care sunt sortate datele returnate de interogarea de căutare.
Numărul maxim de rezultate	Obligatoriu. Numărul maxim de rezultate care poate fi returnat de interogarea de căutare pe care o selectați. Puteți returna până la 100 de rezultate simultan.
Interogare	Obligatoriu. Alegeți dintre interogările comune sau selectați Avansat pentru a vă crea propria interogare.

Șir de interogare

Acesta este un exemplu de interogare pentru obținerea articolelor publicate în ultima zi:

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

Variabila published_at este un filtru disponibil în interogarea de articole și poate fi utilizată de mai multe ori sau combinată cu alte variabile. Variabila Liquid scheduledAt este disponibilă în fluxurile de lucru care utilizează declanșatorul Oră programată. Eticheta Liquid date_minus este o etichetă Flow specială care vă permite să scădeți timp dintr-o dată.

Atunci când interogați date, este util să știți următoarele:

Lista filtrelor de articole disponibile
Interogările trebuie să urmeze o anumită sintaxă
Valorile câmpurilor de interogare nu sunt întotdeauna documentate. În unele cazuri, valorile pot fi găsite consultând documentația API. Alternativ, adesea puteți găsi valorile câmpurilor în adresele URL din panoul de administrare atunci când filtrați. De exemplu, pentru a găsi anumite valori pentru interogarea de comenzi, filtrați pagina Comenzi din panoul de administrare, iar apoi verificați adresa URL.
Puteți rula sau testa o interogare în magazinul dvs. utilizând aplicația Shopify GraphiQL.
Acordați atenție la ce se întâmplă dacă interogarea eșuează. De multe ori, API-ul va returna toate rezultatele (în loc de niciunul).

Date returnate

Toate acțiunile Obține date returnează o listă de la 0 la 100 de resurse. În funcție de cazul dvs. de utilizare, ați putea dori să utilizați aceste date în diverse moduri:

Dacă trebuie să gestionați individual fiecare articol din listă, de exemplu, pentru a adăuga o etichetă pentru fiecare, puteți utiliza acțiunea Pentru fiecare.
Dacă trebuie să agregați date, de exemplu, pentru a număra câte rezultate au fost returnate, puteți utiliza acțiunile Numărare sau Sumă.
Dacă trebuie să utilizați lista ca rezultat, de exemplu, pentru a trimite un e-mail cu toate articolele, puteți folosi datele returnate direct în acțiunile ulterioare.

Pentru a accesa datele returnate în pașii care urmează acestei acțiuni, utilizați variabila denumită Obține date despre articol, care este o listă de articole. Puteți utiliza această variabilă atât în condiții, cât și în acțiuni. De exemplu, puteți trimite lista de articole într-o acțiune Trimite e-mail intern similar cu acesta:

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

Declanșatoare

Puteți utiliza această acțiune în orice flux de lucru, inclusiv cu declanșatorul Oră programată. Într-un flux de lucru care utilizează declanșatorul Oră programată, fluxul de lucru începe la o oră pe care ați specificat-o, nu ca urmare a unui eveniment. Deoarece nu există niciun eveniment specific în magazinul dvs. sau dintr-o aplicație care să înceapă fluxul de lucru, nu sunt incluse date în mod automat.

Referință API

Pentru mai multe informații despre API-ul utilizat în această acțiune, consultați interogarea de articole.