Iegūt raksta datus

Darbplūsmās, kurās nepieciešami emuāra raksta dati, vari izmantot darbību Iegūt raksta datus, lai izgūtu raksta informāciju no sava Shopify veikala.

Piezīme

Šis ir Iegūt datus darbības veids. Lai saprastu, kā izmantot šāda veida darbību ar trigeri Ieplānotais laiks un cikliem Cikls katram, skati rakstu Grafiki, datu iegūšana un darbplūsmu cikli pakalpojumā Shopify Flow.

Konfigurācija

Lauki

Darbība Iegūt raksta datus ietver šādus laukus:

Lauki, kas tiek izmantoti darbībās Iegū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 vari atgriezt līdz pat 100 rezultātiem.
Vaicājums	Obligāts. Izvēlies kādu no biežāk izmantotajiem vaicājumiem vai atlasi Papildu, lai izveidotu savu.

Vaicājuma virkne

Šis ir piemērs vaicājumam, lai iegūtu pēdējā dienā publicētos rakstus:

published_at:<='{{ scheduledAt }}' AND published_at:>'{{ scheduledAt | date_minus: "1 day" }}'

Mainīgais published_at ir filtrs, kas pieejams vaicājumā Articles, un to var izmantot vairākkārt vai apvienot ar citiem mainīgajiem. Liquid mainīgais scheduledAt ir pieejams darbplūsmās, kurās izmanto trigeri Ieplānotais laiks. Liquid tags date_minus ir īpašs Flow tags, kas ļauj atņemt laiku no datuma.

Vaicājot datus, ir noderīgi zināt tālāk minēto:

• Pieejamo rakstu filtru saraksts

• Vaicājumiem jāatbilst noteiktai sintaksei

• Vaicājumu lauku vērtības ne vienmēr ir dokumentētas. Dažos gadījumos vērtības var atrast, skatot API dokumentāciju. Vēl lauku vērtības bieži var atrast administratora paneļa vietrāžos URL, kad veic filtrēšanu. Piemēram, lai atrastu dažas pasūtījumu vaicājuma vērtības, administratora panelī filtrē lapu Pasūtījumi un pēc tam pārbaudi vietrādi URL.

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

• Atceries, kas notiek, ja vaicājums neizdodas. Bieži API atgriež visus rezultātus (nevis nevienu).

Atgrieztie dati

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

• Ja tev katrs saraksta vienums ir jāapstrādā atsevišķi, piemēram, katram jāpievieno tags, vari izmantot darbību Cikls katram.
• Ja tev nepieciešams apkopot datus, piemēram, saskaitīt, cik rezultātu tika atgriezti, vari izmantot darbību Skaits vai Summa.
• Ja tev nepieciešams izvadīt sarakstu, piemēram, nosūtīt pa e-pastu visus vienumus, vari izmantot atgrieztos datus tieši turpmākajās darbībās.

Lai piekļūtu atgrieztajiem datiem soļos, kas seko šai darbībai, izmanto mainīgo Iegūt raksta datus, kas ir rakstu saraksts. Vari izmantot šo mainīgo gan nosacījumos, gan darbībās. Piemēram, vari nosūtīt rakstu sarakstu, izmantojot darbību Nosūtīt iekšēju e-pasta vēstuli, līdzīgi šim:

{% for single_article in GetArticleData %}
    * {{ single_article.title }}
    {% endfor %}

Piezīme

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

Trigeri

Vari izmantot šo darbību jebkurā darbplūsmā, tostarp ar trigeri Ieplānotais laiks. Darbplūsmā, kurā tiek izmantots trigers Ieplānotais laiks, darbplūsma tiek sākta tavā norādītajā laikā, nevis notikuma rezultātā. Tā kā tavā veikalā vai lietotnē nav konkrēta notikuma, kas sāk darbplūsmu, dati netiek automātiski iekļauti.

API atsauce

Lai iegūtu papildinformāciju par šajā darbībā izmantoto API, skati vaicājumu Articles.