Page Comparison

...

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".

...

10. Unter den Windows-Diensten findet sich ein neuer Dienst, der die Weboberfläche hostet und die Kopierjobs verwaltet.

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:

Image Added

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:

Image Added

Der Aufruf von .\mwc.exe (ohne Argumente) liefert eine Übersicht über die verfügbaren Befehle:

Image Added

Update

Wenn eine neue Version des MWCs bereit steht, folgen Sie bitte diesem Leitfaden.

1. Führen Sie das neue SetupMwc.exe aus.

Image Added

2. Klicken Sie auf "NEVARIS aktualisieren".

Image Added

3. Hier sehen Sie noch einmal eine Zusammenfassung des Updates, klicken Sie auf "Jetzt installieren".

Image Added

4. Verlauf des Updates, Kopieren neuer Dateien.

Image Added

5. Fertigstellung des Updates, klicken Sie auf "Schließen".

Image Added

6. Das Update ist abgeschlossen, der MWC ist aktualisiert.

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.

...

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. Zwei konkrete Ausprägungen sind bereits vorkonfiguriert und können Es werden bereits einige konfigurierte Datenhaltungen ausgeliefert, die jeweils im Feld Datenhaltung für Quelle und Ziel ausgewählt werden:

Image Removed

...

Image Added

Einrichtungen zu HTTP-APIs (Datenhaltungen beginnend mit FIN)

Ermöglicht den Zugriff auf die von Finance per HTTP API veröffentlichten Daten (lesend und schreibend). Für die Konfiguration ist die Eingabe der API-Basisadresse (URI) erforderlich sowie die notwendigen Zugangsdaten.

...

• Datenhaltung: FIN***
• URI: https://Webserver:OData-Port/Mittelschicht/api/nevaris/financeworkflow/v2.0/companies(ID des Mandanten). Die ID des Mandanten kann über die Seitenüberprüfung in der Mandantenübersicht oder alternativ über einen GET-Request des Endpunktes /companies der Finance API (https://Webserver:OData-Port/Mittelschicht/api/nevaris/finance/v2.0/companies) ermittelt werden.
• Authentifizierung:
  • Basic:
    • Benutzername: Windows-Benutzername
    • Passwort: Webdienst-Zugriffschlüssel aus der Benutzerkarte des Benutzers für die Verbindung
  • NTLM
  • OAuth2.0:
    • Access Token URL: https://login.microsoftonline.com/Tenant ID/oauth2/v2.0/token
    • Client ID: Wählen Sie die Client ID (AIOAzureAppID) der Entra-Anwendung aus, die Sie angelegt haben (Einrichtung Azure AD-Anmeldung - ACS - Finance 2024.1#EntraIDOAuth2.0Anwendungen)

...

• • • Client Secret: Tragen Sie den Geheimschlüssel (AIOAzureAppKeyValue) ein, den Sie bei der Einrichtung erhalten haben (Einrichtung Azure AD-Anmeldung - ACS - Finance 2024.1#Erl%C3%A4uterungdesSkriptes)
    • Scope: https://api.businesscentral.dynamics.com/.default offline_access

Einrichtungen zu SQL-Datenbanken (Datenhaltungen beginnend mit JR)

• Datenhaltung: JR***
• SQL-Server: Name des SQL-Servers inkl. Instanz
• Datenbank: Name der Datenbank
• Integrated Security: Aktivierung/Deaktivierung von Integrated Security
• Benutzer: Angabe des SQL-Benutzers. In diesem Fall ist ein dbo-Benutzer erforderlich, da im Rahmen der Ausführung des Jobs für die Richtung Finance → JobRouter die Stammdatentabellen angelegt werden, sofern diese noch nicht angelegt sind.
• Passwort: Passwort des SQL-Benutzers.
• Weitere Argumente: Die genannten Felder bilden den Connection String für den SQL-Server, welcher bei Bedarf durch weitere Argumente erweitert werden kann.

Abgesehen von Quelle und Ziel kann noch der Name des Jobs festgelegt werden sowie (optional) eine Cron-Anweisung, die angibt, zu welchen Zeitpunkten der Job ausgeführt, das heißt ein Datentransfer von der Quelle zum Ziel stattfinden soll. Die Cron-Anweisung ist Sekunden-basiert, das heißt, die erste Zahl gibt an, zu welchen Sekunden-Werten der Job ausgeführt wird. Es folgen Minuten und Stunden. Die initial vorgeschlagene Anweisung 0 0 * * * ? bedeutet: Führe den Job genau zu jeder vollen Stunde aus. Eine detaillierte Beschreibung der Cron-Syntax findet sich hier.

Ein vollständig konfigurierter Job sieht zum Beispiel so aus:

Image RemovedImage Added

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.
  Image Modified
• 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.
  Image Modified
  

Job-Konfiguration per appsettings.json

...

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

Anchor
AnpassungDatenhaltung AnpassungDatenhaltung

Anpassen der Datenhaltungs-Konfiguration

Aktuell wird der MWC mit Konfigurationen für zwei Datenhaltungen ausgeliefert: FinanceAPI und JobRouterDB. Die zugehörigen Konfigurationsdateien (configuration-finance.json und configuration-jobrouter.json) liegen Der MWC wird bereits vorgefertigten Konfigurationen ausgeliefert. Diese Konfigurationen liegen im Programmverzeichnis. Außerdem befindet sich im Programmverzeichnis die Datei appsettings.json, in der die Konfigurationsdateien eingebunden werden:

...

 Sollten in den JobRouter-Importtabellen Felder enthalten sein, die nicht Bestandteil den entsprechenden Datentypen des Standard-Importumfangs sind entsprechen, müssen diese in der config-finance.json oder einer alternativen config-finance.json in den "FieldMappings" der "WriteOptions" ergänzt werden. Beispielhafter Aufbau:

"WriteOptions": {
	"OutputStringForNullDate": "0001-01-01T00:00:00Z",
	"FieldMappings": [
		{ "DataSet": "Rebukopf", "SourceField": "ExtraFeld1Feld1", "TargetField": null },
		{ "DataSet": "Rebuzeile", "SourceField": "ExtraFeld1Feld1", "TargetField": null }
	]
}

Als Hilfestellung zur Identifizierung der betroffenen Felder steht folgendes SQL-Skript zur Verfügung, mit dem die Felder abgefragt und bereits in das richtige Format gebracht werden.

https://nevaris.blob.core.windows.net/finance/v24/Tools/MWCSpaltenOhneZuordnung.sql

Weitere detaillierte Erläuterungen für verschiedenste Fälle am Beispiel JobRouter Im- und Export ist in der Online-Hilfe zu finden.

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:

Image Removed

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:

Image Removed

Der Aufruf von .\mwc.exe (ohne Argumente) liefert eine Übersicht über die verfügbaren Befehle:

Image Removed

Update

Wenn eine neue Version des MWCs bereit steht, folgen Sie bitte diesem Leitfaden.

1. Führen Sie das neue SetupMwc.exe aus.

Image Removed

2. Klicken Sie auf "NEVARIS aktualisieren".

Image Removed

3. Hier sehen Sie noch einmal eine Zusammenfassung des Updates, klicken Sie auf "Jetzt installieren".

Image Removed

4. Verlauf des Updates, Kopieren neuer Dateien.

Image Removed

5. Fertigstellung des Updates, klicken Sie auf "Schließen".

Image Removed

6. Das Update ist abgeschlossen, der MWC ist aktualisiert.