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 korduv toote asukoht, 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 malliseadete põhjal.

Lühike vastus

Alustage sihtkoha spetsifikatsiooni teisendamisest lihtsaks väljade plaaniks. Iga sihtkoha välja kohta märkige ü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äärtust tuleb arvutada, ümber vormindada, tõlkida või asendada.
• Kas väli kasutab fikseeritud väärtust, mis on iga toote puhul sama.
• Mis peaks juhtuma siis, kui lähteväärtus on tühi.

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

Lubatud ekspordi muudatused võivad mõjutada XML-faili, mida kasutab veebisait, turuplats, 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 eristamine lihtsustab puuduva tooteinfo tuvastamist ning aitab vältida ajakulu väljadele, mida sihtkoht ei vaja.

Kasutage sihtkoha täpseid väljanimesid ja dokumenteeritud vorminguid. Ärge nimetage sihtkoha välja ümber ainult seetõttu, et vastava B2BLIX-i atribuudi nimi on erinev.

XML-malli osade mõistmine

Juur- ja konteinerteed

Juur on XML-dokumendi välimine struktuur. Tavaliselt esineb see üks kord ja sisaldab eksporditavate toodete kogumit.

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

Tootetee

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

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 jooksva toote andmetest. See võib kasutada:

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

Seega võib väärtus olla iga toote puhul erinev.

Konstandid

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

Näiteks võib valuutavälja väärtuseks kasutada konstanti EUR, kui see kehtib kogu ekspordi kohta.

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

Vaikeväärtused

Vaikeväärtus on ette valmistatud 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 on jätkuvalt täpne.

Enne vaikeväärtuse lisamist kontrollige:

• 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.

Ekspordimalli loomine

XML-struktuuri seadistamiseks avage oma konto ekspordid. Ekspordiseadete ja malliliidese kohta lisateabe saamiseks lugege juhendit 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 sihtkoha spetsifikatsiooni alusel.
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 enne selle kasutamist tootmiskanalis üle.

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 malli lisamist ette valmistada.

Nende reeglite loomiseks või ülevaatamiseks avage oma konto andmete teisendusreeglid. Reeglifiltrite, avaldiste, prioriteetide ja teisendatud atribuutide kohta lugege juhendit 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 erinevad tooted vajavad erinevaid väärtusi.
• Lisaatribuudi loomine algset väärtust asendamata.

Millal kasutada kategooria ID-sid või kategooriakoode

Kategooriate pealkirjad võivad olla pikad, tõlgitud või eri tarnijatel 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 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. Kategooria hierarhia ja tarnija-kategooria seoste kohta lisateabe saamiseks lugege juhendit 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 atribuudi olemasolust. Olenevalt sihtkoha nõudest võib reegel luua kinnitatud varuväärtuse, valida teise atribuudi või aidata tuvastada tooteid, mida ei tohiks kaasata.

Ärge lisage automaatselt vaikeväärtusi igale tühjale väljale. 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 ekspordimallis sihtkoha väljaga.

Erimärgid

Vaadake loodud XML üle, et kinnitada pealkirjade, kirjelduste, tootjanimede ja muude tekstiväärtuste korrektne kuvamine. 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-, pikkuse- või sisupiirangud. Need nõuded tuleb võtta sihtkoha spetsifikatsioonist.

Loodud XML-i valideerimine

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

Kontrollige järgmist:

• XML-i väline struktuur vastab sihtkoha spetsifikatsioonile.
• Tooteelement kordub õiges kohas.
• 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 vastavalt teie plaanile.
• Ka väikese valiku ebatavaliste andmetega toodete puhul näib tulemus korrektne.

XML-i edukas loomine ja avamine kinnitab, et B2BLIX lõi väljundfaili. See ei kinnita, et väline turuplats, 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 ühel tootel puudub väli, väärtus on ootamatu või toodet ei kaasata, kasutage toote taseme tulemuse kontrollimiseks Export Checkerit.

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

Olenevalt tootest vaadake üle:

• Tarnija algsed väärtused.
• Kaardistatud B2BLIX-i atribuudid.
• Toote jaoks 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 üht terviklikku toodet, mitte kogu kogumit või üht üksikut atribuuti.
• Kohustuslikul väljal puudub kaardistatud väärtus. Kontrollige tarnija kaardistust ja kinnitage, et tootel on nõutavad lähteandmed.
• Arvutatud atribuuti ei loodud. Looge nõutav andmete teisendusreegel ja veenduge, et see oleks ekspordi jaoks lubatud.
• Teisendus ei rakendu ettenähtud toodetele. Kontrollige selle filtrikriteeriume, prioriteeti ja ekspordis seadistatud sobivuse korral peatumise käitumist.
• 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äärtust 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 aktsepteerimist.

Näide: turuplatsi tootekaardi ettevalmistamine

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

• ean kasutab standardset atribuuti ean.
• 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 ümardust.
• 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 sobiva 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 andmete teisendusreeglites vajalikud arvutused, vormindusreeglid, vaikeväärtused või tingimuslikud väärtused.
4. Looge ekspordimallis XML-i tootetee ja väljade kaardistused.
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 sihtkohas kontrollitud tootevalikuga, enne kui ekspordi ulatust suurendate.

Võimaluse korral hoidke testeksport aktiivse 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.