Reguły transformacji danych

Do czego służy ta strona

Strona Reguły transformacji danych służy do przygotowywania reguł wielokrotnego użytku, które zmieniają dane produktów otrzymane od dostawców. Typowe zastosowania obejmują dodawanie marży do ceny, zmianę wartości stanów magazynowych, czyszczenie opisów produktów, tłumaczenie treści, zmianę wielkości liter lub tworzenie atrybutów przeznaczonych dla konkretnego miejsca docelowego.

B2BLIX Feed może pobierać ten sam produkt od kilku dostawców. Produkty są grupowane na podstawie zaakceptowanego EAN, dlatego prawidłowe mapowanie EAN ma istotne znaczenie. Podczas przygotowywania eksportu system korzysta z danych produktu i dostawcy wybranych zgodnie z konfiguracją eksportu. Następnie reguła transformacji może zmienić wybrane dane produktu przed wygenerowaniem wyniku XML.

Reguły transformacji są tworzone na poziomie konta. Ta strona pełni więc funkcję katalogu reguł, które można później przypisać do jednej lub kilku projekcji eksportu.

Utworzenie reguły nie aktywuje jej automatycznie. Nowo utworzona reguła nie zmienia danych dostawcy ani wygenerowanych eksportów, dopóki nie zostanie przypisana do projekcji eksportu. Po przypisaniu może wpłynąć na następne zaplanowane wygenerowanie tego eksportu.

Kiedy otworzyć tę stronę

Otwórz tę stronę, gdy dane dostawcy zostały prawidłowo zaimportowane i zmapowane, ale wymagają dostosowania do konkretnego procesu eksportu.

Może być na przykład konieczne:

• Dodanie stałej kwoty lub procentowej marży do ceny dostawcy.
• Utworzenie osobnej ceny dla witryny internetowej lub marketplace'u bez zastępowania pierwotnej ceny.
• Ustawienie innej wartości stanu magazynowego dla wybranych produktów.
• Usunięcie kodu HTML z opisów.
• Przetłumaczenie wybranych treści produktów.
• Zmiana tytułów na wielkie litery, małe litery lub zapis typowy dla tytułów.
• Połączenie kilku wartości w nowy tytuł lub opis.
• Zastosowanie różnych obliczeń do różnych dostawców, kategorii, marek lub przedziałów cenowych.

Co można zrobić na tej stronie

• Utworzyć łatwą do rozpoznania regułę transformacji.
• Ograniczyć działanie reguły do produktów spełniających wybrane kryteria filtrowania.
• Łączyć warunki za pomocą logiki AND i OR.
• Zastąpić istniejący atrybut produktu, na przykład price.
• Utworzyć nowy atrybut, na przykład price_for_website.
• Wybrać, czy wynik transformacji ma być tekstem, czy liczbą.
• Korzystać ze stałych, atrybutów produktów, obliczeń, funkcji i logiki warunkowej.
• Dodać kilka transformacji atrybutów do jednej reguły.
• Zapisać regułę w katalogu transformacji na poziomie konta.

Główne pola i elementy sterujące

Pole lub element	Znaczenie	Działanie
Title	Rozpoznawalna nazwa reguły. Użyj nazwy wyjaśniającej jej cel i docelową grupę produktów.	Służy do późniejszego identyfikowania reguły. Nie zmienia danych produktów.
Filter Criteria	Warunki określające, które produkty otrzymają transformacje.	Są sprawdzane podczas używania reguły w ramach przygotowywania eksportu.
Field	Atrybut produktu, który należy sprawdzić, na przykład dostawca, kategoria, cena, stan magazynowy lub EAN.	Określa, która wartość produktu jest używana przez warunek.
Operator	Porównanie, które należy wykonać, na przykład równa się, zawiera, jest puste lub jest większe niż.	Kontroluje sposób porównania wybranego pola z wprowadzoną wartością.
Value(s)	Wartość, z którą porównywany jest atrybut produktu.	Jest używana wyłącznie do oceny filtra. Niektóre operatory, takie jak Is empty, nie wymagają wartości porównania.
Add AND / OR rule	Dodaje kolejny warunek lub grupę warunków.	Umożliwia dokładniejszy wybór produktów.
Name	Atrybut, do którego ma trafić przekształcony wynik.	Istniejąca nazwa zastępuje wartość tego atrybutu. Nowa nazwa tworzy nowy atrybut do użycia w szablonie eksportu.
Data type	Wybierz Text lub Number zgodnie z oczekiwanym wynikiem.	Określa sposób traktowania wyniku podczas transformacji i przygotowywania eksportu.
Value	Stała, atrybut produktu, formuła, funkcja lub wyrażenie logiczne.	Tworzy wartość zapisywaną w wybranym atrybucie.
Add attribute	Dodaje kolejny wiersz transformacji do tej samej reguły.	Umożliwia jednej regule utworzenie lub zmianę kilku atrybutów.
Create rule	Zapisuje ukończoną regułę.	Dodaje ją do katalogu na poziomie konta. Nie wpływa na eksport, dopóki nie zostanie do niego przypisana.

Nazwa reguły

Pole Title jest wymagane i powinno ułatwiać rozpoznanie reguły w katalogu transformacji oraz ustawieniach eksportu.

Przydatne nazwy opisują zarówno działanie, jak i produkty, których ono dotyczy. Przykłady:

• Dodaj 20% marży dla dostawcy A
• Usuń HTML z opisów
• Utwórz cenę dla witryny
• Przetłumacz wybrane tytuły na fiński

Unikaj nazw takich jak „Reguła 1” lub „Nowa transformacja”, szczególnie gdy ten sam eksport będzie korzystał z wielu reguł.

Kryteria filtrowania

Kryteria filtrowania określają, czy transformacje atrybutów zostaną zastosowane do produktu. Gdy warunki są spełnione, wykonywana jest sekcja transformacji. Gdy nie są spełnione, reguła nie przekształca produktu.

Filtr na tej stronie określa, czy dana reguła transformacji ma zastosowanie. Nie należy go mylić z głównymi filtrami wyboru produktów w projekcji eksportu.

Dostępne pola filtrowania

Widoczny selektor pól zawiera:

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

Dostępne operatory filtrowania

Operator	Znaczenie
Equal (=)	Atrybut musi dokładnie odpowiadać wartości. Wielkość liter jest ignorowana, więc „Apple” i „apple” są traktowane jako równe.
Not equal (!=)	Atrybut nie może odpowiadać wartości. Wielkość liter jest ignorowana.
Contains	Wprowadzona wartość musi występować w atrybucie. Wielkość liter jest ignorowana.
Not contains	Wprowadzona wartość nie może występować w atrybucie. Wielkość liter jest ignorowana.
In	Atrybut musi odpowiadać jednemu elementowi z listy wartości.
Not in	Atrybut nie może odpowiadać żadnemu elementowi z listy wartości.
Is empty	Atrybut nie może zawierać wartości.
Is not empty	Atrybut musi zawierać wartość.
Greater than (>)	Atrybut musi być liczbowo większy od wprowadzonej wartości.
Greater than or equal to (>=)	Atrybut musi być liczbowo większy lub równy wprowadzonej wartości.
Less than (<)	Atrybut musi być liczbowo mniejszy od wprowadzonej wartości.
Less than or equal to (<=)	Atrybut musi być liczbowo mniejszy lub równy wprowadzonej wartości.

Ostrzeżenie dotyczące filtrów liczbowych: Interfejs informuje, że wartości nieliczbowe są traktowane jako 0 w porównaniach liczbowych. Przed użyciem warunków większe niż lub mniejsze niż upewnij się, że wybrane pole zawiera wiarygodne dane liczbowe.

W przypadku In i Not in oddziel wiele wartości średnikami. Przykład:

Brand A;Brand B;Brand C

Używanie AND i OR

AND oznacza, że wszystkie połączone warunki muszą być prawdziwe. Przykład:

• Dostawca równa się „Supplier A”
• AND Kategoria równa się „Electronics”

Transformacja zostanie zastosowana tylko wtedy, gdy oba warunki są spełnione.

OR oznacza, że co najmniej jeden połączony warunek musi być prawdziwy. Przykład:

• Producent równa się „Brand A”
• OR Producent równa się „Brand B”

Interfejs obsługuje grupy warunków AND i OR. W przypadku bardziej złożonych grup najpierw opisz zamierzoną logikę prostym zdaniem, a następnie odtwórz ją w interfejsie.

Dokładnie sprawdzaj złożone filtry AND/OR. Nieprawidłowe użycie AND lub OR może spowodować zastosowanie reguły do zbyt wielu produktów albo uniemożliwić jej dopasowanie do jakiegokolwiek produktu. Zacznij od jednego lub dwóch warunków i rozszerzaj filtr dopiero po zrozumieniu podstawowego wyniku. Wewnętrzny asystent AI może pomóc w sprawdzeniu zamierzonej logiki.

Transformacja atrybutów

Sekcja Attribute transformation określa, co ma się wydarzyć po dopasowaniu produktu do filtra.

Name

Wprowadź atrybut, do którego ma trafić wynik.

• Wprowadź nazwę istniejącego atrybutu, na przykład price, aby zastąpić tę wartość w procesie eksportu.
• Wprowadź nową nazwę, na przykład price_for_website, aby utworzyć osobny atrybut i zachować dostęp do pierwotnej wartości.

Zmiany ceny i stanu magazynowego mogą wpływać na eksportowane dane handlowe. Jeśli nie masz pewności co do formuły, najpierw utwórz osobny atrybut testowy. Potwierdź końcową wartość przed zastąpieniem standardowego atrybutu price lub stock.

Data type

Wybierz typ odpowiadający oczekiwanemu wynikowi:

• Text dla tytułów, opisów, etykiet, statusów, kolorów lub połączonych treści.
• Number dla cen, ilości, wag, marż i innych obliczeń.

Formuła tworząca cenę powinna zwykle używać typu Number. Formuła tworząca etykietę, taką jak „Dostępny”, powinna używać typu Text.

Value

Pole Value określa przekształcony wynik. Może zawierać stałą wartość, istniejący atrybut produktu, formułę matematyczną lub obsługiwaną funkcję.

Stałe

Stałe to niezmienne wartości wpisywane bezpośrednio w transformacji.

Typ	Przykład	Zastosowanie
Numeric constant	9.99	Używaj dla stałych cen, marż, ilości lub wartości obliczeń.
Text constant	"SALE" lub "In Stock"	Używaj dla stałego tekstu. Stałe tekstowe należy umieszczać w cudzysłowie.

Atrybuty systemowe

Atrybuty systemowe reprezentują wartości pobierane z przetwarzanych danych produktu. Można ich używać jako zmiennych wewnątrz formuły transformacji.

Atrybut	Opis wyświetlany przez interfejs
ean	Europejski Numer Artykułu produktu.
sku	SKU dostawcy lub identyfikator produktu.
title	Nazwa produktu.
description	Szczegółowy opis produktu.
price	Cena produktu.
stock	Liczba dostępnych sztuk.
images	Jeden lub więcej adresów URL obrazów produktu.
category_id	Identyfikator kategorii produktu.
manufacturer	Wartość producenta lub marki produktu.
weight	Waga produktu jako wartość liczbowa.
dimensions	Wymiary produktu w formie tekstowej.
color	Kolor produktu w formie tekstowej.
attributes	Lista dodatkowych atrybutów produktu.

Używaj nazw atrybutów dokładnie w postaci wyświetlanej w interfejsie. Wartość pochodzi z danych produktu dostępnych podczas przygotowywania eksportu, a nie bezpośrednio z nieprzetworzonego pliku dostawcy.

Działania matematyczne

Działanie	Cel	Przykład
+	Dodawanie	price + 2.50
-	Odejmowanie	price - 10
*	Mnożenie	price * 1.20
/	Dzielenie	price / 1.20
( )	Grupowanie części obliczenia.	(price + 2.50) * 1.20

Nawiasy są przydatne, gdy formuła składa się z kilku etapów. Wyjaśniają zamierzoną kolejność obliczeń i zmniejszają ryzyko nieoczekiwanego wyniku.

Funkcje matematyczne

Funkcja	Cel	Format przykładu
ceil	Zaokrągla liczbę w górę do najbliższej liczby całkowitej.	ceil(value)
floor	Zaokrągla liczbę w dół do najbliższej liczby całkowitej.	floor(value)
round	Zaokrągla wartość liczbową.	round(value)
min	Zwraca najmniejszą wartość spośród podanych wartości.	min(value1, value2)
max	Zwraca największą wartość spośród podanych wartości.	max(value1, value2)

Funkcje niestandardowe

Funkcja	Działanie	Przykład lub zastosowanie
translate	Tłumaczy tekst na określony język docelowy.	translate(es, text)
html2text	Konwertuje treść HTML na zwykły tekst.	html2text(description)
uppercase	Zmienia tekst na wielkie litery.	uppercase(title)
lowercase	Zmienia tekst na małe litery.	lowercase(title)
headline	Zmienia tekst na zapis typowy dla tytułów.	Użyj formatu funkcji wyświetlanego obecnie w interfejsie.
concat	Łączy kilka wartości tekstowych w jeden wynik.	concat(title, " - ", color)
if	Zwraca jeden wynik, gdy warunek jest prawdziwy, oraz inny, gdy jest fałszywy.	if(condition, value_if_true, value_if_false)

Tłumaczenie zależy od użycia. Reguły korzystające z funkcji translate mogą tworzyć płatne zadania tłumaczeniowe. Przed zastosowaniem tłumaczenia do dużego katalogu zapoznaj się z aktualnymi informacjami o cenach Feed.

Operatory logiczne wewnątrz formuł

Operatorów logicznych można używać wewnątrz wyrażenia if, aby tworzyć różne wartości dla różnych produktów.

Operator lub funkcja	Cel
=	Równa się
!=	Nie równa się
>	Większe niż
>=	Większe niż lub równe
<	Mniejsze niż
<=	Mniejsze niż lub równe
[...]	Zbiór lub lista wartości, na przykład ["Brand A", "Brand B"].
and	Wymaga, aby oba połączone warunki były prawdziwe.
or	Wymaga, aby co najmniej jeden połączony warunek był prawdziwy.
not	Odwraca wynik logiczny.
contains	Sprawdza, czy tekst zawiera wybraną wartość.
not_contains	Sprawdza, czy tekst nie zawiera wybranej wartości.
in	Sprawdza, czy wartość występuje w określonym zbiorze.
not_in	Sprawdza, czy wartość nie występuje w określonym zbiorze.
is_empty	Sprawdza, czy atrybut nie ma wartości.
is_not_empty	Sprawdza, czy atrybut ma wartość.

Przykładowe wyrażenie warunkowe:

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

Ten przykład stosuje jeden mnożnik, gdy cena przekracza 100, oraz inny mnożnik w przeciwnym razie.

Jak bezpiecznie korzystać z tej strony

1. Określ zamierzony wynik.

   Zapisz, które produkty mają zostać zmienione, który atrybut należy zmienić oraz jak powinien wyglądać oczekiwany wynik.

2. Użyj jasnej nazwy reguły.

   Uwzględnij działanie i grupę produktów, aby można było później rozpoznać regułę.

3. Zacznij od wąskiego filtra.

   Podczas pierwszych testów ogranicz regułę do dostawcy, kategorii, marki lub pojedynczego EAN zamiast stosować ją do całego katalogu.

4. Przeczytaj filtr jak zdanie.

   Upewnij się, że każde AND i OR tworzy zamierzoną grupę produktów.

5. Ostrożnie wybierz atrybut wyjściowy.

   Podczas testowania użyj nowego atrybutu. Zastępuj standardowy atrybut tylko wtedy, gdy masz pewność, że formuła jest prawidłowa.

6. Wybierz właściwy typ danych.

   Użyj Number dla obliczeń, a Text dla treści lub etykiet.

7. Sprawdź stałe i cudzysłowy.

   Liczby wprowadza się bez cudzysłowów. Stałe wartości tekstowe należy umieszczać w cudzysłowie.

8. Utwórz regułę.

   Reguła zostanie dodana do katalogu na poziomie konta, ale pozostanie nieaktywna do czasu przypisania jej do projekcji eksportu.

9. Przypisz ją do eksportu testowego.

   Po przypisaniu kilku reguł sprawdź ich skonfigurowany priorytet, ponieważ określa on kolejność przetwarzania.

10. Sprawdź wynik przed użyciem produkcyjnym.

    Użyj kontrolowanej grupy produktów i sprawdź przekształcone atrybuty oraz końcowy XML w Export Checker przed użyciem wyniku w aktywnym kanale sprzedaży.

Co dzieje się po utworzeniu reguły

Po wybraniu opcji Create rule reguła zostaje zapisana w katalogu reguł transformacji danych dla konta.

Na tym etapie:

• Oryginalny plik dostawcy nie zostaje zmieniony.
• Zmapowane dane katalogu nie zostają automatycznie przepisane.
• Żaden eksport nie zostaje zmieniony tylko dlatego, że reguła istnieje.

Po przypisaniu reguły do projekcji eksportu jest ona używana podczas przetwarzania tego eksportu. Może wtedy wpłynąć na dane zawarte w następnym zaplanowanym wygenerowaniu eksportu.

Na przykład reguła zastępująca price może zmienić cenę zapisaną w wygenerowanym XML. To, czy ten XML zostanie później zaimportowany lub opublikowany przez zewnętrzny marketplace albo sklep, jest odrębnym procesem.

Typowe błędy

• Założenie, że zapisanie reguły ją aktywuje.

  Regułę trzeba również przypisać do projekcji eksportu.

• Użycie zbyt szerokiego filtra.

  Transformacja ceny lub stanu magazynowego może wpłynąć na każdy pasujący produkt w przypisanym eksporcie.

• Nieprawidłowe łączenie AND i OR.

  Przeczytaj cały filtr jak zdanie i przetestuj go na małej grupie produktów.

• Wprowadzanie wartości oddzielonych przecinkami dla In lub Not in.

  Interfejs oczekuje oddzielenia wielu wartości filtra średnikami.

• Używanie porównań liczbowych dla danych tekstowych.

  Wartości nieliczbowe mogą być traktowane jako zero.

• Użycie niewłaściwego typu danych.

  Formuły ceny nie należy zapisywać jako Text, a etykiety tekstowej jako Number.

• Brak cudzysłowów wokół stałego tekstu.

  Używaj wartości takich jak "SALE", a nie nieujętej w cudzysłów stałej tekstowej.

• Niezamierzone zastąpienie standardowego atrybutu.

  Wprowadzenie price zmienia wartość ceny na etapie eksportu. Podczas testowania użyj nowej nazwy, na przykład price_test.

• Testowanie tylko jednej reprezentacji dostawcy.

  Produkty mogą być grupowane według EAN pochodzącego od różnych dostawców. Przed oceną wyniku transformacji sprawdź, które dane dostawcy wybiera proces eksportu.

Przykład: utworzenie osobnej ceny dla witryny

Sprzedawca chce dodać 20% marży do produktów od jednego dostawcy i zaokrąglić wynik w górę. Pierwotna cena powinna pozostać dostępna.

Nazwa reguły

Utwórz cenę dla witryny dla dostawcy A

Kryteria filtrowania

Pole	Operator	Wartość
Supplier (title)	Equal (=)	Supplier A
Price	Greater than (>)	0

Połącz warunki za pomocą AND, aby oba musiały zostać spełnione.

Transformacja atrybutu

Nazwa	Typ danych	Wartość
price_for_website	Number	ceil(price * 1.20)

Po utworzeniu reguły przypisz ją do testowej projekcji eksportu. W Export Checker potwierdź, że pierwotny price pozostał niezmieniony, a price_for_website zawiera oczekiwany obliczony wynik. Szablon eksportu może następnie używać nowego atrybutu tam, gdzie jest to wymagane.