↑↓ wybierzEnter otwórzEsc zamknij

    1. Elbuz

    Gdzie trafia plik eksportu: link, FTP i e-mail

    5 min czytaniaZaktualizowano

    Elbuz umieszcza gotowy plik pod stałym linkiem, który raz podajesz marketplace’owi, a zależnie od ustawień wysyła go też na FTP lub e-mailem do klienta; stary plik jest podmieniany dopiero po udanym zapisie nowego.

    Kiedy to się przyda:

    • Marketplace sam pobiera feed — link w kolumnie „Plik” nie zmienia się między przebiegami.
    • Klient potrzebuje pliku na swoim serwerze — po przebiegu plik trafia na FTP lub SFTP.
    • FTP nie przyjmuje pliku — kod odpowiedzi serwera w dzienniku wskaże przyczynę.
    • Klient hurtowy czeka na cennik e-mailem — plik cennika idzie jako załącznik według szablonu newslettera.

    Od czego zacząć: kolumna „Plik” na liście szablonów → „Kopiuj link”.

    Co potrafi dostarczanie pliku

    • Stały link — adres, który podajesz marketplace’owi; każdy przebieg umieszcza pod nim nowy plik.
    • FTP i e-mail — dostarczenie pliku na serwer lub jako załącznik wiadomości.
    • Nazwa pliku i kody FTP — dlaczego plik nie dotarł na serwer.
    • Podmiana pliku — co leży pod linkiem w trakcie przebiegu i po awarii.
    • Poprawienie błędu — jak podmienić błędny plik, który marketplace już pobrał.

    Gdzie trafia plik

    Gotowy plik jest najpierw zapisywany w folderze Twojego konta, a potem trafia tam, gdzie go skierujesz.

    • Link. Adres gotowego pliku jest widoczny w kolumnie „Plik” na liście, obok jest przycisk „Kopiuj link” (po kliknięciu pojawia się komunikat „Link skopiowany”). To właśnie ten adres podajesz marketplace’owi.
    • FTP. Działa, jeśli w „Ustawieniach FTP” wypełniono adres serwera i nazwę użytkownika. Tam też są port, hasło, przełącznik „SFTP (SSH File Transfer Protocol)”, „Ścieżka docelowa eksportu”, „Liczba wątków” i przycisk „Sprawdź połączenie”. Kliknij go przed pierwszym przebiegiem: w odpowiedzi zobaczysz „Połączenie nawiązane!” albo „Błąd: ‹odpowiedź serwera›”. Jeśli nie wypełniono wszystkich pól: serwera, portu, użytkownika i hasła, przycisk odpowie „Wypełnij pola!”.
    • E-mail. Załącznik do wiadomości działa tylko w typie „Cennik (XLSX, CSV)” i tylko wtedy, gdy wypełniono „Szablon newslettera”. Załącznik można spakować do ZIP.
    • Połączenie bezpośrednie. Typy z grupy w ogóle nie mają pliku — dane trafiają do serwisu marketplace’u zapytaniami.

    Nazwę pliku ustawiasz w karcie szablonu i działają w niej trzy makra: {DATE} — dzisiejsza data, {DATETIME} — data z godziną, {TIME} — godzina. Przydaje się to, gdy marketplace lub klient chce osobnego pliku na każdy dzień. Ukośnik w nazwie zamieniany jest na kropkę, a rozszerzenie .php i jego odmiany program wymusza na .xml.

    Po przebiegu program zapisuje rozmiar pliku i czas trwania — obie liczby widać na liście i w oknie podsumowania przy następnym uruchomieniu. Plik mniejszy niż 4 KB liczony jest jako 4 KB: na dysku i tak zajmuje blok.

    Nazwa pliku i FTP: skąd biorą się błędy eksportu

    Na FTP plik trafia pod tą samą nazwą co pod linkiem, do folderu z pola „Ścieżka docelowa eksportu”. Gdy eksport na FTP nie przechodzi, sprawdź w karcie szablonu pole „Nazwa pliku” i ustawienia FTP według tej listy:

    • Litery łacińskie bez spacji. Program wstawia nazwę pliku do adresu FTP tak, jak jest, bez kodowania. Pisz ją literami łacińskimi, cyframi, kropką, myślnikiem i podkreśleniem: feed_rozetka.xml, a nie „cennik rozetka.xml”.
    • Pusta nazwa to nie błąd. Wtedy używana jest standardowa nazwa typu eksportu, np. export_elbuz.xml dla .
    • Podfolderu nie da się podać w nazwie. Ukośnik zamienia się na kropkę; folder podaje się tylko w „Ścieżce docelowej eksportu”, a ta zaczyna się od ukośnika: /public_html/feeds.
    • Plik o takiej nazwie już istnieje — zostanie nadpisany, wersje nie są przechowywane. Potrzebny osobny plik na dzień — dodaj do nazwy {DATE}.

    Gdy plik nie dotarł na FTP, w dzienniku przebiegu zostaje kod odpowiedzi serwera — zwykle od razu widać po nim przyczynę, bez zgadywania:

    KodCo oznaczaGdzie szukać
    226przesyłanie zakończone pomyślniewszystko w porządku, plik jest na serwerze
    530serwer nie wpuścił: login lub hasło nie pasujądane w „Ustawieniach FTP”; na niektórych hostingach nazwę użytkownika pisze się razem z domeną
    550brak dostępu do folderu lub folder nie istniejepole „Ścieżka docelowa eksportu”: folder wymaga prawa zapisu; dla FTP program sam próbuje utworzyć brakujące foldery, dla SFTP folder musi istnieć
    552przekroczono limit miejsca na dyskumiejsce na hostingu
    425, 426kanał przesyłania się nie otworzył lub został zerwanynajczęściej tryb pasywny i zapora po stronie serwera

    Na połączenie z serwerem FTP program czeka 10 sekund, na przesłanie pliku — do 120 sekund. Serwer, który nie zdąży, daje w dzienniku wiersz „Error:” z przyczyną.

    Kody zaczynają się od cyfry, która mówi najważniejsze: 2 — sukces, 4 — chwilowe niepowodzenie (warto powtórzyć), 5 — odmowa, która sama nie minie.

    Wynik widać w dzienniku przebiegu w wierszu „Wyeksportowano pliki przez FTP: N z M”; jeśli przesłanie przez FTP się nie udało, za nim stoi „Error: ‹kod› ‹tekst›” — kod odczytaj z tabeli powyżej.

    Dla SFTP nieudane logowanie zapisuje „Błąd logowania do serwera SFTP!” z przyczyną od serwera; jeśli logowanie się udało, a plik nie trafił na serwer, wiersza „Wyeksportowano pliki przez FTP” w dzienniku w ogóle nie będzie.

    Co leży pod linkiem, gdy powstaje nowy plik

    Eksport do pliku robi jedno: według szablonu tworzy plik z produktami i umieszcza go pod stałym linkiem. Marketplace sam pobiera ten plik przez link.

    Przy takim eksporcie program nie wysyła marketplace’owi osobnych poleceń: ani „usuń produkt”, ani „wycofaj ze sprzedaży”. Wszystko, czego marketplace się od nas dowiaduje, jest zapisane w ostatnim pliku leżącym pod linkiem. Jakie produkty do niego trafiają — warunki wyboru szablonu.

    Kiedy link prowadzi do nowego pliku

    Nowy plik powstaje osobno, w folderze roboczym programu, porcjami (w szablonach XML po 500 produktów). Przez cały ten czas pod linkiem leży poprzedni plik. Gdy nowy plik jest gotowy, program zapisuje go w magazynie plików i dopiero po udanym zapisie link w szablonie prowadzi do nowego pliku.

    Jeśli zapisanie nowego pliku się nie udało, dziennik pisze „Plik nie został przesłany do magazynu plików w chmurze. Poprzedni plik i link do niego pozostawiono bez zmian”, eksport kończy się wierszem „Eksport danych NIE został zakończony: plik nie został utworzony”, a „Link do pliku (#1)” i „Data eksportu” w szablonie pozostają poprzednie.

    • Jeśli eksport zatrzymano przyciskiem „Zatrzymaj”, zatrzymuje się on po bieżącym produkcie. Niedokończony plik zostaje w folderze roboczym, a pod linkiem zostaje poprzedni.
    • Jeśli warunek w szablonie zawiera błąd, plik nie jest publikowany i pod linkiem też zostaje poprzedni. Jeśli wybór nie dał żadnego produktu, plik nie jest publikowany w feedach XML (zwykłych i Google) ani w „Cenniku (XLSX, CSV)”, poza trybem „Eksportować wiersze z kategoriami, poniżej produkty + grupowanie”. Szablony prom.ua w formacie XLS i „1C (CommerceML2)” przy pustym wyborze publikują plik bez produktów, który zastępuje poprzedni.
    • Jeśli w nazwie pliku w szablonie jest {DATE}, {DATETIME} lub {TIME}, nazwa, a z nią i link, zmienia się z każdym przebiegiem. Marketplace, który pobiera plik pod jednym adresem, potrzebuje nazwy bez tych wstawek.
    • W wersji chmurowej do linku po każdym eksporcie dopisywane jest ?uuid= z nową liczbą. Sam plik leży pod tym samym adresem, liczba tylko omija pamięć podręczną przeglądarki.

    Co się dzieje z produktem, który wypadł z pliku

    Po naszej stronie — nic, poza tym, że nie ma go w nowym pliku. Produkt zostaje w katalogu taki, jaki był. Co marketplace zrobi z pozycją, której nie ma już w pliku (ukryje, wycofa ze sprzedaży, usunie czy zostawi bez zmian), decyduje sam marketplace i program nie ma na to wpływu. Sprawdź zasady swojego marketplace’u.

    • Jeśli marketplace ma zobaczyć produkt jako niedostępny, produkt musi zostać w pliku. W tym celu musi spełniać warunki wyboru, a jego status dostępności musi odpowiadać w ustawieniach dostępności szablonu wariantowi „niedostępny” (tam też ustawia się ilość, którą dostanie taki produkt).
    • Jeśli produkt po prostu zostanie dezaktywowany, a w szablonie jest warunek „produkt aktywny”, nie dostanie oznaczenia „niedostępny”, tylko całkowicie zniknie z pliku.
    • Jeśli produkt wrócił (znów go włączono lub znów spełnia warunki), pojawi się w pliku przy następnym eksporcie.

    Jak po dzienniku poznać, że plik powstał

    Przebieg eksportu widać w „Centrum operacji”. Plik powstał i trafił pod link, jeśli w dzienniku jest wiersz „Pobierz plik” z nazwą pliku, a ostatni wiersz to „Eksport danych zakończony”. Jeśli plik nie powstał lub magazyn plików go nie przyjął, ostatni wiersz to „Eksport danych NIE został zakończony: plik nie został utworzony”.

    Po udanym przebiegu na liście szablonów aktualizują się „Data eksportu” i „Link do pliku (#1)”. Jeśli plik nie powstał, „Data eksportu” zostaje stara, a zmienia się tylko „Czas trwania”. Co oznacza każdy wiersz dziennika — w tabeli niżej.

    Jak poprawić błędny eksport

    Przycisku „przywróć poprzedni plik” nie ma: nowy plik zastępuje poprzedni, a program nie przechowuje kopii. Na błędny plik jest jeden sposób: usunąć przyczynę i wyeksportować jeszcze raz. Nowy plik zastąpi błędny pod tym samym linkiem.

    • Jeśli do pliku trafiły nie te produkty lub jest ich mniej, niż trzeba, popraw warunki wyboru szablonu, opcje „Eksportuj do pliku (do sklepu)” w produktach i kategoriach, wybór sklepu lub magazynu. Przed ponownym uruchomieniem sprawdź liczby w oknie „Co zostanie wyeksportowane”.
    • Jeśli produkty w pliku są właściwe, a błędne są ich dane (ceny, dostępność, opisy), popraw dane w katalogu i uruchom eksport ponownie.
    • Jeśli szablon działa z opcją „Eksportować tylko nowe dane”, produkty z błędnego pliku mają już oznaczenie „Wyeksportowano” i same ponownie nie trafią do pliku. Trzeba je zmienić w katalogu lub zdjąć z nich oznaczenie „Wyeksportowano”, inaczej poprawka nie trafi do pliku.
    • Co marketplace zdążył zrobić z błędnym plikiem, zanim pobrał poprawiony, zależy od marketplace’u: program nie kontroluje, kiedy marketplace ponownie czyta plik i jak przetwarza zmiany.

    Aby błąd nie trafił do pliku następnym razem, przełącz reguły stop eksportu w tryb „Zatrzymaj eksport”. Jeśli filtru szablonu nie da się przeliczyć, dziennik pisze „Nie obliczono podsumowania przed startem…”, a reguły stop w takim przebiegu nie działają.

    Scenariusze

    Marketplace pobiera feed przez link

    Co ustawić: w kolumnie „Plik” na liście szablonów kliknij „Kopiuj link” i wklej adres w panelu marketplace’u. Nazwę pliku w karcie szablonu zostaw bez {DATE}, {DATETIME} i {TIME}.

    Efekt: każdy przebieg umieszcza pod tym samym linkiem nowy plik, a marketplace pobiera go według swojego harmonogramu. Czego nie będzie: dopóki nowy plik nie zostanie zapisany w magazynie plików, pod linkiem leży poprzedni.

    Klient chce osobnego pliku na każdy dzień na swoim FTP

    Co ustawić: w „Ustawieniach FTP” wypełnij serwer, użytkownika, hasło i „Ścieżkę docelową eksportu”, kliknij „Sprawdź połączenie”. Do nazwy pliku dodaj {DATE}.

    Efekt: codziennie na serwerze pojawi się nowy plik z datą w nazwie, poprzednie zostają. Czego nie będzie: link z kolumny „Plik” też będzie się zmieniał z każdym przebiegiem — marketplace’owi, który pobiera plik pod jednym adresem, taka nazwa nie odpowiada.

    Cennik dla klienta hurtowego e-mailem

    Co ustawić: szablon typu „Cennik (XLSX, CSV)”, wypełnione pole „Szablon newslettera”; w razie potrzeby włącz pakowanie załącznika do ZIP.

    Efekt: po każdym przebiegu plik trafi jako załącznik do wiadomości. Czego nie będzie: w innych typach szablonów załącznika do wiadomości nie ma.

    Co pisze dziennik, gdy plik nie dotarł

    Co widziszDlaczego tak jestCo zrobić
    „Wyeksportowano pliki przez FTP: 0 z 1 Error: …” w dzienniku przebiegu Serwer nie przyjął pliku: dane logowania, ścieżka, prawo zapisu lub nazwa pliku ze spacjami czy cyrylicą „Sprawdź połączenie” w „Ustawieniach FTP”, ścieżka od ukośnika, nazwa pliku literami łacińskimi (nazwa pliku i FTP)
    „Eksport produktów 500 z …” Plik powstaje: pierwsza liczba to liczba produktów już zapisanych, druga — ile wybrano łącznie. W szablonach XML wiersz pojawia się co 500 produktów i jeszcze raz na końcu Nic, poczekaj na zakończenie
    „Przesyłanie pliku do magazynu plików w chmurze” Plik jest gotowy, program podmienia nim poprzedni pod linkiem Nic, poczekaj na wiersz „Pobierz plik”
    „Plik nie został przesłany do magazynu plików w chmurze. Poprzedni plik i link do niego pozostawiono bez zmian” Plik powstał, ale magazyn plików go nie przyjął. Eksport nie został zakończony, pod linkiem został poprzedni plik Uruchom eksport jeszcze raz
    „Eksport danych NIE został zakończony: plik nie został utworzony” Wybór nie dał żadnego produktu, warunek szablonu zawiera błąd, magazyn plików nie przyjął pliku albo eksport zatrzymano. Pod linkiem został poprzedni plik Sprawdź liczby w podsumowaniu przed startem i warunki wyboru. Reguła stop lub konflikt harmonogramu w dzienniku — analiza uruchomienia

    Najczęstsze pytania

    Eksport na FTP nie przechodzi — czy to może być błąd w nazwie pliku?

    Może. Program wstawia nazwę pliku do adresu FTP tak, jak jest — nie jest stosowane, więc spacje i cyrylica to pierwszy podejrzany: zmień nazwę na łacińską, np. feed.xml. Kod w wierszu „Wyeksportowano pliki przez FTP: … Error:” wskazuje przyczynę: 530 — login lub hasło, 550 — folder lub prawo zapisu.

    Czy stare wersje pliku są przechowywane?

    Nie. Każdy przebieg zastępuje poprzedni plik, wersji „jak było w zeszłym tygodniu” nie ma. Potrzebujesz archiwum — eksportuj na FTP z {DATE} w nazwie pliku.

    Dlaczego w kolumnie „Plik” niektórych szablonów jest pusto?

    Szablony Elbuz Tunnel i bezpośrednie połączenia przez API w ogóle nie mają pliku: tunel zapisuje dane prosto do bazy sklepu, a API — zapytaniami do serwisu marketplace’u.

    Czy można wysłać plik e-mailem z dowolnego szablonu?

    Nie. Załącznik do wiadomości jest tylko w typie „Cennik (XLSX, CSV)” i tylko z wypełnionym „Szablonem newslettera”.

    Dlaczego mały plik na liście waży 4 KB?

    Plik mniejszy niż 4 KB liczony jest jako 4 KB: na dysku i tak zajmuje blok.

    Gdzie to jest i kto ma dostęp

    Menu
    Słowniki → Operacje → Eksport danych → kolumna „Plik”
    Inne wejścia
    karta szablonu, sekcja „Powiązane ustawienia” → „Ustawienia FTP”
    Uprawnienia
    okno „Szczegółowa konfiguracja szablonu eksportu”
    Przygotuj
    dla FTP — adres serwera, użytkownika, hasło i folder z prawem zapisu

    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