Passa al contenuto principale

Connessione a SQL Server

Subiekt GT, Subiekt nexo, Navireo, Comarch ERP Optima e WAPRO Mag conservano i dati in Microsoft SQL Server. Il lettore di prezzi si collega direttamente a questo server attraverso la rete e invia una query di sola lettura per ogni scansione. Questa pagina tratta ciò che questi programmi hanno in comune; i campi specifici sono nella pagina di ciascun programma.

Campi comuni​

CampoCosa inserire
Address (Indirizzo)L'indirizzo di SQL Server, con una porta o un nome di istanza: formati più sotto.
User (Utente)Un login SQL Server (non un account Windows). Usa un login dedicato di sola lettura: come crearlo.
PasswordLa password di quel login.
DatabaseIl nome del database dell'azienda in SQL Server, ad es. Nexo_MyCompany o CDN_MyCompany.
Encrypt connection (SSL) (Crittografa la connessione)Selezionato per impostazione predefinita: dettagli.
Search by product code (SKU) (Cerca per codice prodotto)Ricerca per simbolo / codice / indice del prodotto. Attivo per impostazione predefinita.
Search by EAN code (Cerca per codice EAN)Ricerca per codice a barre. Attivo per impostazione predefinita.

Con entrambi gli interruttori di ricerca attivi, l'app trova il prodotto sia per codice a barre sia per simbolo (quando il cliente scansiona un'etichetta di scaffale con il simbolo). Se entrambi sono disattivati, l'app cerca solo per simbolo, come con il solo SKU.

Formato dell'indirizzo​

Voce nel campo AddressSignificato
192.168.1.10Istanza predefinita, porta 1433.
192.168.1.10:1433 oppure 192.168.1.10,1433La porta indicata.
192.168.1.10\INSERTGTIstanza denominata: la porta è fornita dal servizio SQL Server Browser (UDP 1434).
192.168.1.10\INSERTGT,50123Istanza denominata con porta fissa: il Browser non serve.

Puoi copiare l'indirizzo così come lo mostra il programma (ad es. SERVER\OPTIMA). È però più sicuro inserire l'indirizzo IP al posto del nome del computer: un lettore di prezzi Android non sempre risolve i nomi dei computer di una rete Windows. Il server dovrebbe avere un indirizzo IP fisso (o una prenotazione nel router), perché dopo un cambio di indirizzo il lettore non si collega più.

Quando l'indirizzo contiene una porta, l'app si collega direttamente a quella porta e non interroga il servizio SQL Server Browser.

Cosa verificare sul server​

  1. Il protocollo TCP/IP è abilitato per l'istanza (SQL Server Configuration Manager → SQL Server Network Configuration → protocolli). Nelle edizioni Express spesso è disabilitato per impostazione predefinita. Dopo la modifica riavvia il servizio SQL Server.
  2. La porta dell'istanza. L'istanza predefinita ascolta sulla 1433. Un'istanza denominata di solito ha una porta dinamica: il modo più semplice è impostarle una porta fissa (proprietà TCP/IP → IPAll) e inserirla nell'indirizzo.
  3. Windows Firewall sul server consente il traffico TCP in ingresso verso la porta di SQL Server (e UDP 1434 se ti affidi a SQL Server Browser).
  4. L'autenticazione SQL Server è abilitata (modalità mista: SQL Server e Windows). L'app accede solo con login e password SQL.

Crittografia della connessione (SSL)​

  • Selezionato (predefinito): l'app crittografa la connessione se il server lo supporta; in caso contrario si collega senza crittografia. Il certificato del server non viene convalidato, quindi funziona anche il certificato autofirmato che SQL Server crea da solo.
  • Non selezionato: la connessione non è crittografata.

Se il server impone la crittografia e la casella non è selezionata, il test di connessione mostra The server closed the connection. If the server requires encryption, check “Encrypt connection (SSL)”.

Avanzate

Nel campo Database puoi aggiungere, dopo un punto e virgola, parametri del driver jTDS, ad es. Nexo_MyCompany;ssl=require oppure CDN_MyCompany;loginTimeout=30. Un parametro aggiunto in questo modo sostituisce il valore predefinito (ssl della casella, loginTimeout=15, socketTimeout=15).

Come l'app mantiene la connessione​

  • La connessione si apre all'avvio dell'app e dopo il salvataggio delle impostazioni. In quel periodo lo schermo mostra Loading e le scansioni vengono ignorate.
  • Se la connessione non riesce, lo schermo mostra No connection to the data source e Ask the store staff for help. Ogni scansione successiva tenta di nuovo la connessione: non serve riavviare l'app, ad es. quando il WiFi è partito dopo il lettore.
  • Se una query fallisce (connessione caduta, riavvio del server), l'app apre una nuova connessione e ripete la query. Solo un secondo errore mostra Data download error sullo schermo.
  • Dopo più di 2 minuti senza scansioni, la connessione viene riaperta prima della query, perché firewall e router spesso chiudono in silenzio le connessioni inattive.
  • L'app attende 15 secondi per l'apertura della connessione e 15 secondi per la risposta del server.

Login SQL di sola lettura​

Il lettore di prezzi è appeso tra gli scaffali del negozio e il login e la password sono salvati nella sua memoria. Non inserire mai sa né altri account amministratore: chiunque entrasse in possesso del dispositivo avrebbe pieno accesso al database aziendale. Crea un login dedicato che possa leggere solo le tabelle necessarie all'app.

Esegui lo script in SQL Server Management Studio come amministratore del server. Sostituisci il nome del database, la password e l'elenco delle tabelle con quelli della pagina del tuo programma:

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];

Tabelle necessarie per ciascun programma:

ProgrammaPermesso SELECT sulle tabelle
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

Non concedere db_owner né db_datareader: quest'ultimo dà accesso in lettura all'intero database, compresi i dati dei clienti. Dopo un aggiornamento importante del programma esegui il test di connessione; se compare un errore di permessi, esegui di nuovo le istruzioni GRANT.

SQL Server — FAQ

Posso inserire il login sa sul lettore di prezzi?
Tecnicamente funzionerebbe, ma non farlo. Il login e la password sono salvati su un dispositivo appeso nel negozio. Crea un login SQL dedicato con il permesso SELECT solo sulle tabelle dei prodotti e dei prezzi elencate in questa pagina per il tuo programma.
Quale porta deve essere aperta per il lettore di prezzi?
La porta TCP di SQL Server: 1433 per l'istanza predefinita, oppure la porta fissa impostata per un'istanza denominata. Se inserisci solo il nome dell'istanza senza la porta, serve anche UDP 1434 per il servizio SQL Server Browser.
Il lettore di prezzi può accedere con un account Windows?
No. L'app accede con un login e una password di SQL Server, quindi sul server deve essere abilitata l'autenticazione SQL Server (modalità mista).
Devo selezionare Encrypt connection (SSL)?
Sì, lascia la casella selezionata come per impostazione predefinita. L'app crittografa la connessione quando il server lo supporta e si collega senza crittografia quando non lo supporta. Deselezionala solo se te lo indica il servizio di assistenza.
Perché è meglio inserire un indirizzo IP invece del nome del computer?
Android non sempre risolve i nomi dei computer di una rete Windows, quindi un nome può causare l'errore Computer cannot be found on the network. L'indirizzo IP del server funziona sempre: assicurati solo che sia fisso.