/
Allgemeine Anleitung zur Konfiguration & Jobverwaltung

Allgemeine Anleitung zur Konfiguration & Jobverwaltung

Vorwort

Mit der MWC-Version 1.3 werden die Konfigurationsdateien in Konfigurationspakete gebündelt. In dieser Anleitung ist die allgemeine Verwaltung und Anpassung der Konfigurationspakete beschrieben. Details zu einzelnen Schnittstellen sind in den unten verlinkten Anleitungen beschrieben.

Voraussetzungen

Erfolgte Installation des MiddleWare Connectors.

Einrichten der Jobs via WebClient

Auf dem Server, auf dem der Middleware Connector installiert wurde, lässt sich die Konfigurations-Seite nach Eingabe des Ports, der bei der Installation eingegeben wurde, im Webbrowser öffnen. Initial wird dort eine leere Liste von Jobs angezeigt, mit der Möglichkeit, neue Jobs zu erstellen. Damit ein Job vollständig erstellt werden kann, werden zunächst die Konfigurationspakete benötigt.

Importieren der Konfigurationspakete

PaketverwaltungLeer.png
PaketverwaltungAuswahl.png

In der Übersicht der Pakete kann ein zuvor heruntergeladenes Konfigurationspaket (.mwcpkg-Datei) hochgeladen werden.

PaketverwaltungImportiert.png

Nach erfolgreichem Import steht das Konfigurationspaket in den Jobs zur Verfügung und kann für die Datenverbindung genutzt werden.

Anlegen und Bearbeiten des Jobs

JobverwaltungLeer.png

Klicken Sie auf Neuer Job, um einen neuen Job zu erstellen und anschließend auf Bearbeiten, um ihn zu konfigurieren:

JobverwaltungErstellt.png

Bei einem Job handelt es sich um zeitgesteuerte Datentransfer-Anweisung. Dafür muss konfiguriert werden, von wo Daten gelesen werden (Quelle) und wohin diese geschrieben werden sollen (Ziel). Als mögliche Datenhaltungen kommen aktuell HTTP APIs sowie SQL Server-Datenbanken infrage. Es werden bereits einige konfigurierte Datenhaltungen ausgeliefert, die jeweils im Feld Datenhaltung für Quelle und Ziel ausgewählt werden:

JobverwaltungAuswahlDatenhaltung.png

Im Bearbeitungsdialog des Jobs zunächst für Quelle und Ziele jeweils die Datenhaltung auswählen. Die hinterlegten Datenhaltungen werden dabei aus den zuvor importieren Konfigurationspaketen ermittelt.

JobverwaltungEinrichtung.png

Zudem besteht jeder Job aus einer Konfiguration von Verbindungsdaten. Hier beispielhaft konfiguriert für eine Verbindung von SQL-Server als Quelle und einer REST API als Ziel. Die genaue Konfiguration wird in den Dokumentationsartikeln zu den jeweiligen Schnittstellen erläutert.

JobverwaltungFertig.png

Weitere Möglichkeiten der Jobverwaltung

Abgesehen von der Möglichkeit, Jobs zu erstellen und zu bearbeiten, gibt es noch weitere Funktionen:

  • Löschen: Löscht einen Job nach einer Sicherheitsabfrage.

  • Duplizieren: Erstellt eine Kopie eines Jobs unter neuem Namen.
    Tipp: Häufig möchte man zusätzlich zu einem bestehenden Job einen weiteren Job erstellen, der Daten in die entgegengesetzte Richtung (das heißt vom Ziel in die Quelle) transferiert. Dies kann durch Duplizieren des Jobs und anschließendem Vertauschen von Quelle und Ziel (mithilfe des Buttons ⇆) erreicht werden.

  • Ausführen: Startet den Datentransfer unabhängig von der Cron-Anweisung.

  • Stoppen: Bricht die Ausführung eines Datentransfers ab.

  • Aktivieren/Deaktivieren eines Jobs: Standardmäßig ist ein Job aktiv, d.h. er wird gemäß der per Cron-Anweisung definierten Zeitplanung periodisch ausgeführt. Durch Entfernen des Aktiv-Häkchens wird diese Zeitplanung deaktiviert. Der Job kann aber trotzdem per Ausführen-Funktion explizit angestoßen werden.

    JobAktiv.png

  • Aktivieren/Deaktivieren der gesamten Job-Verarbeitung: Wenn dieses Häkchen entfernt wird, wird kein Job mehr automatisch gestartet. Ein explizites Ausführen einzelner Jobs ist weiterhin möglich.

    JobverarbeitungAktiv.png

Anpassung der Konfigurationen

Der MWC wird bereits vorgefertigten Konfigurationen ausgeliefert. Die einzelnen Konfigurationen liegen in den jeweiligen Paketordnern im Verzeichnis

C:\ProgramData\NEVARIS\MiddlewareConnector\packages
Konfigurationsdateien.png

Jede Konfigurationsdatei kann in allen Abschnitten angepasst werden. Für eigens angepasste Konfigurationen ist es erforderlich das Konfigurationspakete zunächst über die Oberfläche des MWCs und der Aktion “Duplizieren” unterhalb des gewünschtes Konfigurationspaketes zu kopieren und mit einem neuen Namen zu versehen. In den Konfigurationsdateien des neuen Paketes können dann entsprechend die Änderungen, wie z. B. abweichende Feldzuordnungen vorgenommen werden.

Allgemeine Einrichtungen des MWC

Job-Konfiguration per appsettings.json

Die über die Web-Oberfläche erfolgte Konfiguration der Jobs wird in der Datei %PROGRAMDATA%\NEVARIS\MiddlewareConnector\appsettings.json abgespeichert. Der Inhalt sieht z.B. auszugsweise so aus und kann auch von Hand bearbeitet werden:

Anpassen der Basisadresse (URL mit Port)

In der Datei %PROGRAMDATA%\NEVARIS\MiddlewareConnector\appsettings.json ist neben der Job-Konfiguration auch der URL hinterlegt, über den die Web-Oberfläche erreichbar ist. In diese fließt der im Setup eingegeben Port ein, z.B.:

Ein nachträgliches Ändern des URLs ist möglich und erfordert einen Neustart des NEVARIS MiddlewareConnector-Diensts:

Die Angabe mehrerer URLs ist möglich (per Semikolon getrennt, z.B.: "Urls": "http://localhost:5210;https://localhost:7180").

Spezifische Beschreibungen zu Schnittstellen

 

Zurück zur Hauptseite:
Downloads NEVARIS Middleware Connector