Skip to main content

Einrichtung der Datenbank-Verbindungen

Die WEB-Konfigurationen von Invoice greifen über den Table-Service auf Daten aus den Datenbanktabellen zu. Hierzu muss die Verbindung zur Datenbank eingerichtet werden. Der Ordner "TableService" befindet sich im DEXPRO-Ordner der Documents-Installation.

Die Datenbank-Verbindung kann über den Ordner "Verbindung" -> "Table Service" auf der Outbar "Allgemein" konfiguriert werden. Die TableService-URL verweist auf das lokale System. Der Port kann in der Regel unverändert bleiben und der Api-Key kann über den Button "API-KEY ERZEUGEN" automatisch generiert werden.

Pro Datenbank kann ein alternativer Zugriff definiert werden. In der Standard-Auslieferung muss der Zugriff für die Datenbanken "DEX_MasterData", "DEX_Workflow" sowie für die "Documents"-Datenbank konfiguriert werden. Da alle 3 Datenbanken in der Regel auf demselben SQL-Server liegen und ein und die Zugriffe immerin der Regel über denselben Benutzer erfolgen, kann die Checkbox "Verbindungsdaten für alle Verbindungen verwenden?" gesetzt werden,werden. damitHierdurch muss der Zugriff nur einmalig konfiguriert werden. Der Anwender muss unter "Host" den SQL-Server-Namen inklusive Instanz angeben. Der SQL-Benutzer sollte volle Berechtigungen auf den Datenbanken haben.

Über den Button "SERVICE INSTALLIEREN" wird das angegebene Passwort automatisch verschlüsselt und der Table-Service wird als Dienst installiert und gestartet. Sollte die Installation fehlschlagen sollte die "service-install.bat" aus dem Ordner "TableService" manuell mit Administrations-Rechten ausgeführt werden.

image-1591266623552.png

Die WEB-Konfiguration passt die folgenden Dateien an, welche alternativ auch manuell angepasst werden muss.können:

  • ...\Documents5\DEXPRO\TableService\data\database-connections.js
  • ...\Documents5\DEXPRO\TableService\data\database-users.js
  • ...\Documents5\DEXPRO\TableService\config\local.json
  • ...\Documents5\SQUEEZE\www\vue\conf\ServerConfig.js (Eintrag: "dexServer")

 

image-1591266623552.png 

Im Unterordner config muss in der Datei local.yml eine globale Datenbankkonfiguration angegeben werden. Der Table Service kann in der Standardauslieferung über den Port 1958 erreicht werden. Unter dem Eintrag db kann als flavor entweder mysql oder mssql für den globalen Datenbankzugriff angegeben werden. Das Log-Level sollte auf error eingestellt werden.

image-1585891815206.png 

Die spezifischen Datenbankzugriffe werden im Ordner data über die Dateien database-connections.js und database-users.js konfiguriert. Bei der database-users.js sollten nur die Einträge für user und pwd angepasst werden.

image-1585892151434.png 

In der database-connections.js müssen jeweils die Einträge host, port und flavor projektspezifisch angepasst werden. Der Host muss mit Instanz angegeben werden und einfache "\" müssen durch "\\" ersetzt werden.

image-1585892211017.png 

Damit die WEB-Konfigurationen auf den Table-Service zugreifen können muss unter …\Documents5\SQUEEZE\www\vue\conf\ die Datei ServerConfig.js angepasst werden. Der Eintrag „dexServer“ muss auf den korrekten Documents5-Server verweisen.

image-1585892351296.png

Zum Abschluss muss über die service-install.bat aus dem Hauptverzeichnis der Table-Service als Dienst installiert werden. Bei Problemen sollte die Eingabeaufforderung als Administrator gestartet werden und die bat-Datei sollte hierüber ausgeführt werden.

Bei einem MS SQL Express Server (bitte nur auf Testservern verwenden) muss die Einstellung "Named Pipes" über den SQL Configuration Manager aktiviert werden und der Dienst "SQL Server-Browser" muss gestartet werden.

 

Sobald der Table-Service korrekt konfiguriert wurde können die WEB-Konfigurationen aufgerufen werden. Um zu den WEB-Konfigurationen zu gelangen muss man sich mit einem Benutzer aus der Gruppe Administration an der Documents-WEB-Oberfläche anmelden. Auf der Outbar „Administration“ werden mehrere Sub-Outbars gelistet.

Zuerst sollte die Sub-Outbar „Allgemein“ angesteuert werden.