Integracja drukarki fiskalnej z programem Weaver WMS

Aby drukarka fiskalna współpracowała z programem należy w pierwszej kolejności przeprowadzić konfigurację. Drukarki mogą komunikować się WMS-em przy pomocy protokołu Posnet lub XML.

Protokół Posnet

Drukarkę do komputera można podłączyć na dwa sposoby przy pomocy kabla USB lub bezpośrednia do gniazda szeregowego RS232. W przypadku wybrania opcji z użyciem przewodu USB należy pobrać sterowniki dla drukarki ze strony producenta po instalacji w systemie widziany jest wówczas „wirtualny” port RS232. Po instalacji sterowników w menadżerze urządzeń systemu Windows powinien pojawić się port.

Następnie w programie Weaver WMS należy przejść do Ustawień aplikacji i wybrać z zakładek „Drukarka fiskalna”

W sekcji protokół komunikacyjny należy upewnić się że wybrana opcja to „Posnet”, a numer portu COM jest taki sam jak w Menedżerze urządzeń systemu Windows

Protokół XML

Protokół XML (Novitus) stanowi alternatywę dla Posnetu, dzięki niemu druk paragonu trwa o wiele szybciej. Drukarkę podłączamy do naszego komputera lub naszej sieci domowej przy pomocy kabla Etherent/USB bądź poprzez sieć bezprzewodową. Jeśli komputer/sieć domowa ma ustawione automatyczne przydzielanie adresu IP to drukarka sama pobierze potrzebne jej ustawienia w innym przypadku należy je ręcznie wprowadzić. W menu urządzenia należy wydrukować ustawienia sieci i wprowadzić odpowiednie wartości do ustawień Weaver WMS (adres IP oraz port na jakim pracuje).

Wpisujemy adres IP z wydruku oraz port, a w protokole komunikacji wybieramy XML. Podobnie sprawa ma się w przypadku urządzenia tu zmieniamy protokół komunikacji istotną zmianą jest
konfiguracja połączeń poszczególnych urządzeń zewnętrznych na odpowiednim porcie fizycznym drukarki w zależności od podłączenia.
Aby przetestować czy wszystko działa można wydrukować testowy paragon.

Migracja bazy danych na Microsoft SQL Server

Od wersji 2.0.334.0 możliwa jest migracja bazy danych z wersji plikowej (SQL Mobile 3.5) do pełnej wersji Microsoft SQL Server. Dzięki migracji możliwa jest praca rozproszona na programie magazynowym, na wielu stanowiskach. 

Aby dokonać migracji należy w pierwszej kolejności utworzyć nową, pustą bazę danych MS SQL. W tym celu najlepiej użyć Microsoft SQL Server Management Studio. 

Tworzenie nowej bazy SQL

Kolejnym krokiem jest migracja bazy z poziomu WMS. W tym celu należy wejść w zakładkę Ustawienia >>> Baza danych >>> Migracja bazy danych na MS SQL Server.

Migracja bazy danych z poziomu WMS

W kolejnym oknie należy wprowadzić parametry dostępu do bazy danych i wybrać opcję Testuj połączenie

Parametry dostępu do bazy danych SQL

Jeśli połączenie zostało ustanowione poprawnie należy wybrać opcję Zapisz i poczekać aż system migruję bazę danych.

Instalacja serwisu zadań cyklicznych

Do programu magazynowego Weaver WMS dostępny jest dodatek, który pozwala na cykliczne wykonywanie pewnych operacji systemowych. Przykładowo można pobierać zamówienia ze sklepu internetowego lub wysyłać mailowo powiadomienia o nowych zamówieniach.

W programie konfiguracja Zadań Cyklicznych dostępna jest z poziomu menu Ustawienia >>> Zadania cykliczne.

Ustawienia zadań cyklicznych
Ustawienia zadań cyklicznych

Aby zadania cykliczne poprawnie funkcjonowały wymagana jest konfiguracja programu do pracy z bazą danych MS SQL oraz instalacja serwisu Zadań Cyklicznych.

Serwis zadań cyklicznych można pobrać z następującej lokalizacji

http://weaversoft.pl/downloads/wms/Worker.zip

Po rozpakowaniu pliku w pierwszej kolejności należy edytować plik Weaver.Wms.WorkerService.exe.config. W pliku w sekcji connectionStrings należy podać dane umożliwiające dostęp do bazy danych MS SQL.

Ustawienia dostępu do bazy danych
Ustawienia dostępu do bazy danych

Kolejnym krokiem jest instalacja serwisu. Można tego dokonać z konsoli administracyjnej systemu Windows (cmd jako Administrator). Należy przejść do ścieżki w której rozpakowany został serwis integracji i wykonać polecenie Weaver.Wms.WorkerService.exe /install

Instalacja serwisu zadań cyklicznych
Instalacja serwisu zadań cyklicznych

Poprawność instalacji można sprawdzić w serwisach systemu Windows (Start >>> Uruchom >>> services.msc).

Serwisy w systemie Windows
Serwisy w systemie Windows

Serwis „Weaver WMS – Zaplanowane zadania” powinien mieć status Running.

Dodatkowo w programie Weaver WMS, w Zadaniach cyklicznych, w zakładce Logi, powinny pojawiać się wpisy dotyczące działania serwisu.

Zadania cykliczne - Logi
Zadania cykliczne – Logi

Instalacja WMS Advanced na serwerze

Weaver WMS Advanced jest rozszerzeniem Weaver WMS Standard umożliwiającym pracę programu z urządzeniami mobilnymi wyposażonymi w systemi Android, Apple oraz Windows Phone. Więcej informacji o samej wersji Advanced znajduje się w linku poniżej

https://weaversoft.pl/program-magazynowy-android-mobilny/

Kolejnym krokiem jest konfiguracja serwera IIS na serwerze. Należy zainstalować wszystkie możliwe komponenty związane z IIS, WCF oraz .NET na serwerze.

Instalacja IIS

Następnie należy pobrać paczkę z wersją WMS Advanced z linku poniżej.

http://weaversoft.pl/downloads/wms/WMS-Advanced-Web.zip

Zawartość paczki należy rozpakować do folderu IIS’a, czyli C:\inetpub\

Kolejnym krokiem jest wskazanie lokalizacji bazy danych aplikacji WMS Advanced. W tym celu należy wyedytować plik C:\inetpub\WMS-ADV\Web.config i podmienić wytłuszczony tekst na nazwę swojej bazy danych.

<connectionStrings>
<add name=”Default” connectionString=”Data Source=.;Initial Catalog=wmsmobile;Integrated Security=True” providerName=”System.Data.SqlClient” />
</connectionStrings>

Ostatnim krokiem jest dodanie WMS Advanced do serwera webowego IIS. W tym celu należy:

  1. Uruchomić manager IIS. Uruchom (Skrót Windows + R) -> inetmgr
  2. Na drzewie po lewej stronie odnaleźć sekcję Sites, prawym przyciskiem wybrać opcję Add Website (Dodaj witrynę).
  3. W oknie dodawania witryny należy wpisać dowolną nazwę i wybrać folder C:\inetpub\WMS-ADV\
Dodawanie witryny IIS
  • Po kliknięciu Browse *:80 (http) (Przeglądaj *.80 (http)) prawdopodobnie pojawi się błąd sygnalizujący, że użytkownik IIS nie ma uprawnień do korzystania z bazy danych. Rozwiązaniem może być przełączenie użytkownika IIS na użytkownika lokalnego. W tym celu należy wejść w pule aplikacji WMS-ADV (na drzewku wybrać Application Pools (Pule aplikacji), ustawienia zaawansowane, Identity, a następnie wpisać tam login oraz hasło lokalnego użytkownika.
  • Pula aplikacji IIS

    Instalacja programu do pracy na wielu stanowiskach

    Weaver WMS od wersji Standard umożliwia jednoczesną pracę na wielu stanowiskach. W połączeniu z system logowania oraz uprawnieniami daje to możliwość dowolnej konfiguracji systemu do pracy w średnich oraz dużych firmach.

    Pierwszym krokiem niezbędnym aby system pracował na wielu stanowiskach jest instalacja bazy danych. Wersja jednostanowiskowa pracuje na silniku SQL Mobile, wersja wielostanowiskowa wymaga bazy danych Microsoft SQL Server w wersji 2008 lub wyższej (rekomendowana najnowsza – w tej chwili 2018). Baza danych może zostać zainstalowana w bezpłatnej wersji Express. Wersję Express w dowolnej konfiguracji można pobrać np. stąd: http://downloadsqlserverexpress.com. W tym wpisie wykorzystamy link SQL Server 2014 Express x64. Pobieramy wersję „With tools”, czyli wraz z Microsoft SQL Server Managament Studio, który będzie potrzebny do utworzenia czystej bazy danych.

    W niniejszym przykładzie instalujemy bazę w następującej konfiguracji:

    • Nazwa instancji: wms
    • Uwierzytelnienie: mixed
    • Użytkownik: sa (automatycznie)
    • Hasło: Wms@1234
    • Port TCP: 62492 (po instalacji)

    Ustawienia, których nie ma na poniższych zrzutach ekranu pozostawiamy bez zmian.

    Instalacja-SQL-1
    Instalacja-SQL-2
    Instalacja-SQL-3

    PNastępnie należy uruchomić SQL Server Management Studio i połączyć się z bazą poprzez wpisanie odpowiednich ustawień. W naszym przypadku będzie to

    • Nazwa bazy: .\WMS lub (local)\WMS
    • Użytkownik: sa
    • Hasło: Wms@1234

    Następnie należy utworzyć nową bazę o nazwie „wms”.

    Management-1
    Management-2

    Kolejnym krokiem jest konfiguracja API. W tym celu należy uruchomić na komputerze Internetowe usługi informacyjne (IIS). Usługę uruchamia się wchodząc w Panel Sterowania-> Programy-> Włącz lub wyłącz funkcje systemu Windows. W systemach Windows Server IIS uruchamia się z poziomu menu Menedżer Serwera-> Zarządzaj-> Dodaj role lub funkcje.

    Po wejściu w powyższe ustawienia należy zaznaczyć wszystkie opcje (również w menu zagnieżdżonym).

    W przypadku pierwszej instalacji IIS na komputerze należy pobrać „Hosting bundle” ze strony Microsoft’u. Link znajduje się poniżej.

    https://dotnet.microsoft.com/download/dotnet-core/thank-you/runtime-aspnetcore-3.1.10-windows-hosting-bundle-installer

    Następnie w lokalizacji C:\inetpub należy utworzyć folder API. Do utworzonego folderu należy skopiować pliki z lokalizacji C:\Program Files\Weaver Software\Weaver WMS\API (lub …\API32 dla systemów 32 bitowych).

    W pliku json o nazwie appsettings należy zdefiniować z którą bazą danych ma się łączyć API. Definiujemy to wpisując nazwę podmiotu w stringu „Company”: „” pomiędzy cudzysłów. Jeżeli łączymy się z podmiotem domyślnym string pozostawiamy bez zmian. Jeżeli z innym string wygląda następująco: „Company”: „WMS Test API” dla podmiotu o nazwie WMS Test API.

    Następnie w usłudze IIS dodajemy nową stronę Web o dowolnej nazwie. Zaznaczamy opcję „Strony” i klikamy z menu po prawej „Dodaj stronę”.

    W oknie dodawania strony definiujmy:

    • nazwę strony,
    • ścieżkę fizyczną, określającą folder do którego ma odnosić się strona,
    • port, na którym ma zostać uruchomione API

    Dalej przechodzimy do sekcji „Pula aplikacji”, zaznaczamy stworzoną pulę (będzie miała taką samą nazwę jak przed chwilą dodana strona), z menu po prawej wybieramy „Ustawienia podstawowe” i zmieniamy opcję w sekcji „.NET CLR version” na „Bez kodu zarządczego”.

    Następnie musimy udostępnić zdefiniowany wcześniej port (w tym przypadku numer 62400) w firewallu. Definiujemy nową regułę przychodzącą. Ustawienia, które nie zostały pokazane zostawiamy bez zmian.

    Ostatnim i najważniejszym krokiem, jest konfiguracja Weaver WMS do pracy w sieci. Należy wejść w zakładkę Ustawienia -> Konfiguracja bazy danych-> Konfiguracja API. W polu adres serwisu wpisujemy adres IP komputera i po dwukropku numer portu dla API. Warto wcześniej ustawić na komputerze stały adres IP lub nazwę komputera, tak aby komputery w sieci mogły odnaleźć serwer. Adres 127.0.0.1 w poniższym przykładzie należy zastąpić swoim adresem IP lub nazwą hosta.

    Poniższy film przedstawia cały proces.

    Przenoszenie bazy danych programu na inne stanowisko

    Często przy okazji aktualizacji konfiguracji sprzętowej w firmie pojawia się potrzeba przeniesienia programu magazynowego na inne stanowisko. Aby to wykonać należy:

    1. Zainstalować na nowym komputerze najnowszą wersję Weaver WMS ze strony weaversoft.pl
    2. Sprawdzić lokalizację bazy danych na starym oraz nowym komputerze. W tym celu z zakładki Ustawienia wybieramy opcję „Baza danych”. W poniższym przypadku jest to C:\ProgramData\Weaver Software\. Należy zwrócić uwagę że jest to folder systemowy (ukryty). Aby się do niego dostać należy włączyć widoczność ukrytych folderów bądź też poprzez kombinację klawiszy WINDOWS+R wpisać komendę „C:\ProgramData”
  • Należy skopiować zawartość całego folderu ze starego komputera na nowy. W przypadku różnych systemów operacyjnych, lokalizacja może się różnić.