Conexiunea la SQL Server
Subiekt GT, Subiekt nexo, Navireo, Comarch ERP Optima și WAPRO Mag își păstrează datele în Microsoft SQL Server. Verificatorul de preț se conectează direct la acest server prin rețea și trimite o interogare de citire la fiecare scanare. Această pagină descrie ce au în comun aceste programe; câmpurile specifice fiecărui program se găsesc pe pagina programului respectiv.
Câmpuri comune
| Câmp | Ce introduci |
|---|---|
| Address | Adresa SQL Server, cu port sau nume de instanță — formatele sunt mai jos. |
| User | Un cont SQL Server (nu un cont Windows). Folosește un cont dedicat, doar pentru citire — cum îl creezi. |
| Password | Parola acestui cont. |
| Database | Numele bazei de date a firmei din SQL Server, de exemplu Nexo_MyCompany sau CDN_MyCompany. |
| Encrypt connection (SSL) | Bifat implicit — detalii. |
| Search by product code (SKU) | Căutare după simbolul / codul / indexul produsului. Activată implicit. |
| Search by EAN code | Căutare după codul de bare. Activată implicit. |
Cu ambele comutatoare de căutare activate, aplicația găsește produsul atât după codul de bare, cât și după simbol (când clientul scanează o etichetă de raft cu simbolul). Când ambele sunt dezactivate, aplicația caută doar după simbol — la fel ca doar cu SKU.
Formatul adresei
| Valoare în câmpul Address | Semnificație |
|---|---|
192.168.1.10 | Instanța implicită, portul 1433. |
192.168.1.10:1433 sau 192.168.1.10,1433 | Portul indicat. |
192.168.1.10\INSERTGT | Instanță cu nume — portul este furnizat de serviciul SQL Server Browser (UDP 1434). |
192.168.1.10\INSERTGT,50123 | Instanță cu nume și port fix — Browser nu este necesar. |
Poți copia adresa așa cum o arată programul (de exemplu SERVER\OPTIMA). Este însă mai sigur să introduci adresa IP în locul numelui calculatorului: un verificator de preț cu Android nu rezolvă întotdeauna numele calculatoarelor dintr-o rețea Windows. Serverul ar trebui să aibă o adresă IP fixă (sau o rezervare în router), deoarece după schimbarea adresei verificatorul de preț nu se mai conectează.
Când adresa conține un port, aplicația se conectează direct la acel port și nu interoghează serviciul SQL Server Browser.
Ce verifici pe server
- Protocolul TCP/IP este activat pentru instanță (SQL Server Configuration Manager → SQL Server Network Configuration → protocoale). În edițiile Express este adesea dezactivat implicit. După modificare, repornește serviciul SQL Server.
- Portul instanței. Instanța implicită ascultă pe 1433. O instanță cu nume are de obicei un port dinamic — cel mai simplu este să îi stabilești un port fix (proprietățile TCP/IP → IPAll) și să îl introduci în adresă.
- Windows Firewall de pe server permite traficul TCP de intrare către portul SQL Server (și UDP 1434, dacă te bazezi pe SQL Server Browser).
- Autentificarea SQL Server este activată (mod mixt: SQL Server și Windows). Aplicația se autentifică doar cu un cont SQL și o parolă.
Criptarea conexiunii (SSL)
- Bifat (implicit) — aplicația criptează conexiunea dacă serverul o acceptă; dacă nu, se conectează necriptat. Certificatul serverului nu este validat, deci funcționează și certificatul autosemnat pe care SQL Server îl creează singur.
- Nebifat — conexiunea nu este criptată.
Dacă serverul impune criptarea, iar caseta nu este bifată, testul conexiunii afișează The server closed the connection. If the server requires encryption, check “Encrypt connection (SSL)”.
În câmpul Database poți adăuga după punct și virgulă parametri ai driverului jTDS, de exemplu Nexo_MyCompany;ssl=require sau CDN_MyCompany;loginTimeout=30. Un parametru adăugat în acest fel înlocuiește valoarea implicită (ssl din casetă, loginTimeout=15, socketTimeout=15).
Cum menține aplicația conexiunea
- Conexiunea se deschide la pornirea aplicației și după salvarea setărilor. În acest timp ecranul afișează Loading, iar scanările sunt ignorate.
- Dacă conexiunea eșuează, ecranul afișează No connection to the data source și Ask the store staff for help. Fiecare scanare următoare încearcă din nou să se conecteze — nu este nevoie să repornești aplicația, de exemplu atunci când WiFi-ul a apărut mai târziu decât verificatorul de preț.
- Dacă o interogare eșuează (conexiune întreruptă, repornirea serverului), aplicația deschide o conexiune nouă și repetă interogarea. Abia un al doilea eșec afișează pe ecran Data download error.
- După mai mult de 2 minute fără scanări, conexiunea este redeschisă înainte de interogare, deoarece firewall-urile și routerele întrerup adesea în tăcere conexiunile inactive.
- Aplicația așteaptă 15 secunde deschiderea conexiunii și 15 secunde răspunsul serverului.
Autentificare SQL doar pentru citire
Verificatorul de preț stă atârnat în culoarul magazinului, iar numele de utilizator și parola sunt stocate în memoria lui. Nu introduce niciodată pe el contul sa sau alt cont de administrator — oricine ajunge la dispozitiv ar avea acces complet la baza de date a firmei. Creează un cont dedicat, care poate citi doar tabelele de care are nevoie aplicația.
Rulează scriptul în SQL Server Management Studio ca administrator al serverului. Înlocuiește numele bazei de date, parola și lista de tabele cu cele de pe pagina programului tău:
USE [master];
CREATE LOGIN [pricechecker] WITH PASSWORD = N'Put-a-long-password-here', CHECK_POLICY = ON, DEFAULT_DATABASE = [CompanyDatabase];
USE [CompanyDatabase];
CREATE USER [pricechecker] FOR LOGIN [pricechecker];
-- only the tables the price checker reads:
GRANT SELECT ON dbo.tw__Towar TO [pricechecker];
GRANT SELECT ON dbo.tw_Cena TO [pricechecker];
GRANT SELECT ON dbo.tw_Parametr TO [pricechecker];
Tabelele necesare fiecărui program:
| Program | Permisiunea SELECT pe tabele |
|---|---|
| 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 |
Nu acorda db_owner sau db_datareader — acesta din urmă dă drept de citire asupra întregii baze de date, inclusiv a datelor clienților. După o actualizare majoră a programului, rulează testul conexiunii; dacă apare o eroare de permisiuni, rulează din nou instrucțiunile GRANT.