3.1.1 "MSSQL" (Quellsystemtyp)

Auf dieser Seite wird die Einrichtung des Quellsystemtyps “MSSQL” beschrieben.

Falls eine Vorsystem-Datenbank auf SQL Server 2014 oder älter betrieben wird, dann kann es zu Problemen beim Datenabruf kommen. Diese SQL-Server-Versionen von Microsoft werden offiziell nicht mehr unterstützt. Für diesen Fall:

• Legen Sie auf ihrer Vorsystem-Datenbank eine ODBC-Verbindung an.

• Kopieren Sie den MSSQL-Ordner in folgendem Pfad: “C:\ProgramData\Saxess Software\<Dienstname>\<Datenbankserver-ID>\>Datenbankname>\Repository\Integration\<Quellsystem>\MSSQL” und legen Sie diesen zweiten Ordner im gleichen Pfad unter dem Namen “ODBC” ab.

• Öffnen Sie in diesem Ordner: …\<Quellsystem>\ODBC\FIN\package-metadata.json und ändern den “source_type” von “MSSQL” auf “ODBC”.

• Der Konnektor sollte nun mit dem Quellsystemtyp “ODBC” in der https://saxess-software.atlassian.net/wiki/spaces/OH/pages/445645372/3.5.+Modulverwaltung#4.-Registerkarte---Konnektoren verfügbar und einrichtbar sein.

1. Datenbankverbindung auswählen

Datenquelle ID

• Eindeutiger Identifier der Datenquelle (technischer Bezeichner)

Servername

• Name des SQL Servers

Port

• Port, unter dem der SQL Server erreichbar ist

Instanz

• Instanz auf dem SQL Server, auf der die anzubindende Quelldatenbank liegt

Authentifizierung

Definierte die Authentifizierungsmethode auf dem SQL Server - Auswahlmöglichkeiten sind die…

• …Windows-Authentifizierung: Der Service-Benutzer von OCT.

• …SQL Server-Authentifizierung: Die Authentifizierung auf dem SQL Server erfolgt mit einem Benutzer, dessen Benutzername und Password hier hinterlegt werden.

Verbindung testen

• Testet die hier eingegebenen Verbindungsinformationen. Bei erfolgreichem Verbindungstest wird die Benachrichtigung “Der Verbindungstest war erfolgreich” angezeigt.

2. Quelldatenbank auswählen

Vorhandene Datenbank auswählen

• Zeigt die Liste der vorhandenen Datenbanken auf dem angegebenen SQL Server und erfordert die Auswahl genau einer Datenbank.

• Über einen Linksklick kann die jeweilige Datenbank ausgewählt werden. Der Kreis der Datenbank ist bei Auswahl gelb markiert.

Datenbankname angeben

• Ermöglicht die Eingabe eines konkreten Datenbanknamen

Für das korrekte Anlegen einer Datenquelle ist die Auswahl einer Datenbank oder das Angeben eines Datenbanknamens erforderlich. Sofern der hinterlegte Benutzer in den Datenbankverbindungsinformationen keine ausreichenden Berechtigungen auf dem SQL Server hat, kann die Liste der vorhandenen Datenbank leer sein. In diesem Fall bleibt nur die Möglichkeit der Eingabe einer konkreten Datenbank.

Verbindung testen

• Testet die Verfügbarkeit der ausgewählten Datenbank. Bei erfolgreichem Verbindungstest wird die Benachrichtigung “Der Verbindungstest war erfolgreich” angezeigt.

3. Übersicht

Name der Datenquelle

Ist ein Freitextfeld für den Namen der Datenquelle (wird in der Datenquellenübersicht angezeigt).

3.1. Quellsystem-Verbindung

Zeigt die Übersicht der eingegebenen Verbindungsinformationen:

• Diese Eigenschaften werden basierend auf dem Einrichtungsprozess in die Anzeige automatisch übertragen.

Ein-/Ausklappen des Menüs

• Klickt man die Menüzeile “Quellsystem-Verbindung” auf Höhe des kleinen schwarzen Pfeils (rechter Rand der Menüzeile) an, dann klappen sich Details ein/aus.

3.2. Verfügbare Mandanten

Die Auswahl von Mandanten ist nicht in jedem Kontext notwendig/sinnvoll.

Zeigt die Übersicht der Mandanten in der Quelldatenbank und ermöglicht die Auswahl der Mandanten, die aus der Quelldatenbank extrahiert werden sollen:

• Ist noch kein Mandant ausgewählt so sieht man nur den Schriftzug “Verfügbare Mandanten” und den Button “Mandanten auswählen”.

Ein-/Ausklappen des Menüs

• Klickt man die Menüzeile “Verfügbare Mandanten” auf Höhe des kleinen schwarzen Pfeils (rechter Rand der Menüzeile) an, dann klappen sich Details ein/aus.

Mandanten auswählen

Der gelbe Button “Mandanten auswählen” öffnet den Dialog der “Mandantenauswahl”:

Suche

• Durchsucht die Tabelle nach dem eingegebenen Inhalt.

• Über ein kleines schwarzes Kreuz, am rechten Ende des Eingabefeldes, kann die Eingabe wieder gelöscht werden.

Aktivierung eines Mandanten

• Ein Linksklick auf die Checkbox einer Zeile aktiviert den jeweiligen Mandanten.

• Bei erfolgreicher Auswahl zeigt die jeweilige Checkbox einen Haken auf der eingestellten 6.1. Benutzerverwaltung | Hauptfarbe fest.

• Die Checkbox auf Höhe der Spaltenköpfe (de-)aktiviert alle Mandanten.

Mandanten-ID

• Zeigt die definierten Mandanten-ID des Mandanten.

Mandanten-Name

• Zeigt den definierten Mandantennamen des Mandanten.

Name im Quellskript geändert

• Wurde der originale Name des Mandanten im Quellskript angepasst, so erscheint in dieser Spalte ein grüner Haken an dem Mandanten.

Gelöscht im Quellskript

• Wurde der Mandant im Quellskript gelöscht, so erscheint in dieser Spalte ein grüner Haken an dem Mandanten.

Anwenden

• Wendet die Auswahl der jeweiligen Mandanten für das Quellsystem temporär an.