Verbindungen verwalten | Lucanet Knowledge Base

Eine Verbindung enthält die Authentifizierungseinstellungen, mit denen Data Hub auf ein externes Vorsystem wie SAP S/4HANA, Microsoft Dynamics 365 oder eine per JDBC angebundene SQL-Datenbank zugreift.

Sie können Verbindungen auf der Seite Integrationen verwalten, die Sie über Data Hub im Hauptmenü öffnen. Die Seite listet jede Verbindung zusammen mit ihren Quelldatensätzen auf: Jede Verbindung ist eine übergeordnete Zeile, die Sie aufklappen können, um die Quelldatensätze anzuzeigen, die sie verwenden.

Die Seite Integrationen wird z. B. wie folgt angezeigt:

Zeigt die Seite 'Integrationen' in Data Hub mit den aufgeklappten Verbindungen 'MS365-130' und 'SAP', deren Quelldatensätze als untergeordnete Zeilen angezeigt werden, z. B. 'first', 'mode2_130' und 'mode3_130'. Die Tabelle hat die Spalten 'Verbindungsname, Anzahl der zugehörigen Datensätze', 'Vorsystem', 'Status', 'Erzeugt von' und 'Import', und die Spalte 'Import' zeigt für zwei der Quelldatensätze die Status 'Fehlgeschlagen' und 'Erfolgreich'. — Verbindungen und ihre Quelldatensätze auf der Seite 'Integrationen'

Die Übersichtstabelle auf der Seite Integrationen in Data Hub enthält für jede Verbindung die folgenden Informationen:

Spalte	Beschreibung
Verbindungsname, Anzahl der zugehörigen Datensätze	Name der Verbindung und Anzahl der Quelldatensätze, die sie verwenden
Vorsystem	Externes System, zu dem die Verbindung hergestellt wird, z. B. SAP S/4HANA, Microsoft Dynamics 365 oder eine SQL-Datenbank
Status	Status, der angibt, ob die Verbindung aktiv oder inaktiv ist
Erzeugt von	Benutzer, der die Verbindung erstellt hat
Import	Status des letzten Imports der Quelldatensätze der Verbindung

Gehen Sie wie folgt vor, um eine Verbindung in Data Hub zu erstellen:

Wählen Sie im Hauptmenü Data Hub. Die Seite Integrationen wird angezeigt.

Klicken Sie oben rechts auf Neue Verbindung anlegen. Das Verbindungsformular wird z. B. wie folgt angezeigt:

Zeigt das Verbindungsformular in Data Hub mit dem leeren Feld für den Verbindungsnamen, den Schaltflächen 'Verbindung testen', 'Abbrechen' und 'Anlegen' oben rechts und der geöffneten Dropdown-Liste 'Vorsystem' mit den Optionen 'Microsoft Dynamics 365', 'Microsoft SQL Server (JDBC)', 'Oracle Database (JDBC)', 'PostgreSQL (JDBC)' und 'SAP S/4HANA'. — Verbindungsformular mit der Vorsystemauswahl

Wählen Sie das Vorsystem, mit dem Sie sich verbinden möchten: SAP S/4HANA, Microsoft Dynamics 365, Microsoft SQL Server (JDBC), Oracle Database (JDBC) oder PostgreSQL (JDBC).

Für das gewählte Vorsystem wird oben rechts im Bereich Vorsystem die Version der zugehörigen Verbindungsvorlage angezeigt.

Geben Sie die Verbindungseinstellungen für das gewählte Vorsystem ein. Weitere Informationen finden Sie unter Verbindungseinstellungen.

Optional: Klicken Sie auf Verbindung testen, um zu prüfen, ob Data Hub das Vorsystem mit den eingegebenen Einstellungen erreicht. Data Hub speichert die Einstellungen dabei nicht. Weitere Informationen finden Sie unter Verbindung testen.

Klicken Sie auf Anlegen. Die Verbindung wird erstellt und auf der Seite Integrationen angezeigt.

Die Verbindungseinstellungen in Data Hub hängen von dem Vorsystem ab, aus dem Sie die Daten extrahieren möchten.

Die folgenden Verbindungsoptionen in Data Hub sind für jedes Vorsystem gleich:

Option	Beschreibung
Verbindungsname	Name, der die Verbindung auf der Seite Integrationen kennzeichnet. Erforderlich.
SEA-Instanz	Instanz der Lucanet.Script Execution Application (SEA), die die Verbindung ausführt. Erforderlich.
Beschreibung	Optionale Beschreibung der Verbindung

Alle weiteren Einstellungen werden von der Verbindungsvorlage des gewählten Vorsystems vorgegeben und sind nach Zweck gruppiert. Die Werte für diese Einstellungen stammen aus dem Vorsystem.

Die Verbindungseinstellungen werden z. B. wie folgt angezeigt:

Zeigt die Verbindungseinstellungen einer SAP-S/4HANA-Verbindung in Data Hub, mit 'Version: 1.4.0' der Verbindungsvorlage im Bereich 'Vorsystem', dem Feld 'SEA-Instanz' im Bereich 'Konfiguration', dem Feld 'Sprache' im Bereich 'Allgemein', den Feldern 'Host', 'Instanznummer', 'Mandant', 'Benutzer' und 'Passwort' im Bereich 'Authentifizierung' sowie dem Feld 'Beschreibung'. — Verbindungseinstellungen einer SAP-S/4HANA-Verbindung

Bereich 'Allgemein'

Im Bereich Allgemein einer SAP-S/4HANA-Verbindung in Data Hub ist folgende Option verfügbar:

Option	Beschreibung
Sprache	Anmeldesprache für das SAP-System

Bereich 'Authentifizierung'

Im Bereich Authentifizierung einer SAP-S/4HANA-Verbindung in Data Hub sind folgende Optionen verfügbar:

Option	Beschreibung
Host	Hostname oder IP-Adresse des SAP-Servers
Instanznummer	Zweistellige Instanznummer des SAP-Anwendungsservers, z. B. 00
Mandant	Dreistellige Nummer des SAP-Mandanten, an dem die Anmeldung erfolgt, z. B. 100
Benutzer	Benutzername für die Anmeldung am SAP-System
Passwort	Passwort des Benutzers

Bereich 'Authentifizierung'

Im Bereich Authentifizierung einer Microsoft-Dynamics-365-Verbindung in Data Hub sind folgende Optionen verfügbar:

Option	Beschreibung
Endpunkt	URL des Microsoft-Dynamics-365-Dienstes, von dem die Daten gelesen werden
Client-ID	ID der Anwendung, mit der sich Data Hub anmeldet
Client-Geheimnis	Geheimnis, das zu der Client-ID gehört
Mandanten-ID	ID des Mandanten Ihrer Microsoft-Dynamics-365-Umgebung
Ressource	Ressource, für die der Zugriff angefordert wird
X-API-Key	API-Key, den der Endpunkt erfordert

Bereich 'Netzwerk'

Im Bereich Netzwerk einer Microsoft-Dynamics-365-Verbindung in Data Hub sind folgende Optionen verfügbar:

Option	Beschreibung
Verbindungs-Timeout	Zeit, nach der das Herstellen der Verbindung abgebrochen wird
Lese-Timeout	Zeit, nach der das Lesen der Daten abgebrochen wird

Die SQL-Datenbanken Microsoft SQL Server (JDBC), Oracle Database (JDBC) und PostgreSQL (JDBC) werden über JDBC angebunden. Für alle drei Vorsysteme sind dieselben Einstellungen verfügbar.

Bereich 'Verbindung'

Im Bereich Verbindung einer SQL-Datenbankverbindung in Data Hub ist folgende Option verfügbar:

Option	Beschreibung
URL	JDBC-Verbindungs-URL der Datenbank, einschließlich Host, Port und Name der Datenbank

Das Format der JDBC-Verbindungs-URL hängt von der Datenbank ab, z. B.:

Microsoft SQL Server:

jdbc:sqlserver://hostname:1433;databaseName=myDatabase

Oracle Database:

jdbc:oracle:thin:@//hostname:1521/servicename

PostgreSQL:

jdbc:postgresql://hostname:5432/mydatabase

Bereich 'Authentifizierung'

Im Bereich Authentifizierung einer SQL-Datenbankverbindung in Data Hub sind folgende Optionen verfügbar:

Option	Beschreibung
Benutzer	Benutzername für die Anmeldung an der Datenbank
Passwort	Passwort des Benutzers

Eine bestehende Verbindung können Sie über das Symbol in der Zeile der Verbindung auf der Seite Integrationen in Data Hub verwalten. Folgende Optionen sind verfügbar:

Option	Beschreibung
Verbindung testen	Option, um zu prüfen, ob Data Hub das Vorsystem mit den gespeicherten Einstellungen der Verbindung erreicht. Weitere Informationen finden Sie unter Verbindung testen.
Bearbeiten	Option, um die Einstellungen der Verbindung anzuzeigen und zu ändern
Neuen Datensatz anlegen	Option, um einen Quelldatensatz für die Verbindung zu definieren. Weitere Informationen finden Sie unter Quelldatensätze verwalten.
Deaktivieren / Aktivieren	Option, um die Verbindung auf Inaktiv oder wieder auf Aktiv zu setzen. Solange eine Verbindung inaktiv ist, kann sie nicht für Importe verwendet werden, und alle ihre Quelldatensätze sind ebenfalls inaktiv.
Löschen	Option, um die Verbindung zu löschen. Sie können eine Verbindung erst löschen, wenn sie von keinem Quelldatensatz mehr verwendet wird.

Wenn Sie in Data Hub eine Verbindung deaktivieren, die noch aktive Quelldatensätze hat, müssen Sie die Änderung bestätigen, und die Verbindung wird zusammen mit allen ihren Quelldatensätzen auf Inaktiv gesetzt. Wenn Sie eine Verbindung wieder aktivieren, werden die Quelldatensätze der Verbindung nicht automatisch reaktiviert. Sie können eine Verbindung oder einen Quelldatensatz nicht deaktivieren, während einer ihrer Importe läuft oder in der Warteschlange ist.

Beim Testen einer Verbindung prüft Data Hub, ob es das Vorsystem erreicht und ob das Vorsystem die Anmeldedaten akzeptiert. So erkennen Sie einen falschen Host, falsche Anmeldedaten oder ein nicht verfügbares Vorsystem, bevor ein Import fehlschlägt. Der Test ändert die Einstellungen der Verbindung nicht.

Sie können eine Verbindung jederzeit testen, z. B. nachdem das Passwort im Vorsystem geändert wurde. Folgende Möglichkeiten zum Testen einer Verbindung sind in Data Hub verfügbar:

Ort	Vorgehen	Was getestet wird
Seite Integrationen	Klicken Sie in der Zeile der Verbindung auf das Symbol und wählen Sie Verbindung testen.	Data Hub testet die gespeicherten Einstellungen der Verbindung. Sie können auch eine inaktive Verbindung testen.
Verbindungsformular beim Anlegen einer Verbindung	Klicken Sie oben rechts auf Verbindung testen.	Data Hub testet die im Formular eingegebenen Einstellungen, ohne sie zu speichern. Hinweis: Die Schaltfläche Verbindung testen ist verfügbar, sobald Sie ein Vorsystem gewählt und die erforderlichen Einstellungen eingegeben haben. Ein Verbindungsname ist für den Test nicht erforderlich.
Verbindungsformular beim Bearbeiten einer Verbindung	Klicken Sie oben rechts auf Verbindung testen.	Data Hub testet die Einstellungen im Formular einschließlich noch nicht gespeicherter Änderungen. Wenn Sie das Feld Passwort nicht erneut ausfüllen, verwendet Data Hub das gespeicherte Passwort.

Sie müssen eine Verbindung in Data Hub nicht testen, bevor Sie die Verbindung anlegen oder speichern.

Die Option Verbindung testen auf der Seite Integrationen wird z. B. wie folgt angezeigt:

Zeigt die Seite 'Integrationen' in Data Hub mit dem über das Drei-Punkte-Symbol geöffneten Menü einer Verbindung und den Optionen 'Verbindung testen', 'Bearbeiten', 'Neuen Datensatz anlegen', 'Deaktivieren' und 'Löschen'. Rot hervorgehoben sind das Drei-Punkte-Symbol der Verbindung und die Option 'Verbindung testen'. — Die Option 'Verbindung testen' im Menü einer Verbindung

In Data Hub wird das Ergebnis eines Verbindungstests in einer Benachrichtigung angezeigt:

Ist der Test erfolgreich, wird die Benachrichtigung

Verbindungstest erfolgreich

zusammen mit dem Vorsystem angezeigt, z. B.

Erfolgreich verbunden mit SAP S/4HANA

Schlägt der Test fehl, wird die Benachrichtigung

Verbindungstest fehlgeschlagen

zusammen mit der Ursache und einem Hinweis angezeigt, was Sie prüfen sollten.

Folgende Ursachen können bei einem fehlgeschlagenen Verbindungstest in Data Hub angezeigt werden:

Ursache	Was Sie prüfen sollten
Das Vorsystem hat die Anmeldedaten abgelehnt.	Benutzername und Passwort
Das Vorsystem konnte nicht erreicht werden.	Host und Port sowie, ob das Vorsystem in Betrieb und der Port geöffnet ist
Das Vorsystem hat nicht rechtzeitig geantwortet.	Ob das Vorsystem ausgelastet oder vorübergehend nicht verfügbar ist. Versuchen Sie es in diesem Fall in Kürze erneut.
Das Vorsystem hat die Verbindungskonfiguration abgelehnt.	Die Verbindungseinstellungen
Die Verbindung konnte nicht hergestellt werden.	Die Anmeldedaten und die Konfiguration

Kann der Test gar nicht durchgeführt werden, z. B. weil die SEA-Instanz nicht antwortet, wird statt eines Testergebnisses eine Fehlermeldung angezeigt. Prüfen Sie in diesem Fall, ob die SEA-Instanz läuft, und versuchen Sie es erneut.