Datu transformācijas noteikumi

Šīs lapas mērķis

Lapa Data Transformation Rules tiek izmantota atkārtoti lietojamu noteikumu sagatavošanai, lai mainītu no piegādātājiem saņemtos produktu datus. Tipiski izmantošanas piemēri ir cenas maržas pievienošana, krājumu vērtību maiņa, produktu aprakstu tīrīšana, satura tulkošana, teksta reģistra maiņa vai konkrētam mērķim paredzētu atribūtu izveide.

B2BLIX Feed var saņemt vienu un to pašu produktu no vairākiem piegādātājiem. Produkti tiek grupēti, izmantojot atbilstošu EAN, tāpēc pareiza EAN kartēšana ir svarīga. Eksporta sagatavošanas laikā sistēma izmanto produktu un piegādātāju datus, kas atlasīti atbilstoši eksporta konfigurācijai. Pēc tam transformācijas noteikums var mainīt atlasītos produktu datus pirms XML izvades ģenerēšanas.

Transformācijas noteikumi tiek izveidoti konta līmenī. Tāpēc šī lapa darbojas kā noteikumu katalogs, kurus vēlāk var piešķirt vienai vai vairākām eksporta projekcijām.

Noteikuma izveide to neaktivizē automātiski. Jauns noteikums nemaina piegādātāja datus vai ģenerētos eksportus, kamēr tas nav piešķirts eksporta projekcijai. Pēc piešķiršanas tas var ietekmēt nākamo plānoto šī eksporta ģenerēšanu.

Kad atvērt šo lapu

Atveriet šo lapu, kad piegādātāju dati ir pareizi importēti un kartēti, bet vērtības jāpielāgo konkrētai eksporta darbplūsmai.

Piemēram, jums var būt nepieciešams:

• Pievienot piegādātāja cenai fiksētu summu vai procentuālu maržu.
• Izveidot atsevišķu cenu vietnei vai marketplace, neaizstājot sākotnējo cenu.
• Iestatīt citu krājumu vērtību atlasītiem produktiem.
• Noņemt HTML no aprakstiem.
• Tulkot atlasītu produktu saturu.
• Pārveidot nosaukumus lielajiem burtiem, mazajiem burtiem vai virsraksta reģistrā.
• Apvienot vairākas vērtības jaunā nosaukumā vai aprakstā.
• Piemērot atšķirīgus aprēķinus dažādiem piegādātājiem, kategorijām, zīmoliem vai cenu diapazoniem.

Ko varat darīt šajā lapā

• Izveidot viegli atpazīstamu transformācijas noteikumu.
• Ierobežot noteikuma darbību līdz produktiem, kas atbilst atlasītajiem filtra kritērijiem.
• Apvienot nosacījumus, izmantojot loģiku AND un OR.
• Aizstāt esošu produkta atribūtu, piemēram, price.
• Izveidot jaunu atribūtu, piemēram, price_for_website.
• Izvēlēties, vai transformācijas rezultāts ir teksts vai skaitlis.
• Izmantot konstantes, produktu atribūtus, aprēķinus, funkcijas un nosacījumu loģiku.
• Vienam noteikumam pievienot vairākas atribūtu transformācijas.
• Saglabāt noteikumu konta līmeņa transformāciju katalogā.

Galvenie lauki un vadīklas

Lauks vai vadīkla	Nozīme	Ietekme
Title	Viegli atpazīstams noteikuma nosaukums. Izmantojiet nosaukumu, kas izskaidro mērķi un paredzēto produktu grupu.	Izmanto, lai vēlāk identificētu noteikumu. Tas nemaina produktu datus.
Filter Criteria	Nosacījumi, kas nosaka, kuriem produktiem tiks piemērotas transformācijas.	Nosacījumus izvērtē, kad noteikums tiek izmantots eksporta sagatavošanas laikā.
Field	Produkta atribūts, kas jāpārbauda, piemēram, piegādātājs, kategorija, cena, krājumi vai EAN.	Nosaka, kura produkta vērtība tiks izmantota nosacījumā.
Operator	Veicamais salīdzinājums, piemēram, vienāds, satur, ir tukšs vai lielāks par.	Kontrolē, kā atlasītais lauks tiek salīdzināts ar ievadīto vērtību.
Value(s)	Vērtība, ar kuru tiek pārbaudīts produkta atribūts.	Izmanto tikai filtra izvērtēšanai. Dažiem operatoriem, piemēram, Is empty, salīdzināmā vērtība nav nepieciešama.
Add AND / OR rule	Pievieno vēl vienu nosacījumu vai nosacījumu grupu.	Ļauj precīzāk atlasīt produktus.
Name	Atribūts, kurā jāieraksta transformācijas rezultāts.	Esošs nosaukums aizstāj attiecīgā atribūta vērtību. Jauns nosaukums izveido jaunu atribūtu izmantošanai eksporta veidnē.
Data type	Izvēlieties Text vai Number atbilstoši paredzamajam rezultātam.	Nosaka, kā rezultāts tiek apstrādāts transformācijas un eksporta sagatavošanas laikā.
Value	Konstante, produkta atribūts, formula, funkcija vai loģiska izteiksme.	Izveido vērtību, kas tiks ierakstīta atlasītajā atribūtā.
Add attribute	Pievieno tam pašam noteikumam vēl vienu transformācijas rindu.	Ļauj vienam atbilstošam noteikumam izveidot vai mainīt vairākus atribūtus.
Create rule	Saglabā pabeigto noteikumu.	Pievieno to konta līmeņa katalogam. Eksportu tas neietekmē, kamēr noteikums nav tam piešķirts.

Noteikuma nosaukums

Lauks Title ir obligāts, un tā vērtībai jāpadara noteikums viegli atpazīstams transformāciju katalogā un eksporta iestatījumos.

Noderīgos nosaukumos jāapraksta gan darbība, gan ietekmētie produkti. Piemēri:

• Pievienot 20% maržu Supplier A produktiem
• Noņemt HTML no aprakstiem
• Izveidot vietnes cenu
• Tulkot atlasītos nosaukumus somu valodā

Izvairieties no tādiem nosaukumiem kā “Rule 1” vai “New transformation”, īpaši tad, ja vienā eksportā tiks izmantoti vairāki noteikumi.

Filtra kritēriji

Filtra kritēriji nosaka, vai atribūtu transformācijas tiks piemērotas produktam. Ja nosacījumi atbilst, tiek izpildīta transformācijas sadaļa. Ja tie neatbilst, šis noteikums produktu netransformē.

Šīs lapas filtrs nosaka, vai tiek piemērots šis transformācijas noteikums. To nevajadzētu jaukt ar eksporta projekcijas galvenajiem produktu atlases filtriem.

Pieejamie filtra lauki

Redzamajā lauka atlasē ir iekļauti:

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

Pieejamie filtra operatori

Operators	Nozīme
Equal (=)	Atribūtam precīzi jāatbilst vērtībai. Teksta salīdzināšanā netiek ņemti vērā reģistri, tāpēc “Apple” un “apple” tiek uzskatīti par vienādiem.
Not equal (!=)	Atribūts nedrīkst atbilst vērtībai. Teksta salīdzināšanā netiek ņemti vērā reģistri.
Contains	Ievadītajai vērtībai kaut kur jābūt atribūta tekstā. Teksta salīdzināšanā netiek ņemti vērā reģistri.
Not contains	Ievadītā vērtība nedrīkst būt atribūta tekstā. Teksta salīdzināšanā netiek ņemti vērā reģistri.
In	Atribūtam jāatbilst vienam sarakstā norādītajam vērtības elementam.
Not in	Atribūts nedrīkst atbilst nevienam sarakstā norādītajam vērtības elementam.
Is empty	Atribūtam nedrīkst būt vērtības.
Is not empty	Atribūtam jābūt vērtībai.
Greater than (>)	Atribūta skaitliskajai vērtībai jābūt lielākai par ievadīto vērtību.
Greater than or equal to (>=)	Atribūta skaitliskajai vērtībai jābūt lielākai par ievadīto vērtību vai vienādai ar to.
Less than (<)	Atribūta skaitliskajai vērtībai jābūt mazākai par ievadīto vērtību.
Less than or equal to (<=)	Atribūta skaitliskajai vērtībai jābūt mazākai par ievadīto vērtību vai vienādai ar to.

Brīdinājums par skaitliskiem filtriem: Saskarne norāda, ka neskaitliskas vērtības skaitliskajos salīdzinājumos tiek uzskatītas par 0. Pirms nosacījumu “lielāks par” vai “mazāks par” izmantošanas pārliecinieties, ka atlasītajā laukā ir uzticami skaitliski dati.

Operatoriem In un Not in vairākas vērtības atdaliet ar semikoliem. Piemēram:

Brand A;Brand B;Brand C

AND un OR izmantošana

AND nozīmē, ka visiem saistītajiem nosacījumiem jābūt patiesiem. Piemēram:

• Supplier ir vienāds ar “Supplier A”
• AND Category ir vienāda ar “Electronics”

Transformācija tiek piemērota tikai tad, ja atbilst abi nosacījumi.

OR nozīmē, ka patiesam jābūt vismaz vienam saistītajam nosacījumam. Piemēram:

• Manufacturer ir vienāds ar “Brand A”
• OR Manufacturer ir vienāds ar “Brand B”

Saskarne atbalsta AND un OR nosacījumu grupas. Veidojot sarežģītākas grupas, vispirms aprakstiet paredzēto loģiku vienkāršā teikumā un pēc tam atveidojiet šo loģiku saskarnē.

Rūpīgi pārbaudiet sarežģītus AND/OR filtrus. Nepareizi ievietots AND vai OR var izraisīt noteikuma piemērošanu pārāk daudziem produktiem vai neļaut tam atbilst nevienam produktam. Sāciet ar vienu vai diviem nosacījumiem un paplašiniet filtru tikai tad, kad ir saprasts pamata rezultāts. Iekšējais AI atbalsta asistents var palīdzēt pārbaudīt paredzēto loģiku.

Atribūtu transformācija

Sadaļa Attribute transformation nosaka, kas jānotiek pēc tam, kad produkts atbilst filtram.

Name

Ievadiet atribūtu, kurā jāieraksta rezultāts.

• Ievadiet esoša atribūta nosaukumu, piemēram, price, lai eksporta darbplūsmā aizstātu šo vērtību.
• Ievadiet jaunu nosaukumu, piemēram, price_for_website, lai izveidotu atsevišķu atribūtu un saglabātu sākotnējo vērtību.

Cenu un krājumu izmaiņas var ietekmēt eksportētos komerciālos datus. Ja neesat pārliecināts par formulu, vispirms izveidojiet atsevišķu testa atribūtu. Pirms standarta atribūta price vai stock aizstāšanas pārbaudiet galīgo vērtību.

Data type

Izvēlieties paredzamajam rezultātam atbilstošu tipu:

• Text — nosaukumiem, aprakstiem, etiķetēm, statusiem, krāsām vai apvienotam saturam.
• Number — cenām, krājumu daudzumiem, svaram, maržām vai citiem aprēķiniem.

Formulai, kas izveido cenu, parasti jāizmanto Number. Formulai, kas izveido tādu etiķeti kā “In Stock”, jāizmanto Text.

Value

Lauks Value nosaka transformācijas rezultātu. Tajā var būt fiksēta vērtība, esošs produkta atribūts, matemātiska formula vai atbalstīta funkcija.

Konstantes

Konstantes ir fiksētas vērtības, kas transformācijā tiek ierakstītas tieši.

Tips	Piemērs	Izmantošana
Numeric constant	9.99	Izmantojiet fiksētām cenām, maržām, daudzumiem vai aprēķinu vērtībām.
Text constant	"SALE" vai "In Stock"	Izmantojiet fiksētam tekstam. Teksta konstantes jāievieto pēdiņās.

Sistēmas atribūti

Sistēmas atribūti attēlo vērtības, kas iegūtas no apstrādātajiem produktu datiem. Tos var izmantot kā mainīgos transformācijas formulā.

Atribūts	Saskarnē redzamais apraksts
ean	Produkta European Article Number.
sku	Piegādātāja SKU vai produkta identifikators.
title	Produkta nosaukums.
description	Detalizēts produkta apraksts.
price	Produkta cena.
stock	Pieejamo vienību skaits.
images	Viens vai vairāki produktu attēlu URL.
category_id	Produkta kategorijas ID.
manufacturer	Produkta ražotāja vai zīmola vērtība.
weight	Produkta svars kā skaitliska vērtība.
dimensions	Produkta izmēri teksta formā.
color	Produkta krāsa teksta formā.
attributes	Papildu produktu atribūtu saraksts.

Izmantojiet atribūtu nosaukumus tieši tā, kā tie redzami saskarnē. Vērtība tiek iegūta no produktu datiem, kas pieejami eksporta sagatavošanas laikā, nevis tieši no neapstrādāta piegādātāja faila.

Matemātiskās darbības

Darbība	Mērķis	Piemērs
+	Saskaitīšana	price + 2.50
-	Atņemšana	price - 10
*	Reizināšana	price * 1.20
/	Dalīšana	price / 1.20
( )	Apvieno aprēķina daļas.	(price + 2.50) * 1.20

Iekavas ir noderīgas, ja formulai ir vairāki soļi. Tās padara paredzēto aprēķinu secību skaidrāku un samazina negaidīta rezultāta risku.

Matemātiskās funkcijas

Funkcija	Mērķis	Piemēra formāts
ceil	Noapaļo skaitli uz augšu līdz tuvākajam veselajam skaitlim.	ceil(value)
floor	Noapaļo skaitli uz leju līdz tuvākajam veselajam skaitlim.	floor(value)
round	Noapaļo skaitlisku vērtību.	round(value)
min	Atgriež mazāko no norādītajām vērtībām.	min(value1, value2)
max	Atgriež lielāko no norādītajām vērtībām.	max(value1, value2)

Pielāgotās funkcijas

Funkcija	Darbība	Piemērs vai lietojums
translate	Tulko tekstu norādītajā mērķa valodā.	translate(es, text)
html2text	Pārvērš HTML saturu vienkāršā tekstā.	html2text(description)
uppercase	Pārvērš tekstu par lielajiem burtiem.	uppercase(title)
lowercase	Pārvērš tekstu par mazajiem burtiem.	lowercase(title)
headline	Pārvērš tekstu virsraksta stila reģistrā.	Izmantojiet funkcijas formātu, kas pašlaik redzams saskarnē.
concat	Apvieno vairākas teksta vērtības vienā rezultātā.	concat(title, " - ", color)
if	Atgriež vienu rezultātu, ja nosacījums ir patiess, un citu rezultātu, ja tas ir aplams.	if(condition, value_if_true, value_if_false)

Tulkošana ir atkarīga no lietojuma. Noteikumi, kuros tiek izmantota funkcija translate, var radīt maksas tulkošanas darbus. Pirms tulkošanas piemērošanas lielam katalogam pārskatiet aktuālo Feed cenu informāciju.

Loģiskie operatori formulās

Loģiskos operatorus var izmantot izteiksmē if, lai dažādiem produktiem izveidotu atšķirīgas vērtības.

Operators vai funkcija	Mērķis
=	Vienāds
!=	Nav vienāds
>	Lielāks par
>=	Lielāks par vai vienāds ar
<	Mazāks par
<=	Mazāks par vai vienāds ar
[...]	Vērtību kopa vai saraksts, piemēram, ["Brand A", "Brand B"].
and	Prasa, lai abi saistītie nosacījumi būtu patiesi.
or	Prasa, lai patiess būtu vismaz viens saistītais nosacījums.
not	Apgriež loģisko rezultātu.
contains	Pārbauda, vai teksts satur atlasīto vērtību.
not_contains	Pārbauda, vai teksts nesatur atlasīto vērtību.
in	Pārbauda, vai vērtība ir norādītajā kopā.
not_in	Pārbauda, vai vērtība nav norādītajā kopā.
is_empty	Pārbauda, vai atribūtam nav vērtības.
is_not_empty	Pārbauda, vai atribūtam ir vērtība.

Nosacījuma izteiksmes piemērs:

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

Šajā piemērā tiek piemērots viens reizinātājs, ja cena pārsniedz 100, un cits reizinātājs, ja tā nepārsniedz 100.

Kā droši izmantot šo lapu

1. Definējiet paredzēto rezultātu.

   Pierakstiet, kuri produkti jāmaina, kurš atribūts jāmaina un kādam jābūt sagaidāmajam rezultātam.

2. Izmantojiet skaidru noteikuma nosaukumu.

   Iekļaujiet darbību un produktu grupu, lai noteikumu vēlāk varētu identificēt.

3. Sāciet ar šauru filtru.

   Sākotnējai pārbaudei ierobežojiet noteikumu ar piegādātāju, kategoriju, zīmolu vai atsevišķu EAN, nevis piemērojiet to visam katalogam.

4. Izlasiet filtru kā teikumu.

   Pārliecinieties, ka katrs AND un OR veido paredzēto produktu grupu.

5. Rūpīgi izvēlieties izvades atribūtu.

   Testēšanai izmantojiet jaunu atribūtu. Standarta atribūtu aizstājiet tikai tad, kad esat pārliecināts, ka formula ir pareiza.

6. Izvēlieties pareizo datu tipu.

   Aprēķiniem izmantojiet Number, bet saturam vai etiķetēm — Text.

7. Pārbaudiet konstantes un pēdiņas.

   Skaitļus ievada bez pēdiņām. Fiksētas teksta vērtības jāievieto pēdiņās.

8. Izveidojiet noteikumu.

   Noteikums tiek pievienots konta līmeņa katalogam, bet paliek neaktīvs, līdz tas tiek piešķirts eksporta projekcijai.

9. Piešķiriet to testa eksportam.

   Ja ir piešķirti vairāki noteikumi, pārbaudiet to konfigurēto prioritāti, jo prioritāte nosaka apstrādes secību.

10. Pirms lietošanas produkcijā pārskatiet rezultātu.

    Izmantojiet kontrolētu produktu grupu un pārbaudiet transformētos atribūtus un gala XML sadaļā Export Checker, pirms izvades izmantošanas aktīvā pārdošanas kanālā.

Kas notiek pēc noteikuma izveides

Pēc Create rule izvēles noteikums tiek saglabāts konta Data Transformation Rules katalogā.

Šajā posmā:

• Sākotnējais piegādātāja fails netiek mainīts.
• Kartētie kataloga dati netiek automātiski pārrakstīti.
• Eksports netiek mainīts tikai tāpēc, ka noteikums pastāv.

Kad noteikums tiek piešķirts eksporta projekcijai, tas tiek izmantots šī eksporta apstrādes laikā. Tādējādi noteikums var ietekmēt nākamajā plānotajā eksporta ģenerēšanas reizē iekļautos datus.

Piemēram, noteikums, kas aizstāj price, var mainīt ģenerētajā XML ierakstīto cenu. Tas, vai šo XML vēlāk importē vai publicē ārējs marketplace vai veikals, ir atsevišķa darbplūsma.

Biežāk pieļautās kļūdas

• Pieņēmums, ka noteikuma saglabāšana to aktivizē.

  Noteikums ir jāpiešķir arī eksporta projekcijai.

• Pārāk plaša filtra izmantošana.

  Cenas vai krājumu transformācija var ietekmēt visus atbilstošos produktus piešķirtajā eksportā.

• Nepareiza AND un OR apvienošana.

  Izlasiet visu filtru kā teikumu un pārbaudiet to ar nelielu produktu grupu.

• Ar komatiem atdalītu vērtību ievadīšana operatoriem In vai Not in.

  Saskarnē vairākas filtra vērtības jāatdala ar semikoliem.

• Skaitlisku salīdzinājumu izmantošana teksta datiem.

  Neskaitliskas vērtības var tikt uzskatītas par nulli.

• Nepareiza datu tipa izmantošana.

  Cenas formulu nevajadzētu saglabāt kā Text, bet teksta etiķeti — kā Number.

• Pēdiņu aizmiršana ap fiksētu tekstu.

  Izmantojiet tādas vērtības kā "SALE", nevis teksta konstanti bez pēdiņām.

• Nejauša standarta atribūta aizstāšana.

  Ievadot price, tiek mainīta cenas vērtība eksporta posmā. Testēšanai izmantojiet jaunu nosaukumu, piemēram, price_test.

• Tikai viena piegādātāja attēlojuma pārbaude.

  Produktus var grupēt pēc EAN no vairākiem piegādātājiem. Pirms transformācijas rezultāta vērtēšanas pārliecinieties, kuri piegādātāja dati tiek atlasīti eksporta darbplūsmā.

Piemērs: atsevišķas vietnes cenas izveide

Pārdevējs vēlas pievienot viena piegādātāja produktiem 20% maržu un noapaļot rezultātu uz augšu. Sākotnējai cenai jāpaliek pieejamai.

Noteikuma nosaukums

Izveidot vietnes cenu Supplier A produktiem

Filtra kritēriji

Lauks	Operators	Vērtība
Supplier (title)	Equal (=)	Supplier A
Price	Greater than (>)	0

Saistiet nosacījumus ar AND, lai abiem nosacījumiem būtu jāatbilst.

Atribūtu transformācija

Nosaukums	Datu tips	Vērtība
price_for_website	Number	ceil(price * 1.20)

Pēc noteikuma izveides piešķiriet to testa eksporta projekcijai. Pārbaudiet Export Checker, vai sākotnējais price ir palicis nemainīgs un vai price_for_website satur sagaidāmo aprēķina rezultātu. Pēc tam eksporta veidne vajadzības gadījumā var izmantot jauno atribūtu.