Połączenie z SQL Server
Subiekt GT, Subiekt nexo, Navireo, Comarch ERP Optima i WAPRO Mag trzymają dane w Microsoft SQL Server. Sprawdzarka łączy się z tym serwerem bezpośrednio przez sieć i przy każdym skanie wysyła jedno zapytanie odczytu. Ta strona opisuje to, co wspólne dla tych programów; pola specyficzne dla programu są na jego stronie.
Pola wspólne
| Pole | Co wpisać |
|---|---|
| Adres | Adres serwera SQL, z portem albo nazwą instancji – formaty niżej. |
| Użytkownik | Login SQL Server (nie konto Windows). Użyj osobnego loginu tylko do odczytu – jak go założyć. |
| Hasło | Hasło tego loginu. |
| Baza danych | Nazwa bazy firmy w SQL Server, np. Nexo_MojaFirma albo CDN_MojaFirma. |
| Szyfrowanie połączenia (SSL) | Domyślnie zaznaczone – szczegóły. |
| Szukaj po kodzie produktu (SKU) | Szukanie po symbolu / kodzie / indeksie towaru. Domyślnie włączone. |
| Szukaj po kodzie EAN | Szukanie po kodzie kreskowym. Domyślnie włączone. |
Przy obu przełącznikach wyszukiwania włączonych aplikacja znajdzie towar zarówno po kodzie kreskowym, jak i po symbolu (gdy klient zeskanuje etykietę półkową z symbolem). Gdy oba są wyłączone, aplikacja szuka tylko po symbolu – tak jak przy samym SKU.
Format adresu
| Wpis w polu Adres | Znaczenie |
|---|---|
192.168.1.10 | Instancja domyślna, port 1433. |
192.168.1.10:1433 albo 192.168.1.10,1433 | Podany port. |
192.168.1.10\INSERTGT | Instancja nazwana – port podaje usługa SQL Server Browser (UDP 1434). |
192.168.1.10\INSERTGT,50123 | Instancja nazwana ze stałym portem – Browser nie jest potrzebny. |
Adres możesz przepisać tak, jak pokazuje go program (np. SERWER\OPTIMA). Pewniej jest jednak wpisać adres IP zamiast nazwy komputera: sprawdzarka z Androidem nie zawsze rozpozna nazwę komputera z sieci Windows. Serwer powinien mieć stały adres IP (albo rezerwację w routerze), bo po zmianie adresu sprawdzarka przestanie się łączyć.
Gdy w adresie jest port, aplikacja łączy się prosto na ten port i nie pyta usługi SQL Server Browser.
Co sprawdzić na serwerze
- Protokół TCP/IP jest włączony dla instancji (SQL Server Configuration Manager → konfiguracja sieci SQL Server → protokoły). W wersjach Express bywa domyślnie wyłączony. Po zmianie uruchom ponownie usługę SQL Server.
- Port instancji. Instancja domyślna słucha na 1433. Instancja nazwana ma zwykle port dynamiczny – najprościej ustawić jej stały port (właściwości TCP/IP → IPAll) i wpisać go w adresie.
- Zapora Windows na serwerze przepuszcza ruch przychodzący TCP na port SQL Servera (i UDP 1434, jeśli korzystasz z SQL Server Browser).
- Uwierzytelnianie SQL Server jest włączone (tryb mieszany: SQL Server i Windows). Aplikacja loguje się wyłącznie loginem i hasłem SQL.
Szyfrowanie połączenia (SSL)
- Zaznaczone (domyślnie) – aplikacja szyfruje połączenie, jeśli serwer to obsługuje; jeśli nie obsługuje, łączy się bez szyfrowania. Certyfikat serwera nie jest sprawdzany, więc działa także certyfikat samopodpisany, który SQL Server tworzy sam.
- Odznaczone – połączenie bez szyfrowania.
Jeśli serwer wymusza szyfrowanie, a pole jest odznaczone, test połączenia pokaże Serwer zerwał połączenie. Jeśli serwer wymaga szyfrowania, zaznacz „Szyfrowanie połączenia (SSL)”.
W polu Baza danych po średniku można dopisać parametry sterownika jTDS, np. Nexo_MojaFirma;ssl=require albo CDN_MojaFirma;loginTimeout=30. Parametr dopisany w ten sposób wygrywa z ustawieniem domyślnym (ssl z pola wyboru, loginTimeout=15, socketTimeout=15).
Jak aplikacja utrzymuje połączenie
- Połączenie otwiera się przy starcie aplikacji i po zapisaniu ustawień. W tym czasie na ekranie jest Ładowanie, a skany są pomijane.
- Gdy połączenie się nie uda, ekran pokazuje Brak połączenia ze źródłem danych i Poproś o pomoc obsługę sklepu. Każdy kolejny skan próbuje połączyć się od nowa – nie trzeba restartować aplikacji, np. gdy WiFi wstało później niż sprawdzarka.
- Gdy zapytanie się nie powiedzie (zerwane połączenie, restart serwera), aplikacja otwiera nowe połączenie i powtarza zapytanie. Dopiero drugi błąd daje na ekranie Błąd pobierania danych.
- Po ponad 2 minutach bez skanów połączenie jest otwierane od nowa przed zapytaniem, bo zapory i routery często po cichu zrywają bezczynne połączenia.
- Na nawiązanie połączenia i na odpowiedź serwera aplikacja czeka po 15 sekund.
Użytkownik SQL tylko do odczytu
Sprawdzarka wisi w alejce sklepu, a login i hasło są zapisane w jej pamięci. Nigdy nie wpisuj w niej loginu sa ani innego konta administratora – kto dostanie się do urządzenia, miałby pełny dostęp do bazy firmy. Załóż osobny login, który może tylko czytać tabele potrzebne aplikacji.
Skrypt uruchom w SQL Server Management Studio jako administrator serwera. Zamień nazwę bazy, hasło i listę tabel na tę ze strony swojego programu:
USE [master];
CREATE LOGIN [sprawdzarka] WITH PASSWORD = N'Wpisz-tu-dlugie-haslo', CHECK_POLICY = ON, DEFAULT_DATABASE = [NazwaBazyFirmy];
USE [NazwaBazyFirmy];
CREATE USER [sprawdzarka] FOR LOGIN [sprawdzarka];
-- tylko tabele, które czyta sprawdzarka:
GRANT SELECT ON dbo.tw__Towar TO [sprawdzarka];
GRANT SELECT ON dbo.tw_Cena TO [sprawdzarka];
GRANT SELECT ON dbo.tw_Parametr TO [sprawdzarka];
Tabele potrzebne w poszczególnych programach:
| Program | Uprawnienie SELECT na tabelach |
|---|---|
| Subiekt GT | dbo.tw__Towar, dbo.tw_Cena, dbo.tw_Parametr |
| Navireo | dbo.tw__Towar, dbo.tw_Cena, dbo.tw_Parametr, dbo.tw_KodKreskowy |
| Subiekt nexo | ModelDanychContainer.Asortymenty, ModelDanychContainer.PozycjeCennika, ModelDanychContainer.Cenniki, ModelDanychContainer.JednostkiMiarAsortymentow, ModelDanychContainer.KodyKreskowe |
| Comarch ERP Optima | CDN.Towary, CDN.TwrCeny |
| WAPRO Mag | dbo.ARTYKUL, dbo.CENA_ARTYKULU, dbo.CENA |
Nie nadawaj roli db_owner ani db_datareader – ta druga daje odczyt całej bazy, łącznie z danymi kontrahentów. Po większej aktualizacji programu uruchom test połączenia; jeśli pojawi się błąd uprawnień, wykonaj ponownie polecenia GRANT.