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

Co w tym poradniku możesz zrobić

Miejsce docelowe może udostępniać specyfikację XML opisującą oczekiwaną strukturę i informacje o produktach. Twoim zadaniem jest przekształcenie tej specyfikacji w projekcję eksportu korzystającą z danych katalogowych B2BLIX.

Zwykle obejmuje to identyfikację powtarzającej się ścieżki produktu, utworzenie wymaganych pól wyjściowych, wybór ź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, określonych dla eksportu wyborów produktów, filtrów, reguł transformacji danych i ustawień szablonu.

Krótka odpowiedź

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

• nazwę elementu XML i jego lokalizację 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 używa 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 zastosować bezpośrednio.

Zmiany w aktywnym eksporcie mogą wpłynąć na plik XML używany przez stronę internetową, marketplace, porównywarkę 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. Rozdzielenie pól wymaganych i opcjonalnych ułatwia identyfikację 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 identyfikuje 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ą strukturę miejsca docelowego. Nie określają źródła wartości 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 różnić się dla każdego produktu.

Stałe

Stała to ustalona wartość zapisywana dla każdego właściwego 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 prawidłowe dla całego eksportu.

Używaj stałej tylko wtedy, gdy jej wartość jest rzeczywiście prawidłowa dla każdego objętego produktu. Stała wartość nie powinna służyć 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ą właściwe tylko wtedy, gdy miejsce docelowe dopuszcza takie rozwiązanie, a wartość pozostaje prawidłowa.

Przed dodaniem wartości domyślnej sprawdź:

• czy miejsce docelowe zezwala na wartość zastępczą dla tego pola,
• czy ta sama wartość zastępcza jest prawidłowa dla wszystkich objętych produktów,
• czy brak wymaganej wartości nie powinien zamiast tego spowodować wykluczenia produktu,
• czy brakująca wartość powinna zostać poprawiona 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 przygotowywany eksport.
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 dostarczają przydatnych danych 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 należy 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,
• stosowanie VAT-u, 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,
• konwersję opisów HTML do zwykłego tekstu,
• zmianę wielkości liter lub formatowania tytułu,
• łączenie kilku atrybutów w jedną wartość wyjściową,
• stosowanie logiki warunkowej, gdy różne produkty wymagają różnych wartości,
• tworzenie dodatkowego atrybutu bez zastępowania pierwotnej 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 jest często łatwiejszy do użycia w filtrze lub transformacji warunkowej, ponieważ zapewnia krótsze i bardziej spójne odniesienie.

Na przykład reguła może zastosować określoną wartość tylko wtedy, gdy category id odpowiada wybranej kategorii. Może również 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 kategorii 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 jest, przygotuj wymaganą wartość docelową za pomocą odpowiedniej reguły lub mapowania, zamiast zakładać, że identyfikatory są wymienne.

Obsługuj puste wartości, 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 wymagań 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 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 wyświetlają się prawidłowo. Zwróć szczególną uwagę na produkty zawierające cudzysłowy, ampersandy, znaki diakrytyczne lub treści wielojęzyczne.

Miejsce docelowe może również 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ę w prawidłowej ścieżce,
• wymagane pola wyjściowe mają prawidłowe nazwy,
• pola zawierają oczekiwane wartości produktów,
• stałe pojawiają się tylko tam, gdzie jest to zamierzone,
• obecne są wartości obliczone i przekształcone,
• puste wartości są obsługiwane zgodnie z planem,
• niewielki wybór produktów z nietypowymi danymi również wygląda prawidłowo.

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ł lub opublikował ten plik.

Nie publikuj ani nie udostępniaj publicznego adresu URL prywatnego eksportu właściwego dla klienta w publicznej dokumentacji lub osobom nieupoważnionym.

Sprawdzaj pojedyncze produkty, gdy wynik jest nieoczekiwany

Gdy w przypadku jednego produktu brakuje pola, pojawia się nieoczekiwana wartość lub produkt nie został uwzględniony, użyj 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świetlanym w tym miejscu znajdziesz w artykule Export Checker: przegląd danych produktów i wyników eksportu.

W zależności od produktu sprawdź:

• pierwotne 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 z wdrożeniem

• Nieprawidłowa nazwa pola wyjściowego. Zamiast nazwy elementu wymaganej przez miejsce docelowe użyto nazwy atrybutu B2BLIX.
• Ścieżka produktu jest ustawiona na nieprawidłowym poziomie. Powtarzająca się ścieżka musi reprezentować jeden 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 aktywna dla eksportu.
• Transformacja nie dotyczy właściwych produktów. Sprawdź kryteria filtra, priorytet i ewentualne zachowanie „zatrzymaj po dopasowaniu” skonfigurowane w eksporcie.
• 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ę prawidłowo, ale jest odrzucany zewnętrznie. Porównaj go z wymaganymi polami, formatami, dozwolonymi wartościami i zasadami importu miejsca docelowego. Samo wygenerowanie XML nie potwierdza 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 wartości stanu magazynowego eksportowanej dla produktu.
• title korzysta ze zmapowanego tytułu lub tytułu przekształconego specjalnie dla 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 przygotowywana w euro.

Jeśli miejsce docelowe wymaga opisów w zwykłym tekście, 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.

Jeśli to możliwe, 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.