Instrukcja obsługi xserver Konfiguracja xserver z programem LoMag (wersja 1.1.01)
1. Konfiguracja programu xserver W pierwszej kolejności należy skonfigurować program xserver do współpracy z programem LoMag. W tym celu należy przejść do menu Ustawienia Program i uzupełnić parametry połączenia z bazą danych. Parametry połączenia z jakich korzysta program LoMag można odszukać w menu Program Ustawienia. Zakładka Praca w sieci. Program xserver nie używa do logowania autoryzacji Windows dlatego też należy włączyć możliwość logowania z uwierzytelnieniem SQL Server (https://msdn.microsoft.com/pl-pl/library/ms188670%28v=sql.110%29.aspx).
Po poprawnym wprowadzeniu parametrów serwera bazy danych i wybraniu wtyczki importu możemy zdefiniować lokalizację plików jakie zostaną eksportowane z urządzenia. Pliki danych w urządzeniu przenośnym przed wysłaniem do programu magazynowego muszą zostać odpowiednio przetłumaczone do tego służy wtyczka eksportu. Zazwyczaj umożliwia ona skonwertowanie plików XML do określonego formatu. W przypadku programu LoMag jest to jeden plik z danymi wynikowymi i tylko jeden może zostać automatycznie skopiowany/skonwertowany, dlatego też nie ma konieczności użycia opcji automatycznego eksportu danych. Po pobraniu dokumentów XML z urządzenia przenośnego należy przejść do przeglądania dokumentów lokalnych w programie xserver i wyeksportować wybrany dokument. Pobieranie dokumentów może zostać przeprowadzone przy pomocy przewodu USB na dowolnym komputerze w sieci bez użycia programu xserver ta opcja zostanie omówiona w dalszej części instrukcji. Folder eksportu przechowuje dokumenty w formacie XML i nie ma konieczności zmiany jego lokalizacji. Eksport danych pobranych to lokalizacja do jakiej trafiają pliki danych po przekształceniu. Musi być taki sam jak w programie LoMag. Każda wtyczka eksportu danych posiada swoje indywidualne opcje konfiguracji. Przed przystąpieniem do eksportu należy uzupełnić format danych z jakim mają trafić dane do programu LoMag.
Pole program do komunikacji z kolektorem może pozostać pusty jeżeli chcemy korzystać tylko z programu xserver. W przypadku kiedy na komputerze nie ma konieczności użycia programu xserver możemy skorzystać z narzędzi import/export. Są to dwa programy xserver.download.exe do pobierania danych z kolektora i konwersji plików i xserver.upload.exe do wysyłania bazy danych do urządzenia przenośnego.
2. Konfiguracja programu xserver.download.exe W katalogu z programem xserver znajduje się aplikacja xserver.download.exe i służy do pobierania danych z kolektora danych z Windows CE/Mobile. Program wspiera połączenia USB z pośrednictwem programu Active Sync lub Centrum urządzeń mobilnych (w przypadku Windows Vista/7/8/10). Program xserver.download.exe może pracować jako aplikacja samodzielna wystarczy, że skopiujemy xserver.api.dll i wybraną wtyczkę np. xserver.import.lomag.dll. Opcja tak przydaj się w przypadku kiedy posiadamy kilka komputerów w sieci i nie chcemy na każdym z nich instalować programu xserver. Program posiada proste okno główne, po podłączeniu terminala przewodem USB (wymaga Active Sync bądź też Centrum urządzeń mobilnych w przypadku nowszych systemów Windows) lub też z chwilą znalezienia urządzenia podłączonego do sieci lokalnej (np. terminale z Android lub ios korzystające z sieci WiFi). Z chwilą kiedy terminal zostanie odnaleziony wystarczy kliknąć Pobierz.
W programie LoMag program do obsługi kolektora jest zintegrowany i umożliwia pobranie listy dokumentów z urządzenia przenośnego na każdy dokument magazynowy. W ustawieniach LoMag wybieramy w tym celu (pomijając aplikację xserver) Program do komunikacji z kolektorem. W przypadku braku definicji ceny w formacie danych z kolektora w parametrach programu LoMag (zakładka Kolektor ) program automatycznie doda cenę sprzedaży/zakupu z kartoteki. Przy pierwszym uruchomieniu programu należy przejść do ustawień i zdefiniować wtyczkę eksportu i podstawowe parametry pracy. Sposób w jaki dane mają się pobierać i czy cały proces ma zostać zautomatyzowany.
Istotne jest skonfigurowanie połączenia z bazą danych programu LoMag jest to potrzebne chociażby z racji na kody ważone, które mogą zostać wysłane do programu LoMag z odpowiednią ilością i o określonym kodzie. Wtyczka eksportu dla programu LoMag to xserver.export.lomag.dll. W przypadku integracji z programem LoMag w ustawieniach indywidualnych możemy zdefiniować dodatkowe opcje. Zostało to omówione wcześniej w przypadku konfiguracji xserver i jest identyczne jak w przypadku xserver.download.exe.
Reszta opcji zostanie automatycznie pobrana z programu xserver jeżeli został on uprzednio skonfigurowany do pracy z systemem LoMag. Istotne jest żeby wybrać nazwę pliku (w tym przypadku dane.txt), która powinna być wspólna dla xserver/xserver.download.exe i LoMag.
3. Konfiguracja programu xserver.upload.exe W katalogu z programem xserver znajduje się aplikacja xserver.upload.exe. Służy do eksportu danych dla trybu off-line do programy xterminal. Identycznie jak w przypadku programu xserver.download.exe jest to aplikacja nie wymagająca aplikacji xserver i może pracować bez instalacji. Po uruchomieniu programu xserver.upload.exe należy go skonfigurować przed przystąpieniem do wysłania danych. W przypadku LoMag wystarczy dodać lokalizację aplikacji bez definicji dodatkowych parametrów. Baza nie jest pobierana z pliku txt a bezpośrednio z bazy danych. Dlatego też w ustawieniach wtyczki importu należy zdefiniować parametry połączenia z bazą danych LoMag.
W pierwszej kolejności ustawiamy parametry połączenia do serwera Microsoft SQL Server analogicznie jak w poprzednich przypadkach. Przed konfiguracją wtyczki importu należy zapisać poprawnie zdefiniowane ustawienia połączenia z bazą. W dalszej kolejności wybieramy wtyczkę importu, w przypadku LoMag jest to xserver.import.lomag.dll.
Ustawienia wtyczki importu pozwalają na określenie zakresu danych i specyficznych preferencji użytkownika.