Get collection data
Töövoogudes, mis nõuavad kollektsioonide andmeid, saad kasutada toimingut Get collection data, et hankida oma poest kollektsioonide teave.
Sellel lehel
Seadistamine
Väljad
Toiming Get collection data sisaldab järgmisi välju.
| Väli | Kirjeldus |
|---|---|
| Andmete sortimise alus | Nõutav. Parameetrid, mille järgi otsingupäringuga tagastatud andmeid sorditakse. |
| Tulemuste maksimaalne arv | Nõutav. Maksimaalne tulemuste arv, mida valitud otsingupäring saab tagastada. Korraga saab tagastada kuni 100 tulemust. |
| Päring | Nõutav. Vali levinud päringute seast või klõpsa valikut Advanced, et luua enda oma. |
Päringusõne
See on näidispäring viimase päeva jooksul uuendatud kollektsioonide hankimiseks:
updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'Muutuja updated_at on filter, mis on saadaval päringus Collections query ning mida saab kasutada mitu korda või kombineerida teiste muutujatega. Liquidi muutuja scheduledAt on saadaval töövoogudes, mis kasutavad käivitajat Scheduled time. Liquidi silt date_minus on spetsiaalne Flow silt, mis võimaldab kuupäevast aega lahutada.
Andmete pärimisel on kasulik teada järgmist:
- Saadaolevate kollektsioonifiltrite 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 collection data, mis on kollektsioonide loend. Saad seda muutujat kasutada nii tingimustes kui ka toimingutes. Näiteks saad kollektsioonide loendi saata toiminguga Send internal email sarnaselt järgnevaga:
{% for single_collection in GetCollectionData %}
* {{ single_collection.title }}
{% endfor %}Käivitajad
Seda toimingut saab 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 tulemusena. Kuna puudub konkreetne sündmus sinu poest või rakendusest, mis töövoo käivitaks, ei lisata andmeid automaatselt.