Datu plūsmas konfigurācija — kā plūsmu lasa

Šajā rakstā ir piegādātāja formas cilne Datu plūsmas konfigurācija: iestatījumu tabula un kā tajā pievieno atslēgas, kā Integrāciju centrāle saprot, kādā formātā fails ir, lapošana, kursors un tas, cik bieži plūsma tiek atjaunota. Kā uzrakstīt plūsmas adresi, faila nosaukumu un pieejas datus, aprakstīts pirmajā daļā: Datu plūsma — kur atrodas fails un pieejas dati.

Cilni atver Integrāciju centrāle → Piegādātāji → zīmuļa poga vajadzīgajā rindā → Datu plūsmas konfigurācija. Jaunam, vēl nesaglabātam piegādātājam tajā konfigurējama nav nekā.

Divi vārdi, kas rakstā atkārtojas:

• Parsētājs ir lasītājs, kas tieši šī vairumtirgotāja failu pārvērš precēs. Piegādātājam to piesprauž sistēmas administrators ekrānā Integrācija — sk. Atbalstītie formāti un parsētāja izvēle.
• Pavadošie faili ir papildu faili blakus galvenajam: Cenu lapa, Krājumu fails, Kategoriju koks, Vērtību apzīmējumi, Attēlu saraksts. Tos norāda tieši šajā cilnē. Piegādātājam, kura plūsma ir viens fails, tādu nav.

Abas piegādātāja formas datu plūsmas cilnes saglabā viena un tā pati disketes poga panelī augšā — tā iesniedz visu formu neatkarīgi no tā, kura cilne ir atvērta.

Cilne «Datu plūsmas konfigurācija»

Tā ir divu kolonnu tabula: Iestatījums un Vērtība, ar pogām Pievienot iestatījumu, Noņemt iestatījumu (atkritnes ikona rindas galā) un Atjaunot noklusējumus.

Cilne var rādīt arī paziņojumus — tie ir dažādās vietās un var parādīties kopā:

Pirmie divi ziņojumi viens otru izslēdz: jauna piegādātāja formā rādās tikai pirmais, jau saglabātam piegādātājam bez parsētāja — tikai otrais. Tiem blakus parasti ir arī trešais: kamēr parsētāja nav, piedāvājamu iestatījumu nav — izņemot gadījumu, kad piegādātājam kādas rindas jau ir saglabātas, un tad to vietā zīmējas tabula.

Parsētāja nosaukums šajā formā netiek rādīts nekur — ne kā etiķete, ne kā slēpts lauks. Tas ir apzināti: to izvēlas ekrānā, kas pieejams tikai sistēmas administratoram.

📷 Ekrānattēls: ecomlink/vendor — cilne «Datu plūsmas konfigurācija» ar dažām aizpildītām rindām un pogām apakšā

Kā izvēlas iestatījumu

Nospiežot Pievienot iestatījumu, parādās jauna rinda ar nolaižamo sarakstu. Saraksts ir sagrupēts:

Katra izvēle izskatās kā «Apraksts (atslēga)», piemēram «Krājumu fails atrašanās vieta (stock.location)». Atslēga seko aprakstam, jo tieši to nosauc saglabātais dokuments un katrs kļūdas ziņojums.

📷 Ekrānattēls: ecomlink/vendor — cilne «Datu plūsmas konfigurācija», atvērts «Pievienot iestatījumu» saraksts ar redzamām grupām «Faili un pieejas dati» un «Datu plūsmas opcijas»

Divas lietas, kas pārsteidz:

• Galvenā faila atrašanās vietu (main.location) saraksts nepiedāvā nekad. Galvenā faila adrese dzīvo cilnē Datu plūsma (Faila nosaukums zem resursdatora), un otrs tās pieraksts šeit būtu slazds — atslēga, kas klusi zaudē kolonnai.
• Katru atslēgu var lietot tikai vienu reizi. Rindas cita citai izvēles «atņem», un, kad brīvu vairs nav, poga Pievienot iestatījumu kļūst neaktīva.

Daļai iestatījumu vērtība ir nolaižamais saraksts, nevis teksta lauks — tie ir slēdži ar noteiktu vērtību kopu. Paroles tipa vērtības tiek rādītas maskēti.

Daļa apzīmējumu ir angliski. Latviski ir avotu nosaukumi (Galvenā datu plūsma, Cenu lapa, Krājumu fails, Kategoriju koks, Vērtību apzīmējumi, Attēlu saraksts) un lauki («… atrašanās vieta», «… lietotājvārds», «… parole», «… autorizācijas galvene», «… ieslēgts»). Pārējie — Record element, Records key, Worksheet, lapošanas lauki — parādās angliski, jo nāk no pašas integrācijas apraksta. Rakstot atbalstam, tos var citēt tieši tā, kā tie ir ekrānā.

Rindas, kuras nevar rediģēt

Rinda, kas rādās kā kods bez nolaižamā saraksta un ar pelēku piezīmi ar brīdinājuma trijstūra ikonu zem atslēgas, ir saglabāta, bet pašlaik neizmantota. Piezīme pasaka, kāpēc:

📷 Ekrānattēls: ecomlink/vendor — tikai lasāma rinda: atslēga kā kods un zem tās pelēkā piezīme ar brīdinājuma trijstūri

Par otro rindu: pilnie importi strādā, bet palaist tos drīkst tikai sistēmas administrators (vadības panelī poga Pilnais imports ir redzama tikai viņam). Šī cilne pagaidām nepiedāvā rediģēt iestatījumus, ko nolasa vienīgi pilnais imports; jau saglabātā vērtība paliek neskarta. Sk. Preču imports — palaišana un grafiks.

Svarīgi: šīs rindas netiek nodzēstas, saglabājot kaut ko pavisam citu — tāpēc tās formā ir redzamas.

Poga «Atjaunot noklusējumus»

Tā aizpilda tabulu ar visiem iestatījumiem, ko šī plūsma piedāvā, katru ar tā iebūvēto noklusējumu — izņemot paroles tipa atslēgas. Trīs būtiski sīkumi:

1. Nekas netiek saglabāts, kamēr nesaglabājat — tā ir tikai skata darbība.
2. Jau ierakstītās vērtības paliek tām atslēgām, kas joprojām tiek piedāvātas, bet iepriekšējā sadaļā aprakstītās tikai lasāmās rindas tiek izmestas. Tā ir pogas jēga: sakopt piegādātāju pēc parsētāja maiņas.
3. Paroļu rindas tabula pēc šīs pogas nospiešanas pazūd — parole netiek «atjaunota uz noklusējumu», to vienkārši neviens neuzraksta tukšā laukā. Ja paroles rinda bija, pēc Atjaunot noklusējumus tā jāpievieno un jāievada no jauna.

Ko pārbauda saglabāšana

Tukša vērtība netiek pārbaudīta — parasti tā nozīmē «nav uzstādīts» un atgriež parsētāja noklusējumu.

🔴 Izņēmums, kas maksā dārgi. Dažām atslēgām apzināti tukša vērtība nozīmē «funkcija izslēgta», nevis «noklusējums». Šodien tādas ir četras: DUELL skip_restricted (noklusējums lv), nonlocal_if_empty (noklusējums VAASA) un updates_dir (noklusējums Data/Products/), kā arī ALSOLT exclude_classes (noklusējums X19). Iztukšojot šādu lauku, tas, ko tas vada, klusi izslēdzas — ALSO gadījumā katalogā ieplūst garantijas un CarePack pozīcijas, DUELL gadījumā vairs netiek ņemti kataloga papildinājumi. Lai atgrieztos noklusējums, rinda ir jāNOŅEM ar atkritnes pogu Noņemt iestatījumu, nevis jāiztukšo.

Kā Integrāciju centrāle saprot, kādā formātā fails ir

Lauks Importa formāts cilnē Vispārējie (XML / XLSX / CSV / PIM / PIM2 / CUST) neietekmē neko — to drīkst atstāt, kā ir. Vienīgās sekas: tas pats apzīmējums parādās piegādātāju saraksta kolonnā «Formāts» (vadības panelī tā nav), tāpēc jaunam piegādātājam tur rādīsies PIM arī tad, ja patiesībā tā ir XML plūsma. Ja gribat, lai saraksti ir salasāmi, ielieciet tur īsto formātu — importam tas neko nemaina.

Faktiski lasīšanu nosaka piegādātājam piespraustais parsētājs (ekrāns Integrācija, tikai sistēmas administratoram), bet, ja tāda nav, — automātiskā noteikšana pēc faila satura un paplašinājuma.

Automātiskā noteikšana nekad neizvēlas konkrēta vairumtirgotāja parsētāju. Tāpēc piegādātājam, kuram ir savs parsētājs, tas ir jāpiesprauž ar roku — citādi imports vai nu nesagatavo neko, vai (sliktākajā gadījumā) nolasa nepareizo krājumu lauku bez vienas kļūdas. Precīza atpazīšanas kārtība un tās robežas aprakstītas rakstā Atbalstītie formāti un parsētāja izvēle.

Lapošana — kad plūsma nāk pa lapām

Daļa piegādātāju nedod lejupielādējamu failu, bet API, kas katrā pieprasījumā atdod vienu lapu. Šādai plūsmai grupā Faili un pieejas dati parādās pieci iestatījumi (apzīmējumi angliski). Atslēgu nosaukumos priekšā ir avota nosaukums — galvenajai plūsmai tas ir main, un tieši šādā pierakstā tie parādās kļūdu ziņojumos:

Vērtības nosaka piegādātājs, nevis Integrāciju centrāle. Parametru nosaukumus pajautājiet vairumtirgotājam vai atrodiet viņa API dokumentācijā; ceļu uz lapu skaitu var nolasīt, atverot 1. lapu pārlūkā un paskatoties, kurā vietā atbildē ir lapu skaits.

Piemērs. Ja piegādātāja 1. lapas atbilde sākas ar {"resource": {"paging": {"page": 1, "totalPages": 37}, "products": [ … ]}}, tad cilnē Datu plūsmas konfigurācija:

1. Pievienot iestatījumu → «Main feed - Page parameter (main.page_param)», vērtība page (tas, kā parametru sauc piegādātājs). Bez šīs rindas lapošana nenotiek, tāpēc to pievieno pirmo.
2. Pievienot iestatījumu → «Main feed - Page count path (main.page_count_path)», vērtība resource.paging.totalPages.
3. Ja piegādātājs atļauj izvēlēties lapas izmēru — vēl divas rindas: main.page_size_param (piem. limit) un main.page_size (piem. 500).
4. Saglabājiet ar disketes pogu un palaidiet Krājumu importu — kā nolasīt rezultātu, aprakstīts rakstā Datu plūsma — kur atrodas fails un pieejas dati, sadaļā «Kā pārbaudīt, vai plūsma strādā».

Darbība: nolasa 1. lapu, izlasa no tās kopējo lapu skaitu, tad paņem 2…N. Visu lapu saturs nonāk vienā keša failā, salikts cits aiz cita. Divi apzināti lēmumi, kas jāzina:

• ja main.page_count_path neatrisinās vai 1. lapa nav JSON, lejupielāde apstājas pēc pirmās lapas un žurnālā parādās brīdinājums;
• ja plūsma paziņo vairāk lapu nekā main.page_max, skaits tiek ierobežots un tas arī tiek ierakstīts žurnālā.

Lapošanas iestatījumi tiek piedāvāti tikai tām plūsmām, kuru lasītājs prot lasīt sakonkatenētas lapas (praksē — Standard JSON). XML lasītājs apstātos pie pirmā saknes taga un klusi importētu vienu lapu, tāpēc XML plūsmai šo lauku nav.

Kursors — kad plūsmu iet ar nobīdi

Daļa piegādātāju datus atdod pa gabaliem, ko Integrāciju centrāle paņem automātiski — te nav nekā, ko iestatīt, un nav nevienas atslēgas, ko sabojāt.

Vienīgais, kas šeit var gadīties: ja pirmā atbilde neatnes nevienu ierakstu, palaišana krīt ar kļūdu. Tas gandrīz vienmēr nozīmē, ka piegādātājs pieprasījumu noraidīja (pieejas dati vai IP adrese), nevis ka katalogs ir tukšs. Kļūdas tekstu meklējiet ekrānā Žurnāli — sk. Žurnāli — ekrāns un izpilžu rindas.

Cik bieži datu plūsma tiek atjaunota

Grafiks ir cilnē Vispārējie, nevis datu plūsmas cilnēs — divi atsevišķi lauki: Atjaunošanas biežums (cenas, krājumi, statuss) un Pilnā importa biežums (apraksti, attēli, atribūti, opcijas, jaunas preces). Abiem noklusējums ir Tikai manuāli, un abos sarakstos šī izvēle ir pirmā; automātiskās izvēles pārklājas vienīgi pie «Reizi dienā».

Grafiks strādā tikai tad, ja piegādātājam cilnē Vispārējie slēdzis Imports ir «Jā». Neatkarīgi no grafika importu vienmēr var palaist ar roku. Pilns apraksts: Preču imports — palaišana un grafiks un Veikala atjaunošanas grafiks un komandas.

Ja kaut kas nestrādā

Cilne «Datu plūsmas konfigurācija» ir tukša un raksta, ka plūsma vēl nav sagatavota importam. Piegādātājam nav piesprausts parsētājs. Kamēr tā nav, šeit nav ko rediģēt — arī tad, ja zināt, kura atslēga jums vajadzīga. Palūdziet administratoram to piesaistīt ekrānā Integrācija.

Imports pabeidzas «veiksmīgi», bet nesagatavo nevienu preci vai uzrāda nepareizus krājumus. Tipiskākais cēlonis — piegādātājam ar savu parsētāju tas nav piesaistīts, un plūsmu nolasīja standarta parsētājs. Kļūdas nav, jo fails formāli nolasījās. Pārbaudiet ekrānu Integrācija un žurnālus — sk. Žurnāli — diagnostika un ziņojumu atšifrējums.

Iestatījums, ko nesen ierakstījāt, importā neko nemaina. Pirmais, ko pārbaudīt: vai pēc izmaiņas imports ir palaists no jauna — iestatījums stājas spēkā tikai nākamajā lejupielādē. Otrs: atveriet cilni un paskatieties, vai rinda nav kļuvusi tikai lasāma ar piezīmi, ka iestatījums neattiecas uz pašreizējo lasīšanas veidu (parsētājs pa vidu mainīts) vai ka to nolasa tikai pilnais imports. Žurnāla brīdinājums par to, ka spēkā palicis parsētāja noklusējums, ir rets: formā ievadītu vērtību ārpus atļautā saraksta saglabāšana atsaka uzreiz, tāpēc tas iespējams tikai pēc parsētāja nomaiņas vai tad, ja vērtība ierakstīta apejot formu.

Plūsma atdod tikai daļu kataloga. Ja piegādātājs dod datus pa lapām, pārbaudiet main.page_count_path un main.page_max. Žurnālā ir redzams gan tas, cik lapu tika paņemts, gan brīdinājums, ja ceļš uz lapu skaitu neatrisinājās vai skaits tika ierobežots.

Kļūda ir par plūsmas adresi, pieejas datiem vai pašu lejupielādi. Resursdatora lauku atteikumi, 401/403, IP atļauto saraksts un lejupielādes limiti ir pirmajā daļā: Datu plūsma — kur atrodas fails un pieejas dati.

Saistītie raksti: Piegādātāja pievienošana — sagatavošanās un pamatdati — kā piegādātājs tiek izveidots · Atbalstītie formāti un parsētāja izvēle — kā plūsmai piesprauž vairumtirgotāja parsētāju · Lauku pārsaiste — pārsaistīšana un sausā palaišana — ja plūsmas lauks nonāk nepareizā preces īpašībā · Žurnāli — ekrāns un izpilžu rindas — kur redzams, kas importā tiešām notika