Appearance
Harmonogram synchronizacji
Spis treści
- Ustawianie częstotliwości synchronizacji
- Synchronizacja ręczna (na żądanie)
- Historia synchronizacji — logi
- Powiadomienia o błędach synchronizacji
Synchronizacja to proces, w którym Sembot pobiera nową wersję pliku źródłowego ze sklepu lub platformy e-commerce, przetwarza go przez reguły i aktualizuje pliki wyjściowe. Harmonogram określa kiedy i jak często ten proces ma się odbywać automatycznie.
Ustawianie częstotliwości synchronizacji
Harmonogram parsowania konfiguruje się osobno dla każdego pliku źródłowego. Aby do niego przejść, wejdź w Ustawienia feedów, znajdź plik źródłowy na liście i kliknij Edytuj (menu kontekstowe przy wierszu). Sekcja Częstotliwość parsowania znajduje się w dolnej części formularza edycji.
Jak działa harmonogram
Harmonogram składa się z listy wpisów — każdy wpis to jedna godzina doby, o której Sembot automatycznie pobierze i przetworzy plik. Możesz dodać maksymalnie 5 wpisów na jeden plik źródłowy.
Wskazówka widoczna w interfejsie: "Możesz ustawić różne godziny parsowania dla głównego, uzupełniającego lub obu typów feedów."
Tabela harmonogramu — kolumny
| Kolumna | Co ustawiasz |
|---|---|
| Godzina parsowania (czas UTC) | Godzina doby (0–23) w strefie czasowej UTC+0 |
| Typ parsowania feeda | Czy o tej godzinie ma być pobrany feed Główny, Uzupełniający czy Oba |
Strefa czasowa UTC
Wszystkie godziny w harmonogramie podawane są w czasie UTC+0 (czas koordynowany). Polska strefa czasowa (CET/CEST) różni się od UTC o:
- +1 godzina zimą (CET)
- +2 godziny latem (CEST)
Przykład: jeśli chcesz żeby Sembot pobierał feed o 8:00 czasu polskiego latem, ustaw godzinę 6:00 UTC.
Dodawanie i usuwanie wpisów
Dodanie nowej godziny parsowania: kliknij Dodaj czas parsowania — w tabeli pojawi się nowy wiersz. Wybierz godzinę z listy i typ parsowania, a następnie kliknij Zapisz.
Usunięcie wpisu: kliknij ikonę kosza przy wybranym wierszu, a następnie Zapisz.
Ograniczenia:
- Aktywny feed musi mieć co najmniej jeden wpis — nie można usunąć wszystkich godzin jeśli feed jest aktywny. Komunikat: "Musisz mieć co najmniej jedną godzinę parsowania dla aktywnego feeda. Nie możesz usunąć wszystkich godzin parsowania."
- Maksymalnie 5 wpisów na feed. Przy próbie przekroczenia: "Błąd podczas zmiany częstotliwości parsowania. Upewnij się, że masz wybrane maksymalnie 5 godzin parsowania."
- Każda godzina może wystąpić tylko raz — duplikaty są blokowane. Gdy wszystkie 24 godziny są zajęte: "Wszystkie godziny są już zajęte. Usuń istniejące wpisy, aby dodać nowe."
- Przed zapisem wszystkie wiersze muszą mieć uzupełnioną godzinę i typ — niekompletny wiersz blokuje zapis: "Najpierw uzupełnij godzinę i typ parsowania we wszystkich wierszach."
Potwierdzenie zapisu harmonogramu
Po kliknięciu Zapisz pojawia się komunikat: "Częstotliwość parsowania została zmieniona."
Kiedy następuje kolejna synchronizacja
Sembot nie wyświetla odliczania do następnej synchronizacji. Żeby określić kiedy nastąpi kolejne pobranie, sprawdź tabelę harmonogramu i kolumnę Przetworzono na liście plików źródłowych — pokazuje datę i godzinę ostatniego parsowania.
Synchronizacja ręczna (na żądanie)
Nie czekając na harmonogram, możesz w każdej chwili ręcznie uruchomić pobranie pliku źródłowego lub wygenerowanie pliku wyjściowego.
Ręczne pobranie pliku źródłowego
Na stronie Ustawienia feedów (zakładka z plikami źródłowymi) kliknij przycisk Pobierz pliki źródłowe (prawy górny róg). Sembot natychmiast rozpocznie pobieranie wszystkich aktywnych plików źródłowych w projekcie.
Podczas pobierania przycisk jest wyłączony, a nad tabelą pojawia się informacja: "Pliki źródłowe są w trakcie pobierania." Gdy pobieranie się zakończy, stan powraca do normalnego i możesz uruchomić je ponownie.
Ręczne generowanie pliku wyjściowego
Na zakładce z plikami wyjściowymi kliknij Zaktualizuj pliki wyjściowe. Sembot ponownie przetworzy dane przez reguły i wygeneruje nowe wersje wszystkich aktywnych plików wyjściowych.
Podczas generowania przycisk jest wyłączony, a nad tabelą pojawia się: "Pliki wyjściowe są w trakcie generowania."
Pamiętaj: plik wyjściowy generowany jest automatycznie po każdym zakończonym pobraniu pliku źródłowego. Ręczna aktualizacja pliku wyjściowego jest potrzebna tylko gdy zmieniłeś reguły lub ustawienia feeda wyjściowego i chcesz od razu zobaczyć efekt — bez czekania na kolejny cykl harmonogramu.
Stany zablokowania
W niektórych sytuacjach ręczne uruchomienie synchronizacji nie jest możliwe:
| Komunikat | Znaczenie |
|---|---|
| "Pobieranie/parsowanie feedów jest zablokowane lub w toku" | Trwa aktualnie pobieranie — poczekaj na zakończenie |
| "Generowanie feedów wyjściowych jest zablokowane lub w toku" | Trwa aktualnie generowanie — poczekaj na zakończenie |
Sembot automatycznie odblokuje przyciski gdy bieżąca operacja się zakończy.
Historia synchronizacji — logi
Każdy plik źródłowy i wyjściowy ma pełną historię operacji. Otwórz ją przez menu kontekstowe przy wierszu → Historia.
Co widać w historii
Modal Historia parsowania — [nazwa pliku] wyświetla log ostatnich 7 dni. Dane można przeglądać w dwóch widokach:
Widok tabeli — każdy wiersz to jedno zdarzenie synchronizacji:
| Kolumna | Co pokazuje |
|---|---|
| Data | Dokładna data i godzina operacji |
| Status | Wynik operacji (patrz tabela statusów poniżej) |
| Produkty | Liczba produktów w pliku po tej operacji |
| Błąd | Treść komunikatu błędu (jeśli operacja się nie powiodła) |
Widok wykresu — graficzny przebieg ostatnich synchronizacji. Wybierz metrykę:
- Liczba produktów — wykres trendu liczby produktów w czasie; pozwala szybko zauważyć nagły spadek lub wzrost asortymentu
- Czas operacji — wykres czasu trwania parsowania (w minutach); pomaga wykryć spowolnienie serwera sklepu
Legenda wykresu: Sukces (zielony) / Błąd (czerwony).
Statusy synchronizacji
| Status | Znaczenie |
|---|---|
| Sukces | Plik pobrany i przetworzony poprawnie |
| Błąd | Operacja zakończona niepowodzeniem — kolumna Błąd zawiera szczegóły |
| W toku | Operacja aktualnie trwa |
| Oczekuje | Operacja zakolejkowana, czeka na uruchomienie |
Filtrowanie historii
Nad tabelą dostępne są filtry:
- Data — zawęź widok do wybranego zakresu dat
- Status — pokaż tylko sukcesy, błędy, operacje w toku lub oczekujące
Gdy historia jest pusta: "Brak historii parsowania z ostatnich 7 dni." Gdy filtry nie zwracają wyników: "Brak wyników dla wybranych filtrów."
Historia przechowywana jest przez ostatnie 7 dni. Starsze logi nie są dostępne w interfejsie.
Powiadomienia o błędach synchronizacji
Sembot może automatycznie informować o problemach z feedami przez powiadomienia w aplikacji lub e-mailem. Ustawienia powiadomień konfiguruje się w Ustawienia użytkownika → Ustawienia powiadomień.
Dostępne typy powiadomień dla feedów
Pliki źródłowe (feed wejściowy):
| Typ powiadomienia | Kiedy jest wysyłane |
|---|---|
| Błąd feedu wejściowego | Plik źródłowy nie mógł zostać pobrany lub sparsowany |
| Błędy w feedzie wejściowym | Pobieranie zakończyło się błędami w danych (np. niepoprawne rekordy) |
| Spadek produktów w feedzie wejściowym | Liczba produktów w pliku źródłowym znacząco spadła w stosunku do poprzedniego parsowania |
Pliki wyjściowe (feed wyjściowy):
| Typ powiadomienia | Kiedy jest wysyłane |
|---|---|
| Błąd feedu wyjściowego | Plik wyjściowy nie mógł zostać wygenerowany |
| Błędy w feedzie wyjściowym | Generowanie zakończyło się błędami |
| Brakujące wymagane pola w feedzie wyjściowym | Mapowanie nie pokrywa pól wymaganych przez kanał reklamowy |
| Spadek produktów w feedzie wyjściowym | Liczba produktów w pliku wyjściowym znacząco spadła |
Konfiguracja powiadomień
W sekcji Ustawienia powiadomień dostępne są dwa poziomy konfiguracji:
- Domyślne ustawienia powiadomień — reguły obowiązujące globalnie dla wszystkich projektów
- Niestandardowe powiadomienia — reguły dla konkretnych typów zdarzeń; dodajesz je przyciskiem Dodaj niestandardowe powiadomienie wybierając typ z listy
Powiadomienia trafiają do Centrum powiadomień w aplikacji (ikona dzwonka w górnym pasku) oraz opcjonalnie na adres e-mail przypisany do konta.