Duomenų transformavimo taisyklės

Kam skirtas šis puslapis

Puslapyje Duomenų transformavimo taisyklės rengiamos pakartotinai naudojamos taisyklės, skirtos keisti iš tiekėjų gautus produktų duomenis. Įprasti naudojimo atvejai: kainos maržos pridėjimas, likučio reikšmių keitimas, produktų aprašymų valymas, turinio vertimas, teksto raidžių keitimas arba konkrečiai paskirties vietai skirtų atributų kūrimas.

B2BLIX Feed gali surinkti tą patį produktą iš kelių tiekėjų. Produktai grupuojami naudojant priimtą EAN, todėl svarbu teisingai susieti EAN. Ruošiant eksportą sistema dirba su produkto ir tiekėjo duomenimis, pasirinktais pagal eksporto konfigūraciją. Tada transformavimo taisyklė gali pakeisti pasirinktus produkto duomenis prieš sugeneruojant XML išvestį.

Transformavimo taisyklės kuriamos paskyros lygiu. Todėl šiame puslapyje pateikiamas taisyklių katalogas, iš kurio taisyklės vėliau gali būti priskirtos vienai ar kelioms eksporto projekcijoms.

Sukūrus taisyklę, ji automatiškai neaktyvuojama. Nauja taisyklė nekeičia tiekėjo duomenų ar sugeneruotų eksportų, kol nėra priskirta eksporto projekcijai. Priskirta taisyklė gali paveikti kitą suplanuotą to eksporto generavimą.

Kada atidaryti šį puslapį

Atidarykite šį puslapį, kai tiekėjo duomenys yra tinkamai importuoti ir susieti, tačiau konkrečiai eksporto eigai reikia pakoreguoti jų reikšmes.

Pavyzdžiui, galite norėti:

• Pridėti fiksuotą sumą arba procentinę maržą prie tiekėjo kainos.
• Sukurti atskirą kainą svetainei ar prekyvietei, nepakeičiant pradinės kainos.
• Nustatyti kitą pasirinkto produktų rinkinio likučio reikšmę.
• Pašalinti HTML iš aprašymų.
• Išversti pasirinktą produkto turinį.
• Konvertuoti pavadinimus į didžiąsias, mažąsias arba antraštės stiliaus raides.
• Sujungti kelias reikšmes į naują pavadinimą arba aprašymą.
• Taikyti skirtingus skaičiavimus pagal tiekėjus, kategorijas, prekių ženklus arba kainų intervalus.

Ką galite atlikti šiame puslapyje

• Sukurti lengvai atpažįstamą transformavimo taisyklę.
• Taikyti taisyklę tik produktams, atitinkantiems pasirinktus filtravimo kriterijus.
• Sujungti sąlygas naudojant logiką AND ir OR.
• Perrašyti esamą produkto atributą, pavyzdžiui, price.
• Sukurti naują atributą, pavyzdžiui, price_for_website.
• Pasirinkti, ar transformuotas rezultatas yra tekstas, ar skaičius.
• Naudoti konstantas, produkto atributus, skaičiavimus, funkcijas ir sąlyginę logiką.
• Vienai taisyklei pridėti kelias atributų transformacijas.
• Išsaugoti taisyklę paskyros lygio transformavimo kataloge.

Pagrindiniai laukai ir valdikliai

Laukas arba valdiklis	Ką tai reiškia	Poveikis
Title	Lengvai atpažįstamas taisyklės pavadinimas. Naudokite pavadinimą, paaiškinantį paskirtį ir numatomą produktų grupę.	Naudojamas taisyklei vėliau atpažinti. Produkto duomenų nekeičia.
Filter Criteria	Sąlygos, nustatančios, kuriems produktams taikomos transformacijos.	Įvertinamos, kai taisyklė naudojama ruošiant eksportą.
Field	Produkto atributas, kurį reikia patikrinti, pavyzdžiui, tiekėjas, kategorija, kaina, likutis arba EAN.	Nustato, kuri produkto reikšmė naudojama sąlygoje.
Operator	Atliekamas palyginimas, pavyzdžiui, lygu, yra, tuščia arba daugiau už.	Valdo, kaip pasirinktas laukas lyginamas su įvesta reikšme.
Value(s)	Reikšmė, su kuria tikrinamas produkto atributas.	Naudojama tik filtrui įvertinti. Kai kuriems operatoriams, pavyzdžiui, Is empty, palyginimo reikšmė nereikalinga.
Add AND / OR rule	Prideda kitą sąlygą arba sąlygų grupę.	Leidžia tiksliau pasirinkti produktus.
Name	Atributas, kuriam turi būti priskirtas transformuotas rezultatas.	Esamas pavadinimas perrašo tą atributą. Naujas pavadinimas sukuria naują atributą, kurį galima naudoti eksporto šablone.
Data type	Pasirinkite Text arba Number pagal numatomą rezultatą.	Nustato, kaip rezultatas traktuojamas transformuojant ir ruošiant eksportą.
Value	Konstanta, produkto atributas, formulė, funkcija arba loginė išraiška.	Sukuria reikšmę, kuri bus įrašyta į pasirinktą atributą.
Add attribute	Prideda kitą transformavimo eilutę į tą pačią taisyklę.	Leidžia vienai atitinkančiai taisyklei sukurti arba pakeisti kelis atributus.
Create rule	Išsaugo užbaigtą taisyklę.	Prideda ją į paskyros lygio katalogą. Eksportui ji poveikio neturi, kol nėra jam priskirta.

Taisyklės pavadinimas

Laukas Title yra privalomas. Pavadinimas turi padėti lengvai atpažinti taisyklę transformavimo kataloge ir eksporto nustatymuose.

Naudingi pavadinimai nurodo ir veiksmą, ir paveikiamus produktus. Pavyzdžiai:

• Pridėti 20 % maržą tiekėjui A
• Pašalinti HTML iš aprašymų
• Sukurti svetainės kainą
• Išversti pasirinktus pavadinimus į suomių kalbą

Venkite tokių pavadinimų kaip „Taisyklė 1“ arba „Nauja transformacija“, ypač kai tą patį eksportą naudos kelios taisyklės.

Filtravimo kriterijai

Filtravimo kriterijai nustato, ar produkto atributų transformacijos bus taikomos. Kai sąlygos atitinka, vykdoma transformavimo dalis. Kai jos neatitinka, ši taisyklė produkto netransformuoja.

Šiame puslapyje esantis filtras nustato, ar taikoma ši transformavimo taisyklė. Jo nereikėtų painioti su pagrindiniais eksporto projekcijos produktų pasirinkimo filtrais.

Galimi filtravimo laukai

Matomame lauko pasirinkiklyje pateikiami:

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

Galimi filtravimo operatoriai

Operatorius	Reikšmė
Equal (=)	Atributas turi tiksliai sutapti su reikšme. Lyginant tekstą į raidžių registrą neatsižvelgiama, todėl „Apple“ ir „apple“ laikomi vienodais.
Not equal (!=)	Atributas neturi sutapti su reikšme. Lyginant tekstą į raidžių registrą neatsižvelgiama.
Contains	Įvesta reikšmė turi būti kažkur atributo tekste. Lyginant tekstą į raidžių registrą neatsižvelgiama.
Not contains	Įvesta reikšmė neturi būti atributo tekste. Lyginant tekstą į raidžių registrą neatsižvelgiama.
In	Atributas turi sutapti su vienu sąrašo elementu.
Not in	Atributas neturi sutapti su jokiu sąrašo elementu.
Is empty	Atribute neturi būti jokios reikšmės.
Is not empty	Atribute turi būti reikšmė.
Greater than (>)	Atributas skaitine prasme turi būti didesnis už įvestą reikšmę.
Greater than or equal to (>=)	Atributas skaitine prasme turi būti didesnis arba lygus įvestai reikšmei.
Less than (<)	Atributas skaitine prasme turi būti mažesnis už įvestą reikšmę.
Less than or equal to (<=)	Atributas skaitine prasme turi būti mažesnis arba lygus įvestai reikšmei.

Įspėjimas dėl skaitinių filtrų: sąsajoje nurodyta, kad neskaitinės reikšmės skaitiniuose palyginimuose laikomos 0. Prieš naudodami sąlygas „daugiau už“ arba „mažiau už“ įsitikinkite, kad pasirinktame lauke yra patikimi skaitiniai duomenys.

Naudodami In ir Not in, kelias reikšmes atskirkite kabliataškiais. Pavyzdžiui:

Brand A;Brand B;Brand C

AND ir OR naudojimas

AND reiškia, kad visos susietos sąlygos turi būti teisingos. Pavyzdžiui:

• Tiekėjas lygus „Supplier A“
• AND Kategorija lygi „Electronics“

Transformacija taikoma tik tada, kai sutampa abi sąlygos.

OR reiškia, kad teisinga turi būti bent viena susieta sąlyga. Pavyzdžiui:

• Gamintojas lygus „Brand A“
• OR Gamintojas lygus „Brand B“

Sąsaja palaiko AND ir OR sąlygų grupes. Naudodami sudėtingesnes grupes, pirmiausia paprastai sakiniais aprašykite norimą logiką, o tada atkartokite ją sąsajoje.

Atidžiai patikrinkite sudėtingus AND/OR filtrus. Netinkamai įterptas AND arba OR gali pritaikyti taisyklę per dideliam produktų skaičiui arba neleisti jai sutapti su jokiais produktais. Pradėkite nuo vienos ar dviejų sąlygų ir plėskite filtrą tik supratę pagrindinį rezultatą. Vidinis AI pagalbos asistentas gali padėti patikrinti numatytą logiką.

Atributų transformavimas

Skiltyje Attribute transformation nustatoma, kas turi įvykti produktui atitikus filtrą.

Name

Įveskite atributą, kuriam turi būti priskirtas rezultatas.

• Įveskite esamo atributo pavadinimą, pavyzdžiui, price, kad ši reikšmė būtų perrašyta eksporto eigoje.
• Įveskite naują pavadinimą, pavyzdžiui, price_for_website, kad sukurtumėte atskirą atributą ir išsaugotumėte pradinę reikšmę.

Kainos ir likučio pakeitimai gali paveikti eksportuojamus komercinius duomenis. Jei nesate tikri dėl formulės, pirmiausia sukurkite atskirą bandomąjį atributą. Prieš pakeisdami standartinį price arba stock atributą patikrinkite galutinę reikšmę.

Data type

Pasirinkite tipą, atitinkantį numatomą rezultatą:

• Text – pavadinimams, aprašymams, etiketėms, būsenoms, spalvoms arba sujungtam turiniui.
• Number – kainoms, likučių kiekiams, svoriams, maržoms arba kitiems skaičiavimams.

Kainą sukurianti formulė paprastai turi būti priskirta tipui Number. Etiketę, pavyzdžiui, „In Stock“, sukurianti formulė turi būti priskirta tipui Text.

Value

Lauke Value nustatomas transformuotas rezultatas. Jame gali būti fiksuota reikšmė, esamas produkto atributas, matematinė formulė arba palaikoma funkcija.

Konstantos

Konstantos – tai fiksuotos reikšmės, tiesiogiai įrašytos transformacijoje.

Tipas	Pavyzdys	Naudojimas
Numeric constant	9.99	Naudokite fiksuotoms kainoms, maržoms, kiekiams arba skaičiavimo reikšmėms.
Text constant	"SALE" arba "In Stock"	Naudokite fiksuotam tekstui. Teksto konstantos turi būti rašomos kabutėse.

Sisteminiai atributai

Sisteminiai atributai reiškia reikšmes, paimtas iš apdorojamų produkto duomenų. Transformavimo formulėje juos galima naudoti kaip kintamuosius.

Atributas	Sąsajoje rodomas aprašymas
ean	Produkto Europos prekės numeris.
sku	Tiekėjo SKU arba produkto identifikatorius.
title	Produkto pavadinimas.
description	Išsamus produkto aprašymas.
price	Produkto kaina.
stock	Turimų vienetų skaičius.
images	Vienas ar daugiau produkto vaizdų URL.
category_id	Produkto kategorijos ID.
manufacturer	Produkto gamintojo arba prekių ženklo reikšmė.
weight	Produkto svoris kaip skaitinė reikšmė.
dimensions	Produkto matmenys tekstiniu formatu.
color	Produkto spalva tekstiniu formatu.
attributes	Papildomų produkto atributų sąrašas.

Atributų pavadinimus naudokite tiksliai taip, kaip jie rodomi sąsajoje. Reikšmė paimama iš produkto duomenų, pasiekiamų ruošiant eksportą, o ne tiesiogiai iš neapdoroto tiekėjo failo.

Matematinės operacijos

Operacija	Paskirtis	Pavyzdys
+	Sudėtis	price + 2.50
-	Atimtis	price - 10
*	Daugyba	price * 1.20
/	Dalyba	price / 1.20
( )	Sugrupuoja skaičiavimo dalis.	(price + 2.50) * 1.20

Skliaustai naudingi, kai formulę sudaro keli veiksmai. Jie aiškiau parodo numatomą skaičiavimo tvarką ir sumažina netikėto rezultato riziką.

Matematinės funkcijos

Funkcija	Paskirtis	Pavyzdžio formatas
ceil	Suapvalina skaičių į didesnę pusę iki artimiausio sveikojo skaičiaus.	ceil(value)
floor	Suapvalina skaičių į mažesnę pusę iki artimiausio sveikojo skaičiaus.	floor(value)
round	Suapvalina skaitinę reikšmę.	round(value)
min	Grąžina mažiausią iš pateiktų reikšmių.	min(value1, value2)
max	Grąžina didžiausią iš pateiktų reikšmių.	max(value1, value2)

Pasirinktinės funkcijos

Funkcija	Ką ji atlieka	Pavyzdys arba naudojimas
translate	Išverčia tekstą į nurodytą paskirties kalbą.	translate(es, text)
html2text	Konvertuoja HTML turinį į paprastą tekstą.	html2text(description)
uppercase	Konvertuoja tekstą į didžiąsias raides.	uppercase(title)
lowercase	Konvertuoja tekstą į mažąsias raides.	lowercase(title)
headline	Konvertuoja tekstą į antraštės stiliaus raides.	Naudokite šiuo metu sąsajoje rodomą funkcijos formatą.
concat	Sujungia kelias teksto reikšmes į vieną rezultatą.	concat(title, " - ", color)
if	Grąžina vieną rezultatą, kai sąlyga teisinga, ir kitą, kai ji klaidinga.	if(condition, value_if_true, value_if_false)

Vertimo kaina priklauso nuo naudojimo. Taisyklės, kuriose naudojama funkcija translate, gali sukurti apmokestinamą vertimo darbą. Prieš taikydami vertimą dideliam katalogui peržiūrėkite aktualią Feed kainodaros informaciją.

Loginiai operatoriai formulėse

Loginiai operatoriai gali būti naudojami if išraiškoje, kad skirtingiems produktams būtų sukurtos skirtingos reikšmės.

Operatorius arba funkcija	Paskirtis
=	Lygu
!=	Nelygu
>	Daugiau už
>=	Daugiau arba lygu
<	Mažiau už
<=	Mažiau arba lygu
[...]	Reikšmių rinkinys arba sąrašas, pavyzdžiui, ["Brand A", "Brand B"].
and	Reikalauja, kad abi susietos sąlygos būtų teisingos.
or	Reikalauja, kad būtų teisinga bent viena susieta sąlyga.
not	Apverčia loginį rezultatą.
contains	Patikrina, ar tekste yra pasirinkta reikšmė.
not_contains	Patikrina, ar tekste nėra pasirinktos reikšmės.
in	Patikrina, ar reikšmė yra nurodytame rinkinyje.
not_in	Patikrina, ar reikšmės nėra nurodytame rinkinyje.
is_empty	Patikrina, ar atributas neturi reikšmės.
is_not_empty	Patikrina, ar atributas turi reikšmę.

Sąlyginės išraiškos pavyzdys:

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

Šiame pavyzdyje, kai kaina viršija 100, taikomas vienas daugiklis, o kai neviršija – kitas.

Kaip saugiai naudoti šį puslapį

1. Nustatykite norimą rezultatą.

   Užsirašykite, kuriuos produktus reikia pakeisti, kuris atributas turi būti pakeistas ir kaip turėtų atrodyti numatomas rezultatas.

2. Naudokite aiškų taisyklės pavadinimą.

   Nurodykite veiksmą ir produktų grupę, kad vėliau būtų galima atpažinti taisyklę.

3. Pradėkite nuo siauro filtro.

   Pradiniam testavimui apribokite taisyklę pagal tiekėją, kategoriją, prekių ženklą arba atskirą EAN, o ne taikykite visam katalogui.

4. Perskaitykite filtrą kaip sakinį.

   Įsitikinkite, kad kiekvienas AND ir OR sukuria numatytą produktų grupę.

5. Atsargiai pasirinkite išvesties atributą.

   Testuodami naudokite naują atributą. Standartinį atributą perrašykite tik įsitikinę, kad formulė teisinga.

6. Pasirinkite tinkamą duomenų tipą.

   Skaičiavimams naudokite Number, o turiniui arba etiketėms – Text.

7. Patikrinkite konstantas ir kabutes.

   Skaičiai įvedami be kabučių. Fiksuotos teksto reikšmės turi būti rašomos kabutėse.

8. Sukurkite taisyklę.

   Taisyklė pridedama į paskyros lygio katalogą, tačiau lieka neaktyvi, kol nėra priskirta eksporto projekcijai.

9. Priskirkite ją bandomajam eksportui.

   Priskyrę kelias taisykles patikrinkite jų nustatytą prioritetą, nes prioritetas nustato apdorojimo tvarką.

10. Prieš naudodami gamyboje peržiūrėkite rezultatą.

    Naudokite kontroliuojamą produktų grupę ir peržiūrėkite transformuotus atributus bei galutinį XML naudodami Export Checker, prieš naudodami išvestį aktyviame pardavimo kanale.

Kas vyksta sukūrus taisyklę

Pasirinkus Create rule, taisyklė išsaugoma paskyros Duomenų transformavimo taisyklių kataloge.

Šiuo etapu:

• Pradinis tiekėjo failas nepakeičiamas.
• Susieti katalogo duomenys automatiškai neperrašomi.
• Vien dėl to, kad taisyklė egzistuoja, joks eksportas nepakeičiamas.

Priskyrus taisyklę eksporto projekcijai, ji naudojama apdorojant tą eksportą. Tada taisyklė gali paveikti duomenis, įtrauktus į kitą suplanuotą eksporto generavimą.

Pavyzdžiui, taisyklė, perrašanti price, gali pakeisti į sugeneruotą XML įrašomą kainą. Ar tą XML vėliau importuos arba paskelbs išorinė prekyvietė ar parduotuvė, yra atskira proceso dalis.

Dažniausios klaidos

• Manoma, kad taisyklės išsaugojimas ją aktyvuoja.

  Taisyklė taip pat turi būti priskirta eksporto projekcijai.

• Naudojamas per platus filtras.

  Kainos arba likučio transformacija gali paveikti kiekvieną atitinkantį produktą priskirtame eksporte.

• Netinkamai derinami AND ir OR.

  Perskaitykite visą filtrą kaip sakinį ir išbandykite jį su maža produktų grupe.

• Naudojamos kableliais atskirtos In arba Not in reikšmės.

  Sąsaja reikalauja kelias filtro reikšmes atskirti kabliataškiais.

• Teksto duomenims taikomi skaitiniai palyginimai.

  Neskaitinės reikšmės gali būti laikomos nuliu.

• Pasirenkamas netinkamas duomenų tipas.

  Kainos formulė neturėtų būti išsaugota kaip Text, o teksto etiketė – kaip Number.

• Pamirštamos kabutės aplink fiksuotą tekstą.

  Naudokite tokias reikšmes kaip "SALE", o ne teksto konstantą be kabučių.

• Netyčia perrašomas standartinis atributas.

  Įvedus price, pakeičiama eksporto etapo kainos reikšmė. Testuodami naudokite naują pavadinimą, pavyzdžiui, price_test.

• Išbandomas tik vienas tiekėjo atvaizdas.

  Produktai gali būti grupuojami pagal EAN iš kelių tiekėjų. Prieš vertindami transformacijos rezultatą įsitikinkite, kuriuos tiekėjo duomenis pasirenka eksporto eiga.

Pavyzdys: atskiros svetainės kainos sukūrimas

Pardavėjas nori prie vieno tiekėjo produktų pridėti 20 % maržą ir suapvalinti rezultatą į didesnę pusę. Pradinė kaina turi likti pasiekiama.

Taisyklės pavadinimas

Sukurti svetainės kainą tiekėjui A

Filtravimo kriterijai

Laukas	Operatorius	Reikšmė
Supplier (title)	Equal (=)	Supplier A
Price	Greater than (>)	0

Susiekite sąlygas naudodami AND, kad abi jos turėtų sutapti.

Atributų transformavimas

Pavadinimas	Duomenų tipas	Reikšmė
price_for_website	Number	ceil(price * 1.20)

Sukūrę taisyklę priskirkite ją bandomajai eksporto projekcijai. Export Checker patikrinkite, ar pradinis price liko nepakeistas, o price_for_website turi tikėtiną apskaičiuotą rezultatą. Tada eksporto šablone prireikus galima naudoti naują atributą.