Aller au contenu principal

Connexion à SQL Server

Subiekt GT, Subiekt nexo, Navireo, Comarch ERP Optima et WAPRO Mag stockent leurs données dans Microsoft SQL Server. La borne se connecte directement à ce serveur via le réseau et envoie une requête de lecture par scan. Cette page décrit ce que ces logiciels ont en commun ; les champs propres à chaque logiciel figurent sur sa page.

Champs communs​

ChampQue saisir
AddressL'adresse de SQL Server, avec un port ou un nom d'instance — formats ci-dessous.
UserUn identifiant SQL Server (et non un compte Windows). Utilisez un identifiant dédié en lecture seule — comment le créer.
PasswordLe mot de passe de cet identifiant.
DatabaseLe nom de la base de données de la société dans SQL Server, par ex. Nexo_MyCompany ou CDN_MyCompany.
Encrypt connection (SSL)Coché par défaut — détails.
Search by product code (SKU)Recherche par symbole / code / indice du produit. Activé par défaut.
Search by EAN codeRecherche par code-barres. Activé par défaut.

Avec les deux options de recherche activées, l'application trouve le produit aussi bien par code-barres que par symbole (lorsque le client scanne une étiquette de rayon portant le symbole). Si les deux sont désactivées, l'application recherche uniquement par symbole — comme avec SKU seul.

Format de l'adresse​

Saisie dans le champ AddressSignification
192.168.1.10Instance par défaut, port 1433.
192.168.1.10:1433 ou 192.168.1.10,1433Le port indiqué.
192.168.1.10\INSERTGTInstance nommée — le port est fourni par le service SQL Server Browser (UDP 1434).
192.168.1.10\INSERTGT,50123Instance nommée avec un port fixe — le Browser n'est pas nécessaire.

Vous pouvez copier l'adresse telle que l'affiche le logiciel (par ex. SERVER\OPTIMA). Il est toutefois plus sûr de saisir l'adresse IP plutôt que le nom de l'ordinateur : une borne Android ne résout pas toujours les noms d'ordinateurs d'un réseau Windows. Le serveur doit avoir une adresse IP fixe (ou une réservation dans le routeur), car après un changement d'adresse la borne ne se connecte plus.

Lorsque l'adresse contient un port, l'application se connecte directement à ce port et n'interroge pas le service SQL Server Browser.

Que vérifier sur le serveur​

  1. Le protocole TCP/IP est activé pour l'instance (SQL Server Configuration Manager → SQL Server Network Configuration → protocoles). Dans les éditions Express, il est souvent désactivé par défaut. Redémarrez le service SQL Server après la modification.
  2. Le port de l'instance. L'instance par défaut écoute sur le port 1433. Une instance nommée a généralement un port dynamique — le plus simple est de lui attribuer un port fixe (propriétés TCP/IP → IPAll) et de le saisir dans l'adresse.
  3. Le pare-feu Windows du serveur autorise le trafic TCP entrant vers le port de SQL Server (et UDP 1434 si vous utilisez SQL Server Browser).
  4. L'authentification SQL Server est activée (mode mixte : SQL Server et Windows). L'application se connecte uniquement avec un identifiant et un mot de passe SQL.

Chiffrement de la connexion (SSL)​

  • Coché (par défaut) — l'application chiffre la connexion si le serveur le permet ; sinon, elle se connecte sans chiffrement. Le certificat du serveur n'est pas validé : le certificat auto-signé que SQL Server crée lui-même fonctionne donc aussi.
  • Décoché — la connexion n'est pas chiffrée.

Si le serveur impose le chiffrement et que la case est décochée, le test de connexion affiche The server closed the connection. If the server requires encryption, check “Encrypt connection (SSL)”.

Avancé

Dans le champ Database, vous pouvez ajouter des paramètres du pilote jTDS après un point-virgule, par ex. Nexo_MyCompany;ssl=require ou CDN_MyCompany;loginTimeout=30. Un paramètre ajouté de cette façon remplace la valeur par défaut (ssl issu de la case à cocher, loginTimeout=15, socketTimeout=15).

Comment l'application gère la connexion​

  • La connexion s'ouvre au démarrage de l'application et après l'enregistrement des paramètres. Pendant ce temps, l'écran affiche Loading et les scans sont ignorés.
  • Si la connexion échoue, l'écran affiche No connection to the data source et Ask the store staff for help. Chaque scan suivant tente de se reconnecter — aucun redémarrage de l'application n'est nécessaire, par ex. lorsque le WiFi est apparu après la borne.
  • Si une requête échoue (connexion interrompue, redémarrage du serveur), l'application ouvre une nouvelle connexion et répète la requête. Seul un deuxième échec affiche Data download error à l'écran.
  • Après plus de 2 minutes sans scan, la connexion est rouverte avant la requête, car les pare-feu et routeurs coupent souvent silencieusement les connexions inactives.
  • L'application attend 15 secondes l'ouverture de la connexion et 15 secondes la réponse du serveur.

Identifiant SQL en lecture seule​

La borne est accrochée dans une allée du magasin et l'identifiant et le mot de passe sont stockés dans sa mémoire. N'y saisissez jamais sa ni aucun autre compte administrateur — quiconque mettrait la main sur l'appareil aurait un accès complet à la base de données de l'entreprise. Créez un identifiant dédié, qui ne peut lire que les tables dont l'application a besoin.

Exécutez le script dans SQL Server Management Studio en tant qu'administrateur du serveur. Remplacez le nom de la base, le mot de passe et la liste des tables par ceux indiqués sur la page de votre logiciel :

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

Tables nécessaires pour chaque logiciel :

LogicielAutorisation SELECT sur les tables
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

N'accordez pas db_owner ni db_datareader — ce dernier donne accès en lecture à toute la base, y compris aux données clients. Après une mise à jour majeure du logiciel, lancez le test de connexion ; si une erreur d'autorisation apparaît, exécutez de nouveau les instructions GRANT.

SQL Server — FAQ

Puis-je saisir l'identifiant sa sur la borne ?
Techniquement, cela fonctionnerait, mais ne le faites pas. L'identifiant et le mot de passe sont stockés sur un appareil accroché dans le magasin. Créez un identifiant SQL dédié avec une autorisation SELECT uniquement sur les tables de produits et de prix indiquées sur cette page pour votre logiciel.
Quel port doit être ouvert pour la borne ?
Le port TCP de SQL Server — 1433 pour l'instance par défaut, ou le port fixe défini pour une instance nommée. Si vous saisissez uniquement le nom de l'instance sans port, UDP 1434 pour le service SQL Server Browser est également nécessaire.
La borne peut-elle se connecter avec un compte Windows ?
Non. L'application se connecte avec un identifiant et un mot de passe SQL Server ; l'authentification SQL Server (mode mixte) doit donc être activée sur le serveur.
Dois-je cocher Encrypt connection (SSL) ?
Oui, laissez la case cochée comme par défaut. L'application chiffre la connexion lorsque le serveur le permet et se connecte sans chiffrement dans le cas contraire. Ne la décochez que si l'équipe de support vous le demande.
Pourquoi vaut-il mieux saisir une adresse IP plutôt que le nom de l'ordinateur ?
Android ne résout pas toujours les noms d'ordinateurs d'un réseau Windows ; un nom peut donc provoquer l'erreur Computer cannot be found on the network. L'adresse IP du serveur fonctionne toujours — veillez simplement à ce qu'elle soit fixe.