Skip to main content

Einrichtung in Business Central

Nachdem Sie den DYCE API Connector for Dataverse aus dem AppSource installiert haben, führen Sie die folgenden Einrichtungsschritte in Ihrer Business Central-Umgebung durch.

Marketing Einrichtung​

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

  1. Navigieren Sie zu Marketing Einrichtung
    • Verwenden Sie die Suchfunktion (Alt+Q), um Marketing Einrichtung zu finden.
  2. Geschäftsbeziehungscode konfigurieren
    • Stellen Sie sicher, 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. Navigieren Sie zu Microsoft Entra-Anwendungen
    • Verwenden Sie die Suchfunktion in Business Central (Alt+Q)
    • Suchen Sie nach "Microsoft Entra-Anwendungen".
  2. Neue Microsoft Entra-Anwendung erstellen
    • Klicken Sie auf die Schaltfläche + Neu.
    • Geben Sie die Client ID aus Ihrer für Business Central erstellten Entra App-Registrierung ein
    • Fügen Sie eine aussagekräftige Beschreibung hinzu (z. B. "DYCE API Connector for Dataverse Integration")
  3. Zustimmung erteilen
    • Klicken Sie auf die Schaltfläche Zustimmung erteilen, um die Anwendung zu autorisieren.
    • Hinweis: Sie müssen über administrative Rechte verfügen, um die Zustimmung zu erteilen.
    • Sie werden auf die Microsoft-Zustimmungsseite weitergeleitet.
    • Melden Sie sich mit Ihrem Microsoft-Konto an und genehmigen Sie die Zugriffsrechte
    • Bestätigen Sie die erfolgreiche Authentifizierung
  4. Aktivieren Sie die Anwendung
    • Ändern Sie das Feld Status von Deaktiviert auf Aktiviert.
    • 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. Navigieren Sie zu den Benutzerberechtigungssätzen
    • Öffnen Sie den Microsoft Entra-Anwendungsdatensatz
    • Greifen Sie auf den Abschnitt Benutzerberechtigungssätze zu
  2. Erforderliche Berechtigungen zuweisen Fügen Sie die folgenden Berechtigungssätze hinzu:
    • 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.