Elbuz czyta plik dostawcy według mapowania — par „kolumna pliku → pole systemu”: skąd wziąć nazwę, cenę i kod produktu. Program sam tworzy mapowanie przy pierwszym pliku, a każdy kolejny import cennika jest czytany według niego.
Kiedy to się przyda:
- Dodajesz nowego dostawcę — kolumny mapują się automatycznie, Tobie zostaje sprawdzenie wyniku.
- Import zatrzymał się z komunikatem „Nie wypełniono adresów kolumn” — przycisk w dzienniku prowadzi prosto do sekcji „Kolumny”.
- Nazwa lub stan są w kilku kolumnach — adres skleja je lub sumuje bez formuł.
- Dostawca przestawił kolumny — program zauważy przesunięcie i zaproponuje nowe adresy.
Od czego zacząć: karta źródła → sekcja „Kolumny” → „Kreator kolumn”.
Co potrafi mapowanie
- Samo mapuje nowy cennik — słownik nagłówków, przycisk „Powiąż automatycznie” i AI dla nieznanych kolumn.
- Kreator i sprawdzenie przed importem — pole wybierasz kliknięciem, podgląd pokazuje, jak odczytano plik, a przesunięcie kolumn poprawia jeden przycisk.
- Adres kolumny — skleić kolumny, wziąć pierwszą niepustą, wstawić stały tekst.
- Pola i ustawienia kolumny — 50 pól docelowych, własne pola, waluta, unikalność, atrybut.
- Excel, CSV, XML, JSON — co wpisać w adres dla każdego formatu.
Czym jest mapowanie: adres kolumny i pole systemu
Mapowanie składa się z par. Po lewej jest adres kolumny: litera kolumny w skoroszycie Excel, jej numer albo, w XML, nazwa tagu. Po prawej — pole systemu: miejsce, do którego program zapisze odczytaną wartość. W czystym systemie takich pól docelowych jest pięćdziesiąt, do tego Twoje własne pola — od „Nazwa” i „Cena” po „Kod kreskowy ISBN” i „Nutri-Score (wartość odżywcza)”.
Podpowiedź nad tabelą w karcie ujmuje to tak: „Powiąż kolumny pliku z polami systemu. „Nazwa” jest wymagana, „Cena” — zalecana. Kliknięcie wiersza — szczegółowe ustawienia kolumny.”
Wymagane jest tylko jedno pole — „Nazwa”. „Cena” jest zalecana: bez niej program ostrzeże, ale nie odmówi pracy. Pozostałe pola — według uznania: kolumna bez przypisanego pola po prostu się nie importuje. To nie błąd ani strata: w cenniku dostawcy często połowa kolumn nie jest Ci potrzebna.
Scenariusze
Nowy dostawca: od pliku do pierwszego importu
Wczytaj plik — automatyczne dopasowanie samo zmapuje kolumny. Otwórz „Kreator kolumn”, popraw pola, w których przykładowe wartości nie pasują do pola, i przejdź listę kontrolną przed pierwszym importem. Efekt: pierwszy import wczyta produkty z poprawnymi nazwami i cenami.
Import zatrzymał się z komunikatem „Nie wypełniono adresów kolumn”
W dzienniku błędu kliknij „Wypełnij adresy kolumn”, w kreatorze — „Powiąż automatycznie” i ustaw adres przynajmniej dla pola „Nazwa”. Efekt: obie kontrole mapowania przejdą, a import odczyta plik. Przyczyny obu wariantów błędu — w omówieniu poniżej.
Ceny w pliku są w dolarach
Walutę ustawia się kolumnie, a nie formułą: w „Kreatorze kolumn” otwórz ustawienia kolumny „Cena”, w grupie „Waluta” wybierz USD, a „Kurs waluty” zostaw na 0. Efekt: przy przeliczaniu cen cena zostanie pomnożona przez kurs ze słownika walut — pod warunkiem, że na liście rodzajów narzutów cennika jest „Cena + kurs walut”. Czego nie robić: dopisywać jeszcze formuły {Cennik: Cena} * {CURRENCY_RATE_USD} — kurs zostanie zastosowany dwa razy. Krok po kroku — cennik w dolarach.
Dostawca zmienił plik
Nowy plik nie resetuje mapowania: pola i adresy pozostają Twoje. Jeśli kolumny się przesunęły, dziennik pokaże „Kolumny cennika przesunęły się — sprawdź adresy kolumn”. Efekt po kliknięciu „Zastosuj nowe adresy”: adresy zmienią się na nowe numery — jak to wygląda.
Co zrobić, gdy import zatrzymał się przez mapowanie
| Co widzisz | Dlaczego tak jest | Co zrobić |
|---|---|---|
| „Nie wypełniono adresów kolumn, z których mają być importowane dane z cennika!” | W cenniku nie zmapowano żadnej kolumny: żadna nie ma wypełnionego adresu. To pierwsza z dwóch kontroli mapowania | Zmapuj przynajmniej „Nazwa” lub „Kod producenta”. W dzienniku błędu jest przycisk „Wypełnij adresy kolumn” — prowadzi prosto do sekcji „Kolumny” (kreator kolumn) |
| „Nie wypełniono adresów kolumn, z których mają być importowane dane z cennika, dla kolumn z zaznaczoną flagą „Uwzględniaj unikalność”!” | Kolumny są zmapowane, ale żadna z nich nie ma jednocześnie zaznaczonego pola „Uwzględniaj unikalność” i wypełnionego adresu. To druga kontrola — działa dopiero wtedy, gdy program upewnił się, że zmapowano choć jedną kolumnę | Zaznacz „Uwzględniaj unikalność” w kolumnie „Nazwa” lub „Kod producenta” i sprawdź, czy ma ona wypełniony adres (ustawienia kolumny) |
| „Import anulowany!” | Pojawia się w kolejnym wierszu po kontroli powyżej | Zmapuj kolumny i uruchom import ponownie |
| „Błąd wczytywania” | Nie udało się pobrać danych dla okna: zapytanie do serwera nie przeszło | Spróbuj ponownie; jeśli błąd się powtarza — sprawdź, czy masz dostęp do okna „Lista cenników” (kto ma dostęp) |
Najczęstsze pytania
Czy trzeba mapować wszystkie kolumny pliku?
Nie. Wymagane jest tylko jedno pole — „Nazwa”, „Cena” jest zalecana. Kolumna bez przypisanego pola po prostu się nie importuje, a w cenniku dostawcy zwykle jest ich połowa. Mapuj to, czego potrzebujesz.
Dostawca przysłał nowy plik — czy mapowanie przepadnie?
Nie. Pola i adresy pozostają Twoje, w Excelu aktualizują się tylko nazwy kolumn. Ale adres jest czytany dosłownie: gdy dostawca przestawi kolumny, dziennik zaproponuje „Zastosuj nowe adresy”. Więcej: przesunięcie kolumn.
Podczas importu pojawia się błąd „Nie wypełniono adresów kolumn, z których mają być importowane dane z cennika!”. Co zrobić?
Żadna kolumna nie ma przypisanego adresu. Przyciskiem „Wypełnij adresy kolumn” w dzienniku przejdź do sekcji „Kolumny” i ustaw adres przynajmniej dla pola „Nazwa”. Więcej: omówienie problemów.
Zmapowane kolumny — czy produkty są już w moim katalogu?
Nie. Mapowanie mówi tylko, skąd brać wartości: produkty dostawcy trafiają do cennika. Powiązanie z katalogiem to osobna praca: dopasowanie produktów i kategorii.
Czy można sprawdzić mapowanie na czacie z AI?
Tak, dla Excela, i : przycisk „✦ AI” w nagłówku źródła → „Skonfiguruj kolumny / gałąź XML”. Więcej: sprawdzenie mapowania.
Gdzie to jest i kto ma dostęp
Okno „Kreator mapowania kolumn” nie ma własnej pozycji w menu — otwiera się tylko z karty źródła, z sekcji „Kolumny”.
- Menu
- Słowniki → Przetwarzanie cenników → Lista cenników
- Z karty źródła
- sekcja „Kolumny” → przycisk „Kreator kolumn”; tam też jest tabela pól, w której adresy poprawisz bez kreatora
- Z kreatora dodawania źródła
- krok „Sprawdzenie” pokazuje tę samą tabelę dopasowania
- Z okna „Import z arkuszy”
- przycisk kreatora dla wybranego arkusza skoroszytu Excel
- Uprawnienia
- okno „Lista cenników” (w „Uprawnieniach grup” — „Cenniki”)
- Zmiana pól
- uprawnienie do zmiany cenników
- Przygotuj
- wczytany plik cennika; dla XML — nazwę tagu produktu
Sekcja „Kolumny” jest dostępna w karcie każdego źródła plikowego. Parsery stron jej nie mają: tam dane są zbierane ze stron, a nie z kolumn pliku.
1
Kreator kolumn2
Adres kolumny3
Podpowiedź sekcji- Kreator kolumn — otwiera asystenta, który krok po kroku dopasowuje kolumny cennika do pól produktu.
- Adres kolumny — litera lub numer kolumny pliku, z której pochodzi wartość pola.
- Przycisk podpowiedzi obok nagłówka sekcji — wyjaśnia, że „Nazwa” jest wymagana, a „Cena” zalecana.
Odbierz pracownikowi zakładkę ustawień importu, a sekcji „Kolumny” w ogóle nie zobaczy — razem z tabelą pól i przyciskiem kreatora. Produkty cennika pozostaną przy tym dostępne. Tak można pokazać menedżerowi wczytane dane, nie wpuszczając go do ustawień źródła.
Sekcję „Kolumny” można też zamknąć osobno, bez odbierania całej zakładki: ma własny blok uprawnień — w „Uprawnieniach grup” jest podpisany „Zakładka "Ustawienia": sekcja "Kolumny"”. Odznaczenie pola usuwa zarówno kafelek sekcji w spisie treści karty, jak i samą sekcję; pozostałe ustawienia importu zostają na miejscu.
Krok „Sprawdzenie” w kreatorze dodawania źródła pokazuje tę samą tabelę dopasowania. Więcej: Co sprawdzić na kroku „Sprawdzenie”.
Powiązane tematy
- Jeśli dostawca nie jest jeszcze dodany — Jak dodać źródło dostawcy.
- Jeśli mapowanie jest gotowe i czas wczytać produkty — Jak uruchomić import cennika i przenieść ceny do katalogu.
- Jeśli skoroszyt Excel ma kilka arkuszy — Excel z wieloma arkuszami.
- Jeśli zastanawiasz się, czy powierzyć cenniki programowi — co to daje Twojemu sklepowi.
