HandyCafe Docs
owner it-admin

Ustawienia Klientów Legacy

HandyCafe działa równolegle z wcześniejszymi instalacjami klientów V3 i V4 bez zakłóceń. Strona ustawień Klientów Legacy kontroluje dwie odrębne funkcje:

  1. Protokół w czasie rzeczywistym. Umożliwia działanie nasłuchiwaczy sieciowych, które pozwalają klientom V3 i V4 łączyć się z tym serwerem na ich oryginalnych portach.
  2. Migracja bazy danych. Opcjonalnie importuje członków, cenniki, produkty, zamówienia, transakcje i logi z lokalnej starszej instalacji do nowej bazy danych HandyCafe. Dotyczy tylko Windows.

Obie funkcje są niezależne. Możesz włączyć wsparcie w czasie rzeczywistym bez migracji danych, migrować dane bez włączania wsparcia w czasie rzeczywistym lub zrobić jedno i drugie.

Sekcja Protokół w Czasie Rzeczywistym

Włącz Wsparcie dla Klientów Legacy

Główny przełącznik na górze sekcji. Po włączeniu serwer uruchamia trzy nasłuchiwacze sieciowe:

  • Nasłuchiwacz UDP na skonfigurowanej grupie multicast.
  • Nasłuchiwacz poleceń TCP na UDP port + 2.
  • Nasłuchiwacz transferu plików TCP na UDP port + 7.

Wyłączenie przełącznika zatrzymuje wszystkie trzy nasłuchiwacze jednocześnie. Możesz dostosować numery portów lub kodowanie, gdy są wyłączone, a następnie ponownie włączyć, aby zastosować zmiany.

Pola Konfiguracyjne

Pole Domyślna wartość Opis
Klucz Autoryzacji HANDYCAFE Wspólny klucz 10-znakowy. Każda przychodząca i wychodząca ramka zawiera ten ciąg. Ramki, które nie pasują, są odrzucane. Wszyscy Twoi klienci legacy muszą używać tego samego klucza.
IP Multicast UDP 230.4.4.46 Grupa multicast używana do sygnałów odkrywania klientów i do przesyłania poleceń opartych na UDP. Zakodowana na stałe w większości starszych wersji klientów.
Port UDP Serwera 710 Port UDP, na którym serwer nasłuchuje sygnałów i poleceń klientów. Klienci legacy wysyłają na ten port.
Port UDP Klienta 711 Port UDP, na którym nasłuchują klienci legacy. Serwer wysyła polecenia zarządzania unicast na ten port na odkrytym IP klienta.
Kodowanie cp1254 Kodowanie znaków dla pól ciągów w formacie przewodowym. Użyj cp1254 dla instalacji tureckich, cp1252 dla zachodnioeuropejskich. Nieznane wartości wracają do cp1254 z ostrzeżeniem w logu serwera.
Wersja Serwera 3.4.01 Ciąg wersji nadawany w każdym sygnale UDP. Niektórzy klienci legacy odrzucają ramki z wersji, których nie rozpoznają. Ustaw to, aby pasowało do ciągu wersji Twojego oryginalnego serwera.
Wariant Protokołu STE Wybór formatu przewodowego. Zobacz porównanie wariantów poniżej.
Limit Czasu Nieaktywności 10 Sekundy. Nadzór na MAC. Jeśli w tym czasie nie nadejdzie żaden ruch od klienta, klient jest oznaczany jako offline. Przerwa 10 sekund jest odpowiednia dla klientów legacy, które wysyłają sygnały co 2 lub 3 sekundy.

Porty Pochodne

Poniżej formularza strona wyświetla linię tylko do odczytu, która pokazuje pochodne porty TCP:

Port Poleceń TCP: 712   Port Transferu Plików: 717

Te porty są obliczane na podstawie portu serwera UDP. Nie konfigurujesz ich osobno. Jeśli zmienisz Port UDP Serwera na inną wartość, porty pochodne zmienią się wraz z nim.

Wariant Protokołu

Pole Wariant Protokołu wybiera format przewodowy używany przez serwer. Wybierz wariant, który pasuje do tego, jak zbudowany był Twój serwer legacy.

Wariant Kiedy używać
STE (Smart/Turbo Edition) Nowoczesna baza kodu legacy. Dodaje 70-bajtowy prefiks informacji o licencji do struktury ramki. Rozmiar ramki to 1337 bajtów. Wybierz to, jeśli Twoja instalacja legacy używała edycji Smart lub Turbo.
Standard Zwykła podstawowa wersja legacy. Rozmiar ramki to 1267 bajtów bez prefiksu informacji o licencji. Wybierz to tylko, jeśli Twoja instalacja legacy była edycją Standard bez rejestracji licencji.

Wybranie niewłaściwego wariantu powoduje odrzucenie lub błędne odczytanie ramek. Objawy obejmują klientów pojawiających się online, ale ignorujących każde polecenie lub dane poleceń przesunięte o 70-bajtowy offset.

Współistnienie z Nowoczesnymi Klientami

Porty legacy (710, 711, 712, 717) są całkowicie oddzielone od nowoczesnych portów protokołu HandyCafe (TCP 5001, 5002, 5003, UDP 5004). Oba stosy protokołów działają jednocześnie bez konfliktu. Możesz mieszać starych i nowych klientów w tej samej sieci LAN i zarządzać nimi z tego samego Panelu Administracyjnego.

Zastosowanie Zmian

Każde pole w sekcji Protokół w Czasie Rzeczywistym jest zapisywane przy użyciu globalnego przycisku Zapisz na dole strony. Po zapisaniu serwer:

  1. Zatrzymuje trzy nasłuchiwacze legacy, jeśli były uruchomione.
  2. Waliduje klucz autoryzacji (nie może być pusty).
  3. Buduje nowe konfiguracje nasłuchiwaczy z zaktualizowanych pól.
  4. Uruchamia ponownie nasłuchiwacze jednocześnie.
  5. Wywołuje powiadomienie, gdy wszystkie trzy są ponownie online.

Jeśli port jest już używany przez inny proces, serwer zgłasza błąd, a przełącznik wraca do pozycji wyłączonej. Sprawdź swoją zaporę i inne usługi za pomocą netstat i wybierz wolny zakres portów.

Sekcja Migracja Bazy Danych (tylko Windows)

Ta funkcja jest dostępna tylko wtedy, gdy HandyCafe działa na Windows. Na macOS i Linux sekcja pokazuje powiadomienie: "Migracja bazy danych jest obsługiwana tylko na Windows."

Wykrywanie

Po otwarciu serwer skanuje Twój system w poszukiwaniu instalacji legacy. Wykrywanie sprawdza:

  • Rejestr i typowe ścieżki instalacji, takie jak Program Files\HandyCafe i C:\HandyCafe.
  • Plik bazy danych obok instalacji.
  • Pliki konfiguracyjne INI w katalogu instalacyjnym.

Gdy wykrywanie się powiedzie, strona wyświetla:

Etykieta Znaczenie
Ścieżka Instalacji Gdzie na dysku znajduje się instalacja legacy.
Ścieżka Bazy Danych Pełna ścieżka do pliku bazy danych legacy.
Wersja Serwera Parsowana z konfiguracji legacy.
Liczba Plików INI Liczba wykrytych plików konfiguracyjnych. Przydatne do sprawdzenia, czy instalacja jest kompletna.

Jeśli nie wykryto instalacji, strona wyświetla "Nie wykryto instalacji legacy." Nadal możesz włączyć wsparcie w czasie rzeczywistym; funkcja migracji po prostu nie ma nic do zaimportowania.

Status Migracji

Strona śledzi historię migracji:

Status Znaczenie
nigdy Jeszcze nie przeprowadzono migracji.
w_toku Migracja jest obecnie w toku. Nie zamykaj serwera w tym stanie.
zakończona Ostatnia migracja zakończyła się bez ostrzeżeń.
zakończona_z_ostrzeżeniami Ostatnia migracja zakończyła się, ale niektóre rekordy zostały pominięte (na przykład z powodu błędów kodowania lub niepoprawnych dat). Przejrzyj ostrzeżenia przed kontynuowaniem.
cofnięta Ostatnia migracja została cofnięta.

Po pierwszym udanym uruchomieniu przycisk Rozpocznij Migrację zmienia nazwę na Ponownie Uruchom Migrację.

Co Jest Migrowane

Tabela Opis
Członkowie Rekordy klientów z nazwiskami, danymi kontaktowymi i saldami kont.
Cenniki Tabele cenowe i stawki godzinowe.
Produkty Wpisy w katalogu produktów.
Zamówienia Historia zamówień z odniesieniami do sesji.
Transakcje Wpisy księgowe z znacznikami czasu, kwotami i metodami płatności.
Logi Wpisy audytowe i ostrzeżenia z bazy danych legacy.

Gwarancja "Bezpieczne Pliki"

Strona wyświetla powiadomienie na niebiesko: "Oryginalne pliki bazy danych nie są usuwane. Możesz je bezpiecznie usunąć po potwierdzeniu migracji." Migracja jest tylko do odczytu na źródle. Nawet jeśli uruchomisz migrację wielokrotnie, oryginalna baza danych legacy pozostaje nietknięta. To pozwala na eksperymentowanie z importem, przeglądanie liczników i cofanie bez ryzyka.

Rozpocznij, Ponownie Uruchom i Cofnij

  • Rozpocznij Migrację. Otwiera modal postępu. Modal pokazuje bieżącą fazę i liczniki rekordów podczas działania importu. Nie zamykaj HandyCafe w tym czasie.
  • Ponownie Uruchom Migrację. Dostępne po zakończonym uruchomieniu. Ponownie uruchamia import od początku. Nowy import zastępuje poprzednie dane w HandyCafe.
  • Cofnij Migrację. Dostępne po zakończonym uruchomieniu. Otwiera okno dialogowe potwierdzenia. Po potwierdzeniu każdy zaimportowany wiersz jest usuwany z HandyCafe. Źródło legacy nie jest dotykane. Po cofnięciu status wraca do nigdy.

Zakończona z Ostrzeżeniami

Jeśli migracja zakończy się z zakończona_z_ostrzeżeniami, pojawia się żółty baner z linkiem Szczegóły. Kliknij, aby rozwinąć listę pominiętych rekordów z powodem. Typowe powody:

  • Niezgodność kodowania. Wiersz źródłowy zawiera znaki, które nie dekodują się poprawnie w skonfigurowanym kodowaniu. Zmień pole kodowania (cp1254 lub cp1252) i ponownie uruchom migrację.
  • Niepoprawne daty. Niektóre rekordy legacy mają nieprawidłowe znaczniki czasu. Są pomijane, aby poprawne wiersze mogły zostać zaimportowane.
  • Zduplikowane klucze. Rekord z tym samym identyfikatorem już istnieje w HandyCafe. Migracja zachowuje istniejący rekord i pomija duplikat.

Wskazówki

  • Zatrzymaj serwer legacy przed uruchomieniem migracji. Jeśli system legacy nadal zapisuje do swojej bazy danych, import może zobaczyć nieaktualne lub częściowe dane.
  • Dopasuj pole Kodowanie do swojego lokalnego ustawienia legacy przed pierwszą migracją. Zmiana po zaimportowaniu danych nie naprawi już uszkodzonych nazw.
  • Zawsze najpierw przeprowadź testową migrację. Sprawdź liczniki rekordów w "Ostatnie Liczniki" i przejrzyj kilka wierszy członków i transakcji przed zaangażowaniem personelu w nowy system.
  • Włącz wsparcie w czasie rzeczywistym i utrzymuj połączenie swoich klientów legacy przez okres przejściowy. To pozwala zweryfikować, że nowy serwer obsługuje ich identycznie, zanim wycofasz stary serwer.
  • Jeśli zmienisz Port UDP Serwera, pamiętaj, że pochodne porty poleceń i transferu plików zmieniają się wraz z nim. Zasady zapory muszą być odpowiednio zaktualizowane.