Obține date din catalog

În fluxurile de lucru care necesită date din catalog, puteți utiliza acțiunea Obține date din catalog pentru a recupera informații despre catalogul B2B din magazinul dvs. Cataloagele sunt grupuri de produse cu tarifare personalizată pentru anumiți clienți B2B sau anumite locații ale companiei.

Pe această pagină

Configurare

Câmpuri

Acțiunea Obține date din catalog conține următoarele câmpuri:

Câmpuri 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 simultan.
Interogare	Obligatoriu. Alegeți dintre interogările frecvente sau selectați Avansat pentru a vă crea propria interogare.

Șirul interogării

Acesta este un exemplu de interogare pentru obținerea tuturor cataloagelor active:

status:ACTIVE

Variabila status este un filtru disponibil în Interogarea pentru cataloage și poate fi utilizată de mai multe ori sau combinată cu alte variabile.

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

Lista filtrelor de catalog 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, puteți găsi adesea valorile câmpurilor în adresele URL din panoul de administrare atunci când filtrați. De exemplu, pentru a găsi anumite valori de interogare pentru comenzi, filtrați pagina Comenzi din panoul de administrare și apoi verificați adresa URL.
Puteți rula sau testa o interogare în magazinul dumneavoastră utilizând aplicația Shopify GraphiQL.
Fiți atent la ce se întâmplă dacă interogarea dumneavoastră eșuează. Adesea, API-ul va returna toate rezultatele (în loc de niciunul).

Datele returnate

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

Dacă trebuie să gestionați fiecare articol din listă în mod individual, cum ar fi să adăugați o etichetă pentru fiecare, atunci puteți utiliza acțiunea Pentru fiecare.
Dacă trebuie să agregați date, cum ar fi numărarea rezultatelor returnate, atunci puteți utiliza acțiunile Numără sau Sumă.
Dacă trebuie să generați lista ca rezultat, cum ar fi trimiterea unui e-mail cu toate articolele, atunci puteți utiliza 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ți datele catalogului, care este o listă de cataloage. Puteți utiliza această variabilă atât în condiții, cât și în acțiuni. De exemplu, puteți trimite lista de cataloage într-o acțiune Trimite un e-mail intern similară cu aceasta:

{% for single_catalog in getCatalogData %}
  * {{ single_catalog.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 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 cataloage.