Iegūt kolekcijas datus
Darbplūsmās, kurās nepieciešami kolekcijas dati, vari izmantot darbību Iegūt kolekcijas datus, lai izgūtu kolekcijas informāciju no sava veikala.
Konfigurācija
Lauki
Darbība Iegūt kolekcijas datus ietver tālāk norādītos laukus.
| Lauks | Apraksts |
|---|---|
| Kārtot datus pēc | Obligāts. Parametri, pēc kuriem tiek kārtoti meklēšanas vaicājuma atgrieztie dati. |
| Maksimālais rezultātu skaits | Obligāts. Maksimālais rezultātu daudzums, ko var atgriezt atlasītais meklēšanas vaicājums. Vienā reizē var atgriezt līdz pat 100 rezultātiem. |
| Vaicājums | Obligāts. Izvēlies kādu no biežāk izmantotajiem vaicājumiem vai atlasi Paplašināti, lai izveidotu savu. |
Vaicājuma virkne
Šis ir piemērs vaicājumam, kas iegūst pēdējās dienas laikā atjauninātās kolekcijas:
updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'Mainīgais updated_at ir filtrs, kas pieejams kolekciju vaicājumā, un to var izmantot vairākas reizes vai apvienot ar citiem mainīgajiem. Liquid mainīgais scheduledAt ir pieejams darbplūsmās, kurās izmantots ieplānotā laika trigers. Liquid tags date_minus ir īpašs Flow tags, kas ļauj no datuma atņemt laiku.
Izpildot datu vaicājumu, ir noderīgi zināt:
- Pieejamo kolekcijas filtru saraksts
- Vaicājumiem ir jāatbilst noteiktai sintaksei.
- Vaicājuma lauku vērtības ne vienmēr ir dokumentētas. Dažos gadījumos vērtības var atrast, aplūkojot API dokumentāciju. Vēl lauku vērtības bieži vari atrast administratora paneļa URL, kad izmanto filtrus. Piemēram, lai atrastu dažas pasūtījumu vaicājuma vērtības, filtrē lapu Pasūtījumi administratora panelī un pēc tam pārbaudi URL.
- Tu vari izpildīt vai pārbaudīt vaicājumu savā veikalā, izmantojot Shopify GraphiQL lietotni.
- Ņem vērā, kas notiek, ja tavs vaicājums neizdodas. Bieži vien API atgriezīs visus rezultātus (nevis nevienu).
Atgrieztie dati
Visas Iegūt datus darbības atgriež sarakstu ar 0 līdz 100 resursiem. Atkarībā no lietošanas gadījuma tu šos datus vari izmantot dažādos veidos:
- Ja tev nepieciešams apstrādāt katru saraksta vienumu atsevišķi, piemēram, pievienot katram tagu, vari izmantot darbību Katram.
- Ja nepieciešams apkopot datus, piemēram, saskaitīt, cik rezultātu tika atgriezti, tu vari izmantot darbības Saskaitīt vai Summēt.
- Ja tev nepieciešams izvadīt sarakstu, piemēram, nosūtīt e-pasta vēstuli ar visiem vienumiem, tad atgrieztos datus vari tieši izmantot turpmākajās darbībās.
Lai piekļūtu atgrieztajiem datiem soļos, kas seko šai darbībai, izmanto mainīgo ar nosaukumu Iegūt kolekcijas datus, kas ir kolekciju saraksts. Šo mainīgo vari izmantot gan nosacījumos, gan darbībās. Piemēram, vari nosūtīt kolekciju sarakstu, izmantojot darbību Nosūtīt iekšējo e-pastu, kā parādīts tālāk:
{% for single_collection in GetCollectionData %}
* {{ single_collection.title }}
{% endfor %}Trigeri
Šo darbību vari izmantot jebkurā darbplūsmā, tostarp ar trigeri Ieplānots laiks. Darbplūsmā, kurā izmanto trigeri Ieplānots laiks, tā tiek sākta tevis norādītajā laikā, nevis kāda notikuma rezultātā. Tā kā tavā veikalā vai lietotnē nav konkrēta notikuma, kas sāk darbplūsmu, nekādi dati netiek automātiski iekļauti.