Šajā rakstā ir ekrāns Pārsaiste: kam tas ir domāts, kuriem parsētājiem tas vispār darbojas, kā ekrāns ir uzbūvēts un kuras 23 produkta īpašības var pārsaistīt. Kā tiek uzrakstīta avota adrese un no kurienes izvēlnēs rodas elementi — Lauku pārsaiste — avota adreses un izvēlnes saturs. Kā lauku pārsaistīt, pārbaudīt rezultātu un palaist sauso palaišanu — Lauku pārsaiste — pārsaistīšana un sausā palaišana.
Ekrāns Pārsaiste (maršruts ecomlink/remap, virsraksts Lauku pārsaiste — Integrāciju centrāle; «Integrāciju centrāle» ir moduļa nosaukums saskarnē — kodā un adresēs tas ir EcomLink) atbild uz vienu jautājumu: kurš datu plūsmas elements sniedz kuru preces īpašību. Standarta formātu lasītāji sagaida noteiktus nosaukumus — cena ir price, atlikums quantity, artikuls model. Kad piegādātāja fails šos pašus datus sauc citādi (Cena, stock, ArticleNo), šeit katrai īpašībai norāda citu avota elementu, un pārējais imports paliek nemainīgs.
Ekrāna ievads: «Katram piegādātājam izvēlieties, kurš datu plūsmas elements sniedz katru produkta īpašību. Atstājiet īpašību pie tās noklusējuma elementa, lai to importētu kā līdz šim. Tiek mainīts tikai avota elements — īpašības iekšējā apstrāde paliek nemainīga.»
Cilne atrodas nolaižamajā cilnē Uzstādījumi, un šo cilņu grupu vispār uzzīmē tikai sistēmas administratoram (sk. EcomLink — kas tas ir un kā tas ir iekārtots). Rediģēšanai vajag modify tiesības uz ecomlink/remap; bez tām izvēlnes ir pelēkas, pogas Saglabāt nav, un serveris atbild ar «Uzmanību: Jums nav tiesību mainīt Integrāciju centrāles lauku pārsaisti!».
Pārsaiste tiek nolasīta importa brīdī, nevis veikala atjaunošanā — izmaiņa stājas spēkā ar nākamo importu un neko nemaina ar atpakaļejošu datumu.
📷 Ekrānattēls: ecomlink/remap — ekrāns bez izvēlēta piegādātāja: zilā ievada kaste, piegādātāja izvēlne un pelēkais uzaicinājums «Izvēlieties piegādātāju augšpusē…»
Kad pārsaiste strādā un kad nē
Pārsaisti nolasa tikai četri vispārīgie (standarta) parsētāji: Standard XML, Standard CSV, Standard JSON un Standard XLSX.
Konkrētu vairumtirgotāju parsētāji pārsaisti apzināti neņem vērā — tiem lauku nosaukumi ir iebūvēti, un šeit saglabātā izvēle paliek gulēt, neietekmējot importu. Kurš parsētājs piegādātājam piesprausts, redzams ekrānā Integrācija (skat. Atbalstītie formāti un parsētāja izvēle).
Pārsaistīt var tikai 23 vienkāršās (skalārās) īpašības. Preces nosaukums un apraksts (name_lv, description_lv), attēlu un kategoriju saraksti, atribūti, opcijas, akcijas un atlaides nav pārsaistāmi — to iekšējie nosaukumi ir fiksēti.
Ekrāna uzbūve
1. Piegādātāja izvēlne augšā. Pirmais ieraksts ir --- Izvēlieties piegādātāju ---; izvēloties piegādātāju, lapa pārlādējas pati. Sarakstā ir visi neizdzēstie piegādātāji formātā kods — nosaukums, kārtoti pēc koda — arī tie, kuriem imports ir izslēgts. Kamēr piegādātājs nav izvēlēts: «Izvēlieties piegādātāju augšpusē, lai rediģētu tā lauku pārsaisti.»
Izvēle nonāk lapas adresē kā filter_vendor=<kods>, tāpēc konkrēta piegādātāja redaktoru var atvērt ar tiešu saiti un to var saglabāt grāmatzīmēs. Kods, kāda piegādātāja nav (piemēram, izdzēsts vai pārrakstīts adresē), tiek klusi uzskatīts par neizvēlētu piegādātāju — kļūdas nav, redaktora vienkārši nav.
⚠️ Poga Rādīt blakus izvēlnei ir tikai atkāpšanās ceļš: veidne to zīmē tikai tad, ja pārlūkā ir izslēgts JavaScript. Parastā panelī tās nav, un pareizi — izvēle nostrādā pati.
2. Rinda par atklātajiem elementiem. Ja kešotajā datu plūsmā elementi atrasti, virs tabulas ir pelēks teksts ar lupas ikonu: «Šī piegādātāja kešotajā datu plūsmā atrasti N atšķirīgi elementi — izvēlieties tos zemāk esošajos sarakstos.» Ja nav — tur ir brīdinājuma kaste (sk. Lauku pārsaiste — avota adreses un izvēlnes saturs, sadaļu «Kad izvēlnēs ir tikai noklusējumi»).
3. Redaktora tabula ar kolonnām Produkta īpašība · Avota elements (nolaižamā izvēlne) · Noklusējuma elements (pelēks koda rāmītis). Rinda, kurā izvēlēts kaut kas cits, nevis noklusējums, ir izcelta ar zilganu fonu.
Katrā izvēlnē ir noklusējuma elements (tam blakus iekavās noklusējums), visi datu plūsmā atklātie elementi un jau saglabātā izvēle — pēdējā tāpēc, lai plūsmas maiņa klusi neizmestu veco lēmumu.
4. Poga Saglabāt.
5. Poga Atiestatīt uz noklusējumu — parādās tikai tad, kad izpildās abi nosacījumi: lietotājam ir modify tiesības un šim piegādātājam pārrakstījumi tiešām jau ir. Atver apstiprinājuma logu: «Atiestatīt šī piegādātāja lauku pārsaisti uz noklusējuma vērtībām?» ar pogām Atcelt un Atiestatīt uz noklusējumu. Rezultāts: «Lauku pārsaiste notīrīta.»
6. Sausās palaišanas sadaļa — tai ir savs raksts: Lauku pārsaiste — pārsaistīšana un sausā palaišana.
7. Pārskata tabula apakšā — Piegādātāji ar lauku pārsaisti, kolonnas Piegādātājs (saite uz šī piegādātāja redaktoru — tā pati filter_vendor adrese) · Pārrakstījumi (skaits) · Pārsaiste (kompakts saraksts formātā īpašība ← elements). Tabulā nonāk tikai tie piegādātāji, kuriem pēc pārbaudes paliek vismaz viens derīgs pārrakstījums, tāpēc tā ir arī ātrākais veids, kā redzēt, ka saglabātais tiešām ir saglabājies. Ja nav neviena: «Neviens piegādātājs vēl nav pārsaistījis nevienu lauku.»
Kolonnā Pārsaiste redzams tas pats īpašība ← elements pieraksts, ko sausā palaišana izvada rindā Remapped: (sk. Lauku pārsaiste — pārsaistīšana un sausā palaišana) — tas ir viens un tas pats saraksts, tikai divās vietās.
📷 Ekrānattēls: ecomlink/remap — izvēlēts piegādātājs: pelēkā rinda par atklātajiem elementiem un redaktora tabula ar dažām zilgani izceltām rindām un atvērtu «Avota elements» izvēlni
23 īpašības un to noklusējuma elementi
| Produkta īpašība | Noklusējuma elements | Produkta īpašība | Noklusējuma elements |
|---|---|---|---|
| Modelis (identitāte) | model |
MPN | mpn |
| Imports | status |
EAN | ean |
| Daudzums | quantity |
SKU | sku |
| Cena (bez PVN) | price |
Ražotājs | manufacturer |
| Nodokļu klase | tax_class |
Garums | length |
| Mērvienība | unit |
Platums | width |
| Mērvienības ID | unit_id |
Augstums | height |
| Mērvienības daudzums | unit_quantity |
Garuma klase | length_class_id |
| Pieaugušajiem | adult |
Svars | weight |
| Statuss, kad nav noliktavā | out_of_stock_status |
Svara klase | weight_class_id |
| Statuss, kad ir noliktavā | in_stock_status |
Galvenais attēls | title_image |
| Minimālais daudzums | min_quantity |
Trim īpašībām nosaukums un noklusējuma elements atšķiras: Nodokļu klase lasa tax_class, Statuss, kad nav noliktavā — out_of_stock_status, Statuss, kad ir noliktavā — in_stock_status.
CSV un XLSX gadījumā «elements» ir kolonnas nosaukums, JSON gadījumā — locekļa nosaukums; noklusējumi ir tie paši.
Ja kaut kas nestrādā
Ciļņu joslā nav nolaižamās cilnes «Uzstādījumi», tātad arī cilnes «Pārsaiste». Šo cilņu grupu uzzīmē tikai sistēmas administratoram, un tā nav tiesību rūtiņa lietotāju grupā. Atšķirībā no Integrācijas, Žurnāliem un Vendor profiles pats maršruts ecomlink/remap sistēmas administratora statusu tomēr neprasa: lietotājs, kura grupai ir piekļuve šim maršrutam, ekrānu atver pa tiešo saiti. Ja arī tā nesanāk — rakstiet atbalstam.
Izvēlnes ir pelēkas un pogas «Saglabāt» nav. Ekrāns ir atvērts, bet lietotāja grupai nav modify tiesību uz maršrutu ecomlink/remap. Tās piešķir veikala administrators sadaļā Mans veikals → Lietotāji → Lietotāju grupas; mēģinājums saglabāt tik un tā atbild ar «Uzmanību: Jums nav tiesību mainīt Integrāciju centrāles lauku pārsaisti!».
Pogas «Atiestatīt uz noklusējumu» nav. Tā parādās tikai tad, kad izpildās abi nosacījumi: ir modify tiesības un šim piegādātājam tiešām ir vismaz viens saglabāts pārrakstījums. Ja piegādātājs stāv uz tīriem noklusējumiem, atiestatīt nav ko, un pogas nav ar nodomu.
Piegādātāja izvēlnē nav vajadzīgā piegādātāja. Sarakstā ir visi neizdzēstie piegādātāji, arī tie, kuriem imports izslēgts — tātad trūkstošais piegādātājs ir izdzēsts.
Pārējās kļūmes ir aprakstītas abos pārējos rakstos — pēc tā, kurā ekrāna daļā tās parādās.
- Izvēlnēs ir tikai noklusējumi, nav vajadzīgā elementa, vai tie izskatās pēc atbildes apvalka — sk. Lauku pārsaiste — avota adreses un izvēlnes saturs, sadaļu «Ja kaut kas nestrādā».
- Saglabāšana neizdodas, imports nemainās, sausā palaišana rāda «Nothing», vērtība pazuda vai katalogs parādījās divreiz — sk. Lauku pārsaiste — pārsaistīšana un sausā palaišana, sadaļu «Ja kaut kas nestrādā».