Jak zmienić adres URL dostawcy lub strukturę feedu 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ć powiązane eksporty.

Kiedy ten przewodnik jest przydatny

Skorzystaj z tego przewodnika, gdy dostawca udostępnia nowy adres URL feedu, zmienia strukturę istniejącego feedu XML lub JSON, zastępuje jeden plik źródłowy innym albo zmienia sposób połączenia źródła głównego i dodatkowego.

Taką zmianę należy traktować jako kontrolowaną migrację. Nawet jeśli nowe źródło zawiera te same produkty, ich ścieżka, nazwy pól lub lokalizacja 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ź

Zaleca się 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 przed ponownym włączeniem dostawcy.

Należy także ustalić, które eksporty korzystają z tego dostawcy. Po pomyślnej synchronizacji dostawcy sprawdź kilka znanych produktów i zweryfikuj 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 i treść. 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 EAN jako głównego identyfikatora produktu. Produkty bez użytecznego EAN nie są przetwarzane w ramach standardowego procesu łączenia produktów. Uszkodzone mapowanie EAN może więc spowodować, że wiele produktów zniknie z oczekiwanego katalogu i wyników eksportu.

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

Przygotowanie przed zmianą dostawcy

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

• Zapisz obecny 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óżnym stanie magazynowym, cenach, kategoriach i jakości treści.
• Zapisz, które eksporty korzystają z tego 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 EAN-u w nowy. Te same znane numery EAN służą jako punkty kontrolne przed zmianą i po niej. Jeśli później nie można ich znaleźć, może być konieczne sprawdzenie danych źródłowych, ścieżki produktu, mapowania EAN lub innego warunku kwalifikacji.

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 logowania lub 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ź wszystkie mapowania źródła głównego. Nie sprawdzaj tylko EAN, ceny i stanu magazynowego. Przejrzyj całą zmapowaną treść oraz pola handlowe.
5. Sprawdź wszystkie mapowania źródła dodatkowego. Zrób to, gdy dostawca korzysta z osobnego ź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ą rozsądną część wspólną produktów.
7. Sprawdź podglądy mapowania. 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 ze skonfigurowanym 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. Aby poznać zasady konfiguracji dostawcy i procesu mapowania, przeczytaj Dodawanie i konfiguracja feedu 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 zmapowane 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 feed aktualizacyjny bez zmian, albo zmienić oba źródła jednocześnie.

Połączenie źródeł

Gdy źródło główne i dodatkowe są połączone, sprawdź identyfikatory używane do dopasowywania 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, że należy zmienić ustawienia finansowe dostawcy. Przed pozostawieniem tych ustawień bez zmian sprawdź jednak, czy nowe źródło nadal korzysta z tej samej waluty, sposobu naliczania VAT, języka treści, jednostek wagi i zasad określania stanów magazynowych.

Znajdowanie eksportów zależnych od dostawcy

Projekcja eksportu może korzystać tylko z wybranych dostawców z całego 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. Aby poznać ustawienia eksportu, przeczytaj Tworzenie i konfiguracja 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. Zebrane wcześniej 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ównaj zmapowane dane, a nie tylko sprawdź, 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 pierwszy krok. 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 i końcowy wynik XML.

Aby zweryfikować to na swoim koncie, otwórz Export Checker. Aby poznać raport na poziomie produktu, przeczytaj Przegląd 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ć niewłaściwą sekcję nowego pliku.
• Brakuje wielu produktów: Mapowanie EAN może być puste, wskazywać niewłaściwe 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 u dostawcy może już nie odpowiadać nowemu źródłu.
• Stan magazynowy wynosi zero lub produkt jest 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 już nie identyfikować 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 produkt może podlegać filtrom i zasadom przetwarzania tego 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 przechowywał wcześniej każdy produkt w sekcji offer i podawał 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 zmieniony zostanie tylko adres URL, stare mapowanie będzie nadal szukać danych w poprzedniej ścieżce produktu. Produkty mogą wtedy nie mieć zmapowanego EAN-u i mogą nie przejść standardowego procesu katalogowania.

Bezpieczne podejście polega na wyłączeniu dostawcy, wybraniu nowej pełnej ścieżki produktu, ponownym zmapowaniu wszystkich pól w razie potrzeby, 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 końcowe wartości w każdym zależnym eksporcie marketplace lub witryny internetowej.

Co zrobić dalej

1. Pozostaw dostawcę wyłączonego do czasu, aż nowe źródło będzie dostępne i zostanie potwierdzona pełna ścieżka produktu.
2. Sprawdź wszystkie mapowania źródła głównego, dodatkowego i połączenia źródeł.
3. Potwierdź, czy zmieniły się zasady finansowe i dotyczące treści stosowane w źródle.
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 zmienionego eksportu.
7. Porównaj dostępność produktów, ceny, stany magazynowe, treści, liczby produktów i końcowy XML z punktami kontrolnymi zapisanymi przed migracją.
8. Kontynuuj monitorowanie zmienionych eksportów po kolejnych zaplanowanych uruchomieniach dostawcy i eksportu.

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 zmienione dane będą dalej trafiać do eksportów produkcyjnych.