Andmete teisendusreeglid

Milleks seda lehte kasutatakse

Lehte Andmete teisendusreeglid kasutatakse tarnijatelt saadud tooteandmete muutmiseks korduvkasutatavate reeglite ettevalmistamiseks. Tüüpilised kasutusviisid on hinnamarginaali lisamine, laoväärtuste muutmine, tootekirjelduste puhastamine, sisu tõlkimine, teksti suur- ja väiketähtede muutmine või sihtkohaspetsiifiliste atribuutide loomine.

B2BLIX Feed võib koguda sama toote mitmelt tarnijalt. Tooted rühmitatakse aktsepteeritud EAN-i alusel, mistõttu on õige EAN-i vastendus oluline. Ekspordi ettevalmistamisel töötab süsteem ekspordikonfiguratsiooni alusel valitud toote- ja tarnijaandmetega. Seejärel võib teisendusreegel valitud tooteandmeid enne XML-väljundi loomist muuta.

Teisendusreeglid luuakse konto tasemel. Seega toimib see leht reeglite kataloogina, kust saab reegleid hiljem määrata ühele või mitmele ekspordiprojektsioonile.

Reegli loomine ei aktiveeri seda automaatselt. Äsja loodud reegel ei muuda tarnijaandmeid ega loodud eksporti enne, kui see on määratud ekspordiprojektsioonile. Pärast määramist võib see mõjutada selle ekspordi järgmist plaanitud genereerimist.

Millal see leht avada

Avage see leht siis, kui tarnijaandmed on õigesti imporditud ja vastendatud, kuid väärtusi tuleb konkreetse eksporditöövoo jaoks kohandada.

Näiteks võib olla vaja:

• Lisada tarnija hinnale fikseeritud summa või protsentuaalne marginaal.
• Luua veebisaidi või turuplatsi jaoks eraldi hind ilma algset hinda asendamata.
• Määrata valitud toodetele erinev laoväärtus.
• Eemaldada kirjeldustest HTML.
• Tõlkida valitud tootesisu.
• Muuta pealkirjad suurtähtedeks, väiketähtedeks või pealkirjakirjaks.
• Liita mitu väärtust uueks pealkirjaks või kirjelduseks.
• Rakendada erinevaid arvutusi eri tarnijatele, kategooriatele, brändidele või hinnavahemikele.

Mida saate sellel lehel teha

• Luua selgelt äratuntava teisendusreegli.
• Piirata reegli toodetega, mis vastavad valitud filtrikriteeriumidele.
• Siduda tingimusi loogika AND ja OR abil.
• Asendada olemasoleva tooteatribuudi, näiteks price, väärtus.
• Luua uue atribuudi, näiteks price_for_website.
• Valida, kas teisenduse tulemus on tekst või number.
• Kasutada konstante, tooteatribuute, arvutusi, funktsioone ja tingimusloogikat.
• Lisada ühte reeglisse mitu atribuudi teisendust.
• Salvestada reegli konto taseme teisenduskataloogi.

Peamised väljad ja juhtelemendid

Väli või juhtelement	Mida see tähendab	Mõju
Pealkiri	Reegli äratuntav nimi. Kasutage nime, mis selgitab reegli eesmärki ja sihttooterühma.	Seda kasutatakse reegli hilisemaks tuvastamiseks. See ei muuda tooteandmeid.
Filtrikriteeriumid	Tingimused, mis määravad, millistele toodetele teisendused rakendatakse.	Neid hinnatakse reegli kasutamisel ekspordi ettevalmistamise ajal.
Väli	Kontrollitav tooteatribuut, näiteks tarnija, kategooria, hind, laoväärtus või EAN.	Määrab, millist tooteväärtust tingimus kasutab.
Operaator	Tehtav võrdlus, näiteks võrdne, sisaldab, on tühi või suurem kui.	Juhib valitud välja võrdlemist sisestatud väärtusega.
Väärtus(ed)	Väärtus, millega tooteatribuuti võrreldakse.	Seda kasutatakse ainult filtri hindamisel. Mõni operaator, näiteks On tühi, ei vaja võrdlusväärtust.
Lisa AND-/OR-reegel	Lisab veel ühe tingimuse või tingimusterühma.	Võimaldab tooteid täpsemalt valida.
Nimi	Atribuut, millele teisendatud tulemus kirjutatakse.	Olemasolev nimi asendab selle atribuudi väärtuse. Uus nimi loob uue atribuudi, mida saab kasutada ekspordimallis.
Andmetüüp	Valige oodatava tulemuse järgi Tekst või Number.	Määrab, kuidas tulemust teisendamise ja ekspordi ettevalmistamise ajal käsitletakse.
Väärtus	Konstant, tooteatribuut, valem, funktsioon või loogiline avaldis.	Annab väärtuse, mis kirjutatakse valitud atribuuti.
Lisa atribuut	Lisab samasse reeglisse uue teisendusrea.	Võimaldab ühel sobival reeglil luua või muuta mitut atribuuti.
Loo reegel	Salvestab lõpetatud reegli.	Lisab reegli konto taseme kataloogi. See ei mõjuta eksporti enne, kui reegel on sinna määratud.

Reegli nimi

Väli Pealkiri on kohustuslik ja peaks muutma reegli teisenduskataloogis ning ekspordiseadetes hõlpsasti äratuntavaks.

Kasulikud nimed kirjeldavad nii tegevust kui ka mõjutatud tooteid. Näited:

• Lisa tarnija A toodetele 20% marginaal
• Eemalda kirjeldustest HTML
• Loo veebisaidi hind
• Tõlgi valitud pealkirjad soome keelde

Vältige selliseid nimesid nagu „Reegel 1“ või „Uus teisendus“, eriti kui sama eksport kasutab mitut reeglit.

Filtrikriteeriumid

Filtrikriteeriumid määravad, kas atribuudi teisendusi tootele rakendatakse. Kui tingimused on täidetud, käivitatakse teisenduse jaotis. Kui need ei ole täidetud, ei teisenda see reegel toodet.

Selle lehe filter määrab, kas seda teisendusreeglit rakendatakse. Seda ei tohi segi ajada ekspordiprojektsiooni peamiste tootevaliku filtritega.

Saadaolevad filtriväljad

Nähtav väljaväli sisaldab järgmisi valikuid:

• EAN
• SKU
• Pealkiri
• Kirjeldus
• Hind
• Laoväärtus
• Pildid
• Kategooria
• Tootja või bränd
• Kaal
• Mõõtmed
• Värv
• Kategooria ID
• Tarnija (pealkiri)

Saadaolevad filtrioperaatorid

Operaator	Tähendus
Võrdne (=)	Atribuut peab väärtusega täpselt kattuma. Teksti võrdlemisel ei arvestata tähekuju, seega käsitletakse väärtusi „Apple“ ja „apple“ võrdsetena.
Ei võrdu (!=)	Atribuut ei tohi väärtusega kattuda. Teksti võrdlemisel ei arvestata tähekuju.
Sisaldab	Sisestatud väärtus peab atribuudi sees kuskil esinema. Teksti võrdlemisel ei arvestata tähekuju.
Ei sisalda	Sisestatud väärtus ei tohi atribuudis esineda. Teksti võrdlemisel ei arvestata tähekuju.
On loendis	Atribuut peab kattuma ühe loendis oleva väärtusega.
Ei ole loendis	Atribuut ei tohi kattuda ühegi loendis oleva väärtusega.
On tühi	Atribuudil ei tohi olla väärtust.
Ei ole tühi	Atribuudil peab olema väärtus.
Suurem kui (>)	Atribuut peab olema sisestatud väärtusest arvuliselt suurem.
Suurem kui või võrdne (>=)	Atribuut peab olema sisestatud väärtusest arvuliselt suurem või sellega võrdne.
Väiksem kui (<)	Atribuut peab olema sisestatud väärtusest arvuliselt väiksem.
Väiksem kui või võrdne (<=)	Atribuut peab olema sisestatud väärtusest arvuliselt väiksem või sellega võrdne.

Arvulise filtri hoiatus: Liideses on märgitud, et arvulistes võrdlustes käsitletakse mittearvulisi väärtusi väärtusena 0. Enne suurem kui või väiksem kui tingimuste kasutamist veenduge, et valitud väli sisaldab usaldusväärseid arvulisi andmeid.

Operaatorite On loendis ja Ei ole loendis puhul eraldage mitu väärtust semikoolonitega. Näiteks:

Bränd A;Bränd B;Bränd C

AND-i ja OR-i kasutamine

AND tähendab, et kõik seotud tingimused peavad olema tõesed. Näiteks:

• Tarnija võrdub „Tarnija A“
• AND Kategooria võrdub „Elektroonika“

Teisendust rakendatakse ainult siis, kui mõlemad tingimused on täidetud.

OR tähendab, et vähemalt üks seotud tingimus peab olema tõene. Näiteks:

• Tootja võrdub „Bränd A“
• OR Tootja võrdub „Bränd B“

Liides toetab AND- ja OR-tingimuste rühmi. Keerukamate rühmade puhul kirjeldage esmalt soovitud loogikat lihtsa lausena ja koostage seejärel sama loogika liideses.

Kontrollige keerukaid AND-/OR-filtreid hoolikalt. Valesti paigutatud AND või OR võib panna reegli rakenduma liiga paljudele toodetele või takistada selle rakendumist mis tahes toodetele. Alustage ühe või kahe tingimusega ja laiendage filtrit alles pärast põhitoimingu mõistmist. Sisemine tehisintellektil põhinev tugiassistent võib aidata soovitud loogikat üle vaadata.

Atribuudi teisendus

Jaotis Atribuudi teisendus määrab, mis juhtub pärast seda, kui toode filtrile vastab.

Nimi

Sisestage atribuut, millele tulemus kirjutatakse.

• Sisestage olemasoleva atribuudi nimi, näiteks price, et selle väärtus eksporditöövoos asendada.
• Sisestage uus nimi, näiteks price_for_website, et luua eraldi atribuut ja säilitada algne väärtus.

Hinna ja laoväärtuse muudatused võivad mõjutada eksporditavaid äriandmeid. Kui te pole valemis kindel, looge esmalt eraldi testatribuut. Enne standardsete atribuutide price või stock asendamist kontrollige lõplikku väärtust.

Andmetüüp

Valige oodatavale tulemusele vastav tüüp:

• Tekst pealkirjade, kirjelduste, siltide, olekute, värvide või liidetud sisu jaoks.
• Number hindade, laokoguste, kaalude, marginaalide või muude arvutuste jaoks.

Hinda andva valemi puhul tuleks tavaliselt kasutada tüüpi Number. Silti „Laos“ andva valemi puhul tuleks kasutada tüüpi Tekst.

Väärtus

Väli Väärtus määrab teisendatud tulemuse. See võib sisaldada fikseeritud väärtust, olemasolevat tooteatribuuti, matemaatilist valemit või toetatud funktsiooni.

Konstandid

Konstandid on teisendusse otse kirjutatud fikseeritud väärtused.

Tüüp	Näide	Kasutus
Arvuline konstant	9.99	Kasutage fikseeritud hindade, marginaalide, koguste või arvutusväärtuste jaoks.
Tekstikonstant	"SALE" või "In Stock"	Kasutage fikseeritud teksti jaoks. Tekstikonstandid tuleb kirjutada jutumärkidesse.

Süsteemiatribuudid

Süsteemiatribuudid tähistavad töödeldud tooteandmetest saadud väärtusi. Neid saab teisendusvalemis muutujatena kasutada.

Atribuut	Liidese kuvatav kirjeldus
ean	Toote Euroopa artiklinumber.
sku	Tarnija SKU või toote identifikaator.
title	Toote nimi.
description	Üksikasjalik tootekirjeldus.
price	Toote hind.
stock	Saadaolevate ühikute arv.
images	Üks või mitu toote pildi URL-i.
category_id	Toote kategooria ID.
manufacturer	Toote tootja või brändi väärtus.
weight	Toote kaal arvulise väärtusena.
dimensions	Toote mõõtmed tekstina.
color	Toote värv tekstina.
attributes	Toote lisaatribuutide loend.

Kasutage atribuudi nimesid täpselt sellisel kujul, nagu need liideses kuvatakse. Väärtus pärineb ekspordi ettevalmistamise ajal saadaolevatest tooteandmetest, mitte otse töötlemata tarnijafailist.

Matemaatilised tehted

Tehe	Eesmärk	Näide
+	Liitmine	price + 2.50
-	Lahutamine	price - 10
*	Korrutamine	price * 1.20
/	Jagamine	price / 1.20
( )	Rühmitab arvutuse osi.	(price + 2.50) * 1.20

Sulud on kasulikud mitmest etapist koosneva valemi puhul. Need muudavad soovitud tehete järjekorra selgemaks ja vähendavad ootamatu tulemuse riski.

Matemaatikafunktsioonid

Funktsioon	Eesmärk	Näitevorming
ceil	Ümardab arvu üles lähima täisarvuni.	ceil(value)
floor	Ümardab arvu alla lähima täisarvuni.	floor(value)
round	Ümardab arvulise väärtuse.	round(value)
min	Tagastab antud väärtustest väikseima.	min(value1, value2)
max	Tagastab antud väärtustest suurima.	max(value1, value2)

Kohandatud funktsioonid

Funktsioon	Mida see teeb	Näide või kasutus
translate	Tõlgib teksti määratud sihtkeelde.	translate(es, text)
html2text	Teisendab HTML-sisu lihttekstiks.	html2text(description)
uppercase	Teisendab teksti suurtähtedeks.	uppercase(title)
lowercase	Teisendab teksti väiketähtedeks.	lowercase(title)
headline	Teisendab teksti pealkirjalaadse suurtähekasutusega tekstiks.	Kasutage liideses praegu kuvatavat funktsioonivormingut.
concat	Liidab mitu tekstiväärtust üheks tulemuseks.	concat(title, " - ", color)
if	Tagastab tingimuse tõesuse korral ühe tulemuse ja vastasel juhul teise.	if(condition, value_if_true, value_if_false)

Tõlkimine sõltub kasutusest. Funktsiooni translate kasutavad reeglid võivad tekitada tasulist tõlketööd. Enne suure kataloogi tõlkimist tutvuge Feed-i praeguse hinnateabega.

Valemites kasutatavad loogikaoperaatorid

Loogikaoperaatoreid saab kasutada if-avaldises eri toodetele erinevate väärtuste andmiseks.

Operaator või funktsioon	Eesmärk
=	Võrdne
!=	Ei võrdu
>	Suurem kui
>=	Suurem kui või võrdne
<	Väiksem kui
<=	Väiksem kui või võrdne
[...]	Väärtuste hulk või loend, näiteks ["Brand A", "Brand B"].
and	Nõuab, et mõlemad seotud tingimused oleksid tõesed.
or	Nõuab, et vähemalt üks seotud tingimus oleks tõene.
not	Pöörab loogilise tulemuse vastupidiseks.
contains	Kontrollib, kas tekst sisaldab valitud väärtust.
not_contains	Kontrollib, kas tekst ei sisalda valitud väärtust.
in	Kontrollib, kas väärtus esineb määratud hulgas.
not_in	Kontrollib, kas väärtus ei esine määratud hulgas.
is_empty	Kontrollib, kas atribuudil puudub väärtus.
is_not_empty	Kontrollib, kas atribuudil on väärtus.

Tingimusavaldise näide:

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

See näide rakendab üht kordajat, kui hind on suurem kui 100, ja teist kordajat muul juhul.

Kuidas seda lehte turvaliselt kasutada

1. Määratlege soovitud tulemus.

   Kirjutage üles, milliseid tooteid tuleb muuta, millist atribuuti muuta ja milline peaks tulemus välja nägema.

2. Kasutage selget reeglinime.

   Lisage tegevus ja tooterühm, et reeglit oleks hiljem lihtne tuvastada.

3. Alustage kitsast filtrist.

   Esmaseks testimiseks piirake reegel tarnija, kategooria, brändi või üksiku EAN-i järgi, mitte kogu kataloogile.

4. Lugege filtrit lausena.

   Veenduge, et iga AND ja OR annaks soovitud tooterühma.

5. Valige väljundatribuut hoolikalt.

   Testimisel kasutage uut atribuuti. Standardatribuuti asendage ainult siis, kui olete valemi õigsuses kindel.

6. Valige õige andmetüüp.

   Kasutage arvutuste jaoks tüüpi Number ning sisu või siltide jaoks tüüpi Text.

7. Kontrollige konstante ja jutumärke.

   Arvud sisestatakse ilma jutumärkideta. Fikseeritud tekstiväärtused tuleb kirjutada jutumärkidesse.

8. Looge reegel.

   Reegel lisatakse konto taseme kataloogi, kuid jääb passiivseks, kuni see määratakse ekspordiprojektsioonile.

9. Määrake see testekspordile.

   Mitme reegli määramisel vaadake üle nende seadistatud prioriteet, sest prioriteet määrab töötlemise järjekorra.

10. Kontrollige tulemust enne tootmiskasutust.

    Kasutage kontrollitud tooterühma ning vaadake enne väljundi aktiivses müügikanalis kasutamist Export Checkeris üle teisendatud atribuudid ja lõplik XML.

Mis juhtub pärast reegli loomist

Pärast nupu Loo reegel valimist salvestatakse reegel konto andmete teisendusreeglite kataloogi.

Selles etapis:

• Algset tarnijafaili ei muudeta.
• Vastendatud kataloogiandmeid ei kirjutata automaatselt ümber.
• Eksporti ei muudeta üksnes seetõttu, et reegel on olemas.

Kui reegel määratakse ekspordiprojektsioonile, kasutatakse seda selle ekspordi töötlemise ajal. Seejärel võib reegel mõjutada järgmise plaanitud ekspordi genereerimise andmeid.

Näiteks võib price-atribuuti asendav reegel muuta loodud XML-i kirjutatavat hinda. See, kas väline turuplats või pood selle XML-i hiljem impordib või avaldab, on eraldi töövoog.

Levinud vead

• Eeldatakse, et reegli salvestamine aktiveerib selle.

  Reegel tuleb määrata ka ekspordiprojektsioonile.

• Kasutatakse liiga laia filtrit.

  Hinna- või laoväärtuse teisendus võib mõjutada kõiki määratud ekspordis sobivaid tooteid.

• AND-i ja OR-i kombineeritakse valesti.

  Lugege kogu filtrit lausena ja testige seda väikese tooterühmaga.

• Operaatorite On loendis või Ei ole loendis puhul sisestatakse komadega eraldatud väärtused.

  Liides eeldab, et mitu filtriväärtust eraldatakse semikoolonitega.

• Tekstiandmetele rakendatakse arvulisi võrdlusi.

  Mittearvulisi väärtusi võidakse käsitleda nullina.

• Kasutatakse valet andmetüüpi.

  Hinnavalemit ei tohiks salvestada tekstina ja tekstisilti ei tohiks salvestada numbrina.

• Unustatakse fikseeritud teksti ümber jutumärgid.

  Kasutage väärtusi nagu "SALE", mitte jutumärkideta tekstikonstanti.

• Standardatribuut asendatakse tahtmatult.

  price sisestamine muudab ekspordi etapis hinnaväärtust. Testimisel kasutage uut nime, näiteks price_test.

• Testitakse ainult ühe tarnija esitusviisi.

  Tooteid saab tarnijate lõikes EAN-i järgi rühmitada. Enne teisenduse tulemuse hindamist kontrollige, millised tarnijaandmed eksporditöövoos valitakse.

Näide: eraldi veebisaidi hinna loomine

Müüja soovib ühe tarnija toodetele lisada 20% marginaali ja tulemuse üles ümardada. Algne hind peab jääma kättesaadavaks.

Reegli nimi

Loo tarnija A jaoks veebisaidi hind

Filtrikriteeriumid

Väli	Operaator	Väärtus
Tarnija (pealkiri)	Võrdne (=)	Tarnija A
Hind	Suurem kui (>)	0

Siduge tingimused AND-iga, et mõlemad peavad olema täidetud.

Atribuudi teisendus

Nimi	Andmetüüp	Väärtus
price_for_website	Number	ceil(price * 1.20)

Pärast reegli loomist määrake see testekspordiprojektsioonile. Kontrollige Export Checkeris, et algne price jääb muutmata ja price_for_website sisaldab oodatud arvutatud tulemust. Seejärel saab ekspordimall uut atribuuti vajaduse korral kasutada.