4.7.2. Datenbankverbindung

Definieren Sie in Kategorie Datenbankverbindung [Database connection], wie auf die Datenbank (z.B. MSSQL, Oracle, etc.) zugegriffen wird.

[Hinweis]Hinweis

In V12.6 wurde das Konfigurationskonzept geändert. Eine dbproxy.cfg gibt es nicht mehr. Die Konfiguration findet sich nun in odbc.cfg bzw. jdbc.cfg. Das heißt, die Datenbankverbindung muss modifiziert werden und der Login wird ohne Anpassung zunächst fehlschlagen.

Voraussetzungen:

  • ODBC-Treiber: Die Funktionalität zur Verwendung von ODBC ist automatisch vorhanden.

    Wird die Datenbank über den AppServer, gefahren, dann muss der ODBC-Treiber nur auf dem Server installiert sein. Nur wenn die Datenbank direkt angesteuert wird, braucht man ihn auch auf den Clients.

    Wählen Sie im Dialogbereich Verfügbare Datenbankverbindungen [Available database connections] im Listenfeld Vorlage [Template] "MSSQL via ODBC".

  • JDBC-Treiber:

    Alle unter libs/all/java/jar installierten Treiber werden im Dialogbereich Verfügbare Datenbankverbindungen [Available database connections] im Listenfeld Vorlage [Template] aufgelistet (die genannten werden mit ausgeliefert und sind immer vorhanden).

    Weitere müssen beim jeweiligen Hersteller (Oracle, Microsoft) heruntergeladen werden und in das Verzeichnis libs/all/java/jar kopiert werden. Sie werden NICHT CADENAS-seitig mitinstalliert.

    Laden Sie diese bitte unter einer der folgenden Adressen herunter:

    Danach können sie unter Vorlage [Template] ebenfalls ausgewählt werden.

Datenbankverbindung anlegen:

Legen Sie mittels Button Neu [New] benötige Datenbankverbindungen an und füllen Sie rechts daneben die jeweiligen Felder aus. Wählen Sie dann unter Aktive Datenbankverbindung [Active database connection] die gewünschte aus.

Sie können unter Aktive Datenbankverbindung [Active database connection] auch eine Variable eintragen. Tragen Sie beispielsweise $DATABASETYPE ein und legen Sie diese Variable z.B. in der start.env an.

[ENVIRONS]
CADENAS=%DirOfThisFile%
CADENAS_SETUP=C:\ProgramData\PARTsolutions\setup
CADENAS_DEFAULTUSER=$CADENAS_SETUP\user\default_user
CADENAS_SITESETUP=C:\ProgramData\PARTsolutions\sitesetup
CADENAS_USER=%UserAppData%\PARTsolutions\user
CADENAS_LICENSE=$CADENAS_SITESETUP\lic
CADENAS_POOL=C:\ProgramData\PARTsolutions\pool
CADENAS_DATA=C:\data\
DATABASETYPE=group1

Legen Sie nun mittels Neu [New] Verbindungen an, auf welche der Wert von DATABASETYPE referenziert.

Einstellungsoptionen:

  • Aktive Datenbankverbindung [Active database connection]:

    Wählen Sie die gewünschte Aktive Datenbankverbindung [Active database connection]. Der Name muss mit einer der verfügbaren Datenbankverbindungen übereinstimmen.

  • Wählen Sie eine Vorlage [Template].

    -> Der entsprechende Verbindungsstring wird eingetragen.

  • Wählen Sie den Verbindungstyp [Connection type] JDBC oder ODBC.

  • Der Punkt Treiber-Klasse [Driver Class] entfällt bei ODBC. Die Auswahloptionen bei JDBC sind "net.sourceforge.jtds.jdbc.Driver" und "SQLite.JDBC.Driver".

  • Verbindungsstring [Connection String]: Ersetzen Sie die Platzhalter mit den tatsächlichen Daten.

    Der Verbindungsstring [Connection String] enthält alle benötigen Informationen für den Zugriff auf die LinkDB. (Die Notwendigkeit der Einrichtung der ODBC-Datenquelle entfällt.) Admin-Rechte werden nicht benötigt.

    Die Optionen des Verbindungsstrings sind der Doku des entsprechenden Treibers zu entnehmen.

    Die Datenspeicherung erfolgt in odbc.cfg bzw. jdbc.cfg.

  • Tragen Sie DB-Benutzer [DB User] und DB-Passwort [DB Password] ein.

    Testen Sie die Verbindung mit Klick auf Verbindung testen [Check connection].

  • Tragen Sie optional DBO-Benutzer [DBO user] und DBO-Passwort [DBO Password] ein. Dieser wird benötigt für Änderungen des Datenbankschemas wie Anlegen von Tabellenspalten oder für die Sicherung der Datenbank.

    Testen Sie die Verbindung mit Klick auf Verbindung testen [Check connection].