Skip to main content

Einrichtung in Business Central

Nach der Installation des DYCE API Connector for Dataverse aus dem AppSource sind die folgenden Einrichtungsschritte in der Business Central-Umgebung durchzuführen.

Marketing Einrichtung​

Um eine korrekte Synchronisation zu gewährleisten, muss der Geschäftsbeziehungscode für Debitoren konfiguriert sein.

  1. Zu Marketing Einrichtung navigieren
    • Die Suchfunktion (Alt+Q) verwenden, um Marketing Einrichtung zu finden.
  2. Geschäftsbeziehungscode konfigurieren
    • Sicherstellen, dass das Feld Geschäftsbeziehungscode für Debitoren ausgefüllt ist.
    • Diese Einstellung ist erforderlich, um Kontakte mit Debitoren zu verknüpfen.

Einrichtung Microsoft Entra-Anwendung​

  1. Zu Microsoft Entra-Anwendungen navigieren
    • Die Suchfunktion in Business Central (Alt+Q) verwenden
    • Nach "Microsoft Entra-Anwendungen" suchen.
  2. Neue Microsoft Entra-Anwendung erstellen
    • Auf die Schaltfläche + Neu klicken.
    • Die Client ID aus der für Business Central erstellten Entra App-Registrierung eingeben
    • Eine aussagekräftige Beschreibung hinzufügen (z. B. "DYCE API Connector for Dataverse Integration")
  3. Zustimmung erteilen
    • Auf die Schaltfläche Zustimmung erteilen klicken, um die Anwendung zu autorisieren.
    • Hinweis: Zum Erteilen der Zustimmung sind administrative Rechte erforderlich.
    • Die Microsoft-Zustimmungsseite wird geöffnet.
    • Mit dem Microsoft-Konto anmelden und die Zugriffsrechte genehmigen
    • Die erfolgreiche Authentifizierung bestätigen
  4. Die Anwendung aktivieren
    • Das Feld Status von Deaktiviert auf Aktiviert ändern.
    • Diese Aktivierung erstellt einen Systembenutzer für die Integration

Zugriffsrechte​

Berechtigungen erstrecken sich über Business Central und Microsoft Entra.

Business Central​

Die App enthält zwei Berechtigungssätze:

  • DYCEACDUSER (DYCE ACD Entra Benutzer)
    Dieser Berechtigungssatz kann allen Benutzern zugewiesen werden, die mit Kontakten und Verkaufschancen-Elementen arbeiten und Verkaufsbelege buchen dürfen. Darüber hinaus enthält er Lese-Berechtigungen für einige Stammdatentabellen.
  • DYCEACDOPPELEMENTMGT (DYCE ACD Verk.-Ch. Elemente)
    Dieser Berechtigungssatz hat im Vergleich zu DYCEACDUSER einen eingeschränkten Umfang. Er ist für alle Benutzer gedacht, die allgemein mit Verkaufschancen arbeiten.

Weitere Informationen zu Berechtigungssätzen finden Sie in diesem Teil der Microsoft Dokumentation.

Microsoft Entra​

Die Microsoft Entra-Anwendung erfordert bestimmte Berechtigungssätze für den Zugriff auf die erforderlichen API-Pages:

  1. Zu den Benutzerberechtigungssätzen navigieren
    • Den Microsoft Entra-Anwendungsdatensatz öffnen
    • Auf den Abschnitt Benutzerberechtigungssätze zugreifen
  2. Erforderliche Berechtigungen zuweisen Die folgenden Berechtigungssätze hinzufügen:
    • DYCE ACD Entra User (ID: 72077780)
      • Ermöglicht Zugriff auf alle API Connector for Dataverse-spezifischen API-Pages
      • Beinhaltet Berechtigungen für Verkaufschancen-Elemente, Kontakte und Verkaufsdaten
      • Inkludiert automatisch: D365 SALES, D365 OPPORTUNITY MGT, und Logging-Berechtigungen
    • D365 BASIC
      • Ermöglicht Standardzugriff auf Business Central Basisfunktionen
      • Erforderlich für grundlegende System-Operationen

Diese Berechtigungssätze stellen sicher, dass die Integration Daten über die API-Seiten lesen und schreiben kann, während die Sicherheitsgrenzen gewahrt bleiben.