Zum Hauptinhalt springen

SQL-Server-Verbindung

Subiekt GT, Subiekt nexo, Navireo, Comarch ERP Optima und WAPRO Mag speichern ihre Daten in Microsoft SQL Server. Der Preisprüfer verbindet sich direkt über das Netzwerk mit diesem Server und sendet pro Scan eine Leseabfrage. Diese Seite behandelt, was diesen Programmen gemeinsam ist; die programmspezifischen Felder stehen auf der Seite des jeweiligen Programms.

Gemeinsame Felder​

FeldWas einzutragen ist
AddressDie SQL-Server-Adresse mit Port oder Instanzname — Formate siehe unten.
UserEin SQL-Server-Login (kein Windows-Konto). Verwenden Sie einen eigenen schreibgeschützten Login — so legen Sie ihn an.
PasswordDas Passwort dieses Logins.
DatabaseDer Name der Firmendatenbank in SQL Server, z. B. Nexo_MyCompany oder CDN_MyCompany.
Encrypt connection (SSL)Standardmäßig aktiviert — Details.
Search by product code (SKU)Suche nach Produktsymbol / -code / -index. Standardmäßig aktiviert.
Search by EAN codeSuche nach Barcode. Standardmäßig aktiviert.

Sind beide Suchschalter aktiviert, findet die App das Produkt sowohl über den Barcode als auch über das Symbol (wenn der Kunde ein Regaletikett mit dem Symbol scannt). Sind beide deaktiviert, sucht die App nur nach dem Symbol — genau wie mit SKU allein.

Adressformat​

Eintrag im Feld AddressBedeutung
192.168.1.10Standardinstanz, Port 1433.
192.168.1.10:1433 oder 192.168.1.10,1433Der angegebene Port.
192.168.1.10\INSERTGTBenannte Instanz — den Port liefert der Dienst SQL Server Browser (UDP 1434).
192.168.1.10\INSERTGT,50123Benannte Instanz mit festem Port — der Browser wird nicht benötigt.

Sie können die Adresse so übernehmen, wie das Programm sie anzeigt (z. B. SERVER\OPTIMA). Sicherer ist es jedoch, statt des Computernamens die IP-Adresse einzutragen: Ein Android-Preisprüfer löst Computernamen aus einem Windows-Netzwerk nicht immer auf. Der Server sollte eine feste IP-Adresse haben (oder eine Reservierung im Router), denn nach einer Adressänderung kann sich der Preisprüfer nicht mehr verbinden.

Enthält die Adresse einen Port, verbindet sich die App direkt mit diesem Port und fragt den Dienst SQL Server Browser nicht ab.

Was auf dem Server zu prüfen ist​

  1. Das TCP/IP-Protokoll ist aktiviert für die Instanz (SQL Server Configuration Manager → SQL Server Network Configuration → Protocols). In den Express-Editionen ist es oft standardmäßig deaktiviert. Starten Sie nach der Änderung den Dienst SQL Server neu.
  2. Der Instanzport. Die Standardinstanz lauscht auf 1433. Eine benannte Instanz hat meist einen dynamischen Port — am einfachsten legen Sie dafür einen festen Port fest (Eigenschaften von TCP/IP → IPAll) und tragen ihn in die Adresse ein.
  3. Die Windows-Firewall auf dem Server lässt eingehenden TCP-Verkehr zum SQL-Server-Port zu (und UDP 1434, wenn Sie sich auf SQL Server Browser verlassen).
  4. Die SQL-Server-Authentifizierung ist aktiviert (gemischter Modus: SQL Server und Windows). Die App meldet sich ausschließlich mit SQL-Login und Passwort an.

Verbindungsverschlüsselung (SSL)​

  • Aktiviert (Standard) — die App verschlüsselt die Verbindung, wenn der Server dies unterstützt; andernfalls verbindet sie sich unverschlüsselt. Das Serverzertifikat wird nicht geprüft, sodass auch das selbstsignierte Zertifikat funktioniert, das SQL Server selbst erstellt.
  • Deaktiviert — die Verbindung wird nicht verschlüsselt.

Erzwingt der Server die Verschlüsselung und das Kontrollkästchen ist deaktiviert, zeigt der Verbindungstest The server closed the connection. If the server requires encryption, check “Encrypt connection (SSL)”. an.

Für Fortgeschrittene

Im Feld Database können Sie nach einem Semikolon Parameter des jTDS-Treibers anhängen, z. B. Nexo_MyCompany;ssl=require oder CDN_MyCompany;loginTimeout=30. Ein so angegebener Parameter überschreibt den Standardwert (ssl aus dem Kontrollkästchen, loginTimeout=15, socketTimeout=15).

Wie die App die Verbindung hält​

  • Die Verbindung wird beim Start der App und nach dem Speichern der Einstellungen geöffnet. Währenddessen zeigt der Bildschirm Loading, und Scans werden ignoriert.
  • Schlägt die Verbindung fehl, zeigt der Bildschirm No connection to the data source und Ask the store staff for help. Jeder folgende Scan versucht erneut, die Verbindung herzustellen — ein Neustart der App ist nicht nötig, z. B. wenn das WLAN später verfügbar war als der Preisprüfer.
  • Schlägt eine Abfrage fehl (unterbrochene Verbindung, Serverneustart), öffnet die App eine neue Verbindung und wiederholt die Abfrage. Erst ein zweiter Fehlschlag zeigt Data download error auf dem Bildschirm.
  • Nach mehr als 2 Minuten ohne Scans wird die Verbindung vor der Abfrage neu geöffnet, weil Firewalls und Router inaktive Verbindungen oft stillschweigend trennen.
  • Die App wartet 15 Sekunden auf das Öffnen der Verbindung und 15 Sekunden auf die Antwort des Servers.

Schreibgeschützter SQL-Login​

Der Preisprüfer hängt im Verkaufsraum, und Login und Passwort liegen in seinem Speicher. Tragen Sie dort niemals sa oder ein anderes Administratorkonto ein — wer das Gerät in die Hände bekommt, hätte vollen Zugriff auf die Firmendatenbank. Legen Sie einen eigenen Login an, der nur die von der App benötigten Tabellen lesen kann.

Führen Sie das Skript in SQL Server Management Studio als Serveradministrator aus. Ersetzen Sie Datenbanknamen, Passwort und Tabellenliste durch die Angaben von der Seite Ihres Programms:

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

Von den einzelnen Programmen benötigte Tabellen:

ProgrammSELECT-Berechtigung auf 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

Vergeben Sie weder db_owner noch db_datareader — Letzteres gibt Lesezugriff auf die gesamte Datenbank, einschließlich Kundendaten. Führen Sie nach einem größeren Programmupdate den Verbindungstest aus; erscheint ein Berechtigungsfehler, führen Sie die GRANT-Anweisungen erneut aus.

SQL Server — FAQ

Darf ich den Login sa auf dem Preisprüfer eintragen?
Technisch würde es funktionieren, tun Sie es aber nicht. Login und Passwort werden auf einem Gerät gespeichert, das im Geschäft hängt. Legen Sie einen eigenen SQL-Login mit SELECT-Berechtigung nur auf die auf dieser Seite für Ihr Programm aufgeführten Produkt- und Preistabellen an.
Welcher Port muss für den Preisprüfer geöffnet sein?
Der TCP-Port von SQL Server — 1433 für die Standardinstanz oder der für eine benannte Instanz festgelegte Port. Wenn Sie nur den Instanznamen ohne Port eintragen, wird zusätzlich UDP 1434 für den Dienst SQL Server Browser benötigt.
Kann sich der Preisprüfer mit einem Windows-Konto anmelden?
Nein. Die App meldet sich mit einem SQL-Server-Login und Passwort an, daher muss auf dem Server die SQL-Server-Authentifizierung (gemischter Modus) aktiviert sein.
Sollte ich Encrypt connection (SSL) aktivieren?
Ja, lassen Sie das Kontrollkästchen wie standardmäßig aktiviert. Die App verschlüsselt die Verbindung, wenn der Server dies unterstützt, und verbindet sich unverschlüsselt, wenn nicht. Deaktivieren Sie es nur auf Anweisung des Serviceteams.
Warum ist es besser, eine IP-Adresse statt des Computernamens einzutragen?
Android löst Computernamen aus einem Windows-Netzwerk nicht immer auf, sodass ein Name den Fehler Computer cannot be found on the network auslösen kann. Die IP-Adresse des Servers funktioniert immer — achten Sie nur darauf, dass sie fest ist.