Šajā rakstā ir ekrāna Pārsaiste praktiskā daļa: kā lauku pārsaistīt un atiestatīt, kāpēc Modelis ir vienīgais bīstamais lauks un kā ar sauso palaišanu pārbaudīt rezultātu, neko nerakstot. Kas šis ekrāns ir un kā tas izskatās — Lauku pārsaiste (remap) — kas tas ir un ekrāna uzbūve. Kā tiek uzrakstīta avota adrese un no kurienes nāk izvēlnes saturs — Lauku pārsaiste — avota adreses un izvēlnes saturs.
Kā pārsaistīt lauku
- Pārliecinieties, ka piegādātājam ir lejupielādēta datu plūsma — citādi sarakstos būs tikai noklusējumi.
- Atveriet Uzstādījumi → Pārsaiste un izvēlieties piegādātāju.
- Vajadzīgajā rindā izvēlnē Avota elements norādiet elementu, kas šo īpašību tiešām sniedz. Pārējās rindas atstājiet uz noklusējuma.
- Nospiediet Saglabāt. Parādās «Lauku pārsaiste saglabāta.», mainītās rindas kļūst zilganas, un piegādātājs parādās pārskata tabulā.
- Palaidiet sauso palaišanu un pārbaudiet, ka kolonnās Identity, cena un daudzums ir tas, ko gaidījāt.
- Palaidiet importu — tikai tas pārsaisti reāli piemēro (skat. Preču imports).
Ko saglabāšana dara klusi: izvēle, kas atkārto noklusējumu, netiek glabāta kā pārrakstījums, un, ja visas 23 rindas ir uz noklusējuma, pārsaiste tiek notīrīta pilnībā.
Nederīga adrese netiek klusi izmesta. Pārējais saglabājas, bet «Lauku pārsaiste saglabāta.» vietā parādās angliska brīdinājuma josla ar uzskaitītajām noraidītajām adresēm: «Saved, except: … could not be used as a source address and was not stored.» Adresē drīkst būt tikai latīņu burti, cipari, pasvītra, punkti, domuzīmes, viens nosaukumtelpas prefikss un viens beigu @atribūts, un tai jāsākas ar burtu, pasvītru vai — ja adresēts tiek paša ieraksta atribūts — ar @. Tāpēc kolonna ar atstarpi (Product Code), komatu (Cena, EUR), garumzīmi (Krājums) vai ciparu sākumā (1C_kods) izvēlnē būs redzama, bet saglabāta netiks.
Kā pārbaudīt, vai pārsaiste tiešām nostrādāja
Saglabāšana un rezultāts ir divas dažādas lietas, un starp tām ir vesels imports:
- Ekrāna apakšā pārskata tabulā Piegādātāji ar lauku pārsaisti (sk. Lauku pārsaiste (remap) — kas tas ir un ekrāna uzbūve) atrodiet savu piegādātāju un salīdziniet kolonnu Pārsaiste ar to, ko gribējāt saglabāt. Ja rindas nav, saglabāts nav nekas.
- Palaidiet sauso palaišanu ar profilu Full import un pārbaudiet pelēkajā kontekstā rindu Remapped: … — tur jābūt tai pašai adresei.
- Sausās palaišanas tabulā paskatieties kolonnu Fields this item carried: ja jūsu adrese tur neparādās, plūsma šo lauku konkrētajām rindām nesūta, un vainīga nav pārsaiste.
- Palaidiet importu un pēc tam pārbaudiet dažas preces ekrānā Produkti — tikai imports pārsaisti reāli piemēro.
- Ja vērtība nemainījās, atdaliet divus gadījumus: nekas nemainījās nozīmē, ka adrese neatrada neko (vecā vērtība palika); vērtība pazuda nozīmē, ka adrese atrada tukšu elementu. Sk. Lauku pārsaiste — avota adreses un izvēlnes saturs, sadaļu «Trūkstošs elements un tukšs elements nav viens un tas pats».
Kā atiestatīt pārsaisti uz noklusējumu
- Izvēlieties piegādātāju — poga parādās tikai tad, kad pārrakstījumi tiešām ir.
- Nospiediet Atiestatīt uz noklusējumu un apstipriniet logā. Ziņojums: «Lauku pārsaiste notīrīta.»
- Pārliecinieties, ka piegādātājs ir pazudis no pārskata tabulas apakšā.
- Palaidiet importu — līdz tam preces joprojām nes vecās pārsaistes rezultātu, jo notīrīta tika recepte, nevis jau sagatavotie dati.
⚠️ Atiestatīšana neatgriež iepriekšējās vērtības precēm. Tā tikai liek nākamajam importam atkal lasīt noklusējuma elementus; ja to starplaikā plūsmā nav, laukus atsvaidzinās nākamais gājiens, kurā tie ir.
Modelis — vienīgais bīstamais lauks
Rindai Modelis (identitāte) zem nosaukuma ir sarkans brīdinājums: «Modelis ir produkta identitāte. Mainot tā avotu, nākamajā importā šī piegādātāja produktiem tiek mainītas atslēgas (vecās rindas tiek izņemtas no aprites, jaunas ievietotas).»
Praksē: pēc model avota maiņas nākamajā importā neviena vecā artikula plūsmā vairs nav — visi ienāk ar jaunām atslēgām. Importa beigu pārbaude, kas atslēdz plūsmā trūkstošās preces, tādā gadījumā atsakās strādāt (tās ierobežojums Datu plūsmā trūkstošo atslēgšanas ierobežojums pēc noklusējuma ir 20 % no piegādātāja kataloga — maināms piegādātāja formas cilnē Importa uzvedība —, un šeit pazūd 100 %), tāpēc vecās rindas paliek ieslēgtas, un blakus tām parādās viss katalogs no jauna. Rezultāts ir dubults katalogs, nevis pārsaukts.
Tāpēc model avotu maina tikai apzināti un ar plānu, kā vecās rindas sakārtot. Pārējām 22 īpašībām šādu seku nav.
Ja identitāte tomēr jāmaina, tad šādā secībā:
- Izvēlieties jauno avotu rindā Modelis (identitāte), bet vēl nesaglabājiet.
- Vispirms palaidiet sauso palaišanu ar profilu Full import un paskatieties kolonnu Identity: tur jau redzams, kādas atslēgas ienāktu. Ja tur ir tukšums vai atkārtojumi, tālāk iet nevajag.
- Pārbaudiet, ka visām parauga rindām zīmīte ir New product — tas apstiprina, ka neviena vecā atslēga vairs nesakrīt, un tieši tāpēc rodas dubultais katalogs.
- Vienojieties, ko darīt ar vecajām rindām: tās netiks atslēgtas pašas, jo plūsmā pazūd 100 % kataloga un nostrādā tas pats atslēgšanas ierobežojums.
- Tikai tad saglabājiet un palaidiet pilno importu.
- Pēc importa ekrānā Produkti filtrējiet pēc šī piegādātāja ar filtru Nav atjaunots N dienas — tur būs tieši vecās rindas, kuras vairs neviens neatjauno.
Sausā palaišana (Dry run)
Uz šo pašu sadaļu ved arī poga «Dry run this vendor» ekrānā «Vendor profiles» — tā ir cilne nolaižamajā Uzstādījumi un latviskajā panelī saucas angliski; sk. Piegādātāju profili — kas tie ir; pati poga un tās plāna tabula — Piegādātāju profili — piemērošana un plāns.
Zem redaktora ir sadaļa Dry run ar mēģenes ikonu. Tā parsē failu, kas jau ir uz diska, ar piegādātāja pašreizējiem iestatījumiem un parāda, ko pirmās rindas sagatavotu. Tā neko neraksta un neko nelejupielādē, tāpēc to var palaist tik reižu, cik vajag. Lapas atvēršana to nekad nepalaiž pati. Visa sadaļa latviešu panelī ir angliski.
Forma: Profile (Stock refresh / Full import; noklusējums — krājumu atjaunošana) · Rows (20 / 50 / 100) · poga Dry run. Izvēle nonāk adresē kā preview=1, preview_profile un preview_rows, tāpēc konkrētu sauso palaišanu var atvērt ar saiti.
Divas izvēles, kas izskatās sīkumi, bet nav: noklusējuma profils ir krājumu atjaunošana tāpēc, ka tas ir vienīgais profils, ko kaut kas plāno automātiski, un pirmā importa pārsteidzošākais iznākums — «nekas nenotika, neviens artikuls nav pazīstams» — ir tieši krājumu iznākums; sākot ar Full import, tas paliktu neredzams. Un 20 rindas ir paraugs, nevis ierobežojums no skopuma: uz jautājumu «vai šī konfigurācija plūsmu nolasa pareizi» atbild jau pirmās rindas; 50 un 100 ir tam gadījumam, kad pirmās izskatās labi, bet tālāk kaut kas nav kārtībā.
Rezultāts sākas ar verdikta rindu: «N record(s) read: N would be added, N refreshed, N left alone.» Joslas krāsa pati ir informācija: zila — nolasīts; sarkana — no plūsmas netika nolasīts neviens ieraksts; dzeltena — visi pārējie iemesli.
Ja nolasīt neizdevās, tur ir konkrēts iemesls, un katrs no tiem noved pie citas darbības:
| Verdikts | Ko tas nozīmē | Kur to labo |
|---|---|---|
| «Nothing has been downloaded for this vendor yet…» | uz diska nav faila; sausā palaišana ar nolūku nekad nelejupielādē | palaist importu vai atjaunot avotu |
| «No parser could be resolved…» | parsētājs nav piesprausts un failu neizdevās atpazīt. Piezīme turpat: piegādātājs, kas atstāts uz automātiskās noteikšanas, nedabū arī nevienu konfigurācijas atslēgu | ekrāns Integrācija (tikai sistēmas administratoram) |
| «…the current settings read NO records from it» | fails lasās, bet ieraksti netiek atrasti — gandrīz vienmēr ieraksta elements vai records_key |
sk. Lauku pārsaiste — avota adreses un izvēlnes saturs, «Kā atrast pareizo ieraksta elementu» |
| «The parser could not read this feed: …» | parsētājs pats kļūdījās; aiz kola ir tā kļūda | atkarībā no kļūdas — plūsma vai parsētājs |
Zem tā pelēkā rakstā ir konteksts, bez kura atsevišķa rinda nav saprotama: kurš fails, cik liels un cik vecs tika lasīts un ar kādu parsētāju (izmērs tiek rādīts lasāmā mērvienībā līdz pat TB — tieši pēc tā spriež, vai 20 rindas ir paraugs no visas plūsmas vai gandrīz viss fails, un pēc lejupielādes laika — vai vispār tiek skatīti šodienas dati); brīdinājums, ja piegādātājam ir piegādātāja parsētājs (tāds var nolasīt visu plūsmu, pirms atdod pirmo ierakstu, un sausā palaišana tad aizņem tikpat ilgi, cik īsts parsēšanas gājiens); parsētāja iestatījumi; rinda Remapped: … vai «No remapping — every property reads its default element.»; un cenu pārrēķini — valūtas konvertācija un datu plūsmas PVN atdalīšana.
Tabulas kolonnas: # · Identity · Price (excl. VAT) · Quantity · Import (Jā/Nē) · Name (tikai pilnajā profilā) · What would happen · Fields this item carried.
Divas kolonnas ir vērtīgākas, nekā izskatās. Price (excl. VAT) tiek rādīta ar 2–4 zīmēm aiz komata, jo tik daudz glabā pati sagatavotā kolonna — noapaļota divciparu cena te slēptu tieši to starpību, ko meklē, kad cena «gandrīz sakrīt». Un Fields this item carried uzskaita, kādus laukus šī konkrētā rinda tiešām atnesa: ja pārsaistītās adreses tur nav, plūsma šai precei to nesūta, un vainas pārsaistē nav.
| Zīmīte | Nozīme |
|---|---|
| New product (zaļa) | šāda artikula piegādātājam vēl nav — tas tiktu pievienots |
| Refresh (zila) | artikuls jau ir — tiktu atsvaidzinātas tieši tās kolonnas, kas uzskaitītas rindā Writes: |
| Nothing (sarkana vai pelēka) | nekas nenotiktu; sarkana nozīmē, ka imports to atteica |
Zem zīmītes var būt paskaidrojums, un tas ir tabulas galvenā vērtība: cena ir 0 un prece tiktu pievienota izslēgta; preces nav noliktavā, tāpēc jauna prece ienāktu izslēgta; artikuls vēl nav sagatavots, un krājumu atjaunošana jaunas preces nekad nepievieno; prece neizturēja importa pārbaudes; pati datu plūsma šo preci atzīmējusi kā neimportējamu.
Ko sausā palaišana neaptver — tas rakstīts arī ekrānā: plūsmā trūkstošo preču pārbaudi (tai vajadzīga visa plūsma, lai pazudušu artikulu atšķirtu no esoša), variantu bērnus, kā arī PIM un attēlu soļus. Ja parauga beigās ir rindiņa «The feed continues past these rows…», redzētais ir parauga sākums, nevis viss fails.
Kā izlasīt sausās palaišanas rezultātu
- Vispirms izlasiet verdikta joslu un tās krāsu. Sarkana nozīmē, ka tālāk tabulu skatīties nav jēgas — vispirms jārisina ieraksta elements.
- Pelēkajā kontekstā pārbaudiet faila lejupielādes laiku. Vecs fails nozīmē, ka vērtējat vakardienas plūsmu ar šodienas iestatījumiem.
- Turpat pārbaudiet rindu Remapped: … — vai tajā tiešām ir tā adrese, ko saglabājāt.
- Turpat izlasiet cenu pārrēķinus (valūtas konvertācija, plūsmas PVN atdalīšana): kolonna Price (excl. VAT) rāda rezultātu pēc tiem, tāpēc plūsmas cena ar to nesakritīs un tā nav kļūda. Sk. Nodoklis piegādātājam — divi lauki un cenas ķēde.
- Tabulā skatieties zīmīti un paskaidrojumu zem tās, nevis pašu skaitli — paskaidrojums nosauc konkrēto kārtulu, kas rindu apturēja.
- Kad kaut kas neatbilst gaidītajam, salīdziniet kolonnu Fields this item carried ar savu adresi. Ja adreses tur nav, jautājums ir par plūsmu; ja ir, bet vērtība nepareiza — par adresi.
📷 Ekrānattēls: ecomlink/remap — sausās palaišanas rezultāts: verdikta josla, pelēkais konteksta bloks un tabula ar «New product» / «Refresh» / «Nothing» zīmītēm
Ja kaut kas nestrādā
Saglabāju, bet parādījās angliska brīdinājuma josla, nevis «Lauku pārsaiste saglabāta.» Vismaz viena adrese neiztur pārbaudi — parasti tāpēc, ka nosaukumā ir atstarpe, komats, garumzīme vai cipars sākumā. Viss pārējais ir saglabāts; noraidītās adreses ir uzskaitītas pašā ziņojumā.
Saglabāju pārsaisti, bet importā nekas nemainījās. Vai nu piegādātājam piesprausts konkrēta vairumtirgotāja parsētājs (tāds pārsaisti neizmanto vispār), vai imports pēc izmaiņas vēl nav palaists — pārsaiste tiek nolasīta tikai importa brīdī. Ko imports tiešām izdarīja, redzams ekrānā Žurnāli.
Sausajā palaišanā visām rindām ir «Nothing». Ja paskaidrojumā rakstīts, ka artikuls vēl nav sagatavots, izvēlēts ir profils Stock refresh — krājumu atjaunošana jaunas preces nekad nepievieno. Pārslēdziet uz Full import.
Pārsaistīju lauku, un vērtība precēm pazuda pavisam. Adrese trāpa uz elementu, kas plūsmā ir, bet tukšs — tukšs elements nozīmē «atsūtīts tukšs», un imports vērtību notīra. Tas atšķiras no drukas kļūdas adresē: tāda neatrod neko, un vecā vērtība paliek. Pārbaudiet adresi sausajā palaišanā kolonnā Fields this item carried.
Pēc model pārsaistīšanas katalogs veikalā parādījās divreiz. Tā ir gaidāmā sekas: identitātes maiņa ienes visu katalogu kā jaunas preces, bet vecās netiek atslēgtas, jo nostrādā datu plūsmā trūkstošo atslēgšanas ierobežojums. Pirms šāda soļa vienmēr palaidiet sauso palaišanu.
Kļūmes, kas parādās izvēlnēs Avota elements — tikai noklusējumi, trūkstošs elements, atbildes apvalka locekļi — ir aprakstītas rakstā Lauku pārsaiste — avota adreses un izvēlnes saturs.