Piegādātāju profili — piemērošana un plāns

Šajā rakstā ir viss, kas notiek pēc tam, kad profils katalogā ir atrasts: soļi, plāna tabula ar trim iznākumiem, jautājumi, uz kuriem profils atbildēt nevar, ko sistēma ieraksta pēc pogas «Apply profile», un sausā palaišana. Kas profils vispār ir, kur cilne atrodas, kāpēc to redz tikai sistēmas administrators un kāpēc ekrāna teksti zemāk citēti angliski — Piegādātāju profili — kas tie ir.

Divas dažādas «profila» nozīmes. Šajā rakstā «profils» vienmēr ir piegādātāja profils — katalogs ar zināšanām par vienu piegādātāju. Citviet Integrāciju centrālē «profils» nozīmē palaišanas veidu: krājumu atjaunošanu vai pilno importu (ekrānā angliski Stock refresh / Full import). Tos nejauciet — sadursme notiek tieši sausās palaišanas ekrānā, uz kuru šis raksts beigās sūta.

Kā piemērot profilu — soli pa solim

1. Filtrā «Piegādātājs» izvēlieties piegādātāju.
2. Filtrā «Profile» izvēlieties profilu, kura nosaukums sākas ar tā paša piegādātāja kodu.
3. Spiediet «Show what would change». Zemāk parādās plāns.
4. Izlasiet dzelteno kasti virs tabulas (ja tāda ir) — tie ir jautājumi, uz kuriem profils neatbild.
5. Izejiet cauri rindām ar «Replace this value» un izlemiet, kuras atzīmēt (kritērijs — zemāk).
6. Spiediet «Apply profile».
7. Pārliecinieties, ka pārbūvētajā plānā visas rindas tagad lasās «Already matches».
8. Atveriet piegādātāja formu un ievadiet to, ko profils nenes: cilnē Datu plūsma — resursdatoru, faila nosaukumu un pieejas datus; pēc tam visu, kas bija dzeltenajā kastē.
9. Palaidiet «Dry run this vendor» un pārslēdziet tur lauku Profile uz Full import.

Plāns: trīs iespējamie iznākumi

Plāna tabulai ir piecas kolonnas: «Setting» (iestatījums) · «Owned by» (kurš ekrāns to pārvalda) · «This vendor now» (kas piegādātājam ir šobrīd; tukšai vērtībai raksta «not set») · «The profile» (ko piedāvā profils) · «What happens».

Virs tabulas ir kopsavilkuma rinda formā «%d setting(s) to fill, %d already set differently, %d already matching.» — cik aizpildīsies, cik ir citādi un cik jau sakrīt.

⚠️ «Will fill» nav automātiski drošs. Plāna rindās ir arī Modelis (identitāte) — preces identitāte. Profilu piemēro pirms pirmā importa. Ja piegādātājam veikalā jau ir preces, pirms «Apply profile» atrodiet plānā tieši šo rindu: ja tur ir «Will fill» vai atzīmēts «Replace this value», nākamajā importā viss piegādātāja katalogs ienāks kā jaunas preces, bet vecās rindas paliks ieslēgtas (trūkstošo preču drošības ierobežojums — 20 % — nostrādā un neatslēdz neko). Rezultāts ir dubults katalogs, nevis pārsaukts. Tādā gadījumā neizpildiet piemērošanu pats — vienojieties ar atbalstu. Sīkāk: Lauku pārsaiste — pārsaistīšana un sausā palaišana, sadaļa «Modelis — vienīgais bīstamais lauks».

Kad atzīmēt «Replace this value». Tas ir vienīgais īstais lēmums šajā ekrānā:

• Jauns piegādātājs, kas vēl nav importējis — drīkst atzīmēt visu. Tur nav neviena lēmuma, ko kāds būtu pieņēmis apzināti.
• Piegādātājs, kas jau strādā — neatzīmējiet Modelis (identitāte), Datu plūsmas cenu PVN un Datu plūsmas cenu valūta, kamēr nav skaidrs, kāpēc tur stāv cita vērtība. Tur var būt kāda apzināta izvēle. Un atcerieties sekas: PVN vai valūtas maiņa nav «tehnisks iestatījums» — tā pārrēķina katras preces cenu jau nākamajā importā.

Vēl viens tukšuma gadījums, kas nav kļūda: rindā Datu plūsmas cenu PVN tukša šūna kolonnā «The profile» nozīmē «Nav (datu plūsmas cenas jau ir neto)» — 0 % tiek rādīts kā tukšums. Uzraksts «not set» parādās tikai kolonnā «This vendor now»; kolonnā «The profile» tukšums paliek vienkārši tukšs.

Šī asimetrija starp «Will fill» un «Replace this value» ir tā, kas padara katalogu atkārtoti piemērojamu. Izlabotu profilu var pārlaist pāri visiem veikaliem: tukšie aizpildās, sakritības klusē, bet lokālie lēmumi, ko kāds savulaik izdarīja ar roku, uzpeld kā konflikti cilvēkam, nevis tiek klusi noslaucīti.

Kolonna «Owned by» vienmēr nosauc to ekrānu, kurā šo pašu iestatījumu mainītu ar roku: Integration (Integrācija — parsētājs), Feed configuration (Datu plūsmas konfigurācija), Remapping (Pārsaiste) vai Vendor form (piegādātāja forma).

📷 Ekrānattēls: ecomlink/profile — plāna tabula ar visām trim darbībām: «Will fill», «Already matches» un atzīmējams «Replace this value»

Ko profils nevar izlemt jūsu vietā

Ja profilam ir jautājumi, virs plāna parādās dzeltena kaste ar virsrakstu «Confirm these before the first import - a profile cannot answer them for you:» un sarakstu.

Tur nonāk tieši tie jautājumi, uz kuriem pierādījumi neatbild: kura no cenu kolonnām atbilst jūsu līgumam, vai plūsma norāda cenas ar PVN vai bez, kāda piemaksa šim piegādātājam bijusi līdz šim, kāds krājumu statuss jāiestata pirms pirmās palaišanas. Katalogs apzināti pieraksta tikai to, kas ir zināms — minējums, kas nokļūtu profila vērtībās, tiktu piemērots klusi.

Bet brīdinājums par to, ko tur ieraudzīsiet. Šīs piezīmes ir rakstītas integrācijas uzturētājam: angliski, saīsinātā valodā, ar LIELIEM BURTIEM, mērījumu datumiem un rindu skaitiem, un dažviet ar norādēm uz iekšējiem dokumentiem, kas veikala īpašniekam nav pieejami. Tas nav tulkots teksts lietotājam.

Piemērs, kāds tas izskatās dzīvē (MOBILUX profils, saīsināti):

«SURCHARGE: SET "1 EUR" ON THE VENDOR FORM … do not also add a 1.00 EUR tier to the markup plan, or every product is charged the euro twice.»

Ko ar to izdarīt: piegādātāja formas cilnē Vispārējie laukā Cenas piemaksa ievadiet 1 € — un neielieciet to pašu vēlreiz uzcenojuma plānā, citādi eiro tiks pieskaitīts divreiz katrai precei. Cita piegādātāja piezīmē var būt norāde uz iekšēju failu (piemēram, .docs-parser/…) — to jūs atvērt nevarēsiet.

Noteikums: ja kādu punktu nesaprotat, nespiediet «Apply profile». Nokopējiet to punktu atbalstam un pajautājiet.

Izlasiet šo sarakstu pirms piemērošanas: liela daļa no tā attiecas uz laukiem, kurus profils neaiztiek vispār (piemaksa, pieejas dati, krājumu statusi).

📷 Ekrānattēls: ecomlink/profile — dzeltenā «Confirm these before the first import» kaste ar profila jautājumu sarakstu

Kā notiek piemērošana

Poga «Apply profile»; turpat blakus, pa labi no pogas, ir paskaidrojums «Empty settings are filled. A setting this vendor already holds differently is only replaced where you ticked it.»

Pārlūks nosūta tikai to, kuri konflikti ir atzīmēti — nekad pašas vērtības. Plāns tiek pārbūvēts no jauna no kataloga un no dzīvās piegādātāja rindas, tāpēc novecojusi forma (kāds paralēli izrediģēja piegādātāju citā cilnē) piemēro pret to, kas tiešām ir datubāzē.

Atcelšanas pogas nav. Iepriekšējās vērtības nekur netiek saglabātas. Ja piemērošana bija nepareiza, katru iestatījumu būs jāatgriež ar roku tajā ekrānā, kas norādīts kolonnā «Owned by» — Integrācijā, Datu plūsmas konfigurācijā, Pārsaistē un piegādātāja formā atsevišķi. Tāpēc pirms konfliktu atzīmēšanas nofotografējiet vai pierakstiet kolonnu «This vendor now».

Ko sistēma ieraksta un kādā secībā

Tā nav jūsu instrukcija — tie ir soļi, ko pēc pogas nospiešanas izpilda pati sistēma. Secība ir svarīga, jo no tās izriet viens klusais efekts (brīdinājums tūlīt aiz saraksta):

1. Parsētājs — pirmais, jo no tā tiek būvēts derīgo datu plūsmas iestatījumu saraksts.
2. Datu plūsmas konfigurācija — profila atslēgas tiek saplūdinātas ar to, kas jau ir, nekad neaizstājot visu dokumentu. Tur glabājas arī piegādātāja pieejas dati, kurus profils nepazīst; pilna pārrakstīšana tos izdzēstu, un «profila piemērošana» nozīmētu «salauzt lejupielādi».
3. Lauku pārsaiste — arī saplūdināta, un rakstīta caur to pašu validatoru, ko lieto Pārsaistes ekrāns, lai profils nevarētu saglabāt adresi (adrese = datu plūsmas elementa nosaukums, no kura tiek ņemta īpašība), kādu operatoram atteiktu.
4. Komercdatu kolonnas — Datu plūsmas cenu valūta un Datu plūsmas cenu PVN (un teorētiski arī Salīdzināšanas koda avots), katra ar tām pašām pārbaudēm, ko lieto piegādātāja forma. Vērtība, kas pārbaudi neiztur, tiek izlaista, nevis nomesta uz noklusējumu: tas ir daļējs atjauninājums, un klusi ierakstīt 0 būtu sliktāka atbilde nekā atstāt operatora vērtību mierā.
5. Piegādātāja rindā tiek atzīmēts, no kura profila tas uzstādīts, un piemērošanas datums (datums tiek saglabāts, bet ekrānā netiek rādīts) — arī tad, ja nekas nemainījās.

⚠️ Ja profils maina parsētāju, daļa datu plūsmas konfigurācijas var pazust. Dokumentu pārraksta tikai tad, ja profils reizē ar parsētāju ieraksta arī vismaz vienu datu plūsmas iestatījumu; tad saplūdināšana saglabā tikai tās atslēgas, ko atzīst jaunais parsētājs, un pārējās tiek klusi izmestas — tostarp pieejas dati zem avotiem, kuru jaunajam parsētājam nav (piemēram, Cenu lapa lietotājvārds un Cenu lapa parole; galvenās datu plūsmas atslēgas izdzīvo vienmēr). Ja profils nevienu iestatījumu neieraksta, vecās rindas paliek saglabātas, bet jaunais parsētājs tās nelasa — cilnē Datu plūsmas konfigurācija tās stāv ar piezīmi, ka importā tiek ignorētas. Plānā nav redzams ne viens, ne otrs, jo plāns rāda tikai tās atslēgas, ko profils aiztiek. Uzreiz pēc parsētāja maiņas atveriet cilni Datu plūsmas konfigurācija un pārbaudiet, vai viss vajadzīgais tur joprojām ir.

Pēc tam ekrāns atgriežas pie tā paša plāna. Ja viss izdevās, visas rindas tagad lasās «Already matches» — tas ir apstiprinājums. Pats ziņojums parādās kā īss paziņojums ekrāna labajā augšējā stūrī un pēc dažām sekundēm pazūd pats; ja to nepaspējāt izlasīt, atbilde ir plānā zem tā. Ziņojumi:

• «Profile applied: %d setting(s) written.» — cik iestatījumu ierakstīts.
• «This vendor already matches the profile - nothing needed changing.» — nekas netika ierakstīts. Tas var nozīmēt divas dažādas lietas: vai nu viss jau sakrita, vai arī vienīgās atšķirības bija konflikti («Replace this value»), no kuriem neviens nebija atzīmēts. Ja gaidījāt izmaiņas, pārbaudiet, vai atzīmējāt konfliktu ķeksīšus — šis ziņojums nav apliecinājums, ka profils jau ir piemērots.
• Brīdinājums ar noraidītu adrešu sarakstu — pārsaistes validators kādu profila adresi neatzina. Tas nozīmē kļūdu katalogā, ne jūsu darbībā, un par to ir vērts ziņot.

📷 Ekrānattēls: ecomlink/profile — zaļais paziņojums «Profile applied: N setting(s) written.» labajā augšējā stūrī un zem tā pārbūvētais plāns, kurā visas rindas lasās «Already matches»

«Dry run this vendor»

Zem plāna ir poga «Dry run this vendor» ar paskaidrojumu «See what the cached feed would actually stage under these settings. Nothing is written.» Tā ved uz Pārsaistes ekrānu ar ieslēgtu priekšskatījumu tieši šim piegādātājam.

Atšķirība ir svarīga: plāns pasaka, kas tiktu ierakstīts piegādātāja rindā, bet ne to, ko plūsma caur šiem iestatījumiem tiešām sagatavotu. Sausā palaišana ir vienīgais, kas to parāda. Tā neko neraksta un neko nelejupielādē — lasa jau kešoto failu —, tāpēc to drīkst atkārtot, cik reižu vajag.

Divas lietas, bez kurām šī poga jaunam piegādātājam parādīs tukšumu:

• Pārslēdziet lauku «Profile» uz «Full import». Uzmanību: šis «Profile» tajā ekrānā ir palaišanas veids, nevis piegādātāja profils. Noklusējums ir «Stock refresh», un krājumu atjaunošana jaunas preces nekad nepievieno — tieši jaunam, tikko nokonfigurētam piegādātājam visās rindās būs «Nothing». Tas nenozīmē, ka profils nestrādā.
• Sausā palaišana lasa jau lejupielādētu failu. Ja šim piegādātājam nekad nav palaists imports, uz diska nav nekā un rezultāts būs tukšs neatkarīgi no profila. Vispirms palaidiet vienu importu.

Sīkāk par rezultātu tabulu — Lauku pārsaiste — pārsaistīšana un sausā palaišana, sadaļa «Sausā palaišana (Dry run)».

Ja kaut kas nestrādā

Nospiedu «Show what would change», bet nekas neparādās. Jābūt izvēlētiem abiem — piegādātājam un profilam. Ja plānu atvērāt, uzspiežot uz nosaukuma kataloga tabulā, bet piegādātājs augšā nebija izvēlēts, ekrāns paliek tukšs bez jebkāda paziņojuma. Izvēlieties piegādātāju un spiediet pogu vēlreiz.

Plāns ir redzams, bet «Apply profile» pogas nav un konfliktu ķeksīši ir pelēki. Trūkst rediģēšanas tiesības uz maršrutu ecomlink/profile. Skatīšanos atver sistēmas administratora statuss, rakstīšanu — tiesību saraksts.

Parādījās «This vendor already matches the profile - nothing needed changing.», lai gan plānā bija atšķirības. Atšķirības bija konflikti, un neviens ķeksītis «Replace this value» nebija atzīmēts, tāpēc netika ierakstīts nekas. Atzīmējiet vajadzīgās rindas un spiediet vēlreiz.

Profils piemērots («Profile applied: N setting(s) written»), bet imports joprojām neko nesagatavo. Profils uzstāda plūsmas formu, nevis pieeju tai. Pārbaudiet, vai cilnē Datu plūsma ir ievadīts resursdators, faila nosaukums un pieejas dati, un vai ir izdarīts viss, kas bija jautājumu sarakstā. Ja profils nomainīja parsētāju — pārbaudiet arī cilni Datu plūsmas konfigurācija: atslēgas, ko jaunais parsētājs nepazīst, vai nu tika izmestas, vai stāv tur neizlasītas. Tad palaidiet «Dry run this vendor» ar lauku Profile = Full import (ar noklusējuma Stock refresh jaunam piegādātājam visur būs «Nothing») — ja arī tā neko neatrod, atbilde ir tur, nevis profilā. Lejupielādes kļūdas ar paša piegādātāja atbildes tekstu nonāk ekrānā Žurnāli.

Pēc piemērošanas parādās brīdinājums ar noraidītām adresēm. Pārsaistes validators kādu no profila adresēm (adrese = datu plūsmas elementa nosaukums) neatzina, un tieši tās netika ierakstītas; pārējais gan tika. Tā ir kataloga kļūda, ne jūsu — ziņojiet par ierakstu.

Cilnes «Vendor profiles» nav redzams vispār, piegādātāja nav izvēlnē vai izvēlētais profils rāda sarkano kasti — šie trīs gadījumi ir rakstā Piegādātāju profili — kas tie ir, sadaļā «Ja kaut kas nestrādā».

Saistītie raksti: Piegādātāju profili — kas tie ir · Piegādātāja pievienošana · Atbalstītie formāti un parsētāja izvēle · Datu plūsmas konfigurācija — kā plūsmu lasa · Lauku pārsaiste · Žurnāli — ekrāns un izpilžu rindas