Tietojen muunnossäännöt

Mihin tätä sivua käytetään

Data Transformation Rules -sivulla valmistellaan uudelleenkäytettäviä sääntöjä toimittajilta vastaanotettujen tuotetietojen muuttamiseen. Tyypillisiä käyttötarkoituksia ovat hintamarginaalin lisääminen, varastoarvojen muuttaminen, tuotekuvausten siistiminen, sisällön kääntäminen, tekstin kirjainkoon muuttaminen tai kohdekohtaisesti määritettyjen attribuuttien luominen.

B2BLIX Feed voi kerätä saman tuotteen useilta toimittajilta. Tuotteet ryhmitellään hyväksytyn EAN-koodin perusteella, minkä vuoksi EAN-koodien oikea yhdistäminen on tärkeää. Vientitiedoston valmistelun aikana järjestelmä käyttää vientimäärityksen mukaisesti valittuja tuote- ja toimittajatietoja. Muunnossääntö voi tämän jälkeen muuttaa valittuja tuotetietoja ennen XML-tulosteen luomista.

Muunnossäännöt luodaan tilitasolla. Tämä sivu toimii siksi sääntökatalogina, josta sääntöjä voidaan myöhemmin liittää yhteen tai useampaan vientiprojektioon.

Säännön luominen ei ota sitä automaattisesti käyttöön. Luotu sääntö ei muuta toimittajatietoja tai luotuja vientitiedostoja, ennen kuin se on liitetty vientiprojektioon. Liittämisen jälkeen sääntö voi vaikuttaa kyseisen viennin seuraavaan ajastettuun muodostukseen.

Milloin tämä sivu kannattaa avata

Avaa tämä sivu, kun toimittajatiedot on tuotu ja yhdistetty oikein, mutta arvoja on muokattava tiettyä vientityönkulkua varten.

Voit esimerkiksi tarvita seuraavia toimintoja:

• Kiinteän summan tai prosentuaalisen marginaalin lisääminen toimittajan hintaan.
• Erillisen hinnan luominen verkkosivustoa tai markkinapaikkaa varten alkuperäistä hintaa korvaamatta.
• Valittujen tuotteiden varastoarvon muuttaminen.
• HTML-koodin poistaminen kuvauksista.
• Valitun tuotesisällön kääntäminen.
• Otsikoiden muuttaminen isoiksi kirjaimiksi, pieniksi kirjaimiksi tai otsikkotyylisiksi.
• Useiden arvojen yhdistäminen uudeksi otsikoksi tai kuvaukseksi.
• Eri laskutoimitusten käyttäminen eri toimittajille, luokille, brändeille tai hinta-alueille.

Mitä tällä sivulla voi tehdä

• Luoda helposti tunnistettavan muunnossäännön.
• Rajata säännön koskemaan tuotteita, jotka täyttävät valitut suodatusehdot.
• Yhdistää ehtoja AND- ja OR-logiikalla.
• Korvata olemassa olevan tuoteattribuutin, kuten price-arvon.
• Luoda uuden attribuutin, kuten price_for_website.
• Valita, käsitelläänkö muunnettu tulos tekstinä vai lukuna.
• Käyttää vakioita, tuoteattribuutteja, laskutoimituksia, funktioita ja ehtologiikkaa.
• Lisätä yhteen sääntöön useita attribuuttimuunnoksia.
• Tallentaa säännön tilitason muunnossääntökatalogiin.

Tärkeimmät kentät ja ohjaimet

Kenttä tai ohjain	Merkitys	Vaikutus
Title	Säännön helposti tunnistettava nimi. Käytä nimeä, joka kuvaa tarkoitusta ja aiottua tuoteryhmää.	Käytetään säännön tunnistamiseen myöhemmin. Ei muuta tuotetietoja.
Filter Criteria	Ehdot, jotka määrittävät, mitkä tuotteet saavat muunnokset.	Arvioidaan, kun sääntöä käytetään viennin valmistelun aikana.
Field	Tarkistettava tuoteattribuutti, kuten toimittaja, kategoria, hinta, varasto tai EAN.	Määrittää, mitä tuote arvoa ehto käyttää.
Operator	Suoritettava vertailu, kuten yhtä suuri, sisältää, tyhjä tai suurempi kuin.	Ohjaa, miten valittua kenttää verrataan annettuun arvoon.
Value(s)	Arvo, johon tuoteattribuuttia verrataan.	Käytetään vain suodattimen arviointiin. Jotkin operaattorit, kuten Is empty, eivät tarvitse vertailuarvoa.
Add AND / OR rule	Lisää uuden ehdon tai ehtoryhmän.	Mahdollistaa tuotteiden tarkemman valinnan.
Name	Attribuutti, joka vastaanottaa muunnetun tuloksen.	Olemassa oleva nimi korvaa kyseisen attribuutin. Uusi nimi luo uuden attribuutin vientimallissa käytettäväksi.
Data type	Valitse odotetun tuloksen mukaan Text tai Number.	Määrittää, miten tulosta käsitellään muunnoksen ja viennin valmistelun aikana.
Value	Vakioluku tai -teksti, tuoteattribuutti, kaava, funktio tai looginen lauseke.	Tuottaa valittuun attribuuttiin kirjoitettavan arvon.
Add attribute	Lisää samaan sääntöön uuden muunnosrivin.	Mahdollistaa useiden attribuuttien luomisen tai muuttamisen yhdellä säännöllä.
Create rule	Tallentaa valmiin säännön.	Lisää säännön tilitason katalogiin. Sääntö ei vaikuta vientiin, ennen kuin se liitetään siihen.

Säännön nimi

Title-kenttä on pakollinen. Nimen tulisi helpottaa säännön tunnistamista muunnossääntökatalogissa ja vientiasetuksissa.

Hyödyllisissä nimissä kuvataan sekä toiminto että tuotteet, joihin se vaikuttaa. Esimerkkejä:

• Lisää 20 % marginaali toimittajalle A
• Poista HTML kuvauksista
• Luo verkkosivuston hinta
• Käännä valitut otsikot suomeksi

Vältä nimiä, kuten ”Sääntö 1” tai ”Uusi muunnos”, etenkin jos sama vienti käyttää useita sääntöjä.

Suodatusehdot

Suodatusehdot määrittävät, käytetäänkö attribuuttimuunnoksia tuotteeseen. Kun ehdot täyttyvät, muunnososa suoritetaan. Jos ehdot eivät täyty, kyseinen sääntö ei muuta tuotetta.

Tämän sivun suodatin määrittää, koskeeko tämä muunnossääntö tuotetta. Sitä ei pidä sekoittaa vientiprojektion varsinaisiin tuotteenvalintasuodattimiin.

Käytettävissä olevat suodatinkentät

Näkyvä kenttävalitsin sisältää seuraavat kentät:

• EAN
• SKU
• Title
• Description
• Price
• Stock
• Images
• Category
• Manufacturer or brand
• Weight
• Dimensions
• Color
• Category ID
• Supplier (title)

Käytettävissä olevat suodatinoperaattorit

Operaattori	Merkitys
Equal (=)	Attribuutin on vastattava arvoa täsmälleen. Tekstivertailussa kirjainkoolla ei ole merkitystä, joten ”Apple” ja ”apple” käsitellään samoina.
Not equal (!=)	Attribuutti ei saa vastata arvoa. Tekstivertailussa kirjainkoolla ei ole merkitystä.
Contains	Annetun arvon on esiinnyttävä jossain kohdassa attribuuttia. Tekstivertailussa kirjainkoolla ei ole merkitystä.
Not contains	Annettu arvo ei saa esiintyä attribuutissa. Tekstivertailussa kirjainkoolla ei ole merkitystä.
In	Attribuutin on vastattava jotakin arvoluettelon kohtaa.
Not in	Attribuutti ei saa vastata mitään arvoluettelon kohtaa.
Is empty	Attribuutissa ei saa olla arvoa.
Is not empty	Attribuutissa on oltava arvo.
Greater than (>)	Attribuutin on oltava numeerisesti suurempi kuin annettu arvo.
Greater than or equal to (>=)	Attribuutin on oltava numeerisesti suurempi tai yhtä suuri kuin annettu arvo.
Less than (<)	Attribuutin on oltava numeerisesti pienempi kuin annettu arvo.
Less than or equal to (<=)	Attribuutin on oltava numeerisesti pienempi tai yhtä suuri kuin annettu arvo.

Numeerista suodatusta koskeva varoitus: Käyttöliittymän mukaan ei-numeerisia arvoja käsitellään numeerisissa vertailuissa arvona 0. Varmista ennen suurempi kuin- tai pienempi kuin -ehtojen käyttöä, että valittu kenttä sisältää luotettavia numeerisia tietoja.

Käytä In- ja Not in -operaattoreissa puolipisteitä useiden arvojen erottamiseen. Esimerkiksi:

Brand A;Brand B;Brand C

AND- ja OR-ehtojen käyttö

AND tarkoittaa, että kaikkien yhdistettyjen ehtojen on oltava tosia. Esimerkiksi:

• Toimittaja on yhtä suuri kuin ”Supplier A”
• AND Kategoria on yhtä suuri kuin ”Electronics”

Muunnosta käytetään vain, kun molemmat ehdot täyttyvät.

OR tarkoittaa, että vähintään yhden yhdistetyn ehdon on oltava tosi. Esimerkiksi:

• Valmistaja on yhtä suuri kuin ”Brand A”
• OR Valmistaja on yhtä suuri kuin ”Brand B”

Käyttöliittymä tukee AND- ja OR-ehtojen ryhmiä. Kun ryhmät ovat monimutkaisempia, kuvaa tarkoitettu logiikka ensin yksinkertaisena lauseena ja toista se sitten käyttöliittymässä.

Tarkista monimutkaiset AND/OR-suodattimet huolellisesti. Väärään kohtaan sijoitettu AND tai OR voi saada säännön koskemaan liian monia tuotteita tai estää sitä vastaamasta yhteenkään tuotteeseen. Aloita yhdestä tai kahdesta ehdosta ja laajenna suodatinta vasta, kun perustoiminta on ymmärretty. Sisäinen tekoälyavustaja voi auttaa tarkistamaan suunnitellun logiikan.

Attribuuttimuunnos

Attribute transformation -osiossa määritetään, mitä tapahtuu, kun tuote täyttää suodatusehdot.

Name

Anna attribuutti, joka vastaanottaa tuloksen.

• Anna olemassa olevan attribuutin nimi, kuten price, jos haluat korvata kyseisen arvon vientityönkulussa.
• Anna uusi nimi, kuten price_for_website, jos haluat luoda erillisen attribuutin ja säilyttää alkuperäisen arvon käytettävissä.

Hinta- ja varastomuutokset voivat vaikuttaa vietyihin kaupallisiin tietoihin. Jos et ole varma kaavasta, luo ensin erillinen testi-attribuutti. Varmista lopullinen arvo ennen vakioattribuutin price tai stock korvaamista.

Data type

Valitse odotettua tulosta vastaava tyyppi:

• Text otsikoille, kuvauksille, nimikkeille, tiloille, väreille tai yhdistetylle sisällölle.
• Number hinnoille, varastomäärille, painoille, marginaaleille tai muille laskutoimituksille.

Hintaa tuottavan kaavan tulisi yleensä käyttää tyyppiä Number. Nimikkeen, kuten ”Varastossa”, tulisi käyttää tyyppiä Text.

Value

Value-kenttä määrittää muunnetun tuloksen. Se voi sisältää kiinteän arvon, olemassa olevan tuoteattribuutin, matemaattisen kaavan tai tuetun funktion.

Vakiot

Vakiot ovat suoraan muunnokseen kirjoitettuja kiinteitä arvoja.

Tyyppi	Esimerkki	Käyttö
Numeerinen vakio	9.99	Käytä kiinteisiin hintoihin, marginaaleihin, määriin tai laskenta-arvoihin.
Tekstivakio	"SALE" tai "In Stock"	Käytä kiinteään tekstiin. Tekstivakiot on sijoitettava lainausmerkkien sisään.

Järjestelmäattribuutit

Järjestelmäattribuutit edustavat käsiteltävistä tuotetiedoista otettuja arvoja. Niitä voidaan käyttää muuttujina muunnoskaavassa.

Attribuutti	Käyttöliittymän näyttämä kuvaus
ean	Tuotteen European Article Number.
sku	Toimittajan SKU tai tuotetunniste.
title	Tuotteen nimi.
description	Tuotteen yksityiskohtainen kuvaus.
price	Tuotteen hinta.
stock	Saatavilla olevien yksiköiden määrä.
images	Yksi tai useampi tuotteen kuvan URL-osoite.
category_id	Tuotteen kategorian tunnus.
manufacturer	Tuotteen valmistaja tai brändiarvo.
weight	Tuotteen paino numeerisena arvona.
dimensions	Tuotteen mitat tekstimuodossa.
color	Tuotteen väri tekstimuodossa.
attributes	Luettelo tuotteen lisäattribuuteista.

Käytä attribuuttien nimiä täsmälleen siinä muodossa kuin ne näkyvät käyttöliittymässä. Arvo tulee viennin valmistelun aikana käytettävissä olevista tuotetiedoista, ei suoraan käsittelemättömästä toimittajatiedostosta.

Matemaattiset operaatiot

Operaatio	Tarkoitus	Esimerkki
+	Yhteenlasku	price + 2.50
-	Vähennyslasku	price - 10
*	Kertolasku	price * 1.20
/	Jakolasku	price / 1.20
( )	Ryhmittelee laskutoimituksen osia.	(price + 2.50) * 1.20

Sulkeet ovat hyödyllisiä, kun kaavassa on useita vaiheita. Ne selkeyttävät laskujärjestystä ja vähentävät odottamattoman tuloksen riskiä.

Matemaattiset funktiot

Funktio	Tarkoitus	Esimerkkimuoto
ceil	Pyöristää luvun ylöspäin lähimpään kokonaislukuun.	ceil(value)
floor	Pyöristää luvun alaspäin lähimpään kokonaislukuun.	floor(value)
round	Pyöristää numeerisen arvon.	round(value)
min	Palauttaa annetuista arvoista pienimmän.	min(value1, value2)
max	Palauttaa annetuista arvoista suurimman.	max(value1, value2)

Mukautetut funktiot

Funktio	Toiminto	Esimerkki tai käyttö
translate	Kääntää tekstin määritetylle kohdekielelle.	translate(es, text)
html2text	Muuntaa HTML-sisällön pelkäksi tekstiksi.	html2text(description)
uppercase	Muuttaa tekstin isoiksi kirjaimiksi.	uppercase(title)
lowercase	Muuttaa tekstin pieniksi kirjaimiksi.	lowercase(title)
headline	Muuttaa tekstin otsikkotyyliseen kirjainkokoon.	Käytä käyttöliittymässä tällä hetkellä näkyvää funktiomuotoa.
concat	Yhdistää useita tekstiarvoja yhdeksi tulokseksi.	concat(title, " - ", color)
if	Palauttaa yhden tuloksen ehdon ollessa tosi ja toisen sen ollessa epätosi.	if(condition, value_if_true, value_if_false)

Käännöksiä käytetään käytön perusteella. translate-funktiota käyttävät säännöt voivat luoda maksullista käännöstyötä. Tarkista Feed-palvelun ajantasaiset hinnoittelutiedot ennen käännöksen käyttämistä suuressa katalogissa.

Kaavojen loogiset operaattorit

Loogisia operaattoreita voidaan käyttää if-lausekkeessa eri tuotteille palautettavien arvojen määrittämiseen.

Operaattori tai funktio	Tarkoitus
=	Yhtä suuri
!=	Ei yhtä suuri
>	Suurempi kuin
>=	Suurempi tai yhtä suuri kuin
<	Pienempi kuin
<=	Pienempi tai yhtä suuri kuin
[...]	Arvojen joukko tai luettelo, kuten ["Brand A", "Brand B"].
and	Vaatii, että molemmat yhdistetyt ehdot ovat tosia.
or	Vaatii, että vähintään yksi yhdistetty ehto on tosi.
not	Kääntää loogisen tuloksen vastakkaiseksi.
contains	Tarkistaa, sisältääkö teksti valitun arvon.
not_contains	Tarkistaa, ettei teksti sisällä valittua arvoa.
in	Tarkistaa, esiintyykö arvo määritetyssä joukossa.
not_in	Tarkistaa, ettei arvo esiinny määritetyssä joukossa.
is_empty	Tarkistaa, onko attribuutilla arvoa.
is_not_empty	Tarkistaa, onko attribuutilla arvo.

Esimerkki ehtolausekkeesta:

if(price > 100, price * 1.15, price * 1.20)

Tässä esimerkissä käytetään yhtä kerrointa, kun hinta on yli 100, ja toista kerrointa kaikissa muissa tapauksissa.

Sivun turvallinen käyttö

1. Määritä tavoiteltu tulos.

   Kirjaa, mitä tuotteita muutetaan, mitä attribuuttia muutetaan ja miltä odotetun tuloksen tulisi näyttää.

2. Käytä selkeää säännön nimeä.

   Sisällytä nimeen toiminto ja tuoteryhmä, jotta sääntö voidaan tunnistaa myöhemmin.

3. Aloita tarkalla suodattimella.

   Rajaa sääntö ensimmäistä testausta varten toimittajan, kategorian, brändin tai yksittäisen EAN-koodin perusteella sen sijaan, että käyttäisit sitä koko katalogiin.

4. Lue suodatin lauseena.

   Varmista, että jokainen AND- ja OR-ehto tuottaa tarkoitetun tuoteryhmän.

5. Valitse tulosattribuutti huolellisesti.

   Käytä testaamiseen uutta attribuuttia. Korvaa vakioattribuutti vain, kun olet varma kaavan oikeellisuudesta.

6. Valitse oikea tietotyyppi.

   Käytä laskutoimituksiin tyyppiä Number ja sisältöön tai nimikkeisiin tyyppiä Text.

7. Tarkista vakiot ja lainausmerkit.

   Numerot syötetään ilman lainausmerkkejä. Kiinteät tekstiarvot on sijoitettava lainausmerkkien sisään.

8. Luo sääntö.

   Sääntö lisätään tilitason katalogiin, mutta se pysyy passiivisena, kunnes se liitetään vientiprojektioon.

9. Liitä sääntö testivientiin.

   Jos vientiin on liitetty useita sääntöjä, tarkista niiden määritetty prioriteetti, koska prioriteetti määrittää käsittelyjärjestyksen.

10. Tarkista tulos ennen tuotantokäyttöä.

    Käytä rajattua tuoteryhmää ja tarkista muunnetut attribuutit sekä lopullinen XML Export Checkerissä ennen tulosteen käyttämistä aktiivisessa myyntikanavassa.

Mitä tapahtuu säännön luomisen jälkeen

Kun valitset Create rule, sääntö tallennetaan tilin Data Transformation Rules -katalogiin.

Tässä vaiheessa:

• Alkuperäistä toimittajatiedostoa ei muuteta.
• Yhdistettyä katalogidataa ei kirjoiteta automaattisesti uudelleen.
• Mikään vienti ei muutu vain siksi, että sääntö on olemassa.

Kun sääntö liitetään vientiprojektioon, sitä käytetään kyseisen viennin käsittelyn aikana. Sääntö voi tällöin vaikuttaa seuraavan ajastetun vientitiedoston muodostuksen sisältämiin tietoihin.

Esimerkiksi price-attribuutin korvaava sääntö voi muuttaa luotuun XML-tiedostoon kirjoitettua hintaa. Se, tuodaanko ulkoinen markkinapaikka tai myymälä kyseisen XML-tiedoston myöhemmin järjestelmään tai julkaistaanko se siellä, kuuluu erilliseen työnkulkuun.

Yleiset virheet

• Oletus, että säännön tallentaminen ottaa sen käyttöön.

  Sääntö on myös liitettävä vientiprojektioon.

• Liian laajan suodattimen käyttö.

  Hinta- tai varastomuunnos voi vaikuttaa kaikkiin liitetyn viennin täsmääviin tuotteisiin.

• AND- ja OR-ehtojen virheellinen yhdistäminen.

  Lue koko suodatin lauseena ja testaa se pienellä tuoteryhmällä.

• Pilkulla erotettujen arvojen käyttäminen In- tai Not in -operaattoreissa.

  Käyttöliittymä odottaa, että useat suodatin arvot erotetaan puolipisteillä.

• Numeeristen vertailujen käyttäminen tekstitietoihin.

  Ei-numeerisia arvoja voidaan käsitellä nollana.

• Väärän tietotyypin käyttäminen.

  Hintakaavaa ei pidä tallentaa Text-tyyppisenä eikä tekstinimikettä Number-tyyppisenä.

• Kiinteän tekstin lainausmerkkien unohtaminen.

  Käytä arvoja, kuten "SALE", älä lainaamatonta tekstivakiota.

• Vakioattribuutin tahaton korvaaminen.

  price-arvon syöttäminen muuttaa viennin valmisteluvaiheen hinta-arvoa. Käytä testauksessa uutta nimeä, kuten price_test.

• Vain yhden toimittajaesityksen testaaminen.

  Tuotteita voidaan ryhmitellä toimittajien välillä EAN-koodin perusteella. Varmista ennen muunnoksen tuloksen arviointia, mitkä toimittajatiedot vientityönkulku valitsee.

Esimerkki: erillisen verkkosivustohinnan luominen

Myyjä haluaa lisätä yhden toimittajan tuotteisiin 20 prosentin marginaalin ja pyöristää tuloksen ylöspäin. Alkuperäisen hinnan tulee säilyä käytettävissä.

Säännön nimi

Luo verkkosivuston hinta toimittajalle A

Suodatusehdot

Kenttä	Operaattori	Arvo
Supplier (title)	Equal (=)	Supplier A
Price	Greater than (>)	0

Yhdistä ehdot AND-operaattorilla, jotta molempien on täytyttävä.

Attribuuttimuunnos

Nimi	Tietotyyppi	Arvo
price_for_website	Number	ceil(price * 1.20)

Kun sääntö on luotu, liitä se testivientiprojektioon. Varmista Export Checkerissä, että alkuperäinen price säilyy muuttumattomana ja että price_for_website sisältää odotetun lasketun tuloksen. Vientimalli voi tämän jälkeen käyttää uutta attribuuttia tarvittaessa.