↑↓ wybierzEnter otwórzEsc zamknij

    1. Elbuz

    Jak zaimportować katalog z XML: standardowy feed bez mapowania kolumn

    28 min czytaniaZaktualizowano

    Elbuz czyta produktowy feed XML — z pliku lub z linku — i sam rozkłada każdą ofertę na pola karty produktu: nazwę, cenę, dostępność, zdjęcia, atrybuty i kategorię. Mapowanie kolumn nie jest potrzebne.

    Kiedy to się przyda:

    • Katalog jest w postaci feedu XML (Prom, Rozetka, Hotline, CMS) — produkty trafiają do katalogu razem z kategoriami.
    • Feed jest dostępny pod linkiem — szablon według harmonogramu aktualizuje ceny i stany.
    • Ceny w feedzie są w innej walucie — program przelicza je na walutę bazową po kursie z feedu.
    • Kolory i rozmiary to osobne oferty — oferty z tym samym group_id składają się w jeden produkt z wariantami.

    Od czego zacząć: szablon typu „XML” z linkiem do feedu w oknie „Import”.

    Co potrafi import XML

    Jaki feed Elbuz odczyta bez mapowania

    Standardowy feed XML to plik o z góry znanej strukturze. W korzeniu jest yml_catalog, w nim — sklep z trzema blokami: waluty (currencies), kategorie (categories) i oferty (offers). Każda oferta offer to jeden produkt. Nazwy elementów są standardowe, więc Elbuz sam wie, gdzie jest cena, gdzie zdjęcie, a gdzie kategoria.

    Pliku XML z dowolnymi nazwami węzłów ten szablon nie odczyta — taki plik importuje się importem uniwersalnym, w którym dopasowanie pól ustawiasz samodzielnie.

    Feed XML to format feedu produktowego, który przyjmują Rozetka, Prom i inne platformy. Opis formatu dla konkretnego marketplace’u znajdziesz w jego pomocy, np. w Prom: Імпорт через XML — формат файлу (Import przez XML — format pliku). Elbuz czyta standardowe elementy XML niezależnie od źródła.

    Okno „Import” z listą szablonów przefiltrowaną do szablonu XML
    1Wiersz szablonu XML
    1. Szablon importu XML (typ XML) na liście szablonów.

    Jak Elbuz rozpoznaje produkt z feedu

    Kluczem dopasowania jest atrybut id oferty (offer id="…"). Elbuz zapisuje go w polu produktu „ID produktu (ciąg UUID)” i przy każdym przebiegu szuka karty właśnie po nim. Stałe id — ponowny import aktualizuje istniejącą kartę. Id, które zmienia się z eksportu na eksport, za każdym razem daje duplikaty. Więcej: ponowny import bez duplikatów.

    Atrybut group_id łączy warianty jednego produktu: oferty z tym samym group_id składają się w jeden produkt z wariantami, pierwsza w grupie staje się główną.

    Id jest brane tak, jak zapisano je w pliku. Dwa feedy z prostą numeracją (1, 2, 3…) dają te same klucze i drugi szablon nadpisze karty pierwszego. Rozdziela je pole wyboru „Sprawdzaj unikalność rekordów z uwzględnieniem tego źródła importu”. Więcej: dwa szablony dla tego samego produktu.

    Duplikaty z niestałego id widać w tabeli produktów: nazwa ta sama, „ID produktu (ciąg UUID)” inne, „Data dodania” — dzień przebiegu. Najpierw napraw źródło, potem usuń nadmiar. Więcej: jeśli zaimportowano nie to.

    Gdzie trafiają wartości oferty

    Element XMLPole karty w Elbuz
    atrybut idUUID (klucz dopasowania)
    name (lub vendor + model dla type="vendor.model")nazwa produktu
    price (+ priceuah/pricerub/priceusd/pricekzt) oraz currencyIdcena (przeliczana na Twoją walutę bazową po kursie)
    oldpricestara cena
    atrybut available (true/false), presence, stockstatus dostępności
    quantitystan
    vendorCode (lub code)kod produktu ()
    vendor (lub publisher)producent
    categoryId / category / blok categorieskategoria produktu
    picture / image (kilka)zdjęcia (pierwsze — główne)
    descriptionopis
    barcode / ISBNkod kreskowy () / ISBN
    param name="…"atrybuty; param name="sku" → kod
    url, keywordslink do produktu, słowa kluczowe (tagi)
    manufacturer_warrantygwarancja

    Dla oferty typu vendor.model nazwa składa się z marki i modelu, czasem z prefiksem typu (typePrefix). Element param staje się atrybutem produktu: name — nazwa atrybutu, zawartość — wartość. Jeśli elementu nie ma w feedzie, pole nowej karty pozostaje puste.

    Co nadpisze ponowny przebieg

    • Puste pole w feedzie nie kasuje Twojego: kod produktu, model, kod kreskowy, ISBN, gwarancja, tagi, link do produktu, producent i kategoria są aktualizowane tylko wtedy, gdy feed coś dla nich zawiera.
    • Cena, stara cena, ilość, nazwa i opis są zapisywane tak, jak są: brak quantity — w karcie będzie zero, brak name — nazwa zostanie pusta.
    • Zdjęcia są dopisywane: do istniejącej karty dochodzą zdjęcia, których jeszcze w niej nie było.

    Karty z flagą „Nie aktualizuj” przebieg nie zmienia wcale, łącznie z nazwą i opisem; z flagą „Stała cena” — aktualizuje wszystko poza ceną i starą ceną. Po zapisie przebieg wykonuje jeszcze formuły pól oznaczone dla importu — ich wynik zostaje w karcie. Więcej: jak zablokować własną wartość, co się dzieje po przebiegu.

    Droga jednej oferty podczas przebiegu. Gałąź „nie” od pierwszego rombu to nowa pozycja: bez kategorii nie stanie się kartą. Gałąź „tak” to istniejąca karta i tu wszystko rozstrzygają dwie flagi na samej karcie.
    nietaknietaktaknietaknieOferta z plikuJest karta z takim idwśród tych, które widzi szablon?categoryId pasujedo kategorii katalogu?Powstaje nowa kartaKarta nie powstajeNa karcie jest flaga„Nie aktualizuj”?Pola, cena, nazwa i opiszostają bez zmianAktualizowane są pola, nazwa i opisNa karcie jest flaga„Stała cena”?Cena zostaje TwojaCena i stara cena — z feedu
    • Початок або кінець
    • Дія або результат
    • Розвилка: далі шлях залежить від відповіді

    Jak odczytywane są dostępność i cena

    Status dostępności jest brany z pierwszego elementu, który znajdzie się w ofercie:

    W feedzieStatus w karcie
    tekst w presence lub stock («в наявності», «під замовлення»)według Twoich reguł określania statusu
    atrybut available="true"„Dostępny”
    atrybut available="false"„Brak w magazynie”
    nicpierwszy status ze słownika z klasyfikacją „Jest” i jego „Ilość domyślna”

    Feed bez informacji o dostępności sprawi, że produkty będą widoczne jako dostępne w magazynie. Jeśli nie o to chodzi, sprawdź statusy i ilość w słowniku przed pierwszym przebiegiem.

    Skąd bierze się status dostępności. Tekst w presence ma pierwszeństwo przed atrybutem available. Reguły określania statusu i status domyślny ustawiają też ilość — ze słownika, a nie z feedu.
    taknietruefalseinny teksttaknieOferta z plikuWypełnionyelement presence?Brany jest tekst presenceBrany jest atrybut available,a gdy jest pusty — element stockWartość true lub false?Status „Dostępny”Status „Brak w magazynie”Tekst pasuje do regułokreślania statusu?Status z regułyi jego ilośćPierwszy status z dostępnością„Jest”i jego ilość domyślna
    • Початок або кінець
    • Дія або результат
    • Розвилка: далі шлях залежить від відповіді

    Waluta i cena

    Cena jest brana z pierwszego wypełnionego elementu: price, priceuah, pricerub, priceusd, pricekzt. Walutę określa currencyId, kurs — blok currencies samego feedu:

    • Waluta produktu jest w currencies — cena jest przeliczana na walutę bazową po kursie z feedu.
    • Kurs waluty produktu w feedzie wynosi 1, nie jest to Twoja waluta bazowa, a kursu waluty bazowej w feedzie nie ma — kurs jest brany z Twojego słownika walut.
    • Waluty produktu nie ma w currencies — cena jest importowana bez przeliczenia, tak jak jest.

    Jak z feedu powstają kategorie

    Drzewo kategorii Elbuz buduje z bloku categories: każdy category z atrybutami id i parentId określa kategorię i jej kategorię nadrzędną. Produkt jest przypisywany do kategorii według swojego categoryId.

    Bez kategorii nowa karta nie powstaje. Nowa oferta trafia do katalogu tylko wtedy, gdy jej categoryId pasuje do kategorii — utworzonej z bloku categories tego pliku albo założonej wcześniej. Brak bloku i takich kategorii — nie powstanie żaden nowy produkt, choć dziennik pokaże pełne „Łącznie zaimportowano produktów”: to odczytane oferty, a nie utworzone karty.

    Istniejące karty taki feed zaktualizuje normalnie, a one zachowają swoją kategorię.

    Kategorie z feedu przebieg przywraca do stanu z pliku. Zmienisz nazwę kategorii w Elbuz — następny import przywróci nazwę z feedu. Przeniesiesz produkt do innej kategorii — przebieg też to cofnie, jeśli feed wskazuje kategorię dla produktu. Własną strukturę buduj dla produktów, których feed nie obejmuje, albo zmieniaj ją w samym źródle.

    Usunięcie kategorii usuwa produkty, dla których jest ona główna — z opisami, zdjęciami i atrybutami. Następny przebieg założy je od nowa jako inne karty. Więcej: kategorie techniczne i usuwanie kategorii z produktami.

    Jak aktualizować katalog z linku

    Gdy szablon z linkiem jest sprawdzony, ustaw go w harmonogramie przyciskiem „Ustawienia harmonogramu” w karcie szablonu. Elbuz sam będzie pobierał świeży feed i aktualizował ceny, dostępność i stany. Częstotliwość dobierz do źródła: feed, który zmienia się raz na dobę, nie potrzebuje importu co godzinę.

    Według harmonogramu działa tylko link. Harmonogram bierze adres zapisany w szablonie; plik z komputera to jednorazowa ręczna operacja. Szablon, w którym wypełniono tylko pole pliku, według harmonogramu nic nie zrobi.

    Co sprawdza harmonogram, zanim uruchomi szablon. Jeśli choć jeden z trzech warunków nie jest spełniony, tym razem katalog się nie zmieni.
    taknienietaknietakNadeszła pora z harmonogramuTrwa już innyimport według harmonogramu?W dzienniku „Anulowano importwedług harmonogramu”Szablon „Aktywny”?Szablon pominiętyW szablonie wypełnione pole„Link do pliku z produktami”?Nic nie jest importowanePlik jest pobierany z linkuPrzebieg idzie tak samojak po przycisku „Importuj”
    • Початок або кінець
    • Дія або результат
    • Розвилка: далі шлях залежить від відповіді
    Nagłówek szablonu z ikoną historii uruchomień, plakietką stanu i przyciskiem „Importuj”
    1Plakietka stanu
    2Historia uruchomień
    3Przycisk „Importuj”
    1. Pokazuje, czy szablon jest aktywny; plakietka widoczna w obecnym stanie.
    2. Otwiera historię uruchomień.
    3. Uruchamia import (nie kliknięty).

    Pauza, czas trwania i przerwanie przebiegu

    • Pauza. Plakietka „Wyłączony” w nagłówku szablonu zatrzymuje harmonogram, produkty i ustawienia zostają. Więcej: wyłączyć szablon czy usunąć.
    • Czas trwania. Limitu liczby ofert nie ma, plik jest czytany strumieniowo. Czas ostatniego przebiegu widać w kolumnie „Ostatni import”, historię pokazuje „Historia uruchomień”. Więcej: limity przebiegu, jak sprawdzić import.
    • Licznik w dzienniku aktualizuje się co tysiąc ofert, więc przy małym feedzie wiersza „Pobrano z pliku produktów” może nie być — podsumowanie pokaże „Łącznie zaimportowano produktów”.
    • Przerwanie. To, co zapisano przed zatrzymaniem, zostaje; ponowne uruchomienie jest bezpieczne, jeśli id w feedzie się nie zmieniają. Nie uruchamiaj dwóch importów jednocześnie. Więcej: jeśli przebieg został przerwany.

    Co się dzieje z produktem, którego nie ma już w feedzie

    Domyślnie — nic: oferta, która zniknęła, zostaje w katalogu z tą samą ceną, dostępnością i stanem. Tryb lustra włącza pole wyboru „Usuwaj z katalogu bazowego rekordy, których nie ma w przesłanym pliku” — usuwa ono karty bezpowrotnie, a gdy plik zawiera blok categories, także kategorie, których w nim nie ma.

    Bez pola wyboru „Sprawdzaj unikalność rekordów z uwzględnieniem tego źródła importu” usuwanie obejmuje cały katalog, a nie tylko produkty tego szablonu. Jeśli z pliku nie odczytano ani jednego produktu, usuwanie się nie wykonuje. Więcej: produkt zniknął ze źródła.

    Pola wyboru bloku „Co importować” i przycisk „Ustawienia harmonogramu”
    1Usuwanie rekordów, których nie ma w pliku
    2Unikalność według źródła
    3Ustawienia harmonogramu
    1. Usuwa z katalogu rekordy, których brakuje w importowanym pliku.
    2. Sprawdza unikalność rekordów z uwzględnieniem tego źródła importu.
    3. Otwiera ustawienia harmonogramu tego szablonu.
    Trzy sprawdzenia przed usunięciem. Dolne rozgałęzienie decyduje, w jakiej części katalogu przejdzie usuwanie: bez flagi sprawdzania unikalności — w całym.
    nietaknietaknietakKrok usuwaniaWłączone „Usuwaj z katalogubazowego rekordy, których nie maw przesłanym pliku”?Nic nie jest usuwaneZ pliku odczytanochoć jeden produkt?Karty nie są usuwaneWłączone „Sprawdzaj unikalnośćrekordów z uwzględnieniemtego źródła importu”?Sprawdzany jest cały katalogSprawdzane są karty tego szablonu,dodane ręcznie, z cennika iparseremUsuwane są karty, których nie ma wpliku,z opisem, zdjęciami i atrybutami
    • Початок або кінець
    • Дія або результат
    • Розвилка: далі шлях залежить від відповіді

    Scenariusze

    Dostawca udostępnia feed pod linkiem, ceny i stany mają aktualizować się same

    Co włączyć. W szablonie — „Link zewnętrzny” i adres feedu w polu „Link do pliku z produktami (Katalog)”. Następnie „Ustawienia harmonogramu” w bloku „Powiązane ustawienia”; plakietka w nagłówku szablonu — „Aktywny”.

    Efekt. O wyznaczonej porze harmonogram pobiera plik i wykonuje ten sam przebieg co przycisk „Importuj”. Produkty, których w świeżym feedzie już nie ma, zostaną z poprzednią ceną i stanem. Jeśli w tym momencie trwa inny import według harmonogramu, uruchomienie zostanie anulowane z wpisem o konflikcie przetwarzania danych.

    Katalog ma dokładnie odzwierciedlać feed

    Co włączyć. W bloku „Co importować” — „Usuwaj z katalogu bazowego rekordy, których nie ma w przesłanym pliku”, a razem z nim „Sprawdzaj unikalność rekordów z uwzględnieniem tego źródła importu”.

    Efekt. Przy każdym przebiegu karty, których nie ma w pliku, są usuwane z opisem, zdjęciami i atrybutami. Drugie pole wyboru chroni produkty innych szablonów importu; produkty dodane ręcznie, z cennika lub parserem są objęte usuwaniem. Usuniętych danych nie da się odzyskać. Pole wyboru usuwania jest nieaktywne — Twoja grupa nie ma do niego uprawnień.

    Dwóch dostawców numeruje produkty tak samo

    Co włączyć. „Sprawdzaj unikalność rekordów z uwzględnieniem tego źródła importu” w szablonach obu feedów.

    Efekt. Każdy szablon szuka zgodności id wśród swoich kart oraz dodanych ręcznie, z cennika lub parserem. Oferta z tym samym id z drugiego feedu powstanie jako osobna karta, jeśli jej categoryId znalazł kategorię. Karty, które zlały się przed włączeniem pola wyboru, nie rozdzielą się: zostają przy szablonie, który je utworzył.

    Cenę ustawiasz sam, a stan i dostępność pochodzą z feedu

    Co włączyć. W karcie produktu — flagę „Stała cena”.

    Efekt. Przebieg aktualizuje stan, status dostępności, kod produktu i inne pola, a ceny i starej ceny nie zmienia. Nazwę i opis feed nadpisze. Aby chronić przed feedem całą kartę, ustaw „Nie aktualizuj”.

    Co zrobić, gdy feed zaimportował się nie tak

    Najczęstsze problemy
    Co widziszDlaczego tak jestCo zrobić
    „Nie udało się przesłać pliku na serwer. Możliwe, że jest za duży lub połączenie zostało przerwane” Plik z komputera nie dotarł na serwer: limit rozmiaru serwera albo przerwane połączenie Zaimportuj feed z linku — tam tego limitu nie ma (aktualizacja z linku)
    „Łącznie zaimportowano produktów: 0” Pod linkiem przyszedł nie feed — strona błędu lub formularz logowania — albo plik nie jest w formacie XML Otwórz link w przeglądarce i upewnij się, że zwraca XML. Katalog nie ucierpiał (zniknął z feedu)
    W pliku są setki ofert, a nowych kart nie przybyło Dla nowych pozycji nie znalazła się kategoria: brak bloku categories albo categoryId się nie zgadza Sprawdź blok kategorii w feedzie (kategorie)
    Znaki w nazwach są „połamane” Plik nie jest w kodowaniu Poproś źródło o feed w UTF-8
    Cena zaimportowała się w obcej walucie, bez przeliczenia Waluty produktu nie ma w bloku currencies feedu Dodaj walutę z kursem do feedu (waluta i cena)
    XML się zaimportował, ale ceny, zdjęcia lub nazwy są puste Nazwy węzłów w pliku nie są standardowe dla XML Importuj plik importem uniwersalnym z własnym mapowaniem
    „Anulowano import według harmonogramu, przyczyna - trwa import innego szablonu (konflikt przetwarzania danych)” W tym momencie trwał już inny import Rozsuń harmonogramy szablonów w czasie (przerwanie przebiegu)
    „Operacja przerwana przez użytkownika!” Użyto przycisku zatrzymania — przez Ciebie lub innego pracownika Uruchom import ponownie: powtórzenie jest bezpieczne (przerwanie przebiegu)

    Najczęstsze pytania

    Czym feed XML różni się od dowolnego pliku XML?

    Feed XML to format feedu produktowego o stałej strukturze, który przyjmują Rozetka, Prom i inne platformy. Plik o takiej strukturze (yml_catalog, offers, categories) importuje się szablonem „XML” bez mapowania. Dowolny XML importuje się importem uniwersalnym.

    Dostawca przysłał XML — importować go do katalogu czy do cennika?

    Jeśli plik opisuje Twój asortyment — importuj go szablonem „XML” do katalogu. Jeśli opisuje asortyment dostawcy, którego ceny trzeba porównywać i obejmować narzutem — załóż cennik (mapowanie kolumn cennika).

    Dlaczego produkty nie mają opisu ani atrybutów?

    Elbuz bierze tylko to, co jest w feedzie. Jeśli oferta nie ma description ani param, pola zostaną puste. Karty można uzupełnić parserem z zewnętrznych stron.

    Jak zatrzymać automatyczną aktualizację, niczego nie usuwając?

    Przełącz plakietkę w nagłówku szablonu na „Wyłączony”. Harmonogram pomija szablon, produkty, harmonogram i ustawienia zostają, a przycisk „Importuj” nadal działa (pauza).

    Po każdym imporcie pojawiają się kopie produktów. Dlaczego?

    Źródło nadaje ofertom nowe id przy każdym eksporcie. Poproś źródło o stałe id, a kopie usuń (duplikaty).

    Czy można udostępnić swój katalog w formacie XML?

    Tak, służy do tego osobny szablon eksportu — eksport w formacie XML.

    Gdzie to jest i kto ma dostęp

    Menu
    Słowniki → Operacje → Import danych → szablon typu „XML”
    Uprawnienia
    okno „Import” w „Uprawnieniach grup”
    Przygotuj
    plik .xml / .yml lub bezpośredni link do feedu

    Źródło w szablonie — „Plik lokalny” lub „Link zewnętrzny”. Według harmonogramu działa tylko link.

    Formularz szablonu importu XML z przełącznikiem źródła danych i polem pliku
    1Przełącznik „Plik lokalny” / „Link zewnętrzny”
    2Pole pliku lub linku
    1. Przełącz źródło danych między plikiem lokalnym a linkiem zewnętrznym.
    2. Wybierz tu plik albo wpisz adres, gdy wybrany jest link zewnętrzny.

    Powiązane tematy

    Czy ten artykuł był pomocny?

    Brakuje funkcji? Napisz do nas.

    Dodamy ją za darmo, jeśli przyda się też innym.

    Jeśli potrzebujesz jej tylko ty — umówimy się osobno.

    Spis treści

    Zaproponuj usprawnienie

    Wypróbuj Elbuz za darmo