Obține datele paginii

În fluxurile de lucru care necesită date despre pagini, puteți utiliza acțiunea Obține datele paginii pentru a recupera informații despre paginile din magazinul dumneavoastră. Paginile sunt pagini web din magazinul online care conțin informații ce se modifică rar, cum ar fi o pagină Despre noi sau o pagină de Contact.

Pe această pagină

Configurație

Câmpuri

Acțiunea Obține datele paginii conține următoarele câmpuri:

Câmpurile utilizate în acțiunile Obține date.
Câmp	Descriere
Sortează datele după	Obligatoriu. Parametrii după care sunt sortate datele returnate de interogarea de căutare.
Număr maxim de rezultate	Obligatoriu. Numărul maxim de rezultate care pot fi returnate de interogarea de căutare pe care o selectați. Puteți returna până la 100 de rezultate o dată.
Interogare	Obligatoriu. Alegeți dintre interogările obișnuite sau selectați Avansat pentru a o crea pe a dumneavoastră.

Șir de interogare

Acesta este un exemplu de interogare pentru obținerea paginilor publicate:

published_status:published

Variabila published_status este un filtru disponibil în interogarea pentru pagini și poate fi utilizat de mai multe ori sau combinat cu alte variabile.

Când interogați date, este util să știți că:

Lista filtrelor de pagini 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 aplicați filtre. De exemplu, pentru a găsi unele valori de interogare pentru comenzi, filtrați pagina Comenzi din panoul de administrare, apoi verificați adresa URL.
Puteți executa sau testa o interogare în magazinul dumneavoastră folosind aplicația Shopify GraphiQL.
Atenție la ce se întâmplă dacă interogarea dumneavoastră eșuează. Adesea, API-ul va returna toate rezultatele (în loc de niciunul).

Date returnate

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

Dacă trebuie să gestionați individual fiecare articol din listă, de exemplu, pentru a adăuga o etichetă pentru fiecare, atunci 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ără sau Însumează.
Dacă trebuie să afișați lista, de exemplu, să trimiteți un e-mail cu toate articolele, puteți utiliza datele returnate direct în acțiunile ulterioare.

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

{% for single_page in getPageData %}
  * {{ single_page.title }} - {{ single_page.handle }}
{% 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 ora pe care ați specificat-o, nu ca rezultat al unui eveniment. Deoarece nu există niciun eveniment specific în magazinul dumneavoastră sau dintr-o aplicație care să înceapă fluxul de lucru, nu sunt incluse automat date.

Referință API

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