Einrichtung der Integration ab Version 2024.1 zwischen Build & Finance - NEVIS-Dienst

Vorwort

Diese Anleitung dient zur Einrichtung und Konfiguration der Verbindung zwischen Build und Finance. In dieser Anleitung wird erklärt, wie die Programme konfiguriert werden müssen, damit die Verbindung zwischen Build und Finance funktioniert.

Hier werden die Service-Benutzer verwendet, die Sie bei der Einrichtung von Finance oder Build angelegt haben, um die Einrichtung für die Anbindung abschließen zu können.

Außerdem werden die Azure-Verbindungsdaten benötigt. Diese Verbindungsdaten wurden bereits erstellt, wenn Sie die Einrichtung für EntraID abgeschlossen haben. Die Datei "AppProperties.json" wird erstellt und enthält alle notwendigen Informationen, um die Anbindungs-Konfiguration abschließen zu können.

Voraussetzung ist ein installiertes Build mit NEVIS-Dienst und konfigurierten Finance Build-Connector, der bereits an NEVIS registriert ist. Anleitungen zum Build-Connector finden sie im Finance-Bereich auf der Download-Seite.
Führen Sie diese Anleitung erst aus, wenn alle Produkte auf dem selben Stand sind, Version 2024.1.

Wichtige Informationen

Zertifikate

Um eine reibungslose Einrichtung der Anbindung zu gewährleisten, achten Sie bitte darauf, dass die Zertifikate auf den Mittelschicht-, Web- und Build-Server jeweils unter Persönliche Zertifikate und Vertrauenswürdige Stammzertifikate hinterlegt ist. Hier ggf. mit dem CMD-Befehl “gpupdate /force" auf den Servern verteilen.

Wichtige Informationen

Zertifikate

Um eine reibungslose Einrichtung der Anbindung zu gewährleisten, achten Sie bitte darauf, dass die Zertifikate auf den Mittelschicht-, Web- und Build-Server jeweils unter Persönliche Zertifikate und Vertrauenswürdige Stammzertifikate hinterlegt ist. Hier ggf. mit dem CMD-Befehl “gpupdate /force" auf den Servern verteilen.

Definition Begrifflichkeiten

  • AppProperties.json - Ist die Datei, welche bei der Einrichtung vom EntraID erstellt wird. Diese beinhaltet ID und ClientSecret-Schlüssel, welche für die weiteren Konfigurationen benötigt werden.

  • NevIs/Integrationsdienst - Ist die Schnittstelle zwischen Build und Finance. Ein Tool was für den Datenaustausch notwendig ist. Ist als Windows-Dienst verfügbar und als Programm.

Definition Begrifflichkeiten

  • AppProperties.json - Ist die Datei, welche bei der Einrichtung vom EntraID erstellt wird. Diese beinhaltet ID und ClientSecret-Schlüssel, welche für die weiteren Konfigurationen benötigt werden.

  • NevIs/Integrationsdienst - Ist die Schnittstelle zwischen Build und Finance. Ein Tool was für den Datenaustausch notwendig ist. Ist als Windows-Dienst verfügbar und als Programm.

Einrichtung der Anbindung

  • Voraussetzung ist ein installiertes Build mit NEVIS-Dienst und konfigurierten Finance Build-Connector, der bereits an NEVIS registriert ist. Anleitungen zum Build-Connector finden sie im Finance-Bereich auf der Download-Seite.

  • Prüfen der Dienste
    Starten Sie die Dienste „Nevaris Integrationsdienst“ und „Nevaris Build Businessdienst“ neu und überprüfen Sie im Anschluss ob die Dienste „Nevaris Integrationsdienst“, „Nevaris Build Businessdienst“ sowie „Microsoft Dynamics 365 Business Central Server [Instanzname] gestartet sind und laufen.

  • Nevaris Administration öffnen
    Starten Sie die Anwendung „Nevaris Administration“ mit erweiterten Rechten (als Administrator ausführen).
    Klicken Sie auf die Registerkarte „Kaufmännische Integration" und dann auf die Registerkarte „Einrichten".

image-20240628-092927.png
  • Nevaris Build Verbindungsdaten eingeben
    Geben Sie hier die SQL-Verbindungsdaten für Nevaris Build ein.

image-20240628-092938.png
  • Nevaris Finance Verbindungsdaten eingeben
    Hier geben Sie die Verbindungsdaten von Nevaris Finance ein. Die Daten kommen aus der Datei AppProperties.json, welche bei der Einrichtung von EntraID erstellt wird.

Host Name Finance: Hier geben Sie den Server an, auf dem der Mittelschicht-Server installiert ist. Die Verwendung des FQDN-Namens wird empfohlen, Stichwort Ãœbereinstimmung des Namens hier mit dem im Zertifikat!
Port: Standardmäßig 7048 bzw. der OData-Port der bei der Einrichtung definiert worden ist.
Serverinstanz-Name: Die Serverinstanz vom Nevaris Finance
Tenant-ID: Verwenden Sie die Tenant-ID Ihrer Entra-Einrichtung. „AadTenant“ ist der Wert aus der
Client-ID: Die Client-ID aus der Anwendungsregistrierung für AIO Azure Services. „AIOAzureAppID“ ist der Wert aus der AppProperties.json
Client Secret: Verwenden Sie den Client Secret Schlüssel, der von der AIO Azure Services App Registrierung erstellt wurde. „AIOAzureAppKeyValue“ ist der Wert aus der AppProperties.json
Grant Type: Wenn nicht ausgefüllt, wird "client_credentials" verwendet. Ansonsten wird der gewünschte Eintrag verwendet
Scope: Wenn nicht ausgefüllt, wird "https://api.businesscentral.dynamics.com/.default offlince_access" verwendet. Der Scope setzt sich zusammen aus der Application ID URI der WebClient App-Registrierung “SsoAdAppId“ und den Berechtigungen .default und offline_access: Beispiel: api://XXXXXX-XXXXXX-XXXXX-XXXXX/.default offline_access
Host Name Nevis: Hier geben Sie den Server an, auf dem der Nevis Integration Service installiert ist. Die Verwendung des FQDN-Namens wird empfohlen.
Port: Standardmäßig 8201.

  • Start der Einrichtung Nevaris Build
    Wenn die Daten korrekt eingegeben wurden, können Sie nun den Standardmandanten auswählen. Wählen Sie den Default-Mandanten aus und klicken Sie auf die Schaltfläche „Integration einrichten“.

Beantworten Sie die folgenden Fragen. Nach Beantwortung der Fragen beginnt der Einrichtungsprozess!

Hinweis: Wenn die Daten nicht korrekt sind, erhalten Sie eine Fehlermeldung oder können keinen Standardmandanten auswählen. Dies ist für die Einrichtung erforderlich. Stellen Sie sicher, dass Sie die richtige Client-ID und das richtige Client Secret verwenden. Bei Hostname spielt es eine Rolle, ob Sie den FQDN oder nur den PQDN-Namen verwenden. In der Regel wird der FQDN-Name verwendet.

  • Synchronisierung und Abschluss der Einrichtung Nevaris Build
    Nach Anklicken des Buttons „Integration einrichten“ werden die Verbindungsdaten in die Build-Datenbank eingetragen und die erste Synchronisation durchgeführt.

 

  • Abschluss der Einrichtungen
    Starten Sie die Anwendung „Nevaris Integrationsdienst Administration“ mit erhöhten Rechten (als Administrator ausführen). Hier müssen zwei Dienste eingetragen sein. Eine Aktualisierung oder ein „Restart“ kann durchgeführt werden, wenn einer der beiden Dienste fehlen. Sollte nach einer Aktualisierung oder einem „Restart“ immer noch ein Dienst fehlen, wenden Sie sich bitte an den Support.

 

Die Installation und Einrichtung ist erfolgreich abgeschlossen!

 

Port-Freigaben

Ports die möglicherweise freigegeben werden müssen

Port

Beschreibung

Port

Beschreibung

Lizenzdienst (falls installiert, Build)

8300, 8400, 8420

Integrationsdienst/NevIs (Anbindung)

8201, 8400, 8410, 8500

Build Businesshost (Build)

8100, 8400

OData ServicesManage (Finance)

7048 by Default (sonst den von Ihnen definierten Port)

Soap Services (Finance)

7047 by Default (sonst den von Ihnen definierten Port)

Management Services (Finance)

7045 by Default (sonst den von Ihnen definierten Port)

Developer Services (Finance)

7049 by Default (sonst den von Ihnen definierten Port)

Client Services (Finance)

7046 by Default (sonst den von Ihnen definierten Port)

FileService (Finance)

7080 by Default (sonst den von Ihnen definierten Port)

SQL Server

1434 by Default (sonst den von Ihnen definierten Port)