Izgūt lapas datus

Darbplūsmās, kurās nepieciešami lapas dati, vari izmantot darbību Izgūt lapas datus, lai no veikala izgūtu lapas informāciju. Lapas ir tava tiešsaistes veikala tīmekļa lapas, kurās ietverta informācija, kas mainās reti, piemēram, lapa Par mums vai kontaktu lapa.

Piezīme

Šī ir darbība Izgūt datus. Lai saprastu, kā šāda veida darbību izmantot ar trigeri Ieplānotais laiks un cikliem Katram, skati Grafiki, datu izgūšana un cikliskas darbplūsmas lietotnē Shopify Flow.

Konfigurācija

Lauki

Darbībā Izgūt lapas datus ir tālāk norādītie lauki:

Lauki, kas tiek izmantoti darbībās Izgūt datus.

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 skaits, ko var atgriezt tevis atlasītais meklēšanas vaicājums. Vienlaikus var atgriezt līdz 100 rezultātiem.
Vaicājums	Obligāts. Izvēlies kādu no parastajiem vaicājumiem vai atlasi Papildu, lai izveidotu savu.

Vaicājuma virkne

Šis ir publicēto lapu izgūšanas vaicājuma piemērs:

published_status:published

Mainīgais published_status ir filtrs, kas pieejams Lapu vaicājumā, un to var izmantot vairākas reizes vai kombinēt ar citiem mainīgajiem.

Veicot datu vaicājumus, ir noderīgi zināt:

• Pieejamo lapu filtru saraksts

• Vaicājumiem 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 API dokumentācijā. Lauku vērtības var bieži atrast arī administratora paneļa vietrāžos URL, kad veic filtrēšanu. Piemēram, lai atrastu dažas pasūtījuma vaicājuma vērtības, filtrē lapu Pasūtījumi administratora panelī un pēc tam pārbaudi vietrādi URL.

• Vari izpildīt vai testēt vaicājumu savā veikalā, izmantojot lietotni Shopify GraphiQL.

• Ņem vērā, kas notiks, ja vaicājums neizdosies. Bieži vien API atgriež visus rezultātus (nevis nevienu).

Atgrieztie dati

Visas darbības Izgūt datus atgriež sarakstu ar resursiem, kuru skaits ir no 0 līdz 100. Atkarībā no lietošanas gadījuma tu, iespējams, vēlēsies šos datus izmantot dažādos veidos:

• Ja katrs saraksta vienums jāapstrādā atsevišķi, piemēram, katram jāpievieno tags, tad vari izmantot darbību Katram.
• Ja nepieciešams apkopot datus, piemēram, saskaitīt atgriezto rezultātu skaitu, vari izmantot darbību Skaits vai Summa.
• Ja nepieciešams izvadīt sarakstu, piemēram, nosūtīt e-pasta vēstuli ar visiem vienumiem, atgrieztos datus vari izmantot tieši turpmākajās darbībās.

Lai šai darbībai sekojošajos soļos piekļūtu atgrieztajiem datiem, izmanto mainīgo ar nosaukumu Izgūt lapas datus (tas ir lapu saraksts). Šo mainīgo vari izmantot gan nosacījumos, gan darbībās. Piemēram, vari nosūtīt lapu sarakstu darbībā Nosūtīt iekšēju e-pasta vēstuli, kas ir līdzīga šai:

{% for single_page in getPageData %}
  * {{ single_page.title }} - {{ single_page.handle }}
{% endfor %}

Piezīme

Ja vienā darbplūsmā darbība Izgūt datus tiek izmantota vairākas reizes, mainīgā nosaukumam tiek pievienots cipars. Piemēram, darbplūsmā, kurā divreiz izmantota darbība Izgūt pasūtījuma datus, pirmais atgriezto datu mainīgais ir getOrderData un otrais mainīgais ir getOrderData1. Šo nosaukumu nevar pielāgot.

Trigeri

Šo darbību vari izmantot jebkurā darbplūsmā, tostarp kopā ar trigeri Ieplānotais laiks. Darbplūsmā, kurā izmantots trigers Ieplānotais laiks, darbplūsma tiek sākta nevis kāda notikuma rezultātā, bet gan tevis norādītajā laikā. Tā kā darbplūsmu nesāk neviens konkrēts notikums veikalā vai lietotnē, dati netiek iekļauti automātiski.

API uzziņa

Plašāku informāciju par šajā darbībā izmantoto API skati sadaļā Lapu vaicājums.