Jak przekształcić specyfikację docelowego XML w szablon eksportu B2BLIX

Co umożliwia ten poradnik

Docelowa platforma może udostępniać specyfikację XML opisującą oczekiwaną strukturę i informacje o produktach. Twoim zadaniem jest przełożenie tej specyfikacji na projekcję eksportu, która wykorzystuje dane katalogowe B2BLIX.

Zwykle obejmuje to określenie powtarzającej się ścieżki produktu, utworzenie wymaganych pól wyjściowych, wskazanie źródła każdej wartości oraz przygotowanie wartości wymagających obliczeń lub formatowania.

B2BLIX Feed tworzy eksporty XML na podstawie zmapowanych danych katalogowych, wyboru produktów dla danego eksportu, filtrów, reguł transformacji danych i ustawień szablonu.

Krótka odpowiedź

Zacznij od przekształcenia specyfikacji docelowej w prosty plan pól. Dla każdego pola docelowego zapisz:

• Nazwę elementu XML i jego położenie w dokumencie.
• Czy pole jest wymagane, czy opcjonalne.
• Który atrybut B2BLIX powinien dostarczać wartość.
• Czy wartość musi zostać obliczona, ponownie sformatowana, przetłumaczona lub zastąpiona.
• Czy pole korzysta ze stałej wartości takiej samej dla każdego produktu.
• Co powinno się stać, gdy wartość źródłowa jest pusta.

Następnie możesz zbudować strukturę w szablonie eksportu i użyć reguł transformacji danych dla wartości, których nie można wykorzystać bezpośrednio.

Zmiany włączonego eksportu mogą wpłynąć na plik XML używany przez stronę internetową, marketplace, platformę porównywania cen lub inne miejsce docelowe. Przed zmianą aktywnego szablonu sprawdź bieżące ustawienia i wygenerowany plik XML.

Najpierw przygotuj wymagania miejsca docelowego

Przed skonfigurowaniem eksportu utwórz listę kontrolną na podstawie specyfikacji miejsca docelowego. Oddzielenie pól wymaganych od opcjonalnych ułatwia wykrycie brakujących danych produktów i pozwala uniknąć poświęcania czasu na pola, których miejsce docelowe nie potrzebuje.

Używaj dokładnych nazw pól i udokumentowanych formatów miejsca docelowego. Nie zmieniaj nazwy pola docelowego tylko dlatego, że odpowiadający mu atrybut B2BLIX ma inną nazwę.

Poznaj elementy szablonu XML

Ścieżki główne i kontenerów

Element główny to zewnętrzna struktura dokumentu XML. Zwykle występuje raz i zawiera kolekcję eksportowanych produktów.

Na przykład specyfikacja miejsca docelowego może umieszczać wszystkie produkty w strukturze takiej jak catalog/products.

Ścieżka produktu

Ścieżka produktu wskazuje element XML powtarzający się dla każdego wybranego produktu. Jeśli specyfikacja używa catalog/products/product, każdy eksportowany produkt jest zapisywany jako osobny element product w tej ścieżce.

Nazwy pól wyjściowych

Nazwy pól wyjściowych to nazwy elementów XML wymagane przez miejsce docelowe, takie jak ean, price, stock lub title.

Opisują one strukturę miejsca docelowego. Nie określają, skąd pochodzi wartość pola.

Wartości dynamiczne

Wartość dynamiczna pochodzi z bieżących danych produktu. Może wykorzystywać:

• Standardowy zmapowany atrybut, taki jak ean, price, stock lub title.
• Wartość wybraną z danych dostawcy.
• Nowy atrybut utworzony przez regułę transformacji danych, taki jak price_for_website.

Wartość może więc być inna dla każdego produktu.

Stałe

Stała to niezmienna wartość zapisywana dla każdego odpowiedniego produktu. Jest przydatna, gdy miejsce docelowe wymaga informacji, która nie zmienia się między produktami.

Na przykład pole waluty może używać stałej EUR, jeśli jest to poprawne dla całego eksportu.

Używaj stałej tylko wtedy, gdy wartość rzeczywiście jest poprawna dla każdego objętego nią produktu. Stałej wartości nie należy używać do ukrywania niepełnych lub niespójnych danych dostawcy.

Wartości domyślne

Wartość domyślna to przygotowana wartość zastępcza używana, gdy zwykła wartość źródłowa jest pusta. Wartości domyślne są odpowiednie tylko wtedy, gdy miejsce docelowe dopuszcza wartość zastępczą i pozostaje ona zgodna ze stanem faktycznym.

Przed dodaniem wartości domyślnej sprawdź:

• Czy miejsce docelowe dopuszcza wartość zastępczą dla tego pola.
• Czy ta sama wartość zastępcza jest poprawna dla wszystkich objętych nią produktów.
• Czy brak wymaganej wartości powinien zamiast tego spowodować wykluczenie produktu.
• Czy brakującą wartość należy poprawić w mapowaniu dostawcy lub danych źródłowych.

Zbuduj szablon eksportu

Aby skonfigurować strukturę XML, otwórz Eksporty na swoim koncie. Szczegółowe informacje o ustawieniach eksportu i interfejsie szablonu znajdziesz w artykule Tworzenie i konfigurowanie projekcji eksportu XML.

1. Utwórz nowy eksport lub otwórz eksport, który przygotowujesz.
2. Skonfiguruj ogólne ustawienia eksportu i wybierz odpowiednich dostawców oraz produkty.
3. Ustaw powtarzającą się ścieżkę produktu zgodnie ze specyfikacją miejsca docelowego.
4. Dodaj wymagane nazwy pól wyjściowych miejsca docelowego.
5. Połącz każde pole wyjściowe ze standardowym atrybutem, przekształconym atrybutem lub odpowiednią stałą.
6. Dodawaj pola opcjonalne tylko wtedy, gdy zawierają przydatne dane i są zgodne ze specyfikacją miejsca docelowego.
7. Zapisz konfigurację i sprawdź wygenerowany plik XML przed użyciem go w kanale produkcyjnym.

Używaj transformacji, gdy wartości nie można wyeksportować bezpośrednio

Niektóre wymagania miejsca docelowego można spełnić za pomocą standardowych zmapowanych atrybutów. Inne wartości trzeba przygotować przed dodaniem ich do szablonu.

Aby utworzyć lub sprawdzić te reguły, otwórz Reguły transformacji danych na swoim koncie. Wyjaśnienie filtrów reguł, wyrażeń, priorytetów i przekształconych atrybutów znajdziesz w artykule Reguły transformacji danych.

Typowe zastosowania obejmują:

• Obliczanie ceny właściwej dla miejsca docelowego.
• Dodawanie VAT, stałej marży lub marży procentowej.
• Zaokrąglanie wartości liczbowych.
• Tworzenie tytułu właściwego dla miejsca docelowego.
• Tłumaczenie wybranych treści.
• Konwertowanie opisów HTML na zwykły tekst.
• Zmianę wielkości liter lub formatowania tytułu.
• Łączenie kilku atrybutów w jedną wartość wyjściową.
• Używanie logiki warunkowej, gdy różne produkty wymagają różnych wartości.
• Tworzenie dodatkowego atrybutu bez zastępowania oryginalnej wartości.

Kiedy używać identyfikatorów lub kodów kategorii

Nazwy kategorii mogą być długie, przetłumaczone lub różnie zapisywane przez różnych dostawców. Identyfikator kategorii często łatwiej wykorzystać w filtrze lub transformacji warunkowej, ponieważ stanowi krótszy i bardziej spójny punkt odniesienia.

Na przykład reguła może zastosować określoną wartość tylko wtedy, gdy category id odpowiada wybranej kategorii. Może także wykluczyć produkty z tej kategorii lub utworzyć atrybut właściwy dla miejsca docelowego.

Aby sprawdzić dostępne kategorie B2BLIX i ich identyfikatory, otwórz Mapę kategorii na swoim koncie. Szczegółowe informacje o hierarchii kategorii i relacjach między kategoriami dostawców znajdziesz w artykule Interfejs mapy kategorii.

Jeśli miejsce docelowe używa własnych kodów kategorii, sprawdź, czy różnią się one od identyfikatorów kategorii B2BLIX. Jeśli tak, przygotuj wymaganą wartość docelową za pomocą odpowiedniej reguły lub mapowania, zamiast zakładać, że identyfikatory są wymienne.

Obsługuj puste wartości, kod HTML i znaki specjalne

Puste wartości

Używaj warunków dotyczących pustych wartości w regule transformacji, gdy wynik zależy od dostępności atrybutu. W zależności od wymagania miejsca docelowego reguła może utworzyć zatwierdzoną wartość zastępczą, wybrać inny atrybut lub pomóc zidentyfikować produkty, których nie należy uwzględniać.

Nie dodawaj automatycznie wartości domyślnych do każdego pustego pola. Najpierw sprawdź, czy pole jest wymagane i czy proponowana wartość zastępcza jest prawidłowa.

Treść HTML

Jeśli miejsce docelowe wymaga zwykłego tekstu, ale opis dostawcy zawiera kod HTML, użyj funkcji html-to-text w regule transformacji danych. Połącz wynikowy przekształcony atrybut z polem docelowym w szablonie eksportu.

Znaki specjalne

Sprawdź wygenerowany plik XML, aby potwierdzić, że tytuły, opisy, nazwy producentów i inne wartości tekstowe są wyświetlane prawidłowo. Zwróć szczególną uwagę na produkty zawierające cudzysłowy, znaki ampersand, litery diakrytyczne lub treści wielojęzyczne.

Miejsce docelowe może także nakładać własne ograniczenia dotyczące znaków, długości lub treści. Wymagania te należy odczytać ze specyfikacji miejsca docelowego.

Sprawdź wygenerowany plik XML

Po zapisaniu szablonu otwórz ogólne ustawienia eksportu w sekcji Eksporty. Po zalogowaniu użyj publicznego adresu URL eksportu, aby otworzyć wygenerowany plik XML w przeglądarce i sprawdzić jego bieżącą zawartość.

Sprawdź, czy:

• Zewnętrzna struktura XML odpowiada specyfikacji miejsca docelowego.
• Element produktu powtarza się we właściwej ścieżce.
• Wymagane pola wyjściowe mają prawidłowe nazwy.
• Pola zawierają oczekiwane wartości produktów.
• Stałe pojawiają się tylko w zamierzonych miejscach.
• Wartości obliczone i przekształcone są obecne.
• Puste wartości są obsługiwane zgodnie z planem.
• Mały wybór produktów z nietypowymi danymi również wygląda poprawnie.

Pomyślne wygenerowanie i otwarcie pliku XML potwierdza, że B2BLIX utworzył plik wyjściowy. Nie potwierdza to, że zewnętrzny marketplace, strona internetowa lub partner zaakceptował, zaimportował albo opublikował ten plik.

Nie publikuj ani nie udostępniaj publicznie adresu URL prywatnego eksportu przygotowanego dla konkretnego klienta ani nie przekazuj go nieupoważnionym osobom.

Sprawdzaj pojedyncze produkty, gdy wynik jest nieoczekiwany

Gdy w produkcie brakuje pola, występuje nieoczekiwana wartość lub produkt nie został uwzględniony, użyj narzędzia Export Checker, aby sprawdzić wynik na poziomie produktu.

Otwórz Export Checker na swoim koncie. Szczegółowe informacje o danych źródłowych, przetwarzaniu i wyeksportowanym pliku XML wyświetlanych w tym miejscu znajdziesz w artykule Export Checker: sprawdzanie danych produktów i wyników eksportu.

W zależności od produktu sprawdź:

• Oryginalne wartości dostawcy.
• Zmapowane atrybuty B2BLIX.
• Dostawcę wybranego dla produktu.
• Filtry eksportu, które mogły uwzględnić produkt lub go wykluczyć.
• Reguły transformacji, które zmieniły jego wartości.
• Końcowe atrybuty używane przez eksport.
• Reprezentatywny wyeksportowany plik XML.

Typowe problemy podczas wdrażania

• Nazwa pola wyjściowego jest nieprawidłowa. Zamiast nazwy elementu wymaganej przez miejsce docelowe użyto nazwy atrybutu B2BLIX.
• Ścieżka produktu jest ustawiona na niewłaściwym poziomie. Powtarzająca się ścieżka musi reprezentować kompletny produkt, a nie całą kolekcję ani pojedynczy atrybut.
• Wymagane pole nie ma zmapowanej wartości. Sprawdź mapowanie dostawcy i potwierdź, że produkt zawiera wymagane dane źródłowe.
• Nie utworzono obliczonego atrybutu. Utwórz wymaganą regułę transformacji danych i upewnij się, że jest włączona dla eksportu.
• Transformacja nie jest stosowana do zamierzonych produktów. Sprawdź jej kryteria filtrowania, priorytet oraz skonfigurowane w eksporcie zachowanie stop-if-matched.
• Stała jest używana tam, gdzie wymagane są dane właściwe dla produktu. Zastąp ją zmapowaną lub przekształconą wartością dynamiczną.
• Identyfikatory kategorii potraktowano jako kody miejsca docelowego. Potwierdź, którego systemu kategorii oczekuje miejsce docelowe, i w razie potrzeby przekształć wartość.
• Plik XML otwiera się poprawnie, ale został odrzucony zewnętrznie. Porównaj go z wymaganymi polami, formatami, dozwolonymi wartościami i zasadami importu miejsca docelowego. Samo wygenerowanie XML nie dowodzi akceptacji przez miejsce docelowe.

Przykład: przygotowanie rekordu produktu marketplace

Załóżmy, że marketplace wymaga jednego powtarzającego się elementu product zawierającego ean, price, stock, title i currency.

• ean korzysta ze standardowego atrybutu ean.
• stock korzysta z bieżącej wyeksportowanej wartości stanu magazynowego.
• title korzysta ze zmapowanego tytułu lub tytułu przekształconego na potrzeby miejsca docelowego.
• price korzysta z przekształconego atrybutu uwzględniającego wymaganą marżę i zaokrąglenie.
• currency korzysta ze stałej eur, ponieważ każda cena w tym eksporcie jest przygotowana w euro.

Jeśli miejsce docelowe wymaga opisów w postaci zwykłego tekstu, utwórz dodatkowy przekształcony opis za pomocą funkcji html-to-text i połącz ten atrybut z odpowiednim polem wyjściowym.

Co dalej

1. Przekształć specyfikację miejsca docelowego w listę kontrolną pól wymaganych i opcjonalnych.
2. Potwierdź, że niezbędne atrybuty dostawcy są zmapowane i dostępne w B2BLIX.
3. Utwórz obliczenia, reguły formatowania, wartości domyślne lub wartości warunkowe w regułach transformacji danych.
4. Zbuduj ścieżkę produktu XML i mapowania pól w szablonie eksportu.
5. Wygeneruj plik XML i porównaj go ze specyfikacją miejsca docelowego.
6. Sprawdź reprezentatywne produkty, w tym produkty z pustymi lub nietypowymi wartościami.
7. Użyj Export Checker, gdy wynik dla pojedynczego produktu jest niejasny.
8. Przetestuj plik z miejscem docelowym na kontrolowanym wyborze produktów przed rozszerzeniem eksportu.

W miarę możliwości trzymaj eksport testowy oddzielnie od aktywnego procesu sprzedaży. Rozszerzenie katalogu dopiero po sprawdzeniu struktury i wartości zmniejsza ryzyko opublikowania nieprawidłowych cen, stanów magazynowych, treści lub wyboru produktów.