Hangi metaobjekti kirjed
Toimingut Hangi metaobjekti kirjed saad kasutada, et hankida oma poest metaobjekti kirjete loend valikulise päringu põhjal. Lisateavet leiad metaobjektide dokumentatsioonist.
Konfiguratsioon
Väljad
Toiming Hangi metaobjekti kirjed sisaldab rippmenüüd metaobjekti definitsiooni määramiseks ning päringu loomiseks kasutatakse järgmisi välju:
| Väli | Kirjeldus |
|---|---|
| Andmete sortimise alus | Nõutav. Parameetrid, mille alusel otsingupäringuga tagastatud andmeid sorditakse. |
| Maksimaalne tulemuste arv | Nõutav. Valitud otsingupäringuga tagastatavate tulemuste maksimaalne arv. Korraga saab tagastada kuni 100 tulemust. |
| Päring | Nõutav. Vali levinud päringute seast või vali enda päringu loomiseks Täpsem. |
Päringusõne
See on näidispäring metaobjekti kirjete hankimiseks juhul, kui välja email väärtus kattub tellimuse e-posti aadressiga:
{{fields.email}}:"{{order.email}}"See on näidispäring viimase päeva jooksul värskendatud metaobjekti kirjete hankimiseks:
updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'Muutuja updated_at on filter, mis on saadaval metaobjektide päringus ja mida saab kasutada mitu korda või kombineerida teiste muutujatega. Liquidi muutuja scheduledAt on saadaval töövoogudes, mis kasutasid käivitajat Ajastatud aeg. Liquidi silt date_minus on spetsiaalne Flow' silt, mis võimaldab kuupäevast aega lahutada.
Andmete pärimisel on kasulik teada järgmist:
- Saadaolevate metaobjekti filtrite loend
- Metaobjektide pärimiseks välja väärtuse järgi peab metaobjektil olema filtreerimine lubatud, mida saab lubada Shopify administraatori kohandatud andmete seadetes.
- Päringud peavad järgima kindlat süntaksit
- Päringu väljade väärtusi ei dokumenteerita alati. Mõnel juhul saab väärtused leida API dokumentatsioonist. Alternatiivina võid välja väärtused sageli leida adminipaneeli URL-idest, kui kasutad filtreerimist. Näiteks teatud tellimuse päringu väärtuste leidmiseks filtreeri adminipaneelil lehte Tellimused ja kontrolli seejärel URL-i.
- Päringut saad oma poes käivitada või testida Shopify GraphiQL-i rakenduse abil.
- Arvesta sellega, mis juhtub päringu ebaõnnestumisel. Sageli tagastab API (tühja vastuse asemel) kõik tulemused.
Tagastatud andmed
Kõik toimingud Hangi andmeid tagastavad loendi, mis sisaldab 0 kuni 100 ressurssi. Olenevalt kasutusjuhust võid neid andmeid kasutada mitmel viisil:
- Kui sul on vaja iga loendiüksust eraldi käsitleda, näiteks lisada igaühele silt, saad kasutada toimingut For each.
- Kui pead andmeid koondama, näiteks loendama, mitu tulemust tagastati, saad kasutada toiminguid Loenda või Summeeri.
- Kui sul on vaja loend väljastada, näiteks saata kõigi üksustega e-kiri, saad kasutada tagastatud andmeid otse järgnevates toimingutes.
Sellele toimingule järgnevates sammudes tagastatud andmetele juurdepääsuks kasuta muutujat Hangi metaobjekti kirjed, mis on metaobjekti kirjete loend. Saad seda muutujat kasutada nii tingimustes kui ka toimingutes. Näiteks saad metaobjekti kirjete võtme-väärtuse paaride loendi saata toiminguga Saada sisemine e-kiri järgmiselt:
{% for getMetaobjectEntries_item in getMetaobjectEntries %}
Key-value pairs for entry:
{% for fields_item in getMetaobjectEntries_item.system.fields %}
{{fields_item.key}}:{{fields_item.value}}
{% endfor %}
{% endfor %}Käivitajad
Saad seda toimingut kasutada mis tahes töövoos, sealhulgas käivitajaga Ajastatud aeg. Käivitajat Ajastatud aeg kasutavas töövoos algab töövoog sinu määratud ajal, mitte sündmuse tulemusel. Kuna sinu poes või rakendusest ei toimu spetsiifilist sündmust, mis töövoo käivitaks, ei kaasata andmeid automaatselt.