Zum Inhalt springen

Microsoft Dynamics 365 Verbindungshandbuch für Jitterbit App Builder

Übersicht

Diese Anleitung beschreibt die Systemanforderungen und Anweisungen zum Anschließen App Builder an einen 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. Microsoft Azure wird zum Konfigurieren des OAuth-Authentifizierungsflusses verwendet.

In diesem Handbuch wird davon ausgegangen, dass Sie über ein vorhandenes Microsoft Dynamics 365 Business Central-Buchhaltungssystem verfügen, mit dem Sie eine Verbindung herstellen möchten App Builder.

Dieses Handbuch bietet umfassende Informationen zu den Konfigurationsschritten in Microsoft Azure und Dynamics 365 Business Central.

Systemanforderungen

Datenbankserver

  • Dynamics 365 Business Central

  • Microsoft Entra ID

Client-Webbrowser

Chrome: 84+

  • Firefox: 73+

  • Safari: 13.0.1+

Kante: 84+

Anschlussanleitung

Registrieren einer App in Microsoft Azure

Die Methode zur Authentifizierung von App Builder für Microsoft Business Central und Dynamics 365 ist OAuth 2.0. Wir werden den OAuth-Flow 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 manchmal von Benutzern der App angezeigt werden. Beispiel: App Builder Geschäftszentrale

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

  5. Klicken Sie auf Registrieren

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

Hinzufügen einer Umleitungs-URI

Die Umleitungs URL stellt den Ort dar, an den Microsoft den Client des Benutzers umleitet und weiterleitet

die Sicherheitstoken nach der Authentifizierung.

  1. Navigieren Sie zur registrierten App in Microsoft Entra ID

  2. Klicken Sie auf Umleitungs-URI hinzufügen, um den Wert einzugeben. Beispiel: http://localhost/auth-response

Hinzufügen eines Client-Geheimnisses

Client-Geheimnisse werden auch als Anwendungskennwort bezeichnet. Die registrierte App in Microsoft Azure erfordert die Erstellung eines Client-Geheimnis-Datensatzes für jede App Builder Umfeld, in der die Verbindung verwendet wird. Wenn Ihre App Builder Wenn die Konfiguration über eine Entwicklungs-, Qualitätssicherungs- und Umfeld verfügt, benötigen Sie drei entsprechende Client-Geheimdatensätze.

Mit den Client-Geheimnissen ist ein Ablaufdatum verknüpft und ihre maximale Gültigkeitsdauer beträgt zwei Jahre.

Durch das Generieren eines Client-Geheimnisdatensatzes erhalten Sie einen Client-Geheimnis-Wert und eine Geheim-ID. Der Wert ist codiert 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 Zertifikate und Geheimnisse

  3. Klicken Sie auf Neues Client-Geheimnis

  4. Geben Sie eine Beschreibung ein. Beispiel: App Builder Produktion

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

  6. Klicken Sie auf Hinzufügen

  7. Notieren Sie den Wert, da er verschlüsselt wird

App-Endpoints

Nachdem eine App in Microsoft Azure registriert wurde, stellt der Bildschirm Endpoints die für die OAuth 2.0-Authentifizierung erforderlichen Endpoint bereit. Beim Konfigurieren des Sicherheitsanbieters in App Builder müssen Sie auf einige dieser Endpoint verweisen.

  1. Navigieren Sie zur registrierten App in Microsoft Entra ID

  2. Klicken Sie auf die Tab Endpoints. Die folgenden Werte sind erforderlich in App Builder:

    1. OAuth 2.0- Endpoint (v2)

    2. OAuth 2.0-Token Endpoint (v2)

API Berechtigungen zuweisen

Die registrierte App in Microsoft Azure benötigt Berechtigungen, die Business Central zugewiesen sind. Dies sollte basierend darauf konfiguriert werden, wie Sie es integrieren möchten mit App Builder. Eine Methode zum Konfigurieren von Berechtigungen ist ein Benutzertyp-Flow, bei dem Sie sich in Azure authentifizieren und Ihre Berechtigungen in Business Central dieselben Berechtigungen vorgeben, die in App Builder.

  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 Berechtigungen entsprechend Ihren Geschäftsanforderungen

Weitere Einzelheiten finden Sie unter Schnellstart: Registrieren einer Anwendung bei der Microsoft Identity Platform

Für diesen Konfigurationsschritt sollten Sie den Wert Anwendungs-ID (Client-ID) für die oben registrierte App an einen leicht zu verwendenden Ort kopieren, z. B. in Ihre Zwischenablage. In Business Central definieren Sie auch Anwendungsberechtigungen.

  1. Navigieren Sie zu Dynamics 365 Business Central

  2. Gehen Sie zu Microsoft Entra ID Applications

  3. Klicken Sie auf Neu

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

  5. Geben Sie die Beschreibung ein. 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 Berechtigungssätze, die die Anwendung in Business Central hat

Weitere Einzelheiten finden Sie unter Business Central On-Premises in Microsoft Entra ID für die Integration mit anderen registrieren Dienstleistungen

Business Central-Webdienste

In Business Central können Sie Webdienste nutzen, um zusätzliche Daten verfügbar zu machen, wenn diese nicht verfügbar sind oder standardmäßig bereits verfügbar sind. Webdienste ermöglichen es Ihnen, eine Seite oder Abfrage in Business Central als Endpoint verfügbar zu machen, ähnlich dem Konzept einer API. Alle in Business Central geltenden Einschränkungen und Beschränkungen gelten auch für die von 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. Beispiel: Seite

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

  6. Weisen Sie einen Dienstnamen zu. Dies stellt den Endpoint dar, an dem Sie ihn aufrufen würden. Beispiel: Zahlungsbedingungen

  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 vorhanden ist

Weitere Einzelheiten finden Sie unter Business Central Web Services.

Erstellen Sie einen OAuth-Sicherheitsanbieter in App Builder

  1. Navigieren Sie zu App Builder IDE

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

  3. Klicken Sie auf + Benutzerauthentifizierung

  4. Geben Sie einen Namen ein. Beispiel: Business Central OAuth

  5. Wählen Sie Typ als OAuth

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

  7. Setzen Sie Authentifizierungstyp auf OAuth

  8. Setzen Sie OAuth-Zuweisung auf Client-Anmeldeinformationen

  9. Setzen Sie OAuth-Client-Authentifizierung auf Parameter

  10. Setzen Sie OAuth-Ressourcenauthentifizierung auf Inhaber

  11. Setzen Sie Token-Eigentümer auf Client

  12. Klicken Sie auf Speichern

    Anhang

  13. Konfigurieren Sie als Nächstes 2 Endpoints, indem Sie auf + Endpoint klicken:

    • Typ = Endpoint, URL = Wert aus den Azure-Portal-Endpoints

    • Typ = Token-Endpoint, URL = Wert aus den Azure-Portal Endpoints

  14. Klicken Sie auf + Anmeldeinformationen

    • Typ = Kunde

    • Benutzername = Client-ID aus dem Azure-Portal

    • Kennwort = Clientgeheimnis aus dem Azure-Portal

    • Klicken Sie auf Speichern

  15. Klicken Sie auf + Eigenschaft

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

Erstellen Sie eine Datenquelle in App Builder

  1. Navigieren Sie zu App Builder IDE

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

  3. Klicken Sie auf + Server

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

  5. Legen Sie den Typ als Dynamics 365 Business Central fest

  6. Geben Sie die URL als Basis-URL für den Zugriff auf Dynamics 365 in Business Central an (enthält die Mandanten-ID in der Zeichenfolge). Beispiel: https://api.businesscentral.dynamics.com/v1.0/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/ODataV4

    Anhang

  7. Geben Sie den Instanznamen an, mit dem eine Verbindung hergestellt werden soll. Dieser stellt das Unternehmen in Business Central dar.

    • Business Central beschränkt Verbindungen auf jeweils ein Unternehmen

    • Wenn eine Verbindung zu mehreren Unternehmen hergestellt werden muss, müssen mehrere Datenserververbindungen konfiguriert und für jede einzelne Datenserververbindung eine Geschäftslogik entwickelt werden

  8. Klicken Sie auf die Schaltfläche Erweiterte Einstellungen

    • Geben Sie bei Bedarf zusätzliche Verbindungsinformationen im Feld Erweitert ein

    • Klicken Sie auf Speichern

    Anhang

  9. Stellen Sie unter Sicherheitseinstellungen den Sicherheitsanbieter auf den konfigurierten Business Central-Anbieter ein

  10. Klicken Sie auf Speichern

Testen der Verbindung

Klicken Sie unter „Testen“ auf die Schaltfläche Verbindung testen und stellen Sie sicher, dass die Konfiguration wie erwartet funktioniert.

Importieren der Endpoint

Nachdem die Konfiguration abgeschlossen ist, können Sie alle gewünschten Endpoint Daten aus Business Central importieren in App Builder. Nach dem Import können Sie die Daten wie gewohnt anzeigen, bearbeiten und mit ihnen interagieren. App Builder, gelten alle Berechtigungen von Business Central.

  1. Navigieren Sie zu App Builder IDE

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

  3. Suchen Sie die erstellte Dynamics 365 Business Central Datenserververbindung und wählen Sie sie aus

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

  5. Klicken Sie auf die Schaltfläche Importieren

  6. Geben Sie den Endpoint aus Web Services im Importmuster an, den Sie abgleichen möchten. Beispiel: Zahlungsbedingungen

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