Šis ir kopējais problēmu meklēšanas raksts: simptoms → kur skatīties → cēlonis → ko darīt. Katrs punkts ir uzrakstīts no moduļa koda, tāpēc, ja apraksts sakrīt ar to, ko redzat ekrānā, cēlonis ir tieši tas, kas nosaukts.
Šajā rakstā ir pirmie pārbaudes soļi un 1.–4. sadaļa — viss, kas var nogriezt datu ceļu, pirms tie vispār nonāk modulī. Pārējie simptomi ir divos brāļu rakstos: Ja prece neparādās veikalā vai tās dati ir nepareizi (5.–11. un 18. sadaļa) un Ja imports, grafiks vai ekrāni nestrādā (12.–17., 19. un 20. sadaļa, kā arī tas, ko savākt atbalstam).
Modulis kreisajā izvēlnē sadaļā Lietotnes saucas Integrāciju centrāle. Šis raksts pieņem, ka piegādātājs jau ir izveidots un vismaz viens imports ir palaists — ja nē, sāciet ar Ceļš no nulles līdz precēm veikalā un Piegādātāja pievienošana.
Pirms sākat, atcerieties galveno moduļa likumu — darbs notiek divās atsevišķās caurulēs:
- Imports lejupielādē piegādātāja datu plūsmu un ieliek to sagatavošanas tabulās. Veikalā tas nemaina neko.
- Veikala atjaunošana paņem sagatavoto un publicē to veikala katalogā.
Puse visu ziņojumu «imports nostrādāja, bet veikalā nekas nemainījās» ir tieši tas: imports padarīja savu darbu, bet veikala atjaunošana vēl nav palaista. Sīkāk — Preču imports — kā tas notiek.
Simptoms → sadaļa
| Ko redzat | Sadaļa |
|---|---|
| Rinda uzreiz pāriet stāvoklī Kļūda, kļūdā ir HTTP kods | 1 |
| «Piegādātājam nav avota»; forma netiek saglabāta | 2 |
| Imports neatrod formātu vai lasa nepareizi | 3 |
| Imports «veiksmīgs», bet nav sagatavota neviena prece | 4 |
| Preces ir Produktos, bet veikalā to nav | 5 |
| Prece veikalā ir, bet atdod 404 un nav meklēšanā | 6 |
| Cena veikalā nepareiza (~21 %, kurss, uzcenojums) | 7 |
| Veikalā ir cita (dārgākā) piegādātāja cena | 8 |
| Kategorijas vai zīmoli nesasaistās | 9 |
| Nav variantu, specifikāciju, izmēru vai piemērotības | 10 |
| Attēlu nav vai tie nelejupielādējas | 11 |
| Imports «karājas», nesākas vai saka «already running» | 12 |
| Žurnāla ziņojumu bloks ir tukšs | 13 |
| Mainīts iestatījums veikalā neparādās | 14 |
| Preces pēkšņi pazuda no veikala | 15 |
| Automātiskais imports nenotiek pats | 16 |
| Ekrāna nav, poga neko nedara, saskarne angliski | 17 |
| Apraksts veikalā ir svešvalodā | 18 |
| Viena un tā pati prece veikalā ir divreiz | 19 |
| Cena vai daudzums ienāk no nepareizās kolonnas | 20 |
Kur meklēt kuru sadaļu. 1.–4. sadaļa ir šajā rakstā. 5.–11. un 18. sadaļa — rakstā Ja prece neparādās veikalā vai tās dati ir nepareizi. 12.–17., 19. un 20. sadaļa, kā arī tas, ko savākt atbalstam, — rakstā Ja imports, grafiks vai ekrāni nestrādā.
Četras vietas, kur skatīties
| Kur | Ko tur redz | Kam pieejams |
|---|---|---|
Diagnostika (cilne Diagnostika, ecomlink/diagnostics) |
vienā meklējumā par vienu preci: spriedums (Veikalā · Veikalā, izslēgta · Nav uzvarētājs · Gaida publicēšanu · Nav veikalā · Datu artefakts), visi 15 publicēšanas vārti ar sarkanu krustiņu pie tā, kurš preci aptur, Datu kvalitātes artefakti, uzvarētāju kāpnes un Grafiks. Sīkāk: Diagnostika — kāpēc prece nav veikalā | visiem, kam ir piekļuve ekrānam; ekrāns ir tikai lasāms, rediģēšanas tiesības tam nav vajadzīgas |
Vadības panelis (Lietotnes → Integrāciju centrāle, ecomlink/ecomlink) |
katras rindas stāvoklis: Dīkstāvē / Notiek imports / Pabeigts / Pabeigts ar brīdinājumiem / Kļūda, pēdējā importa laiks, Aptvērums (cik liela sagatavotā kataloga daļa ir publicēta veikalā) | visiem, kam ir piekļuve ekrānam |
Produkti (cilne Produkti, ecomlink/product) un preces kartiņa |
vai prece vispār ir sagatavota, kāda ir tās sagatavotā cena, vai kategorija un zīmols ir sasaistīti, vai ir Veikala produkta ID. Kartiņu atver klikšķis uz preces nosaukuma sarakstā; turpat rindā ir arī divas mazas pogas — acs (kartiņa modālajā logā) un stetoskops, kas atver Diagnostiku uzreiz atfiltrētu uz šo preci. Zīmuļa ikonas rindā nav. Sīkāk: Preces kartiņa un rindas īsceļi | visiem, kam ir piekļuve ekrānam |
Žurnāli (Uzstādījumi → Žurnāli, ecomlink/logs) |
izpilžu rindas ar statusu un skaitītājiem + brīdinājumi un kļūdas | tikai sistēmas administratoram |
Žurnālu ekrāns ir aizvērts parastam lietotājam — maršruts ir slēgts un cilne nemaz netiek uzzīmēta. Ja vadības panelī pēc atjaunošanas redzat saiti Skatīt logu, bet, uzspiežot uz tās, saņemat paziņojumu, ka jums nav tiesību uz šo lapu, tas nav bojājums: saite tiek rādīta pēc parastās maršruta atļaujas, bet ekrānu sargā atsevišķa sistēmas administratora pārbaude. Tad žurnāla saturu jāprasa atbalstam.
📷 Ekrānattēls: ecomlink/diagnostics — ekrāns pēc meklēšanas: sarkanā spriedumu josla «Nav veikalā» un zem tās tabula «Publicēšanas pārbaude» ar zaļām ķeksīšu rindām un vienu sarkanu
📷 Ekrānattēls: ecomlink/ecomlink — vadības panelis ar vienu piegādātāja rindu stāvoklī «Kļūda» un vienu «Pabeigts ar brīdinājumiem»
📷 Ekrānattēls: ecomlink/product — atvērta preces kartiņa «Produkta detaļas» ar lauku «Veikala produkta ID» un grupu «Krājumu imports»
Ātrā pārbaudes secība
Šie soļi atsijā lielāko daļu gadījumu, un tos var izdarīt jebkurš, kam ir piekļuve moduļa ekrāniem:
Ja sūdzība ir par konkrētu preci, ātrāk ir Diagnostika. Cilnē Diagnostika ielīmējiet preces kodu, spiediet Pārbaudīt — un ekrāns atbild uz 2.–4. soli vienā gājienā, bet 1. solim blokā Grafiks parāda rindas Pēdējais krājumu imports un Pēdējais pilnais imports. Sešās no 20 sadaļām tas ir pirmais solis, jo ekrāns tur nosauc cēloni vārdā: 5., 6. un 8. sadaļā (rakstā Ja prece neparādās veikalā vai tās dati ir nepareizi) un 14., 15. un 19. sadaļā (rakstā Ja imports, grafiks vai ekrāni nestrādā). Sk. Diagnostika — kāpēc prece nav veikalā.
- Vai imports nostrādāja? Vadības panelī uzbrauciet ar peli uz piegādātāja rindas statusa punkta — uznirstošajā logā ir Pēdējā palaišana, Pievienoti, Atjaunoti un konfigurētais biežums.
- Vai prece ir sagatavota? Ekrānā Produkti atlasiet piegādātāju un meklējiet preci pēc piegādātāja produkta ID.
- Vai precei ir kategorijas un zīmola sasaiste? Tās kolonnās nedrīkst būt oranžā Sasaistīt zīmīte. Izņēmums: zīmols, kas ar nolūku sasaistīts uz -- Nav --, sarakstā izskatās nesasaistīts, bet publicēšanu neaptur — izšķir kartiņas lauks Veikala ražotājs.
- Vai pēc tam tika palaista veikala atjaunošana? Vadības panelī poga Palaist veikala atjaunošanu.
📷 Ekrānattēls: ecomlink/ecomlink — piegādātāja rindas statusa punkts ar atvērto logu «Pēdējā palaišana / Pievienoti / Atjaunoti»
Ja esat sistēmas administrators, pirms tam ir vērts izskatīt žurnālu: blokā Importa un veikala atjaunošanas izpildes atrodiet START rindu ar sava piegādātāja kodu un šodienas datumu, pārliecinieties, ka tai pašai run= vērtībai ir arī FINISH rinda, un nolasiet tās skaitītājus (inserted, updated, skipped, errors, retired, restored). Ja Žurnāli jums nav pieejami, šos trīs soļus palūdziet atbalstam — ko tieši uzrakstīt, ir raksta Ja imports, grafiks vai ekrāni nestrādā pēdējā sadaļā.
1. Datu plūsma nelejupielādējas
Kā izpaužas. Rinda vadības panelī pāriet stāvoklī Kļūda dažu sekunžu laikā. Žurnālā ir START, bet FINISH ir ar status=error, un cēlonis stāv turpat rindā error="…".
Ko meklēt kļūdas tekstā. Lejupielādētājs kļūdas ziņojumā ieliek paša piegādātāja atbildes pirmās ~300 zīmes (marķējums izņemts; garāka atbilde beidzas ar ..., un tas nenozīmē bojājumu). Rindas sākums izskatās šādi: EcomLink download failed (HTTP 403): … vai EcomLink download failed (transport error): …. Tieši atbildes teksts atšķir «IP nav atļauto sarakstā» no «nederīgs marķieris» aiz viena un tā paša 403.
Biežākie cēloņi.
| Statuss | Parasti nozīmē |
|---|---|
| 401 / 403 | mainīti vai beigušies pieejas dati, vai piegādātājs nav pielaidis mūsu servera IP adresi |
| 404 | mainījies faila ceļš (piem., piegādātājs nomainījis eksporta faila nosaukumu) |
| transport error | piegādātāja serveris neatbild vai savienojums pārtrūkst |
Ko darīt. Pārbaudiet cilni Datu plūsma: Datu plūsmas URL (HTTP resursdators) / FTP resursdators, Faila nosaukums, Lietotājvārds, Parole, Klienta / organizācijas ID. Ja pieejas dati ir mainījušies, tie jāsaņem no piegādātāja — modulis tos neuzmin. Skatīt Piegādātāja pievienošana.
Divas noderīgas detaļas: lejupielāde vienmēr iet tikai pa IPv4 (lai piegādātājs redzētu tieši to adresi, ko tam esam nosaukuši), un TLS sertifikāts netiek pārbaudīts — tātad «salauzts sertifikāts» nekad nav importa apstāšanās iemesls.
2. «Piegādātājam nav avota» vai saglabāšana tiek atteikta
Kā izpaužas. Divi dažādi gadījumi ar vienu sakni — adrese ir uzrakstīta tā, kā modulis to nepieņem.
a) Imports krīt ar kļūdu EcomLink: vendor "…" has no Feed URL / FTP host + file name and no cached source (src_cache). Tas nozīmē: nav norādīts ne resursdators ar faila nosaukumu, ne vesels URL, un iepriekš lejupielādēta faila arī nav.
b) Piegādātāja forma vispār netiek saglabāta — kļūda parādās angliski un saka, ka jāaizpilda vai nu datu plūsmas URL, vai FTP resursdators, bet ne abi. Tā ir apzināta pārbaude: FTP resursdators klusi uzvar pār datu plūsmas URL, tāpēc abu aizpildīšana nozīmētu, ka viens lauks izskatās aktīvs, bet netiek lietots.
Ko darīt. Izvēlieties vienu no diviem pareizajiem pierakstiem:
| Veids | Kā izskatās | Kad der |
|---|---|---|
| Resursdators + ceļš | Datu plūsmas URL = example.com, Faila nosaukums = exports/feed.xml |
vienmēr; vienīgais, kas der piegādātājam ar pavadošajiem failiem |
| Vesels URL | Datu plūsmas URL = https://api.example.com/feed?doc=1, Faila nosaukums tukšs |
tikai vienfaila piegādātājam |
Vērtība, kas beidzas ar slīpsvītru (example.com/feeds/), tiek uzskatīta par resursdatoru, nevis par veselu URL.
3. Formāts nav atpazīts vai tiek lasīts ar nepareizo parsētāju
Kā izpaužas. Divi pavisam dažādi scenāriji.
a) Skaļā versija. Imports krīt ar kļūdu EcomLink: could not resolve a parser for the source of vendor "…". Fails ir lejupielādēts, bet formātu nevar noteikt. Atpazīšana skatās pirmos 512 baitus: PK → XLSX, < → XML, { vai [ → JSON; ja tas nepalīdz — faila paplašinājums; ja arī tas ne — komats, semikols vai tabulācija galvā → CSV.
b) Klusā versija — daudz bīstamāka. Imports nostrādā «veiksmīgi», bet vai nu nesagatavo neko (inserted=0 updated=0), jo vispārīgais parsētājs failu nolasa, bet neatrod preces identitāti, vai sagatavo nepareizus krājumus, jo daudzums plūsmā ir nosacījums, ko vispārīgais parsētājs neprot izrēķināt.
Cēlonis. Piegādātājam ar savu īpašo parsētāju tas jāpiesprauž ar roku ekrānā Uzstādījumi → Integrācija — automātiskā noteikšana konkrēta vairumtirgotāja parsētāju nekad neizvēlas. Un vēl: ja piespraustais parsētājs vairs neeksistē reģistrā (izņemts vai pārsaukts), vērtība klusi atrisinās uz automātisko noteikšanu — no ekrāna tas izskatās tieši tāpat kā «nav piesprausts».
Ko darīt. Ekrāns Integrācija ir tikai sistēmas administratoram — parastam lietotājam tā nav izvēlnē. Piesakiet atbalstam vienā teikumā: «Piegādātāja kods X, lūgums ekrānā Integrācija piespraust parsētāju Y.» Sarakstu, kuram piegādātājam kurš parsētājs pienākas, skatiet rakstā Vairumtirgotāju parsētāji un pieejas dati. Ja piekļuve ir, ekrānā pārbaudiet kolonnu Parsētājs: rinda ar piespraustu parsētāju ir iekrāsota zila; rinda uz Automātiskā noteikšana — nav.
⚠️ Lauks Importa formāts piegādātāja formā (XML / XLSX / CSV / PIM / PIM2 / CUST) nav parsētāja izvēle — modulis to nelasa nekur. Tas ir tikai apzīmējums sarakstā.
📷 Ekrānattēls: ecomlink/parser — «Datu plūsmas parsētāji — Integrāciju centrāle» ar vienu zili iekrāsotu piespraustu rindu un vienu uz «Automātiskā noteikšana»
4. Imports beidzas «veiksmīgi», bet nekas nav sagatavots
Kā izpaužas. FINISH rindā status=success, bet inserted=0 updated=0 skipped=<liels skaitlis>. Ekrānā Produkti šim piegādātājam nav nevienas rindas.
Cēlonis. Krājumu imports nepievieno jaunas preces. Tas atjauno tikai komercdatus (statuss, cena, daudzums, krājumu statusi) precēm, kas jau ir sagatavotas. Piegādātāja pirmajam importam jābūt pilnajam.
Modulis par to brīdina, bet brīdinājums žurnālu ekrānā nav redzams: rinda WARNING: nothing staged for vendor=…: a stock import refreshes existing products only and will write nothing. nonāk tikai darbinieka izvades failā (ecomlink_import_<piegādātāja kods>.log) un turklāt tiek izvadīta vēl pirms izpildes atvēršanas, tāpēc tai nav pat run= piesaistes. Žurnālu ekrānā par šo gadījumu ir tikai FINISH rinda ar inserted=0 updated=0.
Ko darīt. Palaidiet Pilno importu. Uzmanību: pilnais imports ir tikai sistēmas administratoram — parastam lietotājam poga rindā nav pieejama, un pilnais imports netiek arī klusi aizstāts ar krājumu importu. Ja pilno importu nevarat palaist pats, rakstiet atbalstam: «Piegādātāja kods X, lūgums palaist pilno importu.»
Ir arī otrs ceļš: piegādātāja cilnē Importa uzvedība rūtiņa Import new products on stock runs (angliski) ļauj krājumu importam sagatavot arī vēl neredzētus artikulus — bet bez apraksta, attēliem un kategorijas, līdz palaists pilnais imports.
Ja kaut kas nestrādā
Ja neviens no šī raksta punktiem neatbilst, tas, ko savākt un kā uzrakstīt atbalstam, ir raksta Ja imports, grafiks vai ekrāni nestrādā pēdējā sadaļā.