Business-Central-Zugriff für Data Foundation

Data Foundation führt die Daten aus jedem ERP-System und jeder Instanz, die Sie verbinden, in einem Common Finance Model zusammen. Microsoft Dynamics 365 Business Central gehört zu den ERP-Systemen, die direkt gelesen werden. Die Verbindung nutzt eine Microsoft-Entra-ID-Anwendung mit Client-Anmeldeinformationen, einen schreibgeschützten Berechtigungssatz und einige als Webdienste veröffentlichte Seitenobjekte. Diese Seite richtet sich an den Business-Central-Administrator, der das einrichtet, und an den PlaidCloud-Benutzer, der ihn darum bittet.

PlaidCloud liest Daten ausschließlich. Ein Client-Secret wird nie per E-Mail verschickt.

Zugriffsanfrage senden

Wählen Sie auf der Registerkarte Foundation des Projekts unter Business-Central-Verbindung die Option Neue Verbindung erstellen. Das Formular zeigt die vollständige Anfrage. Klicken Sie auf Anfrage kopieren, um sie in Ihre eigene Nachricht einzufügen, oder auf Anfrage per E-Mail senden, um sie in Ihrem E-Mail-Programm mit dem Betreff „Read-only Business Central access for PlaidCloud (Microsoft Entra ID, client credentials)“ zu öffnen.

Was der Business-Central-Administrator einrichtet

1. Registrieren Sie eine App in Microsoft Entra ID. Fügen Sie unter App registrations > New registration ein Client-Secret hinzu und notieren Sie die Verzeichnis-ID (Mandant), die Anwendungs-ID (Client) und das Secret.

2. Fügen Sie die App in Business Central hinzu. Öffnen Sie Microsoft Entra Applications, fügen Sie die Anwendung hinzu, setzen Sie ihren Status auf Aktiviert und weisen Sie ihr für jedes Unternehmen, über das Sie berichten, die Berechtigungssätze D365 READ und D365 BASIC zu. Weisen Sie ihr keinen Berechtigungssatz mit Schreibrechten zu.

3. Veröffentlichen Sie Seitenobjekte als Webdienste. Veröffentlichen Sie unter Search > Web Services > New diese Seitenobjekte mit genau diesen Dienstnamen und aktiviertem Kontrollkästchen Published. Die Standard-API enthält ihre Felder nicht:

   Seite	Dienstname	Hinweise
   20 G/L Entries	GLEntries
   16 Chart of Accounts	GLAccounts
   100 Accounting Periods	AccountingPeriods
   537 Dimension Values	DimensionValues
   240 Business Units	BusinessUnits
   605 IC Partner List	ICPartners
   5802 Value Entries	ValueEntries	Herstellkosten der verkauften Waren; optional
   120 G/L Budget Entries	GLBudgetEntries	Budgets; optional
   Statistical Ledger Entries	StatisticalLedgerEntries	Statistische Treiber; optional
   118 General Ledger Setup	GeneralLedgerSetup	Shortcut-Dimensionen 3 bis 8; optional
   479 Dimension Set Entries	DimensionSetEntries	Shortcut-Dimensionen 3 bis 8; optional

4. Teilen Sie dem PlaidCloud-Benutzer zwei Festlegungen mit: den Quellcode, unter dem Ihre Prüfungsanpassungen gebucht werden (PlaidCloud geht von ADJUSTMENT aus), und welche Dimension Ihre Abteilung ist (PlaidCloud geht von Global Dimension 1 mit dem Namen DEPARTMENT aus).

Was Sie zurückschicken

Der Administrator schickt	Eingabe in PlaidCloud als
Die Verzeichnis-ID (Mandant)	Directory (tenant) ID
Den Namen der Umgebung, zum Beispiel production	Umgebungsname
Die Anwendungs-ID (Client)	Application (client) ID
Das Client-Secret	Client-Secret, über das Formular eingegeben, nicht per E-Mail
Den Namen der Dimension, die Ihre Abteilung ist	Die Systemeinstellung department_dimension
Die Unternehmen, die PlaidCloud lesen darf	Unter Companies in PlaidCloud ausgewählt (mindestens eines)

Unternehmen, die Konsolidierungsunternehmen sind, tragen Sie in der Systemeinstellung consolidation_companies ein, damit ihre Buchungen nicht als Aktivität eines Unternehmens zählen. Die Wechselkurse stammen aus einem Unternehmen: Nennen Sie es in der Systemeinstellung rate_company, andernfalls verwendet PlaidCloud das erste Unternehmen.

Zugriff prüfen

Geben Sie in PlaidCloud die Werte ein und klicken Sie auf Verbindung testen. Jedes Dataset wird als Lesbar, Fehlende Berechtigung oder Fehler angezeigt:

Dataset	Was es benötigt
Entitäten, Kontenplan, Kunden, Produkte, Wechselkurse, Saldenliste	API-Zugriff (Berechtigungssatz D365 READ)
Geschäftskalender	Der Webdienst AccountingPeriods
Abteilungen	Der Webdienst DimensionValues
Hauptbuch	Der Webdienst GLEntries
Verkaufspositionen, Budget, Verteilungstreiber	Optional

Fehlt ein Dataset, nennt der Test die Berechtigung oder den Webdienst, der hinzuzufügen ist. Bitten Sie den Administrator, ihn hinzuzufügen, und testen Sie erneut. Verkaufspositionen, Budget und Verteilungstreiber sind optional: Eine Umgebung, die sie nicht nutzt, lädt trotzdem alles andere.

Verwandte Themen

• Data Foundation
• Verbindung zu Business Central herstellen