Kā pārvērst galamērķa XML specifikāciju par B2BLIX eksporta veidni

Ko šis ceļvedis palīdz izdarīt

Galamērķis var nodrošināt XML specifikāciju, kurā aprakstīta tā sagaidītā struktūra un informācija par produktiem. Jūsu uzdevums ir pārvērst šo specifikāciju eksporta projekcijā, kas izmanto jūsu B2BLIX kataloga datus.

Parasti tas ietver atkārtojošā produkta ceļa noteikšanu, nepieciešamo izvades lauku izveidi, katra lauka vērtības avota izvēli un to vērtību sagatavošanu, kurām nepieciešami aprēķini vai formatēšana.

B2BLIX Feed izveido XML eksportus no kartētiem kataloga datiem, eksportam atlasītiem produktiem, filtriem, pārveidošanas noteikumiem un veidnes iestatījumiem.

Īsā atbilde

Sāciet, pārveidojot galamērķa specifikāciju vienkāršā lauku plānā. Katram galamērķa laukam pierakstiet:

• XML elementa nosaukumu un tā atrašanās vietu dokumentā.
• Vai lauks ir obligāts vai neobligāts.
• Kuram B2BLIX atribūtam jānodrošina vērtība.
• Vai vērtība ir jāaprēķina, jāpārformatē, jāiztulko vai jāaizstāj.
• Vai laukā tiek izmantota fiksēta vērtība, kas ir vienāda visiem produktiem.
• Kas jādara, ja avota vērtība ir tukša.

Pēc tam varat izveidot struktūru eksporta veidnē un izmantot datu pārveidošanas noteikumus vērtībām, kuras nevar izmantot tieši.

Izmaiņas iespējotā eksportā var ietekmēt XML failu, ko izmanto tīmekļa vietne, tirdzniecības platforma, cenu salīdzināšanas platforma vai cits galamērķis. Pirms aktīvas veidnes mainīšanas pārskatiet pašreizējos iestatījumus un ģenerēto XML.

Vispirms sagatavojiet galamērķa prasības

Pirms eksporta konfigurēšanas izveidojiet kontrolsarakstu, pamatojoties uz galamērķa specifikāciju. Obligāto un neobligāto lauku nošķiršana atvieglo trūkstošo produktu datu noteikšanu un palīdz netērēt laiku laukiem, kas galamērķim nav nepieciešami.

Izmantojiet precīzus galamērķa lauku nosaukumus un dokumentētos formātus. Nepārdēvējiet galamērķa lauku tikai tāpēc, ka atbilstošajam B2BLIX atribūtam ir cits nosaukums.

Izprotiet XML veidnes daļas

Saknes un konteinera ceļi

Sakne ir XML dokumenta ārējā struktūra. Tā parasti parādās vienu reizi un satur eksportēto produktu kolekciju.

Piemēram, galamērķa specifikācijā visi produkti var būt ievietoti struktūrā, piemēram, catalog/products.

Produkta ceļš

Produkta ceļš identificē XML elementu, kas atkārtojas katram atlasītajam produktam. Ja specifikācijā izmantots catalog/products/product, katrs eksportētais produkts šajā ceļā tiek ierakstīts kā atsevišķs product elements.

Izvades lauku nosaukumi

Izvades lauku nosaukumi ir galamērķim nepieciešamo XML elementu nosaukumi, piemēram, ean, price, stock vai title.

Tie apraksta galamērķa struktūru. Tie nenosaka, no kurienes tiek iegūta lauka vērtība.

Dinamiskās vērtības

Dinamiska vērtība tiek iegūta no pašreizējiem produkta datiem. Tā var izmantot:

• Standarta kartētu atribūtu, piemēram, ean, price, stock vai title.
• No piegādātāja datiem atlasītu vērtību.
• Datu pārveidošanas noteikuma izveidotu jaunu atribūtu, piemēram, price_for_website.

Tāpēc vērtība katram produktam var būt atšķirīga.

Konstantes

Konstante ir fiksēta vērtība, kas tiek ierakstīta katram atbilstošajam produktam. Tā ir noderīga, ja galamērķim nepieciešama informācija, kas produktiem nemainās.

Piemēram, valūtas laukā var izmantot konstanti EUR, ja tā ir pareiza visam eksportam.

Izmantojiet konstanti tikai tad, ja vērtība patiešām ir derīga katram ietekmētajam produktam. Fiksētu vērtību nevajadzētu izmantot, lai slēptu nepilnīgus vai nekonsekventus piegādātāja datus.

Noklusējuma vērtības

Noklusējuma vērtība ir sagatavota rezerves vērtība, ko izmanto, ja parastā avota vērtība ir tukša. Noklusējuma vērtības ir piemērotas tikai tad, ja galamērķis pieļauj šādu rezerves vērtību un tā joprojām ir precīza.

Pirms noklusējuma vērtības pievienošanas pārbaudiet:

• Vai galamērķis šim laukam pieļauj rezerves vērtību.
• Vai viena un tā pati rezerves vērtība ir derīga visiem ietekmētajiem produktiem.
• Vai tukšai obligātajai vērtībai tā vietā nevajadzētu izraisīt produkta izslēgšanu.
• Vai trūkstošā vērtība būtu jāizlabo piegādātāja kartējumā vai avota datos.

Izveidojiet eksporta veidni

Lai konfigurētu XML struktūru, atveriet Eksporti savā kontā. Detalizētu informāciju par eksporta iestatījumiem un veidnes saskarni skatiet XML eksporta projekciju izveide un konfigurēšana.

1. Izveidojiet jaunu eksportu vai atveriet eksportu, ko gatavojat.
2. Konfigurējiet vispārīgos eksporta iestatījumus un atlasiet atbilstošos piegādātājus un produktus.
3. Iestatiet atkārtojošā produkta ceļu atbilstoši galamērķa specifikācijai.
4. Pievienojiet galamērķa nepieciešamos izvades lauku nosaukumus.
5. Savienojiet katru izvades lauku ar standarta atribūtu, pārveidotu atribūtu vai atbilstošu konstanti.
6. Pievienojiet neobligātos laukus tikai tad, ja tie nodrošina noderīgus datus un atbilst galamērķa specifikācijai.
7. Saglabājiet konfigurāciju un pārskatiet ģenerēto XML, pirms to izmantojat ražošanas kanālā.

Izmantojiet pārveidošanu, ja vērtību nevar eksportēt tieši

Dažas galamērķa prasības var izpildīt ar standarta kartētiem atribūtiem. Citas vērtības ir jāsagatavo, pirms tās pievieno veidnei.

Lai izveidotu vai pārskatītu šos noteikumus, atveriet Datu pārveidošanas noteikumi savā kontā. Paskaidrojumu par noteikumu filtriem, izteiksmēm, prioritātēm un pārveidotajiem atribūtiem skatiet Datu pārveidošanas noteikumi.

Biežākie lietojumi:

• Galamērķim paredzētas cenas aprēķināšana.
• PVN, fiksētas maržas vai procentuālas maržas piemērošana.
• Skaitlisko vērtību noapaļošana.
• Galamērķim paredzēta nosaukuma izveide.
• Atlasītā satura tulkošana.
• HTML aprakstu pārveidošana par vienkāršu tekstu.
• Reģistra vai nosaukuma formatējuma maiņa.
• Vairāku atribūtu apvienošana vienā izvades vērtībā.
• Nosacījumu loģikas izmantošana, ja dažādiem produktiem nepieciešamas atšķirīgas vērtības.
• Papildu atribūta izveide, neaizstājot sākotnējo vērtību.

Kad izmantot kategoriju ID vai kategoriju kodus

Kategoriju nosaukumi var būt gari, tulkoti vai dažādu piegādātāju atšķirīgi uzrakstīti. Kategorijas ID bieži ir ērtāk izmantot filtrā vai nosacījumu pārveidošanā, jo tas nodrošina īsāku un konsekventāku atsauci.

Piemēram, noteikums var piemērot konkrētu vērtību tikai tad, ja category id atbilst atlasītai kategorijai. Tas var arī izslēgt produktus no šīs kategorijas vai izveidot galamērķim paredzētu atribūtu.

Lai pārskatītu pieejamās B2BLIX kategorijas un to ID, atveriet Kategoriju karti savā kontā. Detalizētu informāciju par kategoriju hierarhiju un piegādātāju un kategoriju attiecībām skatiet Kategoriju kartes saskarne.

Ja galamērķis izmanto savus kategoriju kodus, pārbaudiet, vai tie atšķiras no B2BLIX kategoriju ID. Ja tie atšķiras, sagatavojiet nepieciešamo galamērķa vērtību, izmantojot atbilstošu noteikumu vai kartējumu, nevis pieņemot, ka ID ir savstarpēji aizvietojami.

Tukšu vērtību, HTML un speciālo rakstzīmju apstrāde

Tukšas vērtības

Izmantojiet tukšas vērtības nosacījumus pārveidošanas noteikumā, ja izvade ir atkarīga no tā, vai atribūts ir pieejams. Atkarībā no galamērķa prasības noteikums var izveidot apstiprinātu rezerves vērtību, atlasīt citu atribūtu vai palīdzēt noteikt produktus, kurus nevajadzētu iekļaut.

Automātiski nepievienojiet noklusējuma vērtības katram tukšajam laukam. Vispirms pārbaudiet, vai lauks ir obligāts un vai piedāvātā rezerves vērtība ir precīza.

HTML saturs

Ja galamērķim nepieciešams vienkāršs teksts, bet piegādātāja aprakstā ir HTML, izmantojiet funkciju html-to-text datu pārveidošanas noteikumā. Savienojiet iegūto pārveidoto atribūtu ar galamērķa lauku eksporta veidnē.

Speciālās rakstzīmes

Pārskatiet ģenerēto XML, lai pārliecinātos, ka nosaukumi, apraksti, ražotāju nosaukumi un citas teksta vērtības tiek attēlotas pareizi. Īpašu uzmanību pievērsiet produktiem, kuros ir pēdiņas, ampersandi, diakritiskās zīmes vai daudzvalodu saturs.

Galamērķim var būt arī savi rakstzīmju, garuma vai satura ierobežojumi. Šīs prasības jāiegūst no galamērķa specifikācijas.

Validējiet ģenerēto XML

Pēc veidnes saglabāšanas atveriet eksporta vispārīgos iestatījumus sadaļā Eksporti. Kad esat pieteicies, izmantojiet eksporta publisko URL, lai pārlūkprogrammā atvērtu ģenerēto XML un pārskatītu tā pašreizējo saturu.

Pārbaudiet, vai:

• Ārējā XML struktūra atbilst galamērķa specifikācijai.
• Produkta elements atkārtojas pareizajā ceļā.
• Nepieciešamajiem izvades laukiem ir pareizie nosaukumi.
• Laukos ir sagaidāmās produktu vērtības.
• Konstantes parādās tikai paredzētajās vietās.
• Ir pieejamas aprēķinātās un pārveidotās vērtības.
• Tukšās vērtības tiek apstrādātas atbilstoši jūsu plānam.
• Arī neliela produktu izlase ar neparastiem datiem izskatās pareizi.

Veiksmīga XML ģenerēšana un atvēršana apstiprina, ka B2BLIX ir izveidojis izvades failu. Tas neapstiprina, ka ārēja tirdzniecības platforma, tīmekļa vietne vai partneris ir failu pieņēmis, importējis vai publicējis.

Nepublicējiet un neizplatiet privātu, konkrētam klientam paredzētu eksporta URL publiskā dokumentācijā vai nepilnvarotām personām.

Pārbaudiet atsevišķus produktus, ja rezultāts ir negaidīts

Ja vienam produktam trūkst lauka, ir neparedzēta vērtība vai produkts nav iekļauts, izmantojiet Export Checker, lai pārbaudītu produkta līmeņa rezultātu.

Atveriet Eksportu pārbaudītāju savā kontā. Detalizētu informāciju par tajā redzamajiem avota datiem, apstrādes informāciju un eksportēto XML skatiet Eksportu pārbaudītājs: produktu datu un eksporta rezultātu pārskatīšana.

Atkarībā no produkta pārskatiet:

• Sākotnējās piegādātāja vērtības.
• Kartētos B2BLIX atribūtus.
• Produktam atlasīto piegādātāju.
• Eksporta filtrus, kuru dēļ produkts var būt iekļauts vai izslēgts.
• Pārveidošanas noteikumus, kas mainīja tā vērtības.
• Eksporta izmantotos galīgos atribūtus.
• Pārstāvošo eksportēto XML.

Biežākās ieviešanas problēmas

• Izvades lauka nosaukums ir nepareizs. B2BLIX atribūta nosaukums tika izmantots galamērķim nepieciešamā elementa nosaukuma vietā.
• Produkta ceļš ir iestatīts nepareizā līmenī. Atkārtojošajam ceļam jāatspoguļo viens pilnīgs produkts, nevis visa kolekcija vai viens atsevišķs atribūts.
• Obligātajam laukam nav kartētas vērtības. Pārbaudiet piegādātāja kartējumu un pārliecinieties, ka produktam ir nepieciešamie avota dati.
• Aprēķinātais atribūts nav izveidots. Izveidojiet nepieciešamo datu pārveidošanas noteikumu un pārliecinieties, ka tas ir iespējots eksportam.
• Pārveidošana neattiecas uz paredzētajiem produktiem. Pārbaudiet tās filtra kritērijus, prioritāti un eksportā konfigurēto darbību pēc atbilstības.
• Konstante tiek izmantota tur, kur nepieciešami konkrētā produkta dati. Aizstājiet to ar kartētu vai pārveidotu dinamisku vērtību.
• Kategoriju identifikatori tika uzskatīti par galamērķa kodiem. Noskaidrojiet, kuru kategoriju sistēmu sagaida galamērķis, un vajadzības gadījumā pārveidojiet vērtību.
• XML tiek atvērts pareizi, bet ārējā sistēma to noraida. Salīdziniet to ar galamērķa nepieciešamajiem laukiem, formātiem, atļautajām vērtībām un importēšanas noteikumiem. XML ģenerēšana pati par sevi nepierāda, ka galamērķis failu pieņems.

Piemērs: tirdzniecības platformas produkta ieraksta sagatavošana

Pieņemsim, ka tirdzniecības platformai ir nepieciešams viens atkārtojošs product elements, kurā ietverti ean, price, stock, title un currency.

• ean izmanto standarta ean atribūtu.
• stock izmanto pašreizējo eksportēto krājuma vērtību.
• title izmanto kartēto nosaukumu vai galamērķim paredzētu pārveidotu nosaukumu.
• price izmanto pārveidotu atribūtu, kurā ietverta nepieciešamā marža un noapaļošana.
• currency izmanto konstanti eur, jo visas šī eksporta cenas ir sagatavotas eiro.

Ja galamērķim nepieciešami apraksti vienkāršā tekstā, izveidojiet papildu pārveidotu aprakstu, izmantojot funkciju html-to-text, un savienojiet šo atribūtu ar atbilstošo izvades lauku.

Turpmākās darbības

1. Pārvērtiet galamērķa specifikāciju obligāto un neobligāto lauku kontrolsarakstā.
2. Pārliecinieties, ka nepieciešamie piegādātāja atribūti ir kartēti un pieejami B2BLIX.
3. Izveidojiet nepieciešamos aprēķinus, formatēšanas noteikumus, noklusējuma vērtības vai nosacījumu vērtības datu pārveidošanas noteikumos.
4. Izveidojiet XML produkta ceļu un lauku kartējumus eksporta veidnē.
5. Ģenerējiet XML un salīdziniet to ar galamērķa specifikāciju.
6. Pārbaudiet reprezentatīvus produktus, tostarp produktus ar tukšām vai neparastām vērtībām.
7. Ja atsevišķa produkta rezultāts nav skaidrs, izmantojiet Export Checker.
8. Pirms eksporta paplašināšanas pārbaudiet failu ar galamērķi, izmantojot kontrolētu produktu atlasi.

Ja iespējams, nošķiriet testa eksportu no aktīvas pārdošanas kanāla darbplūsmas. Kataloga paplašināšana tikai pēc struktūras un vērtību pārskatīšanas samazina risku publicēt nepareizas cenas, krājumu, saturu vai produktu atlasi.