Page Comparison

...

Es wird empfohlen die drei folgenden Jobs wie folgt anzulegen:

Job Nr. 1: Export

Beschreibung: Übertragung der Stammdaten aus Finance in die SQL-Datenbank.

1. Quelle: Datenhaltung FINExport, zusätzliche Informationen sind im Kapitel Einrichtungen zu HTTP-APIs (Datenhaltungen beginnend mit FIN) beschrieben.
2. Ziel: Datenhaltung JRExport

Import

...

1. , 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:

...

Die endgültige Auswahl der Datenhaltungen sieht dann wie folgt aus:

1. Quelle: Datenhaltung JR Datenhaltung FIN***OhneExport
2. Ziel: Datenhaltung FINJR***OhneExport

BK_Status und Upload

Übertragung der Statusupdates vom BK_Status und optional die Übertragung der weiteren Rechnungs- und Kontierungsdaten wenn der Upload-Schritt im REBU-Import verwendet wird.

Der vorherige Job kann einfach dupliziert und anschließend die Quelle und das Ziel getauscht werden.

...

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

Beschreibung: Ermittlung und Übertragung der zu importierenden Datensätze.

Über die Pfeile zwischen Quelle und Ziel die Richtung tauschen, dass als Quelle die SQL-Datenbank verwendet wird und als Ziel die HTTP API.

Die endgültige Auswahl der Datenhaltungen sieht dann wie folgt aus:

1. Quelle: Datenhaltung JR***OhneExport
2. Ziel: Datenhaltung JRFIN***OhneExport

Anchor
EinrichtungHTTPAPI EinrichtungHTTPAPI

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. Damit die API "financeworkflow" vollständig initialisiert wird, ist das Öffnen der entsprechenden Einrichtung "Workflow Standorte" in Finance erforderlich.
• 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: 

      • Der Scope setzt sich zusammen aus der Application ID URI der WebClient App-Registrierung, den Berechtigungen .default und offline_access:

        Beispiel: 

      https

      • api://

      api.businesscentral.dynamics.com

      • XXXXXX-XXXXXX-XXXXX-XXXXX/.default offline_access
        Die URI finden Sie in Ihrer AppProperties.json (Einrichtung Azure AD-Anmeldung - ACS - Finance 2024.1#Erl%C3%A4uterungdesSkriptes)

        Image Added

Anchor
EinrichtungSQL EinrichtungSQL

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.

...

• 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

...

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

Gehen Sie nun zurück zur Hauptseite und folgen der weiteren Anleitung
NEVARIS Finance Version 2024.1