Iegūt kataloga datus

Darbplūsmās, kurās ir nepieciešami kataloga dati, vari izmantot darbību Iegūt kataloga datus, lai izgūtu B2B kataloga informāciju no sava veikala. Katalogi ir produktu grupas ar pielāgotu cenu noteikšanu konkrētiem B2B klientiem vai uzņēmuma atrašanās vietām.

Piezīme

Šis ir darbības Iegūt datus veids. Lai uzzinātu, kā šāda veida darbību izmantot ar trigeri Ieplānots laiks un cikliem Cikls katram, skati izklāstu Grafiki, datu iegūšana un ciklu darbplūsmas lietotnē Shopify Flow.

Konfigurācija

Lauki

Darbība Iegūt kataloga datus ietver tālāk norādītos laukus.

Lauki, kas 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 var atgriezt līdz 100 rezultātiem.
Vaicājums	Obligāts. Izvēlies kādu no standarta vaicājumiem vai atlasi Papildu, lai izveidotu savu.

Vaicājuma virkne

Šis ir vaicājuma piemērs visu aktīvo katalogu iegūšanai:

status:ACTIVE

Mainīgais status ir filtrs, kas pieejams vaicājumā Catalogs query, un to var izmantot vairākkārt vai kombinēt ar citiem mainīgajiem.

Veicot datu vaicājumu, ir noderīgi zināt tālāk norādīto.

• Pieejamo kataloga 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 kataloga datus, kas ir katalogu saraksts. Tu vari izmantot šo mainīgo gan nosacījumos, gan darbībās. Piemēram, vari nosūtīt katalogu sarakstu, izmantojot darbību Nosūtīt iekšējo e-pastu, kā parādīts tālāk:

{% for single_catalog in getCatalogData %}
  * {{ single_catalog.title }}
{% endfor %}

Piezīme

Ja darbība Iegūt datus vienā darbplūsmā tiek izmantota vairākas reizes, mainīgā nosaukumam tiek pievienots skaitlis. 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

Šo darbību vari izmantot jebkurā darbplūsmā, tostarp kopā ar trigeri Ieplānotais laiks. Darbplūsmā, kurā tiek izmantots trigers Ieplānotais laiks, darbplūsmas izpilde tiek sākta tevis norādītajā laikā, nevis kāda notikuma rezultātā. Tā kā tavā veikalā vai no lietotnes nav konkrēta notikuma, kas sāktu darbplūsmu, dati automātiski netiek iekļauti.

API atsauce

Papildinformāciju par šajā darbībā izmantoto API skati katalogu vaicājumā.