Jak tworzyć wielokrotnego użytku atrybuty zależne od kanału bez nadpisywania danych źródłowych

Kiedy to podejście jest przydatne

Dostawca może przekazywać jedną cenę, nazwę, wartość stanu magazynowego lub opis, podczas gdy różne kanały sprzedaży wymagają różnych wersji tych informacji. Na przykład Twoja strona internetowa może wymagać ceny uwzględniającej marżę, a marketplace — innej nazwy lub przetłumaczonego opisu.

B2BLIX Feed umożliwia mapowanie danych dostawcy do wspólnej struktury produktu, a następnie stosowanie oddzielnych reguł transformacji podczas przygotowywania eksportów. Transformacja może zastąpić istniejący atrybut lub utworzyć nowy atrybut, którego można później użyć w szablonie eksportu.

Krótka odpowiedź

Zastąp istniejący atrybut, gdy przekształcona wartość powinna być używana w spójny sposób i nie potrzebujesz oddzielnej wersji zmapowanej wartości w procesie eksportu.

Utwórz nowy atrybut pochodny, gdy chcesz:

• Zachować zmapowaną wartość do porównania lub użycia w innym kanale.
• Utworzyć różne ceny, nazwy, opisy lub wartości stanu magazynowego dla różnych miejsc docelowych.
• Utrzymywać treści w kilku językach.
• Wykorzystywać tę samą obliczoną wartość w więcej niż jednym eksporcie.
• Ułatwić odczytywanie i utrzymanie szablonów eksportu.

Zmiany reguł transformacji mogą wpłynąć na wygenerowany XML po kolejnym wygenerowaniu eksportu. Przed użyciem zmienionego eksportu w działającej stronie internetowej, marketplace lub innym miejscu docelowym sprawdź wynik w Weryfikatorze eksportu.

Jak działają atrybuty pochodne

Atrybut pochodny to nowa wartość utworzona na podstawie istniejących danych produktu. Może zawierać obliczoną cenę, zmodyfikowaną nazwę, przetłumaczony opis, ustandaryzowaną wartość stanu magazynowego lub inny wynik przeznaczony dla konkretnego kanału.

Zamiast zastępować price, możesz na przykład utworzyć:

• price_for_website dla własnego sklepu.
• price_marketplace dla eksportu do marketplace.
• price_comparison dla platformy porównującej ceny.

Oryginalny zmapowany atrybut price pozostaje dostępny pod dotychczasową nazwą, a każdy eksport może korzystać z ceny pochodnej przeznaczonej dla danego miejsca docelowego. Transformacja nie modyfikuje zewnętrznego pliku źródłowego dostawcy.

Kiedy zastąpienie istniejącego atrybutu jest uzasadnione

Zastąpienie atrybutu może być właściwe, gdy istnieje jeden jasno określony wynik, który powinien być używany w całym odpowiednim procesie eksportu.

Typowe przykłady:

• Zastąpienie price ceną, która zawsze uwzględnia wymaganą marżę.
• Zastąpienie stock ustandaryzowaną wartością stanu magazynowego wymaganą przez miejsce docelowe.
• Usunięcie kodu HTML ze wszystkich eksportowanych description.
• Zastosowanie tego samego formatowania nazw do wszystkich produktów w eksporcie.

Przed zastąpieniem atrybutu upewnij się, że inny eksport lub szablon nie potrzebuje zmapowanej wartości pod jej oryginalną nazwą. Jeśli różne kanały wymagają różnych wyników, oddzielne atrybuty pochodne są zazwyczaj łatwiejsze w zarządzaniu.

Kiedy bezpieczniej jest utworzyć nowy atrybut

Utworzenie nowego atrybutu jest bezpieczniejsze, gdy zastąpienie istniejącej wartości mogłoby utrudnić zrozumienie jej przeznaczenia lub uniemożliwić innemu eksportowi użycie innej wersji.

Jest to szczególnie przydatne w przypadku:

• Cen i marż zależnych od kanału.
• Nazw o różnych wymaganiach dotyczących długości lub formatowania.
• Opisów przygotowanych w różnych językach.
• Wersji tego samego opisu w formacie zwykłego tekstu i HTML.
• Wartości stanu magazynowego dostosowanych do konkretnego miejsca docelowego.
• Wartości pośrednich używanych w większym obliczeniu.

Zachowaj na przykład title jako zmapowaną nazwę dostawcy i utwórz title_marketplace dla skróconej lub przeformatowanej wersji. Dzięki temu wiadomo, która wartość należy do danego procesu.

Jak nazywać atrybuty zależne od kanału

Podczas tworzenia własnego szablonu eksportu możesz wybrać nazwy atrybutów dopasowane do swojego procesu. Używaj nazw, które jasno opisują zarówno wartość, jak i jej przeznaczenie.

Praktyczne przykłady:

• price_for_website
• price_marketplace
• stock_marketplace
• title_marketplace
• description_plain_text
• description_lt

Stosuj konsekwentnie jeden schemat nazewnictwa. Unikaj niejasnych nazw, takich jak new_price, value2 lub final_data, ponieważ po dodaniu kolejnych reguł i eksportów ich przeznaczenie może stać się nieczytelne.

Jeśli korzystasz z przygotowanego szablonu eksportu, stosuj mapowania atrybutów wymagane przez ten szablon i nie zmieniaj nazw pól bez sprawdzenia, w jaki sposób są używane.

Utwórz regułę transformacji

Aby utworzyć lub sprawdzić atrybut pochodny, otwórz Reguły transformacji danych na swoim koncie. Aby poznać dostępne pola i opcje transformacji, przeczytaj artykuł Reguły transformacji danych.

Podczas tworzenia reguły:

1. Nadaj regule nazwę wyjaśniającą jej przeznaczenie i miejsce docelowe.
2. Dodaj warunki filtrowania tylko wtedy, gdy transformacja ma dotyczyć wybranych produktów.
3. Wybierz istniejące atrybuty używane w obliczeniu lub transformacji tekstu.
4. Wprowadź nazwę nowego atrybutu pochodnego.
5. Ustal priorytet reguły względem innych reguł używanych przez eksport.
6. Zapisz regułę i przypisz ją do wymaganego profilu eksportu.

Korzystanie z kilku reguł i ustalanie ich priorytetów

Reguły transformacji są stosowane zgodnie z ustawionym priorytetem. Dzięki temu możesz określić, które reguły będą oceniane wcześniej, a które później w procesie eksportu.

Więcej niż jedna reguła może wpływać na ten sam atrybut, ale należy korzystać z tego ostrożnie. Ostateczny wynik może zależeć od priorytetu każdej reguły, warunków filtrowania i skonfigurowanej transformacji. Sam priorytet nie łączy automatycznie kilku wartości w jedno obliczenie.

Aby konfiguracja była łatwa w utrzymaniu:

• Użyj jednej reguły lub jednego jasnego wyrażenia, gdy obliczenie można wykonać w jednym miejscu.
• Stosuj oddzielne reguły, gdy różne grupy produktów wymagają różnych warunków.
• Nadaj każdej regule opisową nazwę.
• Unikaj sytuacji, w której kilka niezależnych reguł zapisuje dane do tego samego atrybutu pochodnego, chyba że jest to zamierzone.
• Po zmianie priorytetów sprawdź wynik dla reprezentatywnych produktów.

Wykorzystaj ten sam atrybut w kilku eksportach

Regułę transformacji można wybrać dla więcej niż jednego profilu eksportu. Nie musisz tworzyć oddzielnej kopii tego samego obliczenia dla każdego eksportu, chyba że wymagana logika jest inna.

Otwórz Eksporty na swoim koncie i edytuj każdy eksport, który powinien korzystać z reguły. Włącz odpowiednią regułę transformacji i zmapuj jej atrybut pochodny w szablonie eksportu. Szczegółowe instrukcje konfiguracji eksportu znajdziesz w artykule Eksporty: tworzenie i konfigurowanie profili eksportu XML.

Na przykład zarówno pełny eksport na stronę internetową, jak i mniejszy eksport promocyjny mogą korzystać z price_for_website. Tę samą regułę można włączyć w obu eksportach, a oba szablony mogą mapować ten atrybut do wymaganego elementu XML.

Co sprawdzić w konfiguracji eksportu

• Upewnij się, że wymagana reguła transformacji jest włączona dla eksportu.
• Sprawdź priorytet reguły względem innych włączonych reguł.
• Sprawdź, czy inna reguła również zapisuje dane do tego samego atrybutu.
• Upewnij się, że szablon eksportu mapuje atrybut pochodny, a nie omyłkowo oryginalny.
• Sprawdź, czy filtry reguły obejmują oczekiwane produkty.
• Upewnij się, że nazwa atrybutu jest zapisana konsekwentnie w regule i szablonie.

Przykład: oddzielne ceny dla strony internetowej i marketplace

Załóżmy, że zmapowana cena dostawcy price wynosi €100. Cena na stronie internetowej powinna uwzględniać marżę 20%, a cena w marketplace — marżę 25%.

Możesz utworzyć:

• price_for_website z wynikiem €120.
• price_marketplace z wynikiem €125.

Szablon eksportu na stronę internetową korzysta z price_for_website. Szablon eksportu do marketplace korzysta z price_marketplace. Zmapowany atrybut price pozostaje dostępny do sprawdzenia oraz dla eksportów, które nadal go wymagają.

Sprawdź wartości pośrednie i końcowe

Użyj Weryfikatora eksportu, aby sprawdzić, jak przetworzono konkretny produkt. Wprowadź EAN produktu, wybierz odpowiedni eksport i przeanalizuj dane źródłowe, zastosowane transformacje, obliczone wartości oraz wygenerowany XML.

Otwórz Weryfikator eksportu na swoim koncie. Instrukcje znajdziesz w artykule Weryfikator eksportu: sprawdzanie danych produktu i wyników eksportu.

Typowe przyczyny nieoczekiwanego wyniku

• Reguła nie jest włączona dla eksportu: Zapisana reguła transformacji nie wpływa na eksport, dopóki nie zostanie wybrana w jego ustawieniach.
• Szablon używa niewłaściwego atrybutu: Reguła może prawidłowo utworzyć price_for_website, podczas gdy szablon nadal eksportuje price.
• Filtr nie pasuje: Dostawca, kategoria, producent, cena, stan magazynowy lub inny warunek może wykluczać produkt z reguły.
• Inna reguła zmienia tę samą wartość: Sprawdź wszystkie włączone reguły i ich priorytety.
• Nazwa atrybutu jest niespójna: Sprawdź pisownię i nazewnictwo zarówno w regule transformacji, jak i w szablonie eksportu.
• Eksport nie został ponownie wygenerowany: Zewnętrzny plik XML może nadal zawierać wynik z wcześniejszego wykonania eksportu.
• Miejsce docelowe używa innego elementu XML: Sprawdź, czy struktura wygenerowanego XML odpowiada wymaganiom platformy odbierającej plik.

Co zrobić dalej

1. Ustal, czy oryginalny zmapowany atrybut musi pozostać dostępny dla innego kanału lub obliczenia.
2. Utwórz jasno nazwany atrybut pochodny, gdy wymagane są różne wyniki.
3. Przypisz regułę transformacji tylko do eksportów, które jej potrzebują.
4. Zmapuj atrybut pochodny w każdym odpowiednim szablonie XML.
5. Sprawdź niewielki zestaw reprezentatywnych produktów według EAN w Weryfikatorze eksportu.
6. Przejrzyj wygenerowany XML przed użyciem eksportu przez działające miejsce docelowe.

B2BLIX generuje skonfigurowany wynik XML, ale zewnętrzna strona internetowa, marketplace lub inne miejsce docelowe decyduje o sposobie importu tego pliku i o tym, czy jego wartości zostaną zaakceptowane.