Kuidas teisendada sihtkoha XML-spetsifikatsioon B2BLIX-i ekspordimalliks

Mida see juhend aitab teha

Sihtkoht võib esitada XML-spetsifikatsiooni, mis kirjeldab oodatavat struktuuri ja tooteteavet. Teie ülesanne on teisendada see spetsifikatsioon ekspordiprojektsiooniks, mis kasutab teie B2BLIX-i kataloogiandmeid.

Tavaliselt tuleb kindlaks teha korduvate toodete tee, luua nõutavad väljundväljad, valida iga väärtuse allikas ning valmistada ette väärtused, mis vajavad arvutamist või vormindamist.

B2BLIX Feed loob XML-ekspordid kaardistatud kataloogiandmete, ekspordipõhiste tootevalikute, filtrite, teisendusreeglite ja malli seadete põhjal.

Lühike vastus

Alustage sihtkoha spetsifikatsiooni teisendamisest lihtsaks väljade plaaniks. Märkige iga sihtkoha välja kohta üles:

• XML-elemendi nimi ja asukoht dokumendis.
• Kas väli on kohustuslik või valikuline.
• Milline B2BLIX-i atribuut peaks väärtuse andma.
• Kas väärtus tuleb arvutada, ümber vormindada, tõlkida või asendada.
• Kas väli kasutab fikseeritud väärtust, mis on iga toote puhul sama.
• Mis peab juhtuma siis, kui lähteväärtus on tühi.

Seejärel saate struktuuri ekspordimallis üles ehitada ning kasutada andmete teisendusreegleid väärtuste puhul, mida ei saa otse kasutada.

Lubatud ekspordi muutmine võib mõjutada XML-faili, mida kasutab veebisait, kauplemisplatvorm, hinnavõrdlusplatvorm või muu sihtkoht. Enne aktiivse malli muutmist vaadake üle praegused seaded ja loodud XML.

Valmistage sihtkoha nõuded esmalt ette

Enne ekspordi seadistamist koostage sihtkoha spetsifikatsiooni põhjal kontroll-loend. Kohustuslike ja valikuliste väljade eraldamine aitab lihtsamalt tuvastada puuduvad tooteandmed ning vältida aja kulutamist väljadele, mida sihtkoht ei vaja.

Kasutage sihtkoha täpseid väljanimesid ja dokumenteeritud vorminguid. Ärge nimetage sihtkoha välja ümber lihtsalt seetõttu, et vastaval B2BLIX-i atribuudil on teistsugune nimi.

XML-malli osade mõistmine

Juure- ja konteineriteed

Juur on XML-dokumendi välimine struktuur. Tavaliselt esineb see ühe korra ja sisaldab eksporditud toodete kogumit.

Näiteks võib sihtkoha spetsifikatsioon paigutada kõik tooted sellisesse struktuuri nagu catalog/products.

Tootetee

Tootetee määrab XML-elemendi, mis kordub iga valitud toote puhul. Kui spetsifikatsioon kasutab teed catalog/products/product, kirjutatakse iga eksporditud toode selle tee sees eraldi product-elemendina.

Väljundväljade nimed

Väljundväljade nimed on sihtkoha nõutavad XML-elemendinimed, näiteks ean, price, stock või title.

Need kirjeldavad sihtkoha struktuuri. Need ei määra, kust välja väärtus pärineb.

Dünaamilised väärtused

Dünaamiline väärtus pärineb praegustest tooteandmetest. See võib kasutada:

• Standardset kaardistatud atribuuti, näiteks ean, price, stock või title.
• Tarnijaandmetest valitud väärtust.
• Andmete teisendusreegliga loodud uut atribuuti, näiteks price_for_website.

Seetõttu võib väärtus olla iga toote puhul erinev.

Konstandid

Konstanti kirjutatakse iga sobiva toote puhul fikseeritud väärtusena. See on kasulik, kui sihtkoht nõuab teavet, mis toodete vahel ei muutu.

Näiteks võib valuutaväljal kasutada konstanti EUR, kui see kehtib kogu ekspordi puhul.

Kasutage konstanti ainult siis, kui väärtus kehtib tegelikult iga mõjutatud toote puhul. Fikseeritud väärtust ei tohiks kasutada puudulike või vastuoluliste tarnijaandmete varjamiseks.

Vaikeväärtused

Vaikeväärtus on ettevalmistatud varuväärtus, mida kasutatakse siis, kui tavaline lähteväärtus on tühi. Vaikeväärtused sobivad ainult juhul, kui sihtkoht lubab varuväärtust ja väärtus jääb täpseks.

Enne vaikeväärtuse lisamist kontrollige järgmist:

• Kas sihtkoht lubab selle välja puhul varuväärtust.
• Kas sama varuväärtus kehtib kõigi mõjutatud toodete puhul.
• Kas tühi kohustuslik väärtus peaks hoopis põhjustama toote väljajätmise.
• Kas puuduv väärtus tuleks parandada tarnija kaardistuses või lähteandmetes.

Koostage ekspordimall

XML-struktuuri seadistamiseks avage oma konto ekspordid. Ekspordi seadete ja malli liidese üksikasju lugege juhendist XML-ekspordiprojektsioonide loomine ja seadistamine.

1. Looge uus eksport või avage ettevalmistatav eksport.
2. Seadistage ekspordi üldseaded ning valige asjakohased tarnijad ja tooted.
3. Määrake korduv tootetee vastavalt sihtkoha spetsifikatsioonile.
4. Lisage sihtkoha nõutavad väljundväljade nimed.
5. Ühendage iga väljundväli standardatribuudi, teisendatud atribuudi või sobiva konstandiga.
6. Lisage valikulised väljad ainult siis, kui need annavad kasulikku teavet ja vastavad sihtkoha spetsifikatsioonile.
7. Salvestage seadistus ja vaadake loodud XML üle enne selle kasutamist tootmiskanalis.

Kasutage teisendusi, kui väärtust ei saa otse eksportida

Mõned sihtkoha nõuded saab täita standardsete kaardistatud atribuutidega. Teised väärtused tuleb enne nende malli lisamist ette valmistada.

Nende reeglite loomiseks või ülevaatamiseks avage oma konto andmete teisendusreeglid. Reeglifiltrite, avaldiste, prioriteetide ja teisendatud atribuutide selgitust lugege juhendist Andmete teisendusreeglid.

Levinud kasutusviisid on järgmised:

• Sihtkohapõhise hinna arvutamine.
• Käibemaksu, fikseeritud juurdehindluse või protsentuaalse juurdehindluse rakendamine.
• Arvväärtuste ümardamine.
• Sihtkohapõhise pealkirja loomine.
• Valitud sisu tõlkimine.
• HTML-kirjelduste teisendamine lihttekstiks.
• Suurtähtede kasutuse või pealkirja vormingu muutmine.
• Mitme atribuudi ühendamine üheks väljundväärtuseks.
• Tingimusloogika kasutamine, kui eri toodete puhul on vaja erinevaid väärtusi.
• Täiendava atribuudi loomine algset väärtust asendamata.

Millal kasutada kategooria ID-sid või kategooriakoode

Kategooriate pealkirjad võivad olla pikad, tõlgitud või tarnijati erinevalt kirjutatud. Kategooria ID-d on sageli filtris või tingimuslikus teisenduses lihtsam kasutada, sest need pakuvad lühemat ja ühtlasemat viidet.

Näiteks võib reegel rakendada kindlat väärtust ainult siis, kui category id vastab valitud kategooriale. Samuti võib see sellest kategooriast tooted välja jätta või luua sihtkohapõhise atribuudi.

Saadaolevate B2BLIX-i kategooriate ja nende ID-de ülevaatamiseks avage oma konto kategooriakaart. Kategooriahierarhia ning tarnija- ja kategooriaseoste kohta lugege juhendist Kategooriakaardi liides.

Kui sihtkoht kasutab oma kategooriakoode, kontrollige, kas need erinevad B2BLIX-i kategooria ID-dest. Erinevuse korral valmistage nõutav sihtkoha väärtus ette sobiva reegli või kaardistuse abil, mitte ärge eeldage, et ID-d on omavahel asendatavad.

Tühjade väärtuste, HTML-i ja erimärkide käsitlemine

Tühjad väärtused

Kasutage teisendusreeglis tühja väärtuse tingimusi, kui väljund sõltub sellest, kas atribuut on saadaval. Sõltuvalt sihtkoha nõudest võib reegel luua heakskiidetud varuväärtuse, valida mõne teise atribuudi või aidata tuvastada tooteid, mida ei tohiks kaasata.

Ärge lisage automaatselt igale tühjale väljale vaikeväärtust. Kontrollige esmalt, kas väli on kohustuslik ja kas kavandatav varuväärtus on täpne.

HTML-sisu

Kui sihtkoht nõuab lihtteksti, kuid tarnija kirjeldus sisaldab HTML-i, kasutage andmete teisendusreeglis funktsiooni html-to-text. Ühendage saadud teisendatud atribuut ekspordimalli sihtkoha väljaga.

Erimärgid

Vaadake loodud XML üle, et kinnitada, et pealkirjad, kirjeldused, tootjate nimed ja muud tekstiväärtused kuvatakse õigesti. Pöörake erilist tähelepanu toodetele, mis sisaldavad jutumärke, ampersande, diakriitilisi tähti või mitmekeelset sisu.

Sihtkoht võib kehtestada ka oma märgi-, pikkus- või sisupiirangud. Need nõuded tuleb võtta sihtkoha spetsifikatsioonist.

Kontrollige loodud XML-i

Pärast malli salvestamist avage ekspordi üldseaded ekspordi jaotises. Sisselogituna kasutage loodud XML-i avamiseks brauseris ekspordi avalikku URL-i ning vaadake üle selle praegune sisu.

Kontrollige järgmist:

• XML-i välimine struktuur vastab sihtkoha spetsifikatsioonile.
• Tooteelement kordub õigel teel.
• Nõutavad väljundväljad kasutavad õigeid nimesid.
• Väljad sisaldavad eeldatud tooteväärtusi.
• Konstandid esinevad ainult ettenähtud kohtades.
• Arvutatud ja teisendatud väärtused on olemas.
• Tühje väärtusi käsitletakse plaani kohaselt.
• Ka väikese valiku ebatavaliste andmetega tooteid kuvatakse õigesti.

XML-i edukas loomine ja avamine kinnitab, et B2BLIX lõi väljundfaili. See ei kinnita, et väline kauplemisplatvorm, veebisait või partner on faili vastu võtnud, importinud või avaldanud.

Ärge avaldage ega jagage privaatset kliendipõhist ekspordi URL-i avalikus dokumentatsioonis või volitamata isikutega.

Ootamatu tulemuse korral kontrollige üksikuid tooteid

Kui mõnel tootel puudub väli, on selle väärtus ootamatu või toodet ei kaasata, kasutage tootetaseme tulemuse uurimiseks Export Checkerit.

Avage oma konto ekspordikontroll. Seal kuvatavate lähteandmete, töötlemisteabe ja eksporditud XML-i üksikasju lugege juhendist Ekspordikontroll: tooteandmete ja eksporditulemuste ülevaatamine.

Sõltuvalt tootest vaadake üle:

• Algse tarnija väärtused.
• Kaardistatud B2BLIX-i atribuudid.
• Tootele valitud tarnija.
• Ekspordifiltrid, mis võisid toote kaasata või välja jätta.
• Teisendusreeglid, mis muutsid selle väärtusi.
• Ekspordi kasutatavad lõplikud atribuudid.
• Eksporditud XML-i näidis.

Levinud rakendusprobleemid

• Väljundvälja nimi on vale. Kasutati B2BLIX-i atribuudi nime, mitte sihtkoha nõutavat elemendinime.
• Tootetee on määratud valele tasemele. Korduv tee peab tähistama ühte täielikku toodet, mitte kogu kogumit ega ühte atribuuti.
• Kohustuslikul väljal puudub kaardistatud väärtus. Kontrollige tarnija kaardistust ja kinnitage, et toode sisaldab nõutavaid lähteandmeid.
• Arvutatud atribuuti ei loodud. Looge vajalik andmete teisendusreegel ja veenduge, et see oleks ekspordi jaoks lubatud.
• Teisendus ei rakendu soovitud toodetele. Kontrollige selle filtritingimusi, prioriteeti ja ekspordis seadistatud käitumist, mis peatab töötlemise sobivuse korral.
• Konstanti kasutatakse seal, kus on vaja tootepõhiseid andmeid. Asendage see kaardistatud või teisendatud dünaamilise väärtusega.
• Kategooriaidentifikaatoreid käsitleti sihtkoha koodidena. Kinnitage, millist kategooriasüsteemi sihtkoht ootab, ja teisendage väärtus vajaduse korral.
• XML avaneb õigesti, kuid lükatakse väliselt tagasi. Võrrelge seda sihtkoha nõutavate väljade, vormingute, lubatud väärtuste ja impordireeglitega. XML-i loomine üksi ei tõenda sihtkoha heakskiitu.

Näide: kauplemisplatvormi tootekirje ettevalmistamine

Oletame, et kauplemisplatvorm nõuab ühte korduvat product-elementi, mis sisaldab elemente ean, price, stock, title ja currency.

• ean kasutab standardset ean-atribuuti.
• stock kasutab praegust eksporditavat laoseisu väärtust.
• title kasutab kaardistatud pealkirja või sihtkohapõhist teisendatud pealkirja.
• price kasutab teisendatud atribuuti, mis sisaldab nõutavat juurdehindlust ja ümardamist.
• currency kasutab konstanti eur, sest kõik selle ekspordi hinnad on ette valmistatud eurodes.

Kui sihtkoht nõuab lihttekstilisi kirjeldusi, looge funktsiooni html-to-text abil täiendav teisendatud kirjeldus ja ühendage see atribuut vastava väljundväljaga.

Mida teha järgmisena

1. Teisendage sihtkoha spetsifikatsioon kohustuslike ja valikuliste väljade kontroll-loendiks.
2. Kinnitage, et vajalikud tarnijaatribuudid on B2BLIX-is kaardistatud ja saadaval.
3. Looge kõik arvutused, vormindusreeglid, vaikeväärtused ja tingimuslikud väärtused andmete teisendusreeglites.
4. Koostage XML-i tootetee ja väljade kaardistused ekspordimallis.
5. Looge XML ja võrrelge seda sihtkoha spetsifikatsiooniga.
6. Kontrollige näidistooteid, sealhulgas tühjade või ebatavaliste väärtustega tooteid.
7. Kui üksiku toote tulemus on ebaselge, kasutage Export Checkerit.
8. Testige faili sihtkohaga kontrollitud tootevaliku abil enne ekspordi laiendamist.

Võimaluse korral hoidke testeksport aktiivsest müügikanali töövoost eraldi. Kataloogi laiendamine alles pärast struktuuri ja väärtuste ülevaatamist vähendab valede hindade, laoseisu, sisu või tootevalikute avaldamise riski.