Jak tworzyć wielokrotnego użytku atrybuty właściwe dla 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 potrzebować 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ł przekształcania podczas przygotowywania eksportów. Przekształcenie 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 spójnie 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.
• Ponownie wykorzystać tę samą obliczoną wartość w więcej niż jednym eksporcie.
• Ułatwić odczytywanie i utrzymanie szablonów eksportu.

Zmiany reguł przekształcania mogą wpłynąć na wygenerowany XML po wygenerowaniu kolejnego eksportu. Przed użyciem zmienionego eksportu w działającej stronie internetowej, na marketplace lub w innym miejscu docelowym sprawdź wynik w module Sprawdzanie 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 właściwy dla danego kanału.

Na przykład zamiast zastępować price, możesz utworzyć:

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

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

Kiedy zastąpienie istniejącego atrybutu ma sens

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 pól 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ą zwykle łatwiejsze w zarządzaniu.

Kiedy bezpieczniej 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ż właściwych dla danego 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 postaci zwykłego tekstu i HTML.
• Wartości stanu magazynowego dostosowanych do określonego miejsca docelowego.
• Wartości pośrednich używanych w większym obliczeniu.

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

Jak nazywać atrybuty właściwe dla kanału

Podczas tworzenia własnego szablonu eksportu możesz wybrać nazwy atrybutów odpowiadające Twojemu procesowi. Używaj nazw, które jasno opisują zarówno wartość, jak i jej docelowe miejsce użycia.

Praktyczne przykłady:

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

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

Jeśli używasz przygotowanego szablonu eksportu, stosuj mapowania atrybutów wymagane przez ten szablon, zamiast zmieniać nazwy pól bez sprawdzenia, jak są używane.

Utwórz regułę przekształcania

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

Podczas tworzenia reguły:

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

Używanie kilku reguł i priorytetów reguł

Reguły przekształcania są stosowane zgodnie z ustawionym priorytetem. Pozwala to określić, które reguły będą oceniane wcześniej, a które później w procesie eksportu.

Na ten sam atrybut może wpływać więcej niż jedna reguła, ale należy korzystać z tego ostrożnie. Ostateczny wynik może zależeć od priorytetu każdej reguły, warunków filtrowania i skonfigurowanego przekształcenia. 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.
• Używaj oddzielnych reguł, 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.

Ponowne używanie tego samego atrybutu w kilku eksportach

Regułę przekształcania można wybrać dla więcej niż jednego eksportu. Nie trzeba tworzyć osobnej 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 używać tej reguły. Włącz odpowiednią regułę przekształcania i zmapuj jej atrybut pochodny w szablonie eksportu. Szczegółowe instrukcje konfiguracji eksportu znajdziesz w artykule Eksporty: tworzenie i konfigurowanie eksportów XML.

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

Co sprawdzić w konfiguracji eksportu

• Upewnij się, że wymagana reguła przekształcania 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 atrybut oryginalny.
• Sprawdź, czy filtry reguły obejmują oczekiwane produkty.
• Upewnij się, że nazwa atrybutu jest zapisana w ten sam sposób 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 na marketplace — marżę 25%.

Możesz utworzyć:

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

Szablon eksportu na stronę internetową używa price_for_website. Szablon eksportu na marketplace używa price_marketplace. Zmapowany atrybut price pozostaje dostępny do sprawdzenia oraz dla każdego eksportu, który nadal go wymaga.

Sprawdzanie wartości pośrednich i końcowych

Użyj modułu Sprawdzanie eksportu, aby sprawdzić, jak przetworzono konkretny produkt. Wpisz EAN produktu, wybierz odpowiedni eksport i przeanalizuj dane źródłowe, zastosowane przekształcenia, obliczone wartości oraz wygenerowany XML.

Otwórz Sprawdzanie eksportu na swoim koncie. Instrukcje znajdziesz w artykule Sprawdzanie eksportów: przegląd danych produktów i wyników eksportu.

Typowe przyczyny nieoczekiwanego wyniku

• Reguła nie jest włączona dla eksportu: Zapisana reguła przekształcania 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 wykluczyć 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 przekształcania, 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. Zdecyduj, 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łę przekształcania 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 module Sprawdzanie eksportu.
6. Przejrzyj wygenerowany XML, zanim eksport zostanie użyty przez działające miejsce docelowe.

B2BLIX generuje skonfigurowany plik 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.