f$SQLDriverConnect

Aufbau einer ODBC-Verbindung zu einer Datenbank. Die zurückgegebene Kanalnummer muss bei allen folgenden Zugriffen angegeben werden.

Anmerkung: Da das Aufbauen einer Verbindung etwas Zeit benötigt, sollte nicht für jede SQL-Funktion eine neue Verbindung hergestellt werden.

Tipp:

Die Funktion f$SQLDriverConnect kann ebenfalls Datei-Datenquellen verwenden. Diese bieten gegenüber den Benutzer- oder Systemdatenquellen den Vorteil, dass sie nicht auf jedem ePOS Anwender-PC installiert werden müssen, sondern sie können zentral auf einem Netzlaufwerk erstellt (und auch transportiert) werden.

Mit f$SQLDriverConnect kann eine Verbindung zur Datenbank aufgebaut werden, die ohne Datenquellen auskommt. Dabei müssen alle benötigten Verbindungsinformationen im Verbindungsstring angegeben sein.

Ebenfalls im Unterschied zu f$SQLConnect können hier weitere Verbindungsinformationen angegeben werden (siehe die jeweilige Datenbank-Dokumentation).

Syntax:	Kanal = f$SQLDriverConnect( ConnectStr )
	Argument	Typ	Bedeutung
	ConnectStr	Zeichenkette	Text mit Verbindungsinformationen für die Datenbank. Allg. Aufbau: eine Liste der Form "<Schlüssel>=<Wert>", durch „;" getrennt. Die Liste darf keine Leerzeichen zur Trennung enthalten (wohl aber als Teil des Wertes). Für die Identifikation der Datenbank muss ein Schlüssel aus folgender Liste angegeben werden: DSN: Name der User- oder System-Datenquelle FILEDSN: Name der Datei-Datenquelle (incl. Erweiterung) DRIVER: Name des ODBC-Treibers Für den Verbindungsaufbau zusätzlich: UID: Username (Wert kann leer bleiben) PWD: Passwort (Wert kann leer bleiben) sowie weitere Schlüssel gemäß der angesprochenen Datenbank (siehe Dokumentation des entsprechenden Treibers)
Ergebnis:	Ganzzahl	Kanalnummer oder –1, wenn die Verbindung nicht hergestellt werden kann.
Beispiele:	Verwendung einer Datei-Datenquelle: Kanal = f$SQLDriverConnect( 'FILEDSN=Artikel.dsn;UID=Müller;PWD=abc' ) Verwendung einer Benutzer-Datenquelle ohne Login-Information: Kanal = f$SQLDriverConnect( 'DSN=Standard Artikel;UID=;PWD=' ) Direktes Verbinden zu einer Datenbank: CN = 'DRIVER=SQL Server;SERVER=DBSQLSERVER;DATABASE=SMP_NG;UID=SMP;PWD=smp' Kanal = f$SQLDriverConnect( CN ) Direktes Verbinden zu einer Excel Arbeitsmappe ExcelDatei = 'C:\\Temp\\Beispiel.xls'; CN = 'DRIVER=Microsoft Excel Driver (*.xls);DBQ=' + ExcelDatei; Kanal = f$SQLDriverConnect( CN )

Direktes Verbinden zu einer Excel Arbeitsmappe

ExcelDatei = ’C:\\Temp\\Beispiel.xls’;

CN = ’DRIVER=Microsoft Excel Driver (*.xls);DBQ=’ + ExcelDatei;

Kanal = f$SQLDriverConnect( CN )

Verwandte Funktionen:

f$SQLConnectf$SQLConnect	Aufbau einer ODBC-Verbindung (Benutzer- oder System-DSN)
f$SQLDisconnectf$SQLDisconnect	Beenden einer ODBC-Verbindung