Näin muunnat kohteen XML-määrityksen B2BLIX-vientimallipohjaksi

Mitä tämä opas auttaa sinua tekemään

Kohde voi toimittaa XML-määrityksen, jossa kuvataan sen edellyttämä rakenne ja tuotetiedot. Tehtäväsi on muuntaa tämä määritys vientiprojektioksi, joka käyttää B2BLIX-luettelosi tietoja.

Tämä tarkoittaa yleensä toistuvan tuotepolun tunnistamista, vaadittujen tulostekenttien luomista, kunkin arvon lähteen valitsemista sekä laskentaa tai muotoilua vaativien arvojen valmistelua.

B2BLIX Feed luo XML-vientejä yhdistettyjen luettelotietojen, vientikohtaisten tuotevalintojen, suodattimien, muunnossääntöjen ja mallipohjan asetusten perusteella.

Lyhyt vastaus

Aloita muuntamalla kohteen määritys yksinkertaiseksi kenttäsuunnitelmaksi. Kirjaa jokaisesta kohteen kentästä:

• XML-elementin nimi ja sijainti asiakirjassa.
• Onko kenttä pakollinen vai valinnainen.
• Minkä B2BLIX-määritteen tulee toimittaa arvo.
• Onko arvo laskettava, muotoiltava, käännettävä tai korvattava.
• Käyttääkö kenttä kiinteää arvoa, joka on sama jokaiselle tuotteelle.
• Mitä tapahtuu, kun lähdearvo on tyhjä.

Tämän jälkeen voit rakentaa rakenteen vientimallipohjaan ja käyttää tietomuunnossääntöjä arvoille, joita ei voi käyttää sellaisenaan.

Käytössä olevaan vientiin tehdyt muutokset voivat vaikuttaa verkkosivuston, markkinapaikan, hintavertailualustan tai muun kohteen käyttämään XML-tiedostoon. Tarkista nykyiset asetukset ja luotu XML ennen aktiivisen mallipohjan muuttamista.

Valmistele kohteen vaatimukset ensin

Tee kohteen määrityksestä tarkistuslista ennen viennin määrittämistä. Pakollisten ja valinnaisten kenttien erottaminen helpottaa puuttuvien tuotetietojen tunnistamista ja säästää aikaa kentiltä, joita kohde ei tarvitse.

Käytä kohteen tarkkoja kenttänimiä ja dokumentoituja muotoja. Älä nimeä kohteen kenttää uudelleen vain siksi, että vastaavalla B2BLIX-määritteellä on eri nimi.

Ymmärrä XML-mallipohjan osat

Juuripolut ja säilöpolut

Juuri on XML-asiakirjan uloin rakenne. Se esiintyy yleensä kerran ja sisältää vietävän tuotekoelman.

Kohteen määrityksessä kaikki tuotteet voidaan esimerkiksi sijoittaa rakenteeseen catalog/products.

Tuotepolku

Tuotepolku yksilöi XML-elementin, joka toistuu jokaiselle valitulle tuotteelle. Jos määrityksessä käytetään polkua catalog/products/product, jokainen viety tuote kirjoitetaan erillisenä product-elementtinä tähän polkuun.

Tulostekenttien nimet

Tulostekenttien nimet ovat kohteen edellyttämiä XML-elementtien nimiä, kuten ean, price, stock tai title.

Ne kuvaavat kohteen rakennetta. Ne eivät määritä, mistä kentän arvo tulee.

Dynaamiset arvot

Dynaaminen arvo tulee nykyisistä tuotetiedoista. Se voi käyttää:

• Vakiomääritettä, kuten ean, price, stock tai title.
• Toimittajan tiedoista valittua arvoa.
• Tietomuunnossäännöllä luotua uutta määritettä, kuten price_for_website.

Arvo voi siten olla erilainen jokaiselle tuotteelle.

Vakiot

Vakio on kiinteä arvo, joka kirjoitetaan jokaiselle soveltuvalle tuotteelle. Se on hyödyllinen, kun kohde edellyttää tietoa, joka ei muutu tuotteiden välillä.

Valuuttakentässä voidaan esimerkiksi käyttää vakiota EUR, jos se on oikein koko viennissä.

Käytä vakiota vain, kun arvo on aidosti oikea jokaiselle tuotteelle, jota se koskee. Kiinteää arvoa ei pidä käyttää puutteellisten tai ristiriitaisten toimittajatietojen peittämiseen.

Oletusarvot

Oletusarvo on valmisteltu varavaihtoehto, jota käytetään, kun tavallinen lähdearvo on tyhjä. Oletusarvot ovat sopivia vain, jos kohde sallii varavaihtoehdon ja arvo pysyy oikeana.

Tarkista ennen oletusarvon lisäämistä:

• Salliiko kohde varavaihtoehdon kyseiselle kentälle.
• Onko sama varavaihtoehto oikea kaikille kyseisille tuotteille.
• Pitäisikö tyhjän pakollisen arvon sijaan jättää tuote pois.
• Pitäisikö puuttuva arvo korjata toimittajan yhdistämisessä tai lähdetiedoissa.

Rakenna vientimallipohja

Määritä XML-rakenne avaamalla tilisi viennit. Lisätietoja vientiasetuksista ja mallipohjan käyttöliittymästä saat oppaasta Luo ja määritä XML-vientiprojektioita.

1. Luo uusi vienti tai avaa valmistelemasi vienti.
2. Määritä viennin yleiset asetukset ja valitse asiaankuuluvat toimittajat ja tuotteet.
3. Aseta toistuva tuotepolku kohteen määrityksen mukaisesti.
4. Lisää kohteen edellyttämät tulostekenttien nimet.
5. Yhdistä jokainen tulostekenttä vakiomääritteeseen, muunnettuun määritteeseen tai sopivaan vakioon.
6. Lisää valinnaisia kenttiä vain, jos ne sisältävät hyödyllisiä tietoja ja vastaavat kohteen määritystä.
7. Tallenna määritys ja tarkista luotu XML ennen sen käyttämistä tuotantokanavassa.

Käytä muunnoksia, kun arvoa ei voi viedä suoraan

Jotkin kohteen vaatimukset voidaan täyttää vakiomääritteillä. Muut arvot on valmisteltava ennen niiden lisäämistä mallipohjaan.

Voit luoda tai tarkistaa nämä säännöt avaamalla tilisi tietomuunnossäännöt. Lisätietoja sääntöjen suodattimista, lausekkeista, prioriteeteista ja muunnetuista määritteistä saat oppaasta Tietomuunnossäännöt.

Yleisiä käyttötapoja ovat:

• Kohdekohtaisen hinnan laskeminen.
• Arvonlisäveron, kiinteän katteen tai prosentuaalisen katteen lisääminen.
• Numeeristen arvojen pyöristäminen.
• Kohdekohtaisen nimen luominen.
• Valitun sisällön kääntäminen.
• HTML-kuvausten muuntaminen tekstiksi.
• Kirjainkoon tai otsikkomuotoilun muuttaminen.
• Useiden määritteiden yhdistäminen yhdeksi tulostearvoksi.
• Ehdollisen logiikan käyttäminen, kun eri tuotteille tarvitaan eri arvoja.
• Lisämääritteen luominen alkuperäistä arvoa korvaamatta.

Milloin käyttää luokkien tunnisteita tai luokkakoodeja

Luokkien nimet voivat olla pitkiä, käännettyjä tai eri toimittajien eri tavoin kirjoittamia. Luokan tunnistetta on usein helpompi käyttää suodattimessa tai ehdollisessa muunnoksessa, koska se on lyhyempi ja yhdenmukaisempi viite.

Sääntö voi esimerkiksi käyttää tiettyä arvoa vain, kun category id vastaa valittua luokkaa. Se voi myös jättää kyseisen luokan tuotteet pois tai luoda kohdekohtaisen määritteen.

Voit tarkistaa saatavilla olevat B2BLIX-luokat ja niiden tunnisteet avaamalla tilisi luokkakartan. Lisätietoja luokkahierarkiasta ja toimittaja–luokka-suhteista saat oppaasta Luokkakartan käyttöliittymä.

Jos kohde käyttää omia luokkakoodejaan, tarkista, eroavatko nämä koodit B2BLIX-luokkien tunnisteista. Jos ne eroavat, valmistele vaadittu kohteen arvo sopivalla säännöllä tai yhdistämisellä äläkä oleta tunnisteiden vastaavan toisiaan.

Tyhjien arvojen, HTML:n ja erikoismerkkien käsittely

Tyhjät arvot

Käytä muunnossäännössä tyhjän arvon ehtoja, kun tulos riippuu siitä, onko määrite saatavilla. Kohteen vaatimuksesta riippuen sääntö voi luoda hyväksytyn varavaihtoehdon, valita toisen määritteen tai auttaa tunnistamaan tuotteet, joita ei pidä sisällyttää.

Älä lisää oletusarvoja automaattisesti jokaiseen tyhjään kenttään. Tarkista ensin, onko kenttä pakollinen ja onko ehdotettu varavaihtoehto oikea.

HTML-sisältö

Jos kohde edellyttää pelkkää tekstiä mutta toimittajan kuvaus sisältää HTML:ää, käytä html-to-text-funktiota tietomuunnossäännössä. Yhdistä tuloksena syntyvä muunnettu määrite kohteen kenttään vientimallipohjassa.

Erikoismerkit

Tarkista luotu XML varmistaaksesi, että nimet, kuvaukset, valmistajien nimet ja muut tekstiarvot näkyvät oikein. Kiinnitä erityistä huomiota tuotteisiin, jotka sisältävät lainausmerkkejä, ampersandeja, aksenttimerkkejä tai monikielistä sisältöä.

Kohteella voi myös olla omia merkkejä, pituutta tai sisältöä koskevia rajoituksia. Nämä vaatimukset on tarkistettava kohteen määrityksestä.

Tarkista luotu XML

Kun olet tallentanut mallipohjan, avaa viennin yleiset asetukset Viennit-osiosta. Kun olet kirjautunut sisään, avaa luotu XML selaimessa käyttämällä viennin julkista URL-osoitetta ja tarkista sen nykyinen sisältö.

Tarkista, että:

• XML:n ulompi rakenne vastaa kohteen määritystä.
• Tuote-elementti toistuu oikeassa polussa.
• Pakolliset tulostekentät käyttävät oikeita nimiä.
• Kentät sisältävät odotetut tuotearvot.
• Vakioita käytetään vain suunnitelluissa kohdissa.
• Lasketut ja muunnetut arvot ovat mukana.
• Tyhjät arvot käsitellään suunnitelman mukaisesti.
• Myös pieni valikoima epätavallisia tietoja sisältäviä tuotteita näyttää oikealta.

XML:n onnistunut luominen ja avaaminen vahvistaa, että B2BLIX tuotti tulostetiedoston. Se ei vahvista, että ulkoinen markkinapaikka, verkkosivusto tai kumppani on hyväksynyt, tuonut tai julkaissut tiedoston.

Älä julkaise tai jaa yksityistä asiakaskohtaista viennin URL-osoitetta julkisissa ohjeissa tai valtuuttamattomille osapuolille.

Tarkista yksittäiset tuotteet, kun tulos on odottamaton

Jos tuotteesta puuttuu kenttä, sen arvo on odottamaton tai tuotetta ei sisällytetä, tarkista tuotetason tulos Export Checkerillä.

Avaa tilisi viennin tarkistus. Lisätietoja siellä näytettävistä lähdetiedoista, käsittelytiedoista ja viedystä XML:stä saat oppaasta Viennin tarkistus: tuotetietojen ja vientitulosten tarkistaminen.

Tarkista tuotteesta riippuen:

• Alkuperäiset toimittajan arvot.
• Yhdistetyt B2BLIX-määritteet.
• Tuotteelle valittu toimittaja.
• Vientisuodattimet, jotka ovat voineet sisällyttää tuotteen tai jättää sen pois.
• Sen arvoja muuttaneet muunnossäännöt.
• Viennin käyttämät lopulliset määritteet.
• Esimerkkinä viety XML.

Yleisiä käyttöönottovaiheen ongelmia

• Tulostekentän nimi on väärä. B2BLIX-määritteen nimeä käytettiin kohteen edellyttämän elementin nimen sijaan.
• Tuotepolku on asetettu väärälle tasolle. Toistuvan polun on edustettava yhtä kokonaista tuotetta, ei koko kokoelmaa tai yhtä yksittäistä määritettä.
• Pakollisella kentällä ei ole yhdistettyä arvoa. Tarkista toimittajan yhdistäminen ja varmista, että tuote sisältää vaaditut lähdetiedot.
• Laskettua määritettä ei luotu. Luo tarvittava tietomuunnossääntö ja varmista, että se on käytössä viennissä.
• Muunnos ei koske aiottuja tuotteita. Tarkista sen suodatusehdot, prioriteetti ja viennissä määritetty toiminta, joka pysäyttää käsittelyn osuman jälkeen.
• Vakiota käytetään, vaikka tarvitaan tuotekohtaisia tietoja. Korvaa se yhdistetyllä tai muunnetulla dynaamisella arvolla.
• Luokkien tunnisteita käsiteltiin kohteen koodeina. Varmista, mitä luokkajärjestelmää kohde odottaa, ja muunna arvo tarvittaessa.
• XML avautuu oikein, mutta hylätään ulkoisesti. Vertaa sitä kohteen vaadittuihin kenttiin, muotoihin, sallittuihin arvoihin ja tuontisääntöihin. Pelkkä XML:n luominen ei todista kohteen hyväksyntää.

Esimerkki: markkinapaikan tuotetietueen valmistelu

Oletetaan, että markkinapaikka edellyttää yhtä toistuvaa product-elementtiä, joka sisältää elementit ean, price, stock, title ja currency.

• ean käyttää vakiomääritettä ean.
• stock käyttää kulloinkin vietävää varastoarvoa.
• title käyttää yhdistettyä nimeä tai kohdekohtaista muunnettua nimeä.
• price käyttää muunnettua määritettä, joka sisältää vaaditun katteen ja pyöristyksen.
• currency käyttää vakiota eur, koska kaikki tämän viennin hinnat on valmisteltu euroina.

Jos kohde edellyttää pelkkää tekstiä sisältäviä kuvauksia, luo html-to-text-funktiolla muunnettu lisäkuvaus ja yhdistä kyseinen määrite asianmukaiseen tulostekenttään.

Mitä seuraavaksi

1. Muunna kohteen määritys pakollisten ja valinnaisten kenttien tarkistuslistaksi.
2. Varmista, että tarvittavat toimittajan määritteet on yhdistetty ja ovat saatavilla B2BLIX:ssä.
3. Luo tarvittavat laskennat, muotoilusäännöt, oletusarvot tai ehdolliset arvot tietomuunnossäännöissä.
4. Rakenna XML:n tuotepolku ja kenttäyhdistämiset vientimallipohjassa.
5. Luo XML ja vertaa sitä kohteen määritykseen.
6. Tarkista edustavat tuotteet, mukaan lukien tuotteet, joiden arvot ovat tyhjiä tai epätavallisia.
7. Käytä Export Checkeriä, kun yksittäisen tuotteen tulos on epäselvä.
8. Testaa tiedosto kohteessa hallitulla tuotevalinnalla ennen viennin laajentamista.

Pidä testivienti mahdollisuuksien mukaan erillään aktiivisesta myyntikanavan työnkulusta. Luettelon laajentaminen vasta rakenteen ja arvojen tarkistamisen jälkeen vähentää virheellisten hintojen, varastotietojen, sisältöjen tai tuotevalintojen julkaisemisen riskiä.