Przejdź do głównej zawartości

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​

PoleCo wpisać
AdresAdres serwera SQL, z portem albo nazwą instancji – formaty niżej.
UżytkownikLogin SQL Server (nie konto Windows). Użyj osobnego loginu tylko do odczytu – jak go założyć.
HasłoHasło tego loginu.
Baza danychNazwa 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 EANSzukanie 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 AdresZnaczenie
192.168.1.10Instancja domyślna, port 1433.
192.168.1.10:1433 albo 192.168.1.10,1433Podany port.
192.168.1.10\INSERTGTInstancja nazwana – port podaje usługa SQL Server Browser (UDP 1434).
192.168.1.10\INSERTGT,50123Instancja 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​

  1. 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.
  2. 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.
  3. Zapora Windows na serwerze przepuszcza ruch przychodzący TCP na port SQL Servera (i UDP 1434, jeśli korzystasz z SQL Server Browser).
  4. 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)”.

Dla zaawansowanych

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:

ProgramUprawnienie SELECT na tabelach
Subiekt GTdbo.tw__Towar, dbo.tw_Cena, dbo.tw_Parametr
Navireodbo.tw__Towar, dbo.tw_Cena, dbo.tw_Parametr, dbo.tw_KodKreskowy
Subiekt nexoModelDanychContainer.Asortymenty, ModelDanychContainer.PozycjeCennika, ModelDanychContainer.Cenniki, ModelDanychContainer.JednostkiMiarAsortymentow, ModelDanychContainer.KodyKreskowe
Comarch ERP OptimaCDN.Towary, CDN.TwrCeny
WAPRO Magdbo.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.

SQL Server — najczęstsze pytania

Czy do sprawdzarki cen mogę wpisać login sa?
Technicznie zadziała, ale nie rób tego. Login i hasło są zapisane w urządzeniu, które wisi w sklepie. Załóż osobny login SQL z uprawnieniem SELECT tylko na tabelach towarów i cen, wymienionych na tej stronie dla Twojego programu.
Jaki port musi być otwarty dla sprawdzarki cen?
Port TCP SQL Servera – 1433 dla instancji domyślnej albo stały port ustawiony dla instancji nazwanej. Jeśli w adresie podajesz tylko nazwę instancji bez portu, potrzebny jest też UDP 1434 dla usługi SQL Server Browser.
Czy sprawdzarka może zalogować się kontem Windows?
Nie. Aplikacja loguje się loginem i hasłem SQL Server, dlatego na serwerze musi być włączone uwierzytelnianie SQL Server (tryb mieszany).
Czy zaznaczać Szyfrowanie połączenia (SSL)?
Tak, zostaw domyślnie zaznaczone. Aplikacja szyfruje połączenie, gdy serwer to obsługuje, a gdy nie – łączy się bez szyfrowania. Odznacz je tylko wtedy, gdy wskaże to serwis.
Dlaczego lepiej wpisać adres IP zamiast nazwy komputera?
Android nie zawsze rozpoznaje nazwy komputerów z sieci Windows, więc nazwa może dać błąd Nie można znaleźć komputera w sieci. Adres IP serwera działa zawsze – zadbaj tylko, żeby był stały.