Ga naar hoofdinhoud

SQL Server-verbinding

Subiekt GT, Subiekt nexo, Navireo, Comarch ERP Optima en WAPRO Mag bewaren hun gegevens in Microsoft SQL Server. De prijsscanner maakt rechtstreeks via het netwerk verbinding met deze server en stuurt per scan één leesopdracht. Deze pagina behandelt wat deze programma's gemeen hebben; de programmaspecifieke velden staan op de pagina van elk programma.

Gemeenschappelijke velden​

VeldWat in te vullen
AddressHet adres van SQL Server, met een poort of een instantienaam — formaten hieronder.
UserEen SQL Server-login (geen Windows-account). Gebruik een speciale login met alleen leesrechten — zo maakt u die aan.
PasswordHet wachtwoord van die login.
DatabaseDe naam van de bedrijfsdatabase in SQL Server, bijv. Nexo_MyCompany of CDN_MyCompany.
Encrypt connection (SSL)Standaard aangevinkt — details.
Search by product code (SKU)Zoeken op het symbool / de code / de index van het product. Standaard aan.
Search by EAN codeZoeken op streepjescode. Standaard aan.

Met beide zoekschakelaars aan vindt de app het product zowel op streepjescode als op symbool (wanneer de klant een schapetiket met het symbool scant). Staan beide uit, dan zoekt de app alleen op symbool — hetzelfde als met alleen SKU.

Adresformaat​

Invoer in het veld AddressBetekenis
192.168.1.10Standaardinstantie, poort 1433.
192.168.1.10:1433 of 192.168.1.10,1433De opgegeven poort.
192.168.1.10\INSERTGTBenoemde instantie — de poort wordt geleverd door de service SQL Server Browser (UDP 1434).
192.168.1.10\INSERTGT,50123Benoemde instantie met een vaste poort — de Browser is niet nodig.

U kunt het adres overnemen zoals het programma het toont (bijv. SERVER\OPTIMA). Veiliger is het echter om in plaats van de computernaam het IP-adres in te vullen: een Android-prijsscanner kan computernamen uit een Windows-netwerk niet altijd omzetten. De server moet een vast IP-adres hebben (of een reservering in de router), omdat de prijsscanner na een adreswijziging geen verbinding meer maakt.

Als het adres een poort bevat, maakt de app direct verbinding met die poort en raadpleegt hij de service SQL Server Browser niet.

Wat u op de server moet controleren​

  1. Het TCP/IP-protocol is ingeschakeld voor de instantie (SQL Server Configuration Manager → SQL Server Network Configuration → protocollen). In Express-edities is het vaak standaard uitgeschakeld. Herstart na de wijziging de service SQL Server.
  2. De poort van de instantie. De standaardinstantie luistert op 1433. Een benoemde instantie heeft meestal een dynamische poort — het eenvoudigst is er een vaste poort voor in te stellen (eigenschappen van TCP/IP → IPAll) en die in het adres in te voeren.
  3. Windows Firewall op de server staat inkomend TCP-verkeer naar de SQL Server-poort toe (en UDP 1434 als u op SQL Server Browser vertrouwt).
  4. SQL Server-verificatie is ingeschakeld (gemengde modus: SQL Server en Windows). De app meldt zich alleen aan met een SQL-login en wachtwoord.

Verbindingsversleuteling (SSL)​

  • Aangevinkt (standaard) — de app versleutelt de verbinding als de server dit ondersteunt; zo niet, dan verbindt hij onversleuteld. Het servercertificaat wordt niet gevalideerd, dus ook het zelfondertekende certificaat dat SQL Server zelf aanmaakt werkt.
  • Niet aangevinkt — de verbinding wordt niet versleuteld.

Als de server versleuteling afdwingt en het vakje is niet aangevinkt, toont de verbindingstest The server closed the connection. If the server requires encryption, check “Encrypt connection (SSL)”.

Geavanceerd

In het veld Database kunt u na een puntkomma parameters van het jTDS-stuurprogramma toevoegen, bijv. Nexo_MyCompany;ssl=require of CDN_MyCompany;loginTimeout=30. Een op die manier toegevoegde parameter overschrijft de standaardwaarde (ssl uit het selectievakje, loginTimeout=15, socketTimeout=15).

Hoe de app de verbinding onderhoudt​

  • De verbinding wordt geopend bij het starten van de app en nadat de instellingen zijn opgeslagen. Gedurende die tijd toont het scherm Loading en worden scans genegeerd.
  • Mislukt de verbinding, dan toont het scherm No connection to the data source en Ask the store staff for help. Elke volgende scan probeert opnieuw verbinding te maken — een herstart van de app is niet nodig, bijv. wanneer de wifi later beschikbaar kwam dan de prijsscanner.
  • Mislukt een opdracht (verbroken verbinding, herstart van de server), dan opent de app een nieuwe verbinding en herhaalt de opdracht. Pas een tweede mislukking toont Data download error op het scherm.
  • Na meer dan 2 minuten zonder scans wordt de verbinding vóór de opdracht opnieuw geopend, omdat firewalls en routers inactieve verbindingen vaak stilzwijgend verbreken.
  • De app wacht 15 seconden tot de verbinding is geopend en 15 seconden op het antwoord van de server.

Alleen-lezen SQL-login​

De prijsscanner hangt in het winkelpad en de login en het wachtwoord staan in zijn geheugen. Voer er nooit sa of een ander beheerdersaccount in — wie het apparaat in handen krijgt, zou volledige toegang tot de bedrijfsdatabase hebben. Maak een speciale login aan die alleen de tabellen kan lezen die de app nodig heeft.

Voer het script uit in SQL Server Management Studio als serverbeheerder. Vervang de databasenaam, het wachtwoord en de lijst met tabellen door die van de pagina van uw 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];

Tabellen die elk programma nodig heeft:

ProgrammaSELECT-recht op tabellen
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

Verleen geen db_owner of db_datareader — die laatste geeft leestoegang tot de hele database, inclusief klantgegevens. Voer na een grote update van het programma de verbindingstest uit; verschijnt er een rechtenfout, voer dan de GRANT-opdrachten opnieuw uit.

SQL Server — veelgestelde vragen

Kan ik de login sa op de prijsscanner invoeren?
Technisch zou het werken, maar doe het niet. De login en het wachtwoord worden opgeslagen op een apparaat dat in de winkel hangt. Maak een speciale SQL-login aan met alleen SELECT-recht op de product- en prijstabellen die op deze pagina voor uw programma staan vermeld.
Welke poort moet voor de prijsscanner open staan?
De TCP-poort van SQL Server — 1433 voor de standaardinstantie, of de vaste poort die voor een benoemde instantie is ingesteld. Voert u alleen de instantienaam zonder poort in, dan is ook UDP 1434 voor de service SQL Server Browser nodig.
Kan de prijsscanner zich aanmelden met een Windows-account?
Nee. De app meldt zich aan met een SQL Server-login en wachtwoord, dus SQL Server-verificatie (gemengde modus) moet op de server zijn ingeschakeld.
Moet ik Encrypt connection (SSL) aanvinken?
Ja, laat het aangevinkt zoals standaard. De app versleutelt de verbinding als de server dit ondersteunt en verbindt onversleuteld als dat niet het geval is. Vink het alleen uit wanneer het serviceteam u dat zegt.
Waarom is het beter een IP-adres in te voeren in plaats van de computernaam?
Android kan computernamen uit een Windows-netwerk niet altijd omzetten, waardoor een naam de fout Computer cannot be found on the network kan geven. Het IP-adres van de server werkt altijd — zorg er alleen voor dat het vast is.