Zum Inhalt springen

Microsoft Dynamics 365 Verbindungsanleitung für Jitterbit App Builder

Übersicht

Diese Anleitung beschreibt die Systemanforderungen und Anweisungen zur Verbindung von App Builder mit einem Microsoft Dynamics 365 Business Central-Datenbankserver. Microsoft Business Central ist ein Buchhaltungssystem, das wir mit OAuth 2.0 konfigurieren werden, um sich von App Builder aus zu authentifizieren. Microsoft Azure wird verwendet, um den OAuth-Authentifizierungsfluss zu konfigurieren.

Diese Anleitung geht davon aus, dass Sie ein bestehendes Microsoft Dynamics 365 Business Central-Buchhaltungssystem haben, das Sie mit App Builder verbinden möchten.

Für die Konfigurationsschritte, die in Microsoft Azure und Dynamics 365 Business Central stattfinden, bietet diese Anleitung allgemeine Informationen.

Systemanforderungen

Datenbankserver

  • Dynamics 365 Business Central

  • Microsoft Entra ID

Client-Webbrowser

  • Chrome: 84+

  • Firefox: 73+

  • Safari: 13.0.1+

  • Edge: 84+

Verbindungsanweisungen

Eine App in Microsoft Azure registrieren

Die Methode, die verwendet wird, um sich von App Builder zu Microsoft Business Central und Dynamics 365 zu authentifizieren, ist OAuth 2.0. Wir werden den OAuth-Fluss mit Microsoft Azure konfigurieren.

  1. Navigieren Sie zum Azure Active Directory Admin Center-Portal

  2. Wählen Sie unter Verwalten App-Registrierungen > Neue Registrierung

  3. Geben Sie einen Namen ein. Dieser Wert kann von den Benutzern der App manchmal angezeigt werden. Zum Beispiel: App Builder Business Central

  4. Wählen Sie aus, wer die Anwendung nutzen kann

  5. Klicken Sie auf Registrieren

Wenn die Registrierung abgeschlossen ist, zeigt das Azure-Portal die App-Registrierung auf dem Übersichtsbildschirm an, zusammen mit der Anwendungs- (oder Client-) ID, die einen eindeutigen Wert zur Identifizierung der Anwendung darstellt.

Eine Umleitungs-URI hinzufügen

Die Umleitungs-URL stellt den Ort dar, an den Microsoft den Client des Benutzers umleiten und die Sicherheitstoken nach der Authentifizierung übergeben wird.

  1. Navigieren Sie zur registrierten App in Microsoft Entra ID

  2. Klicken Sie auf Add a Redirect URI (Redirect-URI hinzufügen), um den Wert einzugeben. Zum Beispiel: http://localhost/auth-response

Add a client secret

Client-Geheimnisse werden auch als Anwendungspasswort bezeichnet. Die registrierte App in Microsoft Azure erfordert, dass für jede App Builder-Umgebung, in der die Verbindung verwendet wird, ein Client-Geheimnis-Datensatz erstellt wird. Wenn Ihre App Builder-Konfiguration eine Entwicklungs-, QA- und Produktionsumgebung hat, benötigen Sie 3 entsprechende Client-Geheimnis-Datensätze.

Client-Geheimnisse haben ein zugehöriges Ablaufdatum, und die maximale Dauer, für die sie festgelegt werden können, beträgt 2 Jahre.

Das Generieren eines Client-Geheimnis-Datensatzes liefert Ihnen einen Client-Geheimnis Wert und eine Geheimnis-ID. Der Wert ist kodiert und kann nur einmal kopiert und verwendet werden (ansonsten müsste ein neues Token generiert werden, um einen neuen Wert zu erfassen).

  1. Navigieren Sie zur registrierten App in Microsoft Entra ID

  2. Wählen Sie unter Verwalten Certificates & secrets (Zertifikate & Geheimnisse)

  3. Klicken Sie auf New client secret (Neues Client-Geheimnis)

  4. Geben Sie eine Description (Beschreibung) an. Zum Beispiel: App Builder Production

  5. Wählen Sie einen Expires (Ablauf) Wert. Zum Beispiel: 730 Tage (24 Monate)

  6. Klicken Sie auf Add (Hinzufügen)

  7. Notieren Sie den Value (Wert), da er kodiert wird

App endpoints

Nachdem eine App in Microsoft Azure registriert wurde, bietet der Bildschirm Endpoints (Endpunkte) die für die OAuth 2.0-Authentifizierung erforderlichen Endpunktwerte. Bei der Konfiguration des Sicherheitsanbieters in App Builder müssen Sie einige dieser Endpunktwerte referenzieren.

  1. Navigieren Sie zur registrierten App in Microsoft Entra ID

  2. Klicken Sie auf die Registerkarte Endpoints (Endpunkte). Die folgenden Werte sind in App Builder erforderlich:

    1. OAuth 2.0-Authentifizierungsendpunkt (v2)

    2. OAuth 2.0-Tokenendpunkt (v2)

Assign API permissions

Die registrierte App in Microsoft Azure benötigt Berechtigungen, die Business Central zugewiesen sind. Dies sollte basierend darauf konfiguriert werden, wie Sie es mit App Builder integrieren möchten. Eine Methode zur Konfiguration von Berechtigungen ist ein Benutzerfluss, bei dem Sie sich in Azure authentifizieren und Ihre Berechtigungen in Business Central die gleichen Berechtigungen diktieren, die in App Builder festgelegt sind.

  1. Navigieren Sie zur registrierten App in Microsoft Entra ID

  2. Wählen Sie unter Verwalten API-Berechtigungen

  3. Klicken Sie auf Berechtigung hinzufügen

  4. Klicken Sie auf Dynamics 365 Business Central

  5. Wählen Sie Anwendungsberechtigungen

  6. Klicken Sie auf Berechtigung hinzufügen und definieren Sie die Berechtigungen gemäß Ihren geschäftlichen Anforderungen

Für weitere Details siehe Schnellstart: Registrieren Sie eine Anwendung bei der Microsoft-Identitätsplattform

Für diesen Konfigurationsschritt sollten Sie den Wert der Anwendungs- (Client-) ID der oben registrierten App irgendwo griffbereit kopiert haben, z. B. in Ihrer Zwischenablage. In Business Central definieren Sie ebenfalls Anwendungsberechtigungen.

  1. Navigieren Sie zu Dynamics 365 Business Central

  2. Gehen Sie zu Microsoft Entra ID-Anwendungen

  3. Klicken Sie auf Neu

  4. Geben Sie den Client-ID-Wert der registrierten App ein. Dies ist der Anwendungs- (Client-) ID-Wert in Microsoft Azure.

  5. Geben Sie die Beschreibung ein. Zum Beispiel: App Builder Business Central Integration

  6. Wählen Sie den Wert Status aus, um anzugeben, ob die Verbindung aktiviert oder deaktiviert ist

  7. Definieren Sie alle Berechtigungssets, die die Anwendung in Business Central hat

Für weitere Details siehe Registrieren von Business Central On-Premises in Microsoft Entra ID zur Integration mit anderen Diensten

Webdienste von Business Central

Innerhalb von Business Central können Sie Webdienste nutzen, um zusätzliche Daten bereitzustellen, wenn diese standardmäßig nicht verfügbar oder bereits bereitgestellt sind. Webdienste ermöglichen es Ihnen, eine Seite oder Abfrage in Business Central als Endpunkt bereitzustellen, ähnlich wie bei einer API. Alle Einschränkungen und Beschränkungen in Business Central gelten auch für die aus Webdiensten abgerufenen Daten. Webdienste können keine Rückrufe durchführen.

  1. Navigieren Sie zu Dynamics 365 Business Central

  2. Gehen Sie zu Webdienste

  3. Klicken Sie auf Neu

  4. Wählen Sie den gewünschten Objekttyp aus. Zum Beispiel: Seite

  5. Wählen Sie die gewünschte Objekt-ID aus

  6. Weisen Sie einen Servicenamen zu. Dies stellt den Endpunkt dar, unter dem Sie ihn aufrufen würden. Zum Beispiel: Zahlungskonditionen

  7. Setzen Sie ein Häkchen bei Veröffentlicht

  8. Die entsprechende OData V4-URI kann verwendet werden, um auf diese Daten zuzugreifen, sobald die richtige Konfiguration eingerichtet ist

Für weitere Details siehe Business Central Web Services.

Erstellen Sie einen OAuth-Sicherheitsanbieter im App Builder

  1. Navigieren Sie zur App Builder IDE

  2. Klicken Sie im Menü "Verbinden" auf die Schaltfläche Sicherheitsanbieter

  3. Klicken Sie auf + Benutzerauthentifizierung

  4. Geben Sie einen Namen an. Zum Beispiel: Business Central OAuth

  5. Wählen Sie Typ als OAuth

  6. Bestätigen Sie, dass Aktiviert ausgewählt ist

  7. Setzen Sie den Authentifizierungstyp auf OAuth

  8. Setzen Sie den OAuth Grant auf Client-Anmeldeinformationen

  9. Setzen Sie die OAuth-Client-Authentifizierung auf Parameter

  10. Setzen Sie die OAuth-Ressourcen-Authentifizierung auf Bearer

  11. Setzen Sie den Token-Besitzer auf Client

  12. Klicken Sie auf Speichern

    attachment

  13. Konfigurieren Sie als Nächstes 2 Endpunkte, indem Sie auf + Endpunkt klicken:

    • Typ = Autorisierungsendpunkt, URL = Wert aus dem Azure-Portal Endpunkte

    • Typ = Token-Endpunkt, URL = Wert aus dem Azure-Portal Endpunkte

  14. Klicken Sie auf + Anmeldeinformationen

    • Typ = Client

    • Benutzername = Client-ID aus dem Azure-Portal

    • Passwort = Client-Geheimnis aus dem Azure-Portal

    • Klicken Sie auf Speichern

  15. Klicken Sie auf + Eigenschaft

    • Parameter = Scopes, Wert = Standardwert aus Business Central. Zum Beispiel: https://api.businesscentral.dynamics.com/.default

Erstellen Sie eine Datenquelle im App Builder

  1. Navigieren Sie zur App Builder IDE

  2. Wählen Sie im Menü "Connect" die Schaltfläche Data Servers aus.

  3. Klicken Sie auf + Server.

  4. Weisen Sie einen Servernamen zu. Zum Beispiel: Dynamics 365 Business Central.

  5. Setzen Sie den Typ auf Dynamics 365 Business Central.

  6. Geben Sie die Url als die Basis-Url an, um auf Dynamics 365 in Business Central zuzugreifen (enthält die Mandanten-ID in der Zeichenfolge). Zum Beispiel: https://api.businesscentral.dynamics.com/v1.0/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/ODataV4

    attachment

  7. Geben Sie den Instanznamen an, mit dem Sie sich verbinden möchten. Dies stellt das Unternehmen in Business Central dar.

    • Business Central beschränkt Verbindungen auf ein Unternehmen gleichzeitig.

    • Wenn mehrere Unternehmen verbunden werden müssen, müssen mehrere Data Server-Verbindungen konfiguriert werden, zusammen mit der Geschäftslogik, die gegen jede einzigartige Data Server-Verbindung entwickelt wurde.

  8. Klicken Sie auf die Schaltfläche Advanced Settings.

    • Geben Sie bei Bedarf zusätzliche Verbindungsinformationen im Feld Advanced an.

    • Klicken Sie auf Save.

    attachment

  9. Unter Security Settings setzen Sie den Security Provider auf den konfigurierten Business Central-Anbieter.

  10. Klicken Sie auf Save.

Testen Sie die Verbindung

Klicken Sie unter Testing auf die Schaltfläche Test Connection und stellen Sie sicher, dass die Konfiguration wie erwartet funktioniert.

Importieren Sie die Endpunktdaten

Nachdem die Konfiguration eingerichtet ist, können Sie beliebige Endpunktdaten von Business Central in den App Builder importieren. Nachdem sie importiert wurden, können Sie die Daten wie gewohnt im App Builder anzeigen, interagieren und manipulieren; alle Berechtigungen von Business Central gelten.

  1. Navigieren Sie zur App Builder IDE.

  2. Wählen Sie im Menü "Connect" die Schaltfläche Data Servers aus.

  3. Suchen Sie die erstellte Data Server-Verbindung für Dynamics 365 Business Central und wählen Sie sie aus.

  4. Klicken Sie auf die Schaltfläche Details im Eintrag des Dynamics 365 Business Central Data Servers im rechten Bereich.

  5. Klicken Sie auf die Importieren-Schaltfläche

  6. Geben Sie den Endpunktwert aus den Webdiensten im Importmuster an, den Sie abgleichen möchten. Zum Beispiel: PaymentTerms

  7. Klicken Sie auf die Importieren-Schaltfläche. Der App Builder importiert das Schema.

Fehlerbehebung

Wenn Sie Probleme mit dem Microsoft Dynamics 365 Business Central-Server haben, werden die folgenden Schritte zur Fehlerbehebung empfohlen:

  1. Aktivieren Sie Datenprotokollierung, um Protokolldateien und Daten zu generieren, die Sie herunterladen und überprüfen können.

  2. Konsultieren Sie die CData ADO.NET Provider für Microsoft Dynamics 365 Business Central-Dokumentation für detaillierte Informationen.