Datu plūsma — kur atrodas fails un pieejas dati

Šajā rakstā ir piegādātāja formas cilne Datu plūsma: kā uzrakstīt plūsmas adresi un faila nosaukumu, kādus pieejas datus kur ievada, kā pārbaudīt, vai plūsma tiešām strādā, un kas notiek ar lejupielādēto failu. Par to, kā šo plūsmu pēc tam lasa — pavadošie faili, parsētāja opcijas, lapošana, formāta noteikšana — ir otrā daļa: Datu plūsmas konfigurācija — kā plūsmu lasa.

Piegādātāja formā (Integrāciju centrāle → Piegādātāji → zīmuļa poga) ir divas cilnes, kas atbild uz diviem dažādiem jautājumiem:

• Datu plūsma — no kurienes fails tiek ņemts un ar kādiem pieejas datiem;
• Datu plūsmas konfigurācija — kā šo plūsmu lasa: kur atrodas pavadošie faili, kādas opcijas parsētājam ir uzstādītas.

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 cilnē Datu plūsmas konfigurācija. Piegādātājam, kura plūsma ir viens fails, tādu nav.

Abas cilnes saglabā viena un tā pati disketes poga panelī augšā — tā iesniedz visu formu neatkarīgi no tā, kura cilne ir atvērta.

Pirms sākat

1. Piegādātājs ir izveidots un vismaz vienreiz saglabāts. Kamēr tā nav, cilnē Datu plūsmas konfigurācija ir tikai paziņojums «Vispirms saglabājiet piegādātāju…» — sk. Piegādātāja pievienošana — sagatavošanās un pamatdati.
2. Jums ir zināma plūsmas adrese un pieejas dati. Tos dod vairumtirgotājs, nevis Integrāciju centrāle.
3. Ja vairumtirgotājam ir savs parsētājs, tas ir piesaistīts. Operators to izdarīt nevar: ekrāns Integrācija ir pieejams tikai sistēmas administratoram. Ja neesat pārliecināts, uzrakstiet atbalstam pieteikumu un norādiet piegādātāja kodu, vairumtirgotāja nosaukumu un plūsmas adresi.

Cilne «Datu plūsma» — kur atrodas fails

Šeit dzīvo piegādātāja kopējie pieejas dati — tie, ko izmanto visi šī piegādātāja faili. (Atsevišķam failam vai galvenei parsētājs var piedāvāt savus pieejas datus cilnē Datu plūsmas konfigurācija; to pašu saka arī paskaidrojums, kas otrajā cilnē ir virs iestatījumu tabulas.)

1. Atveriet piegādātāju: Integrāciju centrāle → Piegādātāji → zīmuļa poga vajadzīgajā rindā.
2. Cilnē Datu plūsma aizpildiet vai nu Datu plūsmas URL (HTTP resursdators), vai FTP resursdators — nekad abus.
3. Laukā Faila nosaukums ierakstiet galvenā faila ceļu zem resursdatora, piem. exports/feed.xml.
4. Ja piegādātājs prasa pieejas datus, aizpildiet Lietotājvārds un Parole (un Klienta / organizācijas ID, ja piegādātājs to prasa).
5. Ja piegādātājs raksta aprakstus citā valodā, ierakstiet to laukā Avota valoda.
6. Nospiediet disketes pogu panelī augšā pa labi.
7. Pārbaudiet rezultātu — sk. sadaļu «Kā pārbaudīt, vai plūsma strādā».

Vienu resursdatoru, nevis abus. Ja ir aizpildīts gan Datu plūsmas URL, gan FTP resursdators, saglabāšana tiek atteikta ar kļūdu (tā ir angliski): «Set either the Feed URL or the FTP host, not both…». Iemesls: importā FTP uzvar bez jebkāda brīdinājuma, tāpēc piegādātājs, kas pārcelts no FTP uz HTTP, klusi vilktu veco failu.

Parole ir redzama ekrānā. Lauks Parole ir parasts teksta lauks, nevis maskēts. Atverot piegādātāja formu, tā ir salasāma ikvienam, kas tajā brīdī skatās monitorā. (Cilnē Datu plūsmas konfigurācija paroles rindas turpretī ir maskētas.)

⚠️ Avota valodas laukā vietturis ir lv, bet tas NAV noklusējums. Pelēkais lv ir tikai piemērs tukšā laukā. Ierakstiet valodu, kādā raksta piegādātājs (pl, de, lt). Ja piegādātājs raksta latviski, atstājiet tukšu vai ierakstiet lv. Sk. arī Mašīntulkošana — divi veidi un lauks «Avota valoda».

Avota valodas maiņai ir blakusefekts. Nomainot Avota valodu un saglabājot, visām šī piegādātāja ar veikalu sasaistītajām precēm tiek ierindota apraksta pārbūve. Tas ir apzināti, bet nozīmē, ka lauku nevajag «pamēģināt».

📷 Ekrānattēls: ecomlink/vendor — piegādātāja forma ar visām sešām cilnēm, aktīva cilne «Datu plūsma» ar aizpildītu resursdatoru, faila nosaukumu un pieejas datiem

Kā pārbaudīt, vai plūsma strādā

Formā nav pogas «Testēt». Saglabāšana pārbauda tikai adreses pierakstu, nevis savienojumu: tā nezina ne to, vai resursdators atbild, ne to, vai parole ir pareiza. Vienīgais veids, kā to uzzināt, ir palaist importu.

1. Atveriet Integrāciju centrāle → Vadības panelis.
2. Šī piegādātāja rindā nospiediet Krājumu imports (lejupvērstās bultiņas poga) un apstipriniet. Darbs aiziet fonā; rindā parādās progresa josla.
3. Kad tas beidzies, paskatieties statusa punktu kolonnā Pēdējais imports. Pabeigts (zaļš) nozīmē, ka fails tika paņemts un nolasīts; Kļūda (sarkans) nozīmē, ka palaišana nokrita. Uzbraucot ar peli, atveras kartīte ar detaļām.
4. Sistēmas administrators to pašu redz precīzāk ekrānā Žurnāli (Žurnāli — ekrāns un izpilžu rindas): blokā Importa un veikala atjaunošanas izpildes atrodiet šīs palaišanas FINISH rindu un skatieties status= un skaitītājus, bet blokā Žurnāla ziņojumi — brīdinājumus un kļūdas. Ekrāns ir pieejams tikai sistēmas administratoram; pārējiem šeit jāraksta atbalstam.

Ko rāda skaitītāji FINISH rindā:

• inserted=0 updated=0 skipped=<liels skaitlis> — plūsma ir nolasīta līdz galam (tātad adrese un pieejas dati strādā), bet neviena prece vēl nav sagatavota. Tā ir normāla pirmā palaišana: tālāk vajadzīgs Pilnais imports, ko var palaist sistēmas administrators.
• status=error — palaišana nokrita; cēlonis ir turpat rindā laukā error="…". Lejupielādes kļūdās tur ir piegādātāja paša atbildes teksts.

Divi veidi, kā uzrakstīt adresi

Vesela URL režīms ieslēdzas tikai tad, ja izpildās visi četri nosacījumi:

1. Faila nosaukums ir tukšs;
2. adresē ir ceļš vai vaicājums;
3. adrese pati nosauc savu shēmu — https:// vai ftp://;
4. šim piegādātājam neviens pavadošais fails nav norādīts kā ceļš zem resursdatora (t. i., tie ir vai nu pilni URL, vai to nav vispār).

⚠️ Shēma veselam URL ir jāraksta pašam. Pieņemtā shēma (https:// HTTP laukam, ftp:// FTP laukam) attiecas tikai uz kailu resursdatoru. Ierakstot api.example.com/feed?doc=1 bez https://, saglabāšana tiek atteikta ar paskaidrojumu, ka veselam URL jānosauc sava shēma.

Ekrāna palīgteksts pie lauka Datu plūsmas URL min tikai resursdatoru — vesela URL režīms tajā nav aprakstīts, bet strādā, ja izpildās visi četri nosacījumi augstāk.

Kad saglabāšana tiek atteikta un kad ne. Atteikums — apzināti skaļš — notiek tikai tad, ja adrese satur ceļu vai vaicājumu, bet tomēr nav lietojama kā vesels URL (trūkst shēmas vai piegādātājam ir pavadošie faili zem resursdatora).

🔴 Bet kails resursdators ar tukšu Faila nosaukumu netiek atteikts. Ierakstot example.com un atstājot Faila nosaukumu tukšu, forma saglabājas mierīgi — un imports pēc tam klusi izmanto iepriekš lejupielādēto failu (sk. «Kas notiek ar lejupielādēto failu»). Tāpēc pēc saglabāšanas vienmēr pārliecinieties, ka Faila nosaukums nav palicis tukšs.

Divi sīkumi, kas maina nozīmi:

• adrese, kas beidzas ar slīpsvītru (example.com/feeds/), skaitās par resursdatoru, nevis par veselu URL;
• ja Faila nosaukums nav tukšs, tas vienmēr uzvar — vesels URL blakus vecam ceļam nekad nesalīmējas par https://host/new.xml/old.xml.

Autentifikācija — kas ir ievadāms un kas nav

Pieejas datus vienmēr ievada cilnē «Datu plūsma» — Lietotājvārds, Parole, Klienta / organizācijas ID. Parsētājs izlemj tikai transportu: kādā veidā tie aiziet pie piegādātāja. Operatoram transports nav jāzina un nav jāizvēlas.

Atslēga main.auth_header sarakstā parādās tikai tiem piegādātājiem, kuru parsētājs to pieprasa (šobrīd tie ir divi). Konfigurēt nevar tikai tādu piegādātāju, kuram vajadzīgais transports nevienā parsētājā vispār nav aprakstīts — tas ir izstrādes darbs, nevis iestatījums.

Kas notiek ar lejupielādēto failu

• Lejupielādētais fails tiek noglabāts veikala krātuvē (storage/ecomlink/downloads/), un tā ceļš tiek pierakstīts pie piegādātāja.
• Pirms katras jaunas lejupielādes iepriekšējā tiek arhivēta un saspiesta; arhīvs glabājas 20 dienas. Tas ir vienīgais veids, kā vēlāk noskaidrot, kas tiešām ienāca vakar.
• Ja avots nav nokonfigurēts nemaz (nav resursdatora, nav faila nosaukuma, nav vesela URL), imports klusi izmanto iepriekš lejupielādēto failu. Ja arī tā nav — skaidra kļūda.
• Savienojumam ir 30 sekunžu, visam failam — 30 minūšu limits.
• Kļūdas atbildes saturs (līdz 2 KB) tiek iekļauts kļūdas ziņojumā — tieši tas atšķir «IP nav atļauto sarakstā» no «nederīgs marķieris» aiz viena un tā paša 403.

Ja piegādātājs pieeju atver pēc IP adreses, viņam jāpaziņo jūsu veikala servera IPv4 adrese. Pieprasījums vienmēr iet pa IPv4 tieši tāpēc, lai piegādātājs redzētu to pašu adresi, ko esam viņam nosaukuši. Adresi pasaka atbalsts vai sistēmas administrators — nemēģiniet to nolasīt no sava datora vai pārlūkā, jo pieprasījumu veic serveris, nevis jūsu dators.

Ja kaut kas nestrādā

Saglabāšana atsakās: «Set either the Feed URL or the FTP host, not both». Aizpildīti abi resursdatora lauki. Atstājiet vienu — to, no kura tiešām ņem datus, — un otru iztukšojiet.

Saglabāšana atsakās, ka adresei jānosauc sava shēma. (Arī šis ziņojums ir angliski.) Adresē ir ceļš vai vaicājums, bet nav https:// vai ftp://. Vai nu uzrakstiet shēmu klāt, vai sadaliet adresi: resursdators laukā Datu plūsmas URL, ceļš laukā Faila nosaukums.

Žurnālā ir 401, 403 vai «access denied». Vai nu pieejas dati ir mainīti, vai veikala serveris nav piegādātāja atļauto IP adrešu sarakstā. Kurš no diviem — pasaka pats kļūdas ziņojums: tajā ir iekļauts piegādātāja atbildes teksts. Pārbaudiet Lietotājvārdu / Paroli cilnē Datu plūsma; ja tie ir pareizi, prasiet atbalstam servera IPv4 adresi un nosūtiet to piegādātājam.

Lejupielāde neizdodas vai apstājas pusceļā. Savienojumam ir 30 sekunžu, visam failam — 30 minūšu limits. Ļoti liela vai ļoti lēna plūsma tajos neiekļaujas; to risina ar piegādātāju (mazāks fails, arhīvs, lapošana), nevis formā.

Kļūda vai brīdinājums ir par kādu iestatījumu tabulā «Datu plūsmas konfigurācija». Tie ir aprakstīti otrajā daļā: Datu plūsmas konfigurācija — kā plūsmu lasa.

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