Installation & Update - Nevaris Middleware Connector - 2024.2.2
Einleitung
Der Middleware Connector (MWC) ist ein Dienst, der die Kommunikation zwischen verschiedenen Anwendungen, Systemen oder Technologien ermöglicht.
Er fungiert als Schnittstelle, die es unterschiedlichen Programmen ermöglicht, miteinander zu kommunizieren und Daten auszutauschen, selbst wenn diese auf verteilten Plattformen oder mit verschiedenen Technologien arbeiten.
Er wird eingesetzt, um die Integration verschiedener Softwareanwendungen im Unternehmensumfeld zu erleichtern, indem er die Interoperabilität zwischen ihnen sicherstellt.
Zurzeit wird der MWC für die Anbindung von JobRouter (per SQL-Zugriff) genutzt.
Versionsangaben in den Screenshots können abweichen.
Installation
1. Führen Sie das SetupMwc.exe aus.
2. Wählen Sie den Middleware Connector aus und klicken Sie auf "Weiter".
3. Wählen Sie einen User aus, unter dem der Middleware Connector laufen soll und unter welchem Port (Default: 8501) die Weboberfläche erreichbar sein soll, klicken Sie auf "Weiter".
4. Hier sehen Sie nochmals eine Zusammenfassung der Installation. Klicken Sie auf "Jetzt installieren".
5. Es werden die nötigen Dateien für den Middleware Connector kopiert.
6. Der Middleware Connector ist nun vollständig installiert, schließen Sie das Setup.
7. Der Middleware Connector erzeugt einen Eintrag unter "Programme und Funktionen".
8. Die eigentlichen Programmdateien liegen unter dem Pfad %PROGRAMFILES%\NEVARIS MWC:
9. Die Konfigurationsdatei appsettings.json für die Kopier-Jobs zwischen den verschiedenen Datenbanken (beispielsweise einer Finance-Datenbank und einer JobRouter-Datenbank) findet sich im Verzeichnis %PROGRAMDATA%\NEVARIS\MiddlewareConnector. Zusätzlich werden dort Log-Dateien zum Austausch der Daten (mwc*.txt) angelegt.
Die Datei appsettings.json kann auch manuell bearbeitet werden, was im den Abschnitten Job-Konfiguration per appsettings.json und Anpassung der Datenhaltungs-Konfiguration erklärt wird.
10. Unter den Windows-Diensten findet sich ein neuer Dienst, der die Weboberfläche hostet und die Kopierjobs verwaltet.
Weiter geht es mit der Job-Einrichtung.
Benutzerverwaltung
Der MWC bietet eine einfache Kommandozeilen-basierte Benutzerverwaltung. Im Installationsverzeichnis befindet sich dafür das Programm Mwc.exe, mit dem unter anderem ein neuer Benutzer angelegt werden kann:
Die Benutzer werden in der Datei %PROGRAMDATA%\NEVARIS\MiddlewareConnector\users.json, die bei der ersten Anlage eines Benutzers initial erstellt wird. Sobald sie vorhanden ist, ist für den Zugriff auf die Web-Oberfläche die Eingabe von Zugangsdaten erforderlich:
Der Aufruf von .\mwc.exe (ohne Argumente) liefert eine Übersicht über die verfügbaren Befehle:
Update
Wenn eine neue Version des MWCs bereit steht, folgen Sie bitte diesem Leitfaden.
Führen Sie das neue SetupMwc.exe aus.
2. Klicken Sie auf "NEVARIS aktualisieren".
3. Hier sehen Sie noch einmal eine Zusammenfassung des Updates, klicken Sie auf "Jetzt installieren".
4. Verlauf des Updates, Kopieren neuer Dateien.
5. Fertigstellung des Updates, klicken Sie auf "Schließen".
6. Das Update ist abgeschlossen, der MWC ist aktualisiert.
Einrichten der Jobs via WebClient
Die Einrichtung wird nachfolgend beschrieben am Beispiel der Finance-JobRouter-Schnittstelle (Connect2JR).
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.
Klicken Sie auf Neuer Job, um einen neuen Job zu erstellen und anschließend auf Bearbeiten, um ihn zu konfigurieren:
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:
Es wird empfohlen die drei folgenden Jobs wie folgt anzulegen:
Job Nr. 1: Export
Beschreibung: Übertragung der Stammdaten aus Finance in die SQL-Datenbank.
Quelle: Datenhaltung FINExport, zusätzliche Informationen sind im Kapitel Einrichtungen zu HTTP-APIs (Datenhaltungen beginnend mit FIN) beschrieben.
Ziel: Datenhaltung JRExport, die zusätzliche Einrichtung ist im Kapitel Einrichtungen zu SQL-Datenbanken (Datenhaltungen beginnend mit JR) beschrieben.
Nach erfolgter Einrichtung den Job speichern und mit der Aktion "Duplizieren" den zweiten Job anlegen. Den neu angelegten Job über "Bearbeiten" wie folgt anpassen:
Job Nr. 2: BK_Status und Upload
Beschreibung: Übertragung der Statusupdates vom BK_Status und optional die Übertragung der weiteren Rechnungs- und Kontierungsdaten wenn der Upload-Schritt im REBU-Import verwendet wird.
Im duplizierten Job muss jeweils für Quelle und Ziel die Datenhaltung angepasst werden. Je nach verwendeten Umfang (REBU, RABU, etc.) der Schnittstelle, weicht die auszuwählende Datenhaltung ab. Zur Auswahl stehen die Datenhaltungen:
JRRebuOhneExport und FINRebuOhneExport: Rechnungseingangsbuch
JRRebuRabuOhneExport und FINRebuRabuOhneExport: Rechnungseingangsbuch und Rechnungsausgangsbuch
JRRebuRabuKabuOhneExport und FINRebuRabuKabuOhneExport: Rechnungseingangsbuch, Rechnungsausgangsbuch und Kassenbuch
JRRebuRabuKabuUrlaubOhneExport und FINRebuRabuKabuOhneExport: Rechnungseingangsbuch, Rechnungsausgangsbuch, Kassenbuch und Urlaubsanträge
Die endgültige Auswahl der Datenhaltungen sieht dann wie folgt aus:
Quelle: Datenhaltung FIN***OhneExport
Ziel: Datenhaltung JR***OhneExport
Nach erfolgter Einrichtung den Job speichern und mit der Aktion "Duplizieren" den dritten Job anlegen. Den neu angelegten Job über "Bearbeiten" wie folgt anpassen:
Job Nr. 3: Import