Program pomocniczy jtl-bridge

jtl-bridge to mały program allverto do przeprowadzki. Działa na komputerze, na którym działa Twoja JTL-Wawi (zwykle serwer Windows), odczytuje tam dane Twojej Wawi i przesyła je w postaci zaszyfrowanej do allverto. Ani baza danych Wawi, ani serwer REST Wawi nie muszą być w tym celu dostępne z internetu. Nie potrzebujesz żadnych poleceń – wystarczy dwukrotne kliknięcie i wklejony kod.

#Zanim zaczniesz

Wcześniej nie musisz nic wpisywać. W allverto otwórz Ustawienia → Migracja danych → Migracja z JTL-Wawi, krok Połącz źródło, i wybierz źródło: API JTL-Wawi (zobacz Konfiguracja API REST) lub Baza danych JTL (zobacz Dostęp przez bazę danych JTL).

Potem rozwiń ramkę Serwer niedostępny z internetu? Prześlij dane przez jtl-bridge. Pokazuje te same kroki co tutaj. O adres, serwer SQL, użytkownika i hasło program zapyta później na Twoim serwerze. To, co allverto już rozpoznaje, jest w ramce odhaczane.

#Krok po kroku

1. Pobierz jtl-bridge. Kliknij w polu Pobierz dla Windows. Plik nazywa się np. allverto-jtl-bridge-1.0.0-windows-x64.exe i nie wymaga instalacji. Jeśli przeglądarka ostrzega przed plikiem, wybierz Zachowaj lub Pobierz mimo to.
2. Skopiuj plik na serwer, na którym działa Twoja JTL-Wawi – np. przez Pulpit zdalny na pulpit. Skopiuj plik na swoim komputerze (Ctrl + C) i wklej go w oknie Pulpitu zdalnego na pulpicie serwera (Ctrl + V). Możesz też otworzyć allverto bezpośrednio w przeglądarce serwera i pobrać plik tam.
3. Na serwerze uruchom plik dwukrotnym kliknięciem. Otworzy się okno z czarnym tłem. Jeśli Windows wcześniej pokaże „System Windows ochronił ten komputer”, kliknij Więcej informacji, a potem Uruchom mimo to – program nie jest jeszcze podpisany cyfrowo.
4. Kliknij tutaj „Wygeneruj kod konfiguracyjny”, skopiuj kod, wklej go w oknie prawym przyciskiem myszy i naciśnij Enter. allverto zakłada przy tym połączenie z wybranym źródłem. Kod kopiujesz przyciskiem Kopiuj kod konfiguracyjny. Zaczyna się od AVJTL1. i zawiera wszystko, czego program potrzebuje.
5. Odpowiedz na pytania w oknie – zwykle wystarczy Enter. Propozycja w nawiasach kwadratowych zwykle pasuje; wtedy po prostu naciśnij Enter. Program od razu sprawdza połączenie. Jeśli się nie uda, wyjaśnia przyczynę i pyta jeszcze raz. Sprawdzone dane przekazuje do allverto w postaci zaszyfrowanej – przy następnym uruchomieniu już o nie nie pyta.
   • API JTL-Wawi: Program sam szuka serwera REST na tym komputerze (porty od 5883 do 5890) i proponuje znaleziony adres, np. „Znaleziono: http://localhost:5885/api/eazybusiness – naciśnij Enter, aby użyć”. Jeśli niczego nie znajdzie, zapyta o adres serwera REST. Port to ten, który ustawiono w Wawi dla serwera REST (np. 5883).
   • Baza danych JTL: Program pyta o Serwer SQL [localhost], Instancja [JTLWAWI] (wpisz minus -, jeśli jej nie ma), Baza danych [eazybusiness], Użytkownik [sa] i Hasło. Hasła nie widać podczas wpisywania. Chodzi o hasło SQL Server, a nie o Twoje hasło do JTL-Wawi.
6. Tylko przy źródle „API JTL-Wawi”: Zarejestruj aplikację w JTL-Wawi. Okno powie Ci, kiedy nadejdzie ten moment: Klucz API program przekaże potem sam do allverto w postaci zaszyfrowanej – nie musisz niczego przepisywać. Jeśli klucz jest już zapisany, ten krok odpada.
   1. Otwórz w JTL-Wawi Anwendungsregistrierungen → Anwendung registrieren (rejestracja aplikacji) i przejdź dalej aż do Registrierung beginnen (rozpocznij rejestrację). Pojawi się tam: „Es wird auf die Übermittlung einer Registrierungsanfrage durch die zu registrierende Anwendung gewartet …” (oczekiwanie na żądanie rejestracji od aplikacji).
   2. Teraz naciśnij Enter w oknie jtl-bridge. Program wyśle żądanie allverto – Umzug von JTL-Wawi. Jeśli Wawi jeszcze go nie przyjmuje, program ponawia próbę co 5 sekund przez 10 minut.
   3. Sprawdź w Wawi Anwendungsinformationen (informacje o aplikacji), w Benutzer (użytkownik) wybierz użytkownika Wawi, w Zugriffsverwaltung (zarządzanie dostępem) potwierdź żądane uprawnienia (tylko odczyt) i kliknij Einrichtung abschließen (zakończ konfigurację).
7. Poczekaj, aż pojawi się „Gotowe” – allverto odhaczy wtedy ten krok. Program najpierw sprawdza połączenie, zlicza dane, a potem przesyła je rodzaj po rodzaju. W zależności od ilości danych trwa to od kilku minut do kilku godzin. Nie zamykaj w tym czasie okna. Potem naciśnij Enter – okno się zamknie.

Dalej w allverto przechodzisz do Znalezione dane i Przypisania – zobacz Migracja z JTL-Wawi: jak to przebiega.

#Skąd się bierze klucz API?

JTL-Wawi nie pokazuje klucza API, który dałoby się przepisać, i nie tworzy go na życzenie. Wydaje klucz tylko aplikacji, która właśnie o niego prosi – gdy jej kreator czeka w kroku Registrierung beginnen. Jeśli Twój serwer REST jest dostępny z internetu, allverto samo wysyła żądanie (Wyślij rejestrację z allverto). W przeciwnym razie robi to jtl-bridge: wysyła żądanie, odbiera klucz po „Einrichtung abschließen” i przekazuje go zaszyfrowany do allverto.

#Dane w kreatorze

W Dane połączenia widzisz, co przesłał jtl-bridge: adres serwera REST lub serwer SQL, instancję, bazę danych i użytkownika. Hasło nigdy nie jest pokazywane. Zmieniać coś tutaj trzeba tylko w wyjątkowych przypadkach. Tam jest też przełącznik Uzupełnij brakujące dane z bazy danych (opcjonalnie) – zobacz Konfiguracja API REST.

#Testuj połączenie

W kreatorze widać ostatni wynik sprawdzenia, np. „Ostatnio sprawdzone przez jtl-bridge: połączono ✓ (2 minuty temu)”, albo błąd ze wskazówką rozwiązania. jtl-bridge zgłasza przy każdym uruchomieniu, czy połączenie się udało.

Przyciskiem Testuj połączenie sprawdzasz połączenie z poziomu kreatora:

• Jeśli adres jest dostępny tylko na Twoim serwerze lub w sieci firmowej (np. localhost, 127.0.0.1, 192.168.…, 10.… albo nazwa komputera, jak WAWI-SERVER), allverto nie może się z nim połączyć. Wtedy test wykonuje jtl-bridge: uruchom plik dwukrotnym kliknięciem i wklej kod konfiguracyjny – wynik pojawi się w kreatorze.
• Jeśli adres jest dostępny z internetu, allverto sprawdza go samo: przy serwerze REST – czy odpowiada; przy SQL Server – logowanie i wersję Wawi. Taki port otwórz w zaporze tylko dla adresów serwerów allverto.

#Kod konfiguracyjny

• Kod zawiera adres Twojego allverto i Twój osobisty token importu. Działa jak hasło: nie wysyłaj go e-mailem i nie kopiuj do zgłoszeń.
• allverto pokazuje kod tylko zaraz po wygenerowaniu. Jeśli później będziesz go potrzebować ponownie, wygeneruj nowy przyciskiem Wygeneruj nowy kod konfiguracyjny – stary przestanie wtedy działać.
• Kod jest ważny 30 dni, najdłużej do zakończenia migracji. Przyciskiem Przedłuż o 30 dni przedłużasz go od dziś.
• Działa tylko tak długo, jak osoba, która go wygenerowała lub ostatnio przedłużyła, jest aktywna i ma uprawnienie „Przeprowadzanie migracji z JTL-Wawi”.

#Twoja Wawi działa na serwerze w Twoim biurze?

Wtedy nie musisz uruchamiać programu na samym serwerze: wystarczy też dowolny komputer z Windows w tej samej sieci. Wpisz w oknie przy adresie lub przy serwerze SQL zamiast localhost nazwę lub adres IP serwera (np. http://WAWI-SERVER:5883/api/eazybusiness). Serwer musi dopuszczać dostęp z tego komputera (zapora Windows); w razie wątpliwości prościej jest uruchomić program bezpośrednio na serwerze. Jeśli wpiszesz adres IP komputera, na którym działa program, ostrzeże Cię o tym: wystarczy wtedy localhost.

#Gdy coś nie działa

Przy błędzie okno mówi, co się stało i co możesz zrobić. Najczęstsze przypadki:

Więcej przypadków: Rozwiązywanie problemów przy migracji z JTL.

#Inne systemy

Wawi działa na Windows, dlatego allverto zawsze najpierw proponuje plik dla Windows. W Inne systemy jtl-bridge jest dostępny także dla Linuksa (nadaj plikowi prawo wykonywania i uruchom go w terminalu) i macOS (rozpakuj ZIP, kliknij dwukrotnie jtl-bridge.command; jeśli macOS zgłasza niezweryfikowanego dewelopera: kliknij z wciśniętym klawiszem ctrl → Otwórz). Dalszy przebieg jest taki sam.

#Bezpieczeństwo

• jtl-bridge przesyła dane tylko przez HTTPS. Dane są dodatkowo szyfrowane kluczem wyprowadzonym z tokenu importu.
• Program tylko odczytuje – niczego nie zmienia w Twojej Wawi.
• Hasło i klucz API nigdy nie są wyświetlane w oknie. To, co wpiszesz w oknie, program przekazuje do allverto w postaci zaszyfrowanej. allverto przechowuje hasło i klucz API w postaci zaszyfrowanej i używa ich tylko do tej migracji; w protokole widnieje tylko informacja, że zostały zapisane.
• allverto przechowuje z tokenu importu tylko odcisk, nigdy sam token.
• Po dziesięciu nieprawidłowych kodach z tego samego adresu allverto blokuje kolejne próby na kilka minut.
• Po Zakończ przejście kod traci ważność, a tymczasowo zapisane dane JTL zostają usunięte. Aplikację „allverto – Umzug von JTL-Wawi” możesz wtedy ponownie usunąć w Wawi w Anwendungsregistrierungen.

#Dla zaawansowanych

jtl-bridge można też sterować poleceniami w wierszu polecenia lub PowerShell, np. do testów lub zaplanowanych zadań. Zamiast --code działa też --url <allverto-Adresse> --token <Import-Token>.

W programie dla Windows wywołanie nazywa się tak jak plik, np. .\allverto-jtl-bridge-1.0.0-windows-x64.exe check --code ….

Hasło i klucz API możesz też ustawić tylko na komputerze (zmienne środowiskowe JTL_DB_PASSWORD, JTL_API_KEY) – wtedy nigdy go nie opuszczają. Sumę kontrolną (SHA-256) każdego pliku podaje lista plików do pobrania pod /api/downloads/jtl-bridge.