Hangi kataloogi andmed

Kataloogiandmeid nõudvates töövoogudes saad kasutada toimingut Hangi kataloogi andmed, et hankida oma poest B2B-kataloogi teavet. Kataloogid on tooterühmad, millel on kohandatud hinnakujundus kindlatele B2B-klientidele või ettevõtte asukohtadele.

Sellel lehel

Konfiguratsioon

Väljad

Toiming Hangi kataloogi andmed sisaldab järgmisi välju:

Väljad, mida kasutatakse toimingutes Hangi andmed.
Väli	Kirjeldus
Andmete sortimise alus	Nõutav. Parameetrid, mille järgi otsingupäringu tagastatud andmeid sorditakse.
Tulemuste maksimumarv	Nõutav. Maksimaalne tulemuste arv, mida valitud otsingupäring saab tagastada. Korraga saad tagastada kuni 100 tulemust.
Päring	Nõutav. Vali levinud päringute seast või vali Täpsem, et luua oma päring.

Päringusõne

See on näidispäring kõigi aktiivsete kataloogide hankimiseks:

status:ACTIVE

Muutuja status on filter, mis on saadaval päringus Catalogs query ja mida saab kasutada mitu korda või kombineerida teiste muutujatega.

Andmete pärimisel on kasulik teada järgmist:

Saadaolevate kataloogifiltrite loend
Päringud peavad järgima kindlat süntaksit
Päringu väljaväärtused pole alati dokumenteeritud. Mõnikord leiab need API dokumentatsioonist. Tihti leiab väljaväärtused ka adminis filtreerides URL-ist. Näiteks mõne tellimuse päringu väärtuse leidmiseks filtreeri adminis lehte Tellimused ja seejärel kontrolli URL-i.
Saad päringut oma poes käivitada või testida, kasutades rakendust Shopify GraphiQL app.
Arvesta sellega, mis juhtub, kui sinu päring ebaõnnestub. Sageli tagastab API tühja tulemuse asemel kõik tulemused.

Tagastatud andmed

Kõik Get data toimingud tagastavad loendi, mis sisaldab 0 kuni 100 ressurssi. Olenevalt kasutusjuhust võid neid andmeid kasutada mitmel viisil:

Kui pead töötlema iga loendi üksust eraldi, näiteks lisama neile kõigile sildi, saad kasutada toimingut For each.
Kui pead andmeid koondama, näiteks loendama, mitu tulemust tagastati, saad kasutada toimingut Count või Sum.
Kui sul on vaja loend väljastada, näiteks saata kõigi üksustega e-kiri, saad tagastatud andmeid kasutada otse järgnevates toimingutes.

Sellele toimingule järgnevates sammudes tagastatud andmetele juurde pääsemiseks kasuta muutujat nimega Get catalog data, mis on kataloogide loend. Saad seda muutujat kasutada nii tingimustes kui ka toimingutes. Näiteks saad kataloogide loendi saata toiminguga Send internal email sarnaselt järgnevaga:

{% for single_catalog in getCatalogData %}
  * {{ single_catalog.title }}
{% endfor %}

Käivitajad

Saad seda toimingut kasutada igas töövoos, sealhulgas käivitajaga Scheduled time. Töövoos, mis kasutab käivitajat Scheduled time, algab töövoog sinu määratud ajal, mitte sündmuse tulemusel. Kuna töövoogu ei käivita sinu poes või rakenduses toimuv kindel sündmus, ei lisata andmeid automaatselt.

API viide

Lisateavet selles toimingus kasutatud API kohta leiad jaotisest Catalogs query.