Kohteen XML-määrityksen muuntaminen B2BLIX-vientimalliksi

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

Kohde voi toimittaa XML-määrityksen, joka kuvaa sen edellyttämän rakenteen 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 tuloskenttien 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 malliasetusten perusteella.

Lyhyt vastaus

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

• XML-elementin nimi ja sen sijainti asiakirjassa.
• Onko kenttä pakollinen vai valinnainen.
• Minkä B2BLIX-määritteen pitäisi tuottaa arvo.
• Onko arvo laskettava, muotoiltava uudelleen, käännettävä tai korvattava.
• Käyttääkö kenttä kiinteää arvoa, joka on sama kaikille tuotteille.
• Mitä tapahtuu, kun lähdearvo on tyhjä.

Tämän jälkeen voit rakentaa rakenteen vientimalliin ja käyttää tietojen muunnossääntöjä arvoille, joita ei voi käyttää suoraan.

Käytössä olevan viennin muutokset voivat vaikuttaa XML-tiedostoon, jota verkkosivusto, markkinapaikka, hintavertailualusta tai muu kohde käyttää. Tarkista nykyiset asetukset ja luotu XML ennen aktiivisen mallin muuttamista.

Valmistele kohteen vaatimukset ensin

Luo tarkistuslista kohteen määrityksen perusteella ennen viennin määrittämistä. Pakollisten ja valinnaisten kenttien erottaminen helpottaa puuttuvien tuotetietojen tunnistamista ja estää käyttämästä aikaa kenttiin, joita kohde ei tarvitse.

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

XML-mallin osien ymmärtäminen

Juuri- ja säilöpolut

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

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

Tuotepolku

Tuotepolku määrittää XML-elementin, joka toistetaan jokaiselle valitulle tuotteelle. Jos määrityksessä käytetään polkua catalog/products/product, jokainen viety tuote kirjoitetaan erillisenä product-elementtinä kyseiseen polkuun.

Tulostuskenttien nimet

Tulostuskenttien 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ää seuraavia:

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

Arvo voi näin ollen 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 viennille.

Käytä vakiota vain, kun arvo on aidosti oikea jokaiselle kyseessä olevalle tuotteelle. Kiinteää arvoa ei pidä käyttää puutteellisten tai epäyhtenäisten toimittajatietojen peittämiseen.

Oletusarvot

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

Tarkista ennen oletusarvon lisäämistä seuraavat asiat:

• Salliiko kohde kyseisen kentän varavaihtoehdon.
• Onko sama varavaihtoehto oikea kaikille kyseessä oleville tuotteille.
• Pitäisikö tyhjän pakollisen arvon sijaan tuote jättää pois.
• Pitäisikö puuttuva arvo korjata toimittajan määrityksessä tai lähdetiedoissa.

Vientimallin rakentaminen

Määritä XML-rakenne avaamalla tilisi viennit. Lisätietoja vientiasetuksista ja mallin käyttöliittymästä on oppaassa XML-vientiprojektioiden luominen ja määrittäminen.

1. Luo uusi vienti tai avaa valmistelemasi vienti.
2. Määritä viennin yleiset asetukset ja valitse tarvittavat toimittajat ja tuotteet.
3. Aseta toistuva tuotepolku kohteen määrityksen mukaisesti.
4. Lisää kohteen edellyttämät tulostuskenttien nimet.
5. Yhdistä kukin tulostuskenttä vakiomääritteeseen, muunnettuun määritteeseen tai sopivaan vakioarvoon.
6. Lisää valinnaisia kenttiä vain, kun 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ää tavallisilla yhdistetyillä määritteillä. Muut arvot on valmisteltava ennen niiden lisäämistä malliin.

Voit luoda tai tarkistaa nämä säännöt avaamalla tilisi tietojen muunnossäännöt. Lisätietoja sääntöjen suodattimista, lausekkeista, prioriteeteista ja muunnetuista määritteistä on oppaassa Tietojen muunnossäännöt.

Yleisiä käyttötapoja ovat esimerkiksi:

• Kohdekohtaisen hinnan laskeminen.
• ALV:n, kiinteän katteen tai prosentuaalisen katteen lisääminen.
• Lukuarvojen pyöristäminen.
• Kohdekohtaisen nimen luominen.
• Valitun sisällön kääntäminen.
• HTML-kuvausten muuntaminen tekstiksi.
• Kirjainkoon tai otsikon muotoilun muuttaminen.
• Useiden määritteiden yhdistäminen yhdeksi tulostusarvoksi.
• Ehtologiikan käyttäminen, kun eri tuotteille tarvitaan erilaisia arvoja.
• Lisämääritteen luominen alkuperäistä arvoa korvaamatta.

Milloin luokan tunnisteita tai koodeja käytetään

Luokkien nimet voivat olla pitkiä, käännettyjä tai eri toimittajien eri tavoin kirjoittamia. Luokan tunnistetta on usein helpompi käyttää suodattimessa tai ehtomuunnoksessa, koska se tarjoaa lyhyemmän ja yhdenmukaisemman viitteen.

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

Voit tarkistaa käytettävissä olevat B2BLIX-luokat ja niiden tunnisteet avaamalla tilisi luokkakartan. Lisätietoja luokkahierarkiasta ja toimittajien sekä luokkien välisistä suhteista on oppaassa Luokkakartan käyttöliittymä.

Jos kohde käyttää omia luokkakoodejaan, tarkista, poikkeavatko koodit B2BLIX-luokkien tunnisteista. Jos ne poikkeavat, valmistele tarvittava kohteen arvo sopivalla säännöllä tai määrityksellä sen sijaan, että olettaisit tunnisteiden olevan keskenään vaihtokelpoisia.

Tyhjien arvojen, HTML:n ja erikoismerkkien käsittely

Tyhjät arvot

Käytä muunnossäännössä tyhjiin arvoihin liittyviä ehtoja, kun tulos riippuu siitä, onko määrite käytettävissä. 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 kaikkiin tyhjiin kenttiin. Tarkista ensin, onko kenttä pakollinen ja onko ehdotettu varavaihtoehto paikkansapitävä.

HTML-sisältö

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

Erikoismerkit

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

Kohteella voi lisäksi olla omia merkkeihin, pituuteen tai sisältöön liittyviä rajoituksia. Nämä vaatimukset on tarkistettava kohteen määrityksestä.

Luodun XML:n validointi

Kun olet tallentanut mallin, avaa viennin yleiset asetukset Vientiosiosta. Kun olet kirjautunut sisään, avaa luotu XML selaimessa viennin julkisen URL-osoitteen avulla ja tarkista sen nykyinen sisältö.

Tarkista seuraavat asiat:

• Ulompi XML-rakenne vastaa kohteen määritystä.
• Tuote-elementti toistuu oikeassa polussa.
• Pakollisilla tulostuskentillä on oikeat nimet.
• Kentät sisältävät odotetut tuotearvot.
• Vakiot esiintyvät vain tarkoitetuissa kohdissa.
• Lasketut ja muunnetut arvot ovat mukana.
• Tyhjät arvot käsitellään suunnitelman mukaisesti.
• Pieni valikoima tuotteita, joiden tiedot ovat poikkeuksellisia, näyttää myös oikealta.

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

Älä julkaise tai jaa yksityistä asiakaskohtaista vienti-URL-osoitetta julkisissa dokumenteissa tai valtuuttamattomille osapuolille.

Tarkista yksittäiset tuotteet, kun tulos on odottamaton

Kun tuotteelta puuttuu kenttä, sen arvo on odottamaton tai tuotetta ei ole sisällytetty, tarkista tuotetason tulos Export Checkerillä.

Avaa tilisi Exports checker. Lisätietoja siellä näkyvistä lähdetiedoista, käsittelytiedoista ja viedystä XML:stä on oppaassa Exports checker: tuotetietojen ja vientitulosten tarkistaminen.

Tarkista tuotteesta riippuen seuraavat asiat:

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

Yleiset toteutusongelmat

• Tulostuskentän nimi on virheellinen. B2BLIX-määritteen nimeä on käytetty 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 määritys ja varmista, että tuote sisältää vaaditut lähdetiedot.
• Laskettua määritettä ei luotu. Luo tarvittava tietojen muunnossääntö ja varmista, että se on käytössä viennissä.
• Muunnos ei koske tarkoitettuja tuotteita. Tarkista sen suodatusehdot, prioriteetti ja viennissä määritetty toiminta, joka pysäyttää käsittelyn ehdon täyttyessä.
• Vakiota käytetään, vaikka tarvitaan tuotekohtaisia tietoja. Korvaa se yhdistetyllä tai muunnetulla dynaamisella arvolla.
• Luokkien tunnisteita on käsitelty kohteen koodeina. Varmista, mitä luokkajärjestelmää kohde odottaa, ja muunna arvo tarvittaessa.
• XML avautuu oikein, mutta ulkoinen taho hylkää sen. Vertaa sitä kohteen edellyttämiin kenttiin, muotoihin, sallittuihin arvoihin ja tuontisääntöihin. Pelkkä XML:n luominen ei osoita, että kohde hyväksyy sen.

Esimerkki: markkinapaikan tuotetietueen valmistelu

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

• ean käyttää vakiomääritettä ean.
• stock käyttää nykyistä vietävää varastoarvoa.
• title käyttää yhdistettyä nimeä tai kohdekohtaisesti 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ää tekstimuotoisia kuvauksia, luo html-to-text-funktiolla muunnettu lisäkuvaus ja yhdistä kyseinen määrite oikeaan tulostuskenttään.

Seuraavat vaiheet

1. Muunna kohteen määritys pakollisten ja valinnaisten kenttien tarkistuslistaksi.
2. Varmista, että tarvittavat toimittajamääritteet on yhdistetty ja että ne ovat käytettävissä B2BLIXissä.
3. Luo laskennat, muotoilusäännöt, oletusarvot ja ehdolliset arvot tietojen muunnossäännöissä.
4. Rakenna XML-tuotepolku ja kenttien yhdistämiset vientimallissa.
5. Luo XML ja vertaa sitä kohteen määritykseen.
6. Tarkista edustavat tuotteet, mukaan lukien tuotteet, joiden arvot ovat tyhjiä tai poikkeuksellisia.
7. Käytä Export Checkeriä, kun yksittäisen tuotteen tulos on epäselvä.
8. Testaa tiedosto kohteen kanssa 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ä.