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

Ko šī rokasgrāmata palīdz paveikt

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šā produktu ceļa identificēšanu, nepieciešamo izvades lauku izveidi, katra lauka vērtības avota izvēli un tādu vērtību sagatavošanu, kurām nepieciešami aprēķini vai formatēšana.

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

Īsā atbilde

Sāciet, pārvēršot galamērķa specifikāciju vienkāršā lauku plānā. Katram galamērķa laukam norādiet:

• 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ātulko vai jāaizstāj.
• Vai laukā tiek izmantota fiksēta vērtība, kas ir vienāda visiem produktiem.
• Kā rīkoties, 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.

Iespējota eksporta izmaiņas 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 identificēšanu un palīdz netērēt laiku laukiem, kas galamērķim nav nepieciešami.

Izmantojiet galamērķa precīzos 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. Parasti tā parādās vienu reizi un satur eksportējamo 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ā tiek 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

Dinamiskā 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.
• Jaunu atribūtu, kas izveidots ar datu pārveidošanas noteikumu, 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 attiecīgajam produktam. Tā ir noderīga, ja galamērķim nepieciešama informācija, kas starp 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 visiem ietekmētajiem produktiem. 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 iepriekš 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 aizstājējvē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 aizstājējvērtību.
• Vai viena un tā pati aizstājējvērtība ir derīga visiem ietekmētajiem produktiem.
• Vai tukšas obligātās vērtības gadījumā produkts tā vietā nebūtu jāizslēdz.
• Vai trūkstošā vērtība nebūtu jāizlabo piegādātāja kartējumā vai avota datos.

Izveidojiet eksporta veidni

Lai konfigurētu XML struktūru, atveriet Eksportus 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 attiecīgos 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ētajiem 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 noteikumus savā kontā. Skaidrojumu par noteikumu filtriem, izteiksmēm, prioritātēm un pārveidotajiem atribūtiem skatiet Datu pārveidošanas noteikumi.

Izplatīti izmantošanas veidi:

• 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 vienkāršā tekstā.
• Reģistra vai nosaukumu 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 norādīti atšķirīgi. 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ītajai kategorijai. Tas var arī izslēgt šīs kategorijas produktus 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 ar atbilstošu noteikumu vai kartējumu, nevis pieņemiet, ka ID ir savstarpēji aizvietojami.

Rīkojieties ar tukšām vērtībām, HTML un īpašajām rakstzīmēm

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ībām noteikums var izveidot apstiprinātu aizstājējvērtību, atlasīt citu atribūtu vai palīdzēt identificēt produktus, kurus nevajadzētu iekļaut.

Neievietojiet automātiski noklusējuma vērtības katrā tukšajā laukā. Vispirms pārbaudiet, vai lauks ir obligāts un vai piedāvātā aizstājējvē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ē.

Īpašā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ķis var noteikt arī savus rakstzīmju, garuma vai satura ierobežojumus. Šī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ļā Eksports. 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ļā.
• Obligātajiem izvades laukiem ir pareizie nosaukumi.
• Lauki satur sagaidītās produktu vērtības.
• Konstantes parādās tikai paredzētajās vietās.
• Aprēķinātās un pārveidotās vērtības ir pieejamas.
• Tukšās vērtības tiek apstrādātas atbilstoši 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 pieņēmis, importējis vai publicējis šo failu.

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 negaidīta vērtība vai produkts nav iekļauts, izmantojiet Eksporta pārbaudītāju, lai pārbaudītu rezultātu produkta līmenī.

Atveriet Eksporta pārbaudītāju savā kontā. Detalizētu informāciju par tur attēlotajiem avota datiem, apstrādes informāciju un eksportēto XML skatiet Eksporta 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, kas produktu varēja iekļaut vai izslēgt.
• Pārveidošanas noteikumus, kas mainīja tā vērtības.
• Galīgos eksportā izmantotos atribūtus.
• Eksportētā XML piemēru.

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

• Izvades lauka nosaukums ir nepareizs. Galamērķim nepieciešamā elementa nosaukuma vietā tika izmantots B2BLIX atribūta nosaukums.
• Produkta ceļš ir iestatīts nepareizā līmenī. Atkārtojošajam ceļam jāapzīmē 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 produkts satur nepieciešamos avota datus.
• Aprēķinātais atribūts netika izveidots. Izveidojiet nepieciešamo datu pārveidošanas noteikumu un pārliecinieties, ka tas ir iespējots šim eksportam.
• Pārveidošana neattiecas uz paredzētajiem produktiem. Pārbaudiet tās filtrēšanas kritērijus, prioritāti un jebkādu eksportā konfigurēto darbību, kas aptur apstrādi pēc atbilstības.
• Konstante tiek izmantota vietā, kur nepieciešami produkta dati. Aizstājiet to ar kartētu vai pārveidotu dinamisko 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ēji tiek noraidīts. Salīdziniet to ar galamērķa obligātajiem 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 to ir pieņēmis.

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

Pieņemsim, ka tirdzniecības platforma pieprasa vienu atkārtojošu product elementu, kurā ietverti ean, price, stock, title un currency.

• ean izmanto standarta ean atribūtu.
• stock izmanto pašreizējo eksportēto krājumu 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 šajā eksportā ietvertās 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.

Ko darīt tālāk

1. Pārvērtiet galamērķa specifikāciju obligāto un neobligāto lauku kontrolsarakstā.
2. Apstipriniet, ka nepieciešamie piegādātāja atribūti ir kartēti un pieejami B2BLIX.
3. Izveidojiet visus 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 Eksporta pārbaudītāju.
8. Pirms eksporta paplašināšanas pārbaudiet failu ar galamērķi, izmantojot kontrolētu produktu izlasi.

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 informāciju, saturu vai produktu izlasi.