Konfiguracja systemu

Prawidłowa konfiguracja systemu Wapro Mobile ST jest istotna dla sprawnej wymiany danych pomiędzy aplikacją mobilną a systemem centralnym Wapro Best. Proces obejmuje wybór odpowiedniego modelu pracy, utworzenie i połączenie baz danych, konfigurację integracji oraz uruchomienie usług synchronizacji urządzeń mobilnych.

Jakie są dostępne warianty pracy systemu?

System Wapro Mobile ST oraz pozostałe rozwiązania mobilne Wapro mogą działać w kilku konfiguracjach, dostosowanych do potrzeb różnych obszarów działalności firmy. Wybór odpowiedniego wariantu zależy od tego, czy użytkownicy realizują inwentaryzację środków trwałych, obsługują magazyn czy pracują w sprzedaży mobilnej.

Dostępne są następujące modele współpracy systemów:

• Wapro Best + Wapro Mobile ST. To konfiguracja przeznaczona do prowadzenia inwentaryzacji środków trwałych i wyposażenia. System wykorzystuje odrębny zestaw baz danych, dzięki czemu możliwe jest sprawne przeprowadzanie remanentów i weryfikacja składników majątku przedsiębiorstwa.
• Wapro Mag + Wapro Mobile. Wariant dedykowany dla handlowców mobilnych. Umożliwia pracę w terenie z dostępem do kontrahentów, dokumentów handlowych oraz danych sprzedażowych synchronizowanych z systemem Wapro Mag.
• Wapro Mag + Wapro Mobile Mag. Rozwiązanie stworzone z myślą o mobilnej obsłudze magazynu. Użytkownicy mogą realizować zadania magazynowe z wykorzystaniem urządzeń mobilnych, przy jednoczesnej synchronizacji danych z systemem centralnym.
• Wapro Mag + Wapro Mobile + Wapro Mobile Mag. To najbardziej rozbudowany wariant, który pozwala połączyć funkcjonalności sprzedaży mobilnej oraz mobilnej gospodarki magazynowej w ramach jednej instalacji. Współpraca systemów jest możliwa dzięki wykorzystaniu wspólnej bazy danych Konsoli zarządzającej oraz odpowiednich licencji dla Wapro Mobile i Wapro Mobile Mag. W takim modelu wszystkie funkcje są dostępne z poziomu jednej Konsoli zarządzającej. Liczba użytkowników mobilnych posiadających uprawnienia handlowca lub magazyniera pozostaje zgodna z zakupionymi licencjami, natomiast liczba użytkowników centralnych jest sumowana.

uwaga

Każda z baz danych działająca w parze systemów, takich jak Wapro Best oraz Wapro Mobile ST lub Wapro Mobile i Wapro Mag nie może równocześnie połączyć się z inną bazą danych (mobilną lub centralną).

Jak skonfigurować system Wapro Mobile ST?

informacja

Do współpracy systemu Wapro Mobile ST niezbędny jest system centralny Wapro Best w najnowszej wersji.

Aby szybko skonfigurować ustawienia systemu należy skorzystać z Kreatora konfiguracji. Kreator w kilku krokach przeprowadzi użytkownika przez proces łączenia z systemem centralnym, operacje tworzenia użytkowników mobilnych czy łączenia urządzeń. Umożliwi także rozesłanie dostępów do użytkowników lub zeskanowanie konfiguracji za pośrednictwem kodu QR.

Jak utworzyć bazy danych Konsoli zarządzającej?

Pierwszym krokiem po zainstalowaniu wszystkich komponentów systemu Wapro Mobile ST jest utworzenie bazy danych Konsoli zarządzającej na serwerze SQL, na którym pracuje baza danych Wapro Best. W przypadku braku systemu Wapro Best, w pierwszej kolejności należy go pobrać i zainstalować - można uruchomić go w wersji 30 dniowej.

Bazę danych tworzy się przy pomocy Administratora baz danych.

Administrator ten dostępny jest po przejściu do widoku: Start | Programy | Wapro | Wapro Inwentaryzator ST Konsola zarządzająca | Administrator Wapro Inwentaryzator ST.

Domyślnie podpowiadana jest nazwa bazy danych: WaproMOBILEST. W Administratorze baz danych należy uzupełnić również dane licencyjne.

Konfigurator integracji Wapro Mobile ST i Wapro Best

Po utworzeniu bazy danych i pominięciu kreatora połączenia należy uruchomić Konfigurator integracji. Narzędzie to pozwoli na połączenie bazy Wapro Best z bazą Konsoli zarządzającej.

Konfigurator integracji dostępny jest po przejściu do widoku: Start | Programy | Wapro | Wapro Mobile | Konfigurator integracji.

Po uruchomieniu aplikacji wyświetlone zostanie okno logowania. Podczas pierwszego uruchomienia pole hasła pozostaje puste.

Po zalogowaniu otworzy się główne okno Konfiguratora integracji.

Hasło dostępu do konfiguratora możesz zmienić w widoku Aplikacja | Zmień hasło.

Przejdź na zakładkę Bazy, kliknij przycisk Dodaj i wybierz serwer SQL, bazę danych Wapro Best oraz bazę danych Konsoli zarządzającej. W oknie dodawania połączenia dostępne są także opcje Szyfrowanie połączenia i Ufaj cert. serwera. Podczas tworzenia i walidacji połączeń komunikaty są wyświetlane na wierzchu aplikacji.

Jak sprawdzić zgodność baz i zaktualizować skrypty integracyjne?

Po dodaniu połączenia konfigurator automatycznie identyfikuje system centralny. W przypadku integracji Mobile ST z Wapro Best odpowiednia informacja pojawi się w kolumnie Baza centralna. Dodatkowe informacje można sprawdzić, zatrzymując kursor myszy nad nazwą połączenia. Wyświetlone zostaną między innymi:

• pogrubiony status ✓ Wersje programów i skrypty są poprawne albo [X] Wykryto niezgodność,
• wersje programów Wapro Best oraz Wapro Mobile,
• wersje struktur integracyjnych w obu bazach,
• data ostatniego rozłączenia zestawu baz,
• zalecenie aktualizacji programu lub skryptów integracyjnych, jeżeli wykryto niezgodność.

Kolor wiersza informuje o rodzaju wykrytego problemu:

• czerwony – niezgodność głównych wersji programów. Przed uruchomieniem integracji należy zaktualizować program wskazany w podpowiedzi,
• pomarańczowy — różnice w wersjach struktur integracyjnych. Wymagana jest aktualizacja skryptów integracyjnych.

Jeżeli konfigurator wykryje niezgodność, wyświetli przycisk Aktualizuj. Opcja ta jest dostępna wyłącznie dla połączeń wymagających aktualizacji. Do wyboru są dwa tryby aktualizacji:

1. Pełna procedura (zalecana) — archiwizuje ustawienia, wykonuje bezpieczne wysłanie, odebranie i potwierdzenie danych, rozłącza bazy, wgrywa skrypty zgodne z wersją połączonej bazy Konsoli zarządzającej, odbudowuje dane i automatycznie odtwarza połączenie wraz z ustawieniami. Usługa integracji jest zatrzymywana na czas operacji i ponownie uruchamiana, jeżeli wcześniej działała.
2. Tylko wgraj skrypt — wgrywa właściwy skrypt bez rozłączania baz i odbudowy danych. Opcję oznacza pomarańczowa ikona strzałki w dół do kreski.

Ostrzeżenie

Zalecana jest pełna procedura, ponieważ obejmuje wymianę i potwierdzenie danych oraz ich odbudowę. Wariant Tylko wgraj skrypt stosuj wyłącznie wtedy, gdy świadomie pomijasz te zabezpieczenia.

W przypadku odtworzenia baz z kopii zapasowej konfigurator może wyświetlić pytanie dotyczące wyczyszczenia struktur integracyjnych i ponownego przesłania danych inicjalnych. Operacja jest bezpieczna i nie powoduje ponownego importu istniejących danych.

Konfiguracja harmonogramu integracji

Konfigurator umożliwia określenie sposobu działania automatycznej synchronizacji danych. Nowo utworzone połączenia korzystają domyślnie z opcji Automatyczne ustawienia integracji. W tym trybie wszystkie etapy integracji wykonywane są kolejno w jednym cyklu, który domyślnie uruchamia się co 20 minut. Dzięki temu nie ma konieczności definiowania osobnych harmonogramów dla poszczególnych etapów integracji.

W przypadku połączeń Mobile ST + Wapro Best widoczny jest wyłącznie główny cykl integracji. Szczegółowe zadania cykliczne nie są dostępne, ponieważ nie są wykorzystywane w tym typie połączenia.

Po wyłączeniu opcji automatycznej konfiguracji (przełącznik Automatyczne ustawienia integracji) można ręcznie określić częstotliwość wykonywania poszczególnych operacji. Wprowadzone ustawienia są zapamiętywane i pozostają dostępne po ponownym przełączeniu na tryb automatyczny. Pola automatycznego harmonogramu są pogrupowane przy przełączniku cyklu integracji, ponieważ zadania cykliczne nie są wykonywane dla połączeń Mobile ST + Wapro Best

Uwaga

Ustawienie interwału na 5 minut lub mniej może powodować nakładanie się operacji oraz zwiększone obciążenie serwera. W konfiguratorze wartości te są oznaczane kolorem czerwonym i dodatkowym komunikatem ostrzegawczym.

Przykład

Jeśli pozostawisz domyślny cykl integracji 20 minut, etapy integracji będą wykonywane kolejno w ramach jednego cyklu co około 20 minut.

Na karcie Logi można odczytać czasy uruchomienia i zatrzymania usługi, jak również zapamiętane błędy działania w przypadku ich wystąpienia.

Po poprawnym połączeniu baz danych można wrócić na zakładkę Status i uruchomić usługę automatycznej integracji danych.

informacja

Usługa automatyzacji procesów integracyjnych może pozostać wyłączona. Integrację można przeprowadzać ręcznie z poziomu Konsoli zarządzającej.

Uwaga

Prawidłowa współpraca programów Wapro Best i Konsoli zarządzającej Wapro Mobile wymaga zgodnych struktur integracyjnych w obu bazach danych. Jeżeli konfigurator wykryje niezgodność, automatycznie zaproponuje aktualizację. Kontynuowanie integracji bez aktualizacji wymaganych struktur nie jest możliwe. Dzięki temu system zapewnia bezpieczeństwo danych i poprawność wymiany informacji między aplikacjami.

Jak korzystać z konfiguratora synchronizacji Android SQLite?

Kolejny krok to konfiguracja synchronizacji (replikacji) urządzeń mobilnych z bazą konsoli. Na jednym serwerze może działać równolegle dowolna ilość usług synchronizacyjnych, jednak każda musi używać odrębnego portu TCP.

Konfiguracja synchronizacji Android SQLite jest dostępna po przejściu do widoku Start | Programy | Wapro | Wapro Mobile | Serwer Synchronizacji SQLite.

Usługa SQLite pozwala połączyć bazę Konsoli zarządzającej (domyślnie WaproMOBILE) z aplikacją mobilną na platformie Android.

W tym celu w oknie konfiguratora synchronizacji kliknij przycisk Dodaj.

Wyświetli się ekran konfiguracji nowej usługi.

Wypełnij wymagane dane:

• Parametry konfiguracyjne usługi:
  • Nazwa - wpisz nazwę konfiguracji. Podczas dodawania nowej usługi konfigurator podpowiada nazwę na podstawie wybranej bazy danych. Nazwę możesz zmienić ręcznie przed zapisem. Podczas edycji istniejącej usługi nazwa nie jest zmieniana automatycznie po samym otwarciu okna. Jeżeli zmienisz wybraną bazę, konfigurator może podpowiedzieć nazwę zgodną z nową bazą, o ile nazwa nie została wcześniej zmieniona ręcznie,
  • Nazwa usługi - wpisz rozszerzoną nazwę usługi synchronizacyjnej. Domyślnie wyświetla się nazwa AssecoWaproSQLite.WaproMOBILE (ostatni człon to nazwa bazy).

Jeżeli jest to kolejna usługa synchronizacji, należy zmienić nazwę konfiguracji, co przełoży się na zmianę nazwy usługi.

• Lokalizacja pliku wykonywalnego wirtualnej maszyny Java - domyślnie jest ustawiona na ścieżkę instalacyjną OpenJDK, pliku Java.exe instalowanego wraz z systemem Wapro Mobile ST. W przypadku gdy Java była zainstalowana wcześniej, należy wskazać ręcznie aktywną jej wersję. Istotne jest prawidłowe wskazanie pliku wykonywalnego Java, ponieważ usługa korzysta z tego komponentu do połączeń urządzeń.

uwaga

Błędne wskazanie pliku wykonywalnego lub wskazanie nieaktywnego pliku wykonywalnego Java spowoduje brak komunikacji urządzeń.

• Połączenie MS-SQL:
  • Serwer:Port - wybierz z listy rozwijanej lub wskaż ręcznie. Lista serwerów SQL jest uzupełniana na podstawie informacji dostępnych lokalnie w systemie. Możesz wpisać lokalną nazwę instancji, np. .\INSTANCJA, localhost\INSTANCJA, nazwę komputera albo gotowy adres w formacie serwer:port. Konfigurator normalizuje nazwę przed zapisem i zapisuje konfigurację w formacie serwer:port, wymaganym do połączeń urządzeń mobilnych. Aby ręcznie sprawdzić serwer oraz port serwera SQL, przejdź do Konfiguratora SQL, dostępnego w menu Start, dostarczonego z programami Wapro ERP. Zalecamy ustawienie statycznego portu serwera w konfiguracji serwera MSSQL,
  • Baza - baza danych Konsoli zarządzającej, wybierz z listy rozwijanej.

• Port TCP do replikacji - port wykorzystywany do połączenia urządzeń mobilnych. Istnieje możliwość zmiany portu na inny niż standardowy 2450. Przycisk Sprawdź umożliwia sprawdzenie, czy wybrany port jest wolny do utworzenia usługi. Jeżeli port będzie zajęty, program zapyta czy nadać kolejny wolny numer portu. Ustawiony port należy uwzględnić podczas wprowadzania konfiguracji do urządzenia.
• Typ uruchomienia usługi - domyślnie ustawiono opcję Automatyczny (opóźnione uruchamianie). Ustawienie to pozwala na opóźnienie startu usługi do czasu uruchomienia serwera MSSQL.

• Typ logowania usługi w systemie - domyślnie ustawiono system lokalny. Aby zmodyfikować typ logowania, kliknij przycisk Zmień.

W oknie dodawania i edycji usługi dostępna jest także zakładka Logi. Możesz na niej ustawić poziom logowania, typ logowanych zdarzeń oraz włączyć lub wyłączyć logowanie skryptów. Zakładka pokazuje końcowy fragment najnowszego pliku logu, umożliwia otwarcie folderu z logami oraz przygotowanie wiadomości e-mail z logiem jako załącznikiem na adres serwis.wapro@assecobs.pl. Jeżeli w systemie nie ma skonfigurowanego klienta poczty, konfigurator wyświetli odpowiedni komunikat.

Zmiany ustawień logowania są zapisywane w konfiguracji usługi. Jeżeli edytowana usługa jest uruchomiona, konfigurator automatycznie uruchomi ją ponownie po zapisie ustawień. Po zapisaniu ustawień logów albo po utworzeniu usługi z włączonym logowaniem diagnostycznym w wersji 2 konfigurator wyświetla ostrzeżenie o zwiększonej szczegółowości logów. Konfigurator aktualizuje ustawienia usługi oraz plik log4j.properties: przy włączonej diagnostyce poziom logowania jest ustawiany na DEBUG, a po wyłączeniu diagnostyki wraca do poziomu standardowego WARN/INFO.

Po wskazaniu serwera, portów oraz bazy danych zapisz konfigurację. Usługa serwera synchronizacji SQLite zostanie uruchomiona. Po starcie lub restarcie usługi konfigurator czeka nie tylko na status uruchomienia usługi Windows, ale także na realne nasłuchiwanie portu replikacji. Ogranicza to pierwsze nieudane próby synchronizacji po utworzeniu, edycji lub restarcie usługi.

informacja

Komunikat o niepoprawnym uruchomieniu usługi może być spowodowany zajętym przez inną usługę portem TCP, powieloną nazwą usługi w systemie lub problemem z zapisem logu we wskazanej lokalizacji. Konfigurator oznacza nieprawidłowe lub niewypełnione pola, na które należy zwrócić uwagę podczas weryfikacji parametrów. Problem może również dotyczyć nieprawidłowego działania komponentu Java, wielokrotnej jego instalacji lub nieprawidłowego wskazania pliku wykonywalnego java.exe.

Listę usług możesz sortować po kliknięciu nagłówka kolumny. Ponowne kliknięcie tej samej kolumny zmienia kierunek sortowania. Konfigurator zapamiętuje ostatnio wybraną kolumnę i kierunek sortowania między uruchomieniami.

informacja

Przy problemie z połączeniem do bazy konfigurator może zaproponować naprawę użytkownika technicznego ml_MOBL. Operacja może odtworzyć brakującego użytkownika w bazie, np. po odtworzeniu archiwum, ale nie zmienia hasła istniejącego loginu SQL. Do wykonania naprawy wymagane są uprawnienia administracyjne do SQL Servera.

Jak archiwizować i dezarchiwizować bazy?

Podpowiedź

Szczegółowe informacje na temat działania Archiwizatora baz danych znajdziesz w instrukcji Archiwizacja bazy danych.

uwaga

Wykonywanie oraz odtwarzanie archiwum baz programów Wapro Best i Konsoli zarządzającej powinny odbywać się równolegle. Stosowanie baz z różnych okresów może spowodować brak spójności danych.

uwaga

Odtwarzanie bazy mobilnej z archiwum pod inną nazwą bez rozłączenia integracji zachowa połączenie do produkcyjnej bazy Wapro Best, a wywołanie pobrania danych w Konsoli zarządzającej na odtworzonej bazie może zakłócić działanie środowiska produkcyjnego.

Zgodność baz integracyjnych

Komunikat Nie udało się zaktualizować zabezpieczenia zgodności baz integracyjnych oznacza problem z zapisaniem potwierdzenia, że wskazana baza Wapro Best i baza Konsoli zarządzającej tworzą właściwy komplet. Mechanizm chroni przed przypadkowym połączeniem Konsoli zarządzającej z niewłaściwą bazą centralną albo z bazą odtworzoną z kopii wykonanej w innym czasie.

Najczęstszą przyczyną jest odtworzenie bazy na innym serwerze lub instancji SQL Server, po którym nie można automatycznie otworzyć klucza głównego bazy danych. Jeżeli masz pewność, że obecnie wskazana baza centralna jest właściwa, możesz zatwierdzić ją jako poprawny komplet. Operacja odbuduje lokalne klucze używane wyłącznie do zapisu potwierdzenia zgodności tego połączenia. Po zatwierdzeniu komplet baz należy traktować jako nierozłączny i archiwizować oraz odtwarzać razem.

Szczegóły techniczne: utwórz klucz główny w bazie danych albo otwórz klucz główny w sesji przed wykonaniem tej operacji.

Zatwierdź zgodność baz tylko wtedy, gdy masz pewność, że są to właściwe bazy danych, pochodzące z tego samego okresu i nieposiadające rozbieżności w zakresie integracji.