Jak zmienić adres URL dostawcy lub strukturę pliku danych bez zakłócania eksportów

Opis: Ten przewodnik wyjaśnia, dlaczego istniejące mapowania mogą przestać działać po zmianie źródła dostawcy, co należy sprawdzić przed włączeniem synchronizacji oraz jak zweryfikować eksporty, których dotyczy zmiana.

Kiedy ten przewodnik jest przydatny

Skorzystaj z tego przewodnika, gdy dostawca udostępni nowy adres URL pliku danych, zmieni strukturę istniejącego pliku XML lub JSON, zastąpi jeden plik źródłowy innym albo zmieni sposób połączenia źródła głównego ze źródłem dodatkowym.

Zmianę należy traktować jako kontrolowaną migrację. Nawet jeśli nowe źródło zawiera te same produkty, ścieżka produktu, nazwy pól lub lokalizacje pól mogą być inne. Istniejące mapowania mogą wtedy przestać znajdować ważne wartości, takie jak EAN, cena, stan magazynowy, tytuł lub kategoria.

Krótka odpowiedź

Zalecamy wyłączenie dostawcy podczas zmiany konfiguracji źródła. Zaktualizuj adres URL, sprawdź ścieżkę produktu, przejrzyj każde mapowanie oraz zweryfikuj połączenie źródła głównego ze źródłem dodatkowym, zanim ponownie włączysz dostawcę.

Należy również ustalić, które eksporty korzystają z tego dostawcy. Po pomyślnej synchronizacji dostawcy sprawdź kilka znanych produktów i skontroluj końcowy wynik każdego zależnego eksportu.

Ostrzeżenie: Zmiana źródła lub mapowania może wpłynąć na eksportowane ceny, ilości w magazynie, dostępność produktów oraz treści. Nie włączaj ponownie dostawcy, dopóki nowa struktura i mapowania nie zostaną dokładnie sprawdzone.

Dlaczego stare mapowanie może stać się nieprawidłowe

B2BLIX odczytuje informacje o produktach z określonych lokalizacji w strukturze XML lub JSON dostawcy. Podczas konfiguracji dostawcy te lokalizacje są łączone ze standardowymi polami B2BLIX.

Na przykład stare źródło może przechowywać identyfikator produktu w polu o nazwie EAN. Nowe źródło może nazywać je barcode albo umieszczać je w innej sekcji produktu. Stare mapowanie nadal będzie szukać danych w poprzedniej lokalizacji i może w rezultacie otrzymać pustą wartość.

Jest to szczególnie ważne w przypadku EAN. B2BLIX używa zaakceptowanego numeru EAN jako głównego identyfikatora produktu. Produkty bez użytecznego numeru EAN nie są przetwarzane w ramach standardowego procesu łączenia produktów. Uszkodzone mapowanie EAN może więc spowodować zniknięcie wielu produktów z oczekiwanego katalogu i wyników eksportu.

Sam adres URL nie zawsze jest problemem. Jeśli nowy adres URL zwraca dokładnie taką samą strukturę, istniejące mapowanie może nadal działać. Należy jednak zweryfikować strukturę, zamiast zakładać, że się nie zmieniła.

Przygotowanie przed zmianą dostawcy

Przed edycją źródła zapisz kilka punktów odniesienia z obecnej, działającej konfiguracji. Dzięki temu po migracji będziesz mieć praktyczne dane do porównania.

• Zanotuj bieżący adres URL dostawcy oraz informację, czy używane jest źródło dodatkowe.
• Zapisz bieżącą liczbę produktów lub inną dostępną liczbę produktów w katalogu.
• Wybierz kilka reprezentatywnych produktów i zanotuj ich numery EAN.
• Uwzględnij produkty o różnych statusach magazynowych, cenach, kategoriach i jakości treści.
• Zanotuj, które eksporty korzystają z dostawcy.
• Zapisz oczekiwaną cenę, stan magazynowy, tytuł i dostawcę dla wybranych przykładowych produktów.

Celem zapisania przykładowych numerów EAN nie jest przekształcenie starego numeru EAN w nowy. Te same znane numery EAN służą jako punkty odniesienia przed zmianą i po niej. Jeśli później nie będzie można ich znaleźć, należy sprawdzić dane źródłowe, ścieżkę produktu, mapowanie EAN lub inne warunki kwalifikacji produktu.

Bezpieczna zmiana źródła dostawcy

1. Wyłącz dostawcę. Zmniejsza to ryzyko synchronizacji częściowo skonfigurowanego źródła podczas zmiany ścieżek i mapowań.
2. Zastąp adres URL źródła lub konfigurację źródła. Sprawdź odpowiednie ustawienia uwierzytelniania lub żądań, ale nie publikuj ani nie udostępniaj prywatnych adresów URL dostawcy, danych uwierzytelniających ani nagłówków.
3. Sprawdź pełną ścieżkę produktu. Upewnij się, że B2BLIX odczytuje powtarzający się element reprezentujący jeden kompletny produkt.
4. Sprawdź każde mapowanie źródła głównego. Nie sprawdzaj tylko EAN, ceny i stanu magazynowego. Przejrzyj całą mapowaną zawartość oraz pola handlowe.
5. Sprawdź każde mapowanie źródła dodatkowego. Zrób to, gdy dostawca korzysta z oddzielnego źródła aktualizacji, stanów magazynowych, cen lub treści.
6. Sprawdź połączenie źródła głównego ze źródłem dodatkowym. Upewnij się, że wybrane identyfikatory nadal łączą prawidłowe rekordy oraz że oba źródła nadal mają odpowiednią część wspólną produktów.
7. Sprawdź podglądy mapowań. Upewnij się, że wyświetlane przykładowe wartości są rzeczywistymi wartościami produktów i pochodzą z oczekiwanych pól.
8. Włącz dostawcę dopiero po zakończeniu konfiguracji. Pozwól dostawcy zsynchronizować się zgodnie z ustawionym harmonogramem, a następnie rozpocznij opisane poniżej sprawdzanie produktów i eksportów.

Aby zmienić źródło i przejrzeć jego mapowania, otwórz Dostawcy. Wyjaśnienie konfiguracji dostawcy i procesu mapowania znajdziesz w artykule Dodawanie i konfigurowanie pliku danych dostawcy.

Mapowania, które należy sprawdzić

Migracja struktury dostawcy powinna obejmować pełny przegląd mapowań. Pole, które nadal wyświetla wartość, niekoniecznie jest zmapowane do prawidłowej nowej lokalizacji.

Źródło główne

Sprawdź wszystkie pola używane z głównego źródła dostawcy, w tym odpowiednie identyfikatory, ceny, stany magazynowe, treści produktów, obrazy, kategorie, producentów, wymiary i inne mapowane atrybuty.

Źródło dodatkowe

Jeśli skonfigurowano źródło dodatkowe, sprawdź osobno jego ścieżkę produktu i mapowania. Dostawca może zmienić główny katalog, pozostawiając plik aktualizacyjny bez zmian, albo zmienić oba źródła jednocześnie.

Połączenie źródeł

Jeśli źródło główne i dodatkowe są połączone, sprawdź identyfikatory używane do dopasowywania ich rekordów. Prawidłowe mapowanie źródła głównego i prawidłowe mapowanie źródła dodatkowego nie pomogą, jeśli połączenie między nimi nie wskazuje już tych samych produktów.

Interpretacja danych finansowych i treści

Zmiana struktury nie oznacza automatycznie konieczności zmiany finansowych ustawień dostawcy. Przed pozostawieniem tych ustawień bez zmian upewnij się jednak, że nowe źródło nadal korzysta z tej samej waluty, zasad naliczania VAT, języka treści, jednostek masy i sposobu oznaczania stanów magazynowych.

Znajdowanie eksportów zależnych od dostawcy

Projekcja eksportu może korzystać tylko z wybranych dostawców z pełnego katalogu B2BLIX. Dostawca jest bezpośrednio powiązany z eksportem, gdy został wybrany w ustawieniach dostawców tego eksportu.

Otwórz każdy eksport, który może korzystać z dostawcy, i sprawdź pola wyboru dostawców. Nie musisz testować niezależnych eksportów, w których ten dostawca nie został wybrany.

Aby sprawdzić to na swoim koncie, otwórz Eksporty. Informacje o ustawieniach eksportu znajdziesz w artykule Tworzenie i konfigurowanie projekcji eksportu XML.

Ważne: Wyłączenie dostawcy nie powinno być traktowane jako dowód, że wszystkie wcześniej zapisane produkty natychmiast zniknęły z każdego eksportu. Wcześniej zebrane dane katalogowe mogą pozostać dostępne zgodnie z ustawieniami aktualności i przechowywania danych na koncie. Zawsze sprawdzaj rzeczywisty wynik eksportu.

Porównanie produktów przed zmianą i po niej

Po zsynchronizowaniu dostawcy z nowego źródła wyszukaj numery EAN zapisane przed migracją. Porównuj zmapowane dane, a nie tylko sprawdzaj, czy produkt istnieje.

Aby sprawdzić nowo zaimportowane dane katalogowe, otwórz Wszystkie produkty. Szczegółowe informacje o dostępnych danych produktów znajdziesz w artykule Interfejs wszystkich produktów.

Testowanie zależnych eksportów

Znalezienie produktu w zapisanym katalogu to dopiero pierwsza kontrola. Eksport może nadal wykluczać produkt, wybierać innego dostawcę, stosować transformację lub generować inną wartość końcową.

Dla każdego eksportu korzystającego ze zmienionego dostawcy sprawdź kilka przykładowych numerów EAN w narzędziu Export Checker. Przejrzyj oryginalne dane dostawcy, wybranego dostawcę, zmapowane atrybuty, wynik przetwarzania oraz końcowy wynik XML.

Aby zweryfikować to na swoim koncie, otwórz Export Checker. Informacje o raporcie na poziomie produktu znajdziesz w artykule Sprawdzanie danych produktów i wyników eksportu za pomocą Export Checker.

Typowe problemy po zmianie źródła

• Nie zaimportowano żadnych produktów: Pełna ścieżka produktu może wskazywać nieprawidłową sekcję nowego pliku.
• Brakuje wielu produktów: Mapowanie EAN może być puste, wskazywać nieprawidłowe pole albo otrzymywać wartości, które nie są akceptowane jako użyteczne numery EAN.
• Ceny są puste lub nieprawidłowe: Lokalizacja pola ceny albo interpretacja waluty i VAT dostawcy może nie odpowiadać już nowemu źródłu.
• Stan magazynowy zmienia się na zero lub produkt staje się niedostępny: Pole stanu magazynowego albo znaczenie jego wartości mogło się zmienić.
• Brakuje treści: Mapowania tytułu, opisu, obrazu, kategorii, producenta lub języka mogą nadal wskazywać stare lokalizacje.
• Informacje ze źródła głównego i dodatkowego nie łączą się: Mapowanie połączenia może nie identyfikować już tego samego produktu w obu plikach.
• Produkty istnieją w sekcji Wszystkie produkty, ale nie ma ich w eksporcie: Eksport może nie obejmować tego dostawcy albo na produkt mogą wpływać filtry i reguły przetwarzania danego eksportu.
• Eksport nadal zawiera starsze wartości: Synchronizacja dostawcy i generowanie eksportu korzystają z niezależnych harmonogramów. Upewnij się, że obie operacje miały możliwość wykonania się z nowymi danymi.

Przykład

Dostawca wcześniej przechowywał każdy produkt w sekcji offer i udostępniał tam jego EAN, cenę oraz stan magazynowy. Nowe źródło przechowuje produkty w innej sekcji i używa innej lokalizacji pola EAN.

Jeśli zastąpisz tylko adres URL, stare mapowanie nadal będzie szukać danych w poprzedniej ścieżce produktu. Produkty mogą wtedy nie mieć zmapowanego numeru EAN i mogą nie przejść standardowego procesu katalogowania.

Bezpieczne podejście polega na wyłączeniu dostawcy, wybraniu nowej pełnej ścieżki produktu, ponownym zmapowaniu w razie potrzeby każdego pola, zweryfikowaniu połączenia źródła głównego ze źródłem dodatkowym, a następnie włączeniu dostawcy. Po synchronizacji wyszukaj kilka wcześniej zapisanych numerów EAN i potwierdź ich wartości końcowe w każdym zależnym eksporcie marketplace'u lub witryny internetowej.

Co zrobić dalej

1. Pozostaw dostawcę wyłączonego, dopóki nowe źródło nie będzie dostępne i nie zostanie potwierdzona pełna ścieżka produktu.
2. Sprawdź wszystkie mapowania źródła głównego, dodatkowego oraz połączenia.
3. Potwierdź, czy zmieniły się zasady finansowe i dotyczące treści stosowane przez źródło.
4. Ustal zależne eksporty na podstawie ich ustawień wyboru dostawców.
5. Włącz dostawcę i po synchronizacji sprawdź reprezentatywne produkty.
6. Sprawdź te same numery EAN w Export Checker dla każdego eksportu, którego dotyczy zmiana.
7. Porównaj dostępność produktów, ceny, stany magazynowe, treści, liczby produktów i końcowy XML z punktami odniesienia zapisanymi przed migracją.
8. Kontynuuj monitorowanie eksportów, których dotyczy zmiana, po kolejnym zaplanowanym uruchomieniu synchronizacji dostawcy i eksportów.

Jeśli przykładowe produkty i liczby produktów znacznie się różnią, ponownie wyłącz dostawcę i sprawdź ścieżkę źródła oraz mapowania, zanim zezwolisz na dalsze przekazywanie zmienionych danych do eksportów produkcyjnych.