Skip to main content

Voraussetzungen für DYCE API Connector für Dataverse

Vorsicht

Die standard Microsoft Dataverse-Verbindung darf nicht aktiviert werden, wenn DYCE API Connector for Dataverse verwendet wird. Die Aktivierung beider Dataverse-Verbindungen kann zu doppelten Daten und Synchronisationskonflikten führen.

Vor der Installation von DYCE API Connector for Dataverse müssen die folgenden Anforderungen erfüllt sein:

  • Administrativer Zugriff auf die Microsoft Entra ID (früher Azure AD)
  • Ein aktives Azure-Abonnement
  • Administrative Berechtigungen in Business Central
  • Zugriff auf die Dataverse/Dynamics 365 Sales-Umgebung
  • Koordination mit wysa für die Bereitstellung von SalesCentral und DataBridge

Der Einrichtungsprozess umfasst drei Hauptkomponenten:

  1. DYCE API Connector for Dataverse - Die AppSource-App, die API-Pages in Business Central bereitstellt
  2. SalesCentral - wysas Vertriebslösung für die Dynamics 365 Sales Prozessanpassung
  3. DataBridge - Azure-gehostetes Mapping- und Synchronisationsmodul

Die Einrichtung von SalesCentral und DataBridge ist unter DataBridge und SalesCentral beschrieben.

App-Registrierung in Microsoft Entra ID​

Um eine sichere Kommunikation zwischen Business Central und Dataverse zu ermöglichen, müssen zwei App-Registrierungen in Microsoft Entra ID erstellt werden.

Business Central App Registrierung​

  1. Zu dem Azure Portal > Microsoft Entra ID > App-Registrierungen navigieren
  2. Auf Neue Registrierung klicken, um eine neue App-Registrierung zu erstellen.
  3. Die folgenden API-Berechtigungen konfigurieren:
    • Business Central API.ReadWrite.All (erfordert die Zustimmung des Administrators)
    • Business Central Automation.ReadWrite.All (erfordert die Zustimmung des Administrators)
    • User.Read (delegierte Berechtigung)
  4. Ein Administrator muss die Berechtigungen für Business Central erteilen
  5. Die Anwendungs-(Client-)ID zur Verwendung bei der Einrichtung von Business Central notieren

Dataverse/SalesCentral App-Registrierung​

  1. Eine zweite App-Registrierung nach demselben Verfahren wie oben erstellen
  2. Die folgende API Berechtigung konfigurieren:
    • User.Read (delegierte Berechtigung)
  3. Die Anwendungs-(Client-)ID für die Verwendung bei der Einrichtung von SalesCentral notieren

So wird ein Client-Geheimnis für eine der App-Registrierungen generiert:

  1. Zu Azure Portal > Microsoft Entra ID > App-Registrierungen navigieren.
  2. Die App-Registrierung auswählen, für die ein Geheimnis erstellt werden soll.
  3. Zu Zertifikate & Geheimnisse > Geheime Clientschlüssel gehen.
  4. Auf Neuer geheimer Clientschlüssel klicken.
  5. Eine Beschreibung hinzufügen, ein "Gültig bis" Datum wählen und dann auf Hinzufügen klicken.
  6. Den Wert des Geheimnisses sofort kopieren. Er wird nur dieses eine Mal angezeigt. Der Wert ist sicher aufzubewahren, da er für die Konfiguration der Verbindung zwischen Business Central und Dataverse/SalesCentral benötigt wird.