Ressourcen
Hilfe & Support ↗ Lucanet Learning Space ↗
Dokumentation
Getting Started
Globale Funktionen
Lucanet Lume
Administration
Data Hub
Integrationen
Microsoft Dynamics 365 Business Central Beta
Microsoft Dynamics 365 Business Central (JDBC)
Microsoft Dynamics 365 Business Central (OData)
SAP S/4HANA (RFC)
Verbindungen verwalten
Quelldatensätze verwalten
Daten importieren
Consolidation & Financial Planning
Lease Accounting
Extended Planning and Analysis (xP&A)
ESG Reporting
Disclosure Management
XBRL-Tagger
Tax Compliance & Reporting
Banking & Cash Management
Data Collection
Glossar

Integration Microsoft Dynamics 365 Business Central (OData) in Data Hub

Überblick

Die Integration Microsoft Dynamics 365 Business Central (OData) in Data Hub extrahiert per OData v4 Daten aus Microsoft Dynamics 365 Business Central und schreibt sie als Parquet-Rohdatensätze in den Lucanet Data Lake. Im Data Lake stehen die Daten für die weitere Verarbeitung in der Lucanet CFO Solution Platform zur Verfügung.

Diese Seite beschreibt die technischen Details und die Voraussetzungen der Integration Microsoft Dynamics 365 Business Central (OData) in Data Hub, alle Schritte vom Erstellen der Verbindung bis zum Start des Imports, die Verbindungseinstellungen, alle Optionen der Konfiguration des Quelldatensatzes, Beispielkonfigurationen, eine Checkliste für die Konfiguration und die Release Notes.

Dieses Dokument beschreibt die Version 1.4 der Integration Microsoft Dynamics 365 Business Central (OData). Im Verbindungsformular wird die Version im Bereich Vorsystem angezeigt, z. B. Version: 1.4.0. Bugfix-Versionen wie 1.4.1 werden automatisch angewendet und ändern die auf dieser Seite beschriebenen Optionen nicht. Die Änderungen jeder Version finden Sie in den Release Notes.

Technische Details der Integration Microsoft Dynamics 365 Business Central (OData) in Data Hub

Die Integration Microsoft Dynamics 365 Business Central (OData) verwendet das Skript #3724-GenericDataUploadViaODatav4 und wird von der Lucanet.Script Execution Application (SEA) ausgeführt. Die Integration liest die Daten über die OData-v4-Webdienste von Business Central und meldet sich über den OAuth-2.0-Client-Credentials-Flow bei Microsoft Entra ID an. Lucanet.Financial Client ist nicht beteiligt.

Die Integration Microsoft Dynamics 365 Business Central (OData) schreibt die Daten als Rohdaten. Die Integration ordnet keine Werte einem Zielschema zu und wandelt keine Werte um: Die Felder der Entität werden so gespeichert, wie der Webdienst sie zurückgibt. Die Datentypen der Spalten werden aus den OData-Metadaten des Webdienstes übernommen. Die Daten können Sie später im Data Lake verknüpfen, filtern oder zuordnen.

Voraussetzungen für die Integration Microsoft Dynamics 365 Business Central (OData) in Data Hub

Für die Integration Microsoft Dynamics 365 Business Central (OData) in Data Hub gelten die folgenden Voraussetzungen. Die Voraussetzungen betreffen die Umgebung und sind keine Optionen der Integration:

  • Eine Lizenz für die Integration Microsoft Dynamics 365 Business Central (OData). Ohne Lizenz wird Microsoft Dynamics 365 Business Central (OData) in der Dropdown-Liste Vorsystem nicht angezeigt.
  • Eine laufende SEA-Instanz, die die Integration Microsoft Dynamics 365 Business Central (OData) ausführt
  • Eine App-Registrierung in Microsoft Entra ID mit einem geheimen Clientschlüssel, die sich über den OAuth-2.0-Client-Credentials-Flow anmelden kann. Die App-Registrierung benötigt die Anwendungsberechtigung API.ReadWrite.All für Dynamics 365 Business Central mit Administratorzustimmung. In Business Central muss die App-Registrierung auf der Seite Microsoft Entra-Anwendungen eingerichtet und aktiviert sein, mit Berechtigungssätzen, die Lesezugriff auf die benötigten Daten gewähren. Der Berechtigungssatz SUPER kann Anwendungen nicht zugewiesen werden. Weitere Informationen finden Sie unter Using Service to Service Authentication in der Microsoft-Dokumentation.
  • Die zu lesenden Entitäten, in Business Central als OData-v4-Webdienste veröffentlicht
  • Ein Netzwerkzugriff über HTTPS von der SEA-Instanz auf login.windows.net und auf den Host der Business-Central-Webdienste

Daten mit der Integration Microsoft Dynamics 365 Business Central (OData) in Data Hub importieren

So importieren Sie Daten mit der Integration Microsoft Dynamics 365 Business Central (OData) in Data Hub:

1

Erstellen Sie eine Verbindung mit dem Vorsystem Microsoft Dynamics 365 Business Central (OData) und geben Sie die Einstellungen für den Zugriff auf Business Central ein. Weitere Informationen finden Sie unter Verbindung für die Integration Microsoft Dynamics 365 Business Central (OData) erstellen.

2

Erstellen Sie einen Quelldatensatz, der die Verbindung verwendet, und legen Sie in seinem Bereich Konfiguration fest, welche Daten aus dem Vorsystem extrahiert werden. Eine Verbindung kann einen oder mehrere Quelldatensätze haben. Weitere Informationen finden Sie unter Quelldatensatz für die Integration Microsoft Dynamics 365 Business Central (OData) erstellen.

3

Starten Sie einen Import des Quelldatensatzes. Prüfen Sie vor dem ersten Import die Punkte der Checkliste für die Konfiguration der Integration Microsoft Dynamics 365 Business Central (OData). Weitere Informationen finden Sie unter Import für die Integration Microsoft Dynamics 365 Business Central (OData) starten.

Verbindung für die Integration Microsoft Dynamics 365 Business Central (OData) in Data Hub erstellen

Eine Verbindung der Integration Microsoft Dynamics 365 Business Central (OData) in Data Hub legt die Einstellungen fest, mit denen Data Hub auf Business Central zugreift.

So erstellen Sie eine Verbindung für die Integration Microsoft Dynamics 365 Business Central (OData) in Data Hub:

1

Wählen Sie im Hauptmenü Data Hub. Die Seite Integrationen wird z. B. wie folgt angezeigt:

Zeigt die Seite 'Integrationen' in Data Hub mit der Schaltfläche 'Neue Verbindung anlegen' und einer Tabelle mit den Spalten 'Verbindungsname, Anzahl der zugehörigen Datensätze', 'Vorsystem', 'Status', 'Erzeugt von' und 'Import'. Die Tabelle listet Verbindungen mit den Vorsystemen 'Microsoft Dynamics 365 Business Central (OData)' und 'SAP S/4HANA (RFC)', alle mit dem Status 'Aktiv'. Rot hervorgehoben ist 'Data Hub' im Hauptmenü.
Verbindungen und ihre Quelldatensätze auf der Seite 'Integrationen'
2

Klicken Sie oben rechts auf Neue Verbindung anlegen. Das Verbindungsformular wird z. B. wie folgt angezeigt:

Zeigt das Verbindungsformular in Data Hub mit dem leeren Feld für den Verbindungsnamen und der Meldung 'Dieses Feld ist erforderlich.', den Schaltflächen 'Verbindung testen', 'Abbrechen' und 'Anlegen' oben rechts und der geöffneten Dropdown-Liste 'Vorsystem' mit den Optionen 'Microsoft Dynamics 365 Business Central (JDBC)', 'Microsoft Dynamics 365 Business Central (OData)', 'Microsoft Dynamics 365 Business Central Beta' und 'SAP S/4HANA (RFC)'.
Verbindungsformular mit der Vorsystemauswahl
3

Wählen Sie in der Dropdown-Liste Vorsystem den Eintrag Microsoft Dynamics 365 Business Central (OData). Oben rechts im Bereich Vorsystem wird die Version der Integration angezeigt.

4

Geben Sie oben im Verbindungsformular im Feld Geben Sie den Verbindungsnamen ein einen Namen für die Verbindung ein. Der Name kennzeichnet die Verbindung auf der Seite Integrationen.

5

Wählen Sie im Bereich Konfiguration die SEA-Instanz, die die Verbindung ausführt. Weitere Informationen finden Sie unter Lucanet.Script Execution Application.

6

Geben Sie im Bereich Authentifizierung einer Verbindung für Microsoft Dynamics 365 Business Central (OData) die folgenden Informationen ein:

OptionErforderlichBeschreibungBeispiel
EndpunktJaURL des OData-v4-Dienststamms der Business-Central-Umgebung. Die URL darf das Unternehmen nicht enthalten, z. B. Company('CRONUS'). Das Unternehmen legen Sie im Quelldatensatz fest.https://api.businesscentral.dynamics.com/v2.0/<tenant-id>/Production/ODataV4/
Client-IDJaAnwendungs-ID (Client-ID) der App-Registrierung in Microsoft Entra ID00000000-0000-0000-0000-000000000000
Client-GeheimnisJaGeheimer Clientschlüssel der App-Registrierung(geheim)
Mandanten-IDJaVerzeichnis-ID (Mandanten-ID) des Microsoft-Entra-ID-Mandanten der App-Registrierung00000000-0000-0000-0000-000000000000
RessourceNeinRessource, für die das Zugriffstoken angefordert wird. Wenn Sie das Feld leer lassen, wird https://api.businesscentral.dynamics.com verwendet.https://api.businesscentral.dynamics.com
7

Geben Sie bei Bedarf unten im Verbindungsformular im Feld Beschreibung eine Beschreibung der Verbindung ein.

8

Klicken Sie bei Bedarf oben rechts auf Verbindung testen, um zu prüfen, ob Data Hub Business Central mit den eingegebenen Einstellungen erreicht. Data Hub speichert die Einstellungen dabei nicht. Weitere Informationen finden Sie unter Verbindung testen.

9

Klicken Sie auf Anlegen. Die Verbindung wird erstellt und auf der Seite Integrationen angezeigt.

Quelldatensatz für die Integration Microsoft Dynamics 365 Business Central (OData) in Data Hub erstellen

Ein Quelldatensatz der Integration Microsoft Dynamics 365 Business Central (OData) in Data Hub legt fest, welche Daten aus Business Central importiert werden. Jeder Quelldatensatz gehört zu einer Verbindung, und eine Verbindung kann einen oder mehrere Quelldatensätze haben.

Sie erstellen einen Quelldatensatz für die Integration Microsoft Dynamics 365 Business Central (OData) in Data Hub in drei Teilen und in dieser Reihenfolge: zuerst die allgemeinen Optionen des Quelldatensatzes, dann den Reiter Upload configuration des Bereichs Konfiguration und zum Schluss das Speichern des Quelldatensatzes.

So legen Sie die allgemeinen Optionen eines Quelldatensatzes für die Integration Microsoft Dynamics 365 Business Central (OData) in Data Hub fest:

1

Klicken Sie auf der Seite Integrationen in der Zeile der Verbindung für Microsoft Dynamics 365 Business Central (OData) auf das Symbol Drei-Punkte-Symbol und wählen Sie Neuen Datensatz anlegen.

2

Geben Sie im Feld Name einen Namen für den Quelldatensatz ein. Der Name kennzeichnet den Quelldatensatz auf der Seite Integrationen.

3

Prüfen Sie die Verbindung in der Dropdown-Liste Verbindung. Die Verbindung, aus der Sie den Quelldatensatz erstellen, ist vorausgewählt. Bei Bedarf können Sie eine andere Verbindung wählen. Der Bereich Konfiguration zeigt dann die Optionen des gewählten Vorsystems. Nach dem Erstellen des Quelldatensatzes kann die Verbindung nicht mehr geändert werden.

4

Geben Sie im Feld Namensraum einen technischen Bezeichner für den Quelldatensatz ein. Mit dem Namensraum wird in SQL-Abfragen an den Data Lake auf die Datentabellen des Quelldatensatzes verwiesen, z. B. Namensraum.Tabellenname. Der Namensraum darf maximal 255 Zeichen lang sein und muss SQL-konform sein, ohne Leerzeichen oder nicht unterstützte Sonderzeichen.

5

Legen Sie bei Bedarf im Bereich Variablen Variablen fest. Variablen sind Platzhalter in der Konfiguration, deren Werte bei jedem Start eines Imports gewählt werden. Weitere Informationen finden Sie unter Variablen.

Der Bereich Variablen wird z. B. wie folgt angezeigt:

Zeigt den Bereich 'Variablen' eines Quelldatensatzes in Data Hub mit den Spalten 'Variablenname', 'Anzeigename', 'Datentyp' und 'Auswahltyp' und den Variablen 'PERIOD' ('Periode', 'Zeichenkette', 'Einzelwert', 3 Werte) und 'YEAR' ('Wirtschaftsjahr', 'Zeichenkette', 'Einzelwert') sowie der Schaltfläche 'Variable hinzufügen'. Rot hervorgehoben ist 'Werte konfigurieren' in der Zeile der Variable 'YEAR'.
Bereich 'Variablen' eines Quelldatensatzes

Reiter 'Upload configuration' konfigurieren

Im Bereich Konfiguration eines Quelldatensatzes für Microsoft Dynamics 365 Business Central (OData) enthält der Reiter Upload configuration alle Optionen des Quelldatensatzes. Jeder Quelldatensatz liest genau eine Entität eines Unternehmens. Um mehrere Entitäten oder Unternehmen zu lesen, erstellen Sie für jede bzw. jedes einen eigenen Quelldatensatz.

Die folgende Tabelle beschreibt die Optionen auf dem Reiter Upload configuration der Integration Microsoft Dynamics 365 Business Central (OData):

OptionErforderlichBeschreibungBeispiel
Current companyJaName des Business-Central-Unternehmens, dessen Daten gelesen werden. Für jeden Import erforderlich, auch wenn Use fixed navigation filter 'Company' nicht gewählt ist. In diesem Fall wird das Unternehmen nicht zum Lesen der Daten verwendet.CRONUS International Ltd.
Current entityJaName der Entität, die gelesen wird, genau so, wie sie in den OData-Metadaten des Endpunkts veröffentlicht ist, z. B. der Dienstname eines Webdienstes. Wenn die Entität nicht gefunden wird, bricht der Import mit einem Fehler ab.Chart_of_Accounts
Query parametersNeinOData-Abfrageoptionen, mit denen die Daten eingeschränkt oder sortiert werden. Jede Abfrageoption wird in einer eigenen Zeile mit den Spalten Query option und Value angegeben. Weitere Informationen finden Sie unter Query parameters.Filter, Account_Type eq 'Posting'
Use fixed navigation filter 'Company'NeinWenn die Option gewählt ist, liest die Integration die Entität des Unternehmens in Current company. Wählen Sie diese Option für Entitäten, die zu einem Unternehmen gehören.Gewählt

Query parameters

Die Tabelle Query parameters auf dem Reiter Upload configuration der Integration Microsoft Dynamics 365 Business Central (OData) enthält die OData-Abfrageoptionen der Anfrage. In der Spalte Query option wählen Sie eine der folgenden Abfrageoptionen und in der Spalte Value geben Sie ihren Wert ein:

Query optionWert
SelectKommagetrennte Liste der Felder, die gelesen werden. Jedes Feld muss in der Entität vorhanden sein. Die Felder legen die Spalten des Datensatzes im Data Lake fest, in der angegebenen Reihenfolge. Wenn Sie Select nicht verwenden, werden alle Felder der Entität gelesen, außer Navigationseigenschaften.
FilterOData-Filterausdruck. Der Ausdruck muss mindestens einen der Operatoren eq, ne, gt, ge, lt, le, and, or, not, in oder has enthalten.
OrderByKommagetrennte Liste der Felder, nach denen sortiert wird, jeweils optional gefolgt von asc oder desc
TopMaximale Anzahl der Datensätze, die gelesen werden, als ganze Zahl ab 0
SkipAnzahl der Datensätze, die übersprungen werden, als ganze Zahl ab 0
SearchFreitextsuche mit maximal 200 Zeichen

Für die Tabelle Query parameters der Integration Microsoft Dynamics 365 Business Central (OData) gelten die folgenden Regeln:

  • Jede Abfrageoption kann nur einmal verwendet werden.
  • Jede Zeile benötigt einen Wert.
  • Wenn eine Regel verletzt wird oder ein Feld in Select in der Entität nicht vorhanden ist, bricht der Import mit einem Fehler ab.

Datentypen im Data Lake

Die Integration Microsoft Dynamics 365 Business Central (OData) übernimmt die Datentypen der Spalten aus den OData-Metadaten der Entität. Die folgende Tabelle beschreibt, wie die OData-Datentypen im Data Lake gespeichert werden:

OData-DatentypDatentyp im Data Lake
Edm.BooleanBoolescher Wert
Edm.Byte, Edm.SByteByte
Edm.Int16, Edm.Int32, Edm.Int64Ganze Zahl der passenden Größe
Edm.Single, Edm.DoubleGleitkommazahl
Edm.DecimalDezimalzahl mit 2 Nachkommastellen. Weitere Nachkommastellen, z. B. von Wechselkursen oder Mengen, werden nicht gespeichert.
Edm.DateDatum
Edm.TimeOfDay, Edm.DurationUhrzeit
Edm.DateTimeOffsetDatum und Uhrzeit
Alle anderen Datentypen, z. B. Edm.String und Edm.GuidText

Beispielkonfiguration für den Reiter 'Upload configuration'

Das folgende Beispiel zeigt eine Konfiguration eines Quelldatensatzes der Integration Microsoft Dynamics 365 Business Central (OData), die aus dem Kontenplan die Nummer, den Namen und die Kontoart aller Buchungskonten eines Unternehmens liest:

OptionWert
Current companyCRONUS International Ltd.
Current entityChart_of_Accounts
Query parametersSelect, No, Name, Account_Type
Filter, Account_Type eq 'Posting'
Use fixed navigation filter 'Company'Gewählt

Das Beispiel ist ein Muster: Die Namen der Entität und ihrer Felder hängen von den Webdiensten ab, die im Business-Central-System veröffentlicht sind.

Quelldatensatz speichern

Um den Quelldatensatz für Microsoft Dynamics 365 Business Central (OData) zu speichern, klicken Sie auf Anlegen. Der Quelldatensatz wird erstellt und unter der gewählten Verbindung auf der Seite Integrationen angezeigt.

Nach dem ersten Import kann ein Quelldatensatz nicht mehr bearbeitet werden. Vor dem ersten Import können alle Optionen außer der Verbindung noch geändert werden.

Import für die Integration Microsoft Dynamics 365 Business Central (OData) in Data Hub starten

Ein Import der Integration Microsoft Dynamics 365 Business Central (OData) in Data Hub extrahiert die in einem Quelldatensatz festgelegten Daten aus Business Central und schreibt sie in den Data Lake. Die Integration Microsoft Dynamics 365 Business Central (OData) prüft die Konfiguration des Quelldatensatzes, wenn der Import ausgeführt wird. Die Integration liest die Daten seitenweise mit bis zu 10.000 Datensätzen pro Seite.

Wie ein Import der Integration Microsoft Dynamics 365 Business Central (OData) die Daten im Data Lake ändert, hängt davon ab, ob der Quelldatensatz Variablen verwendet. Weitere Informationen finden Sie unter Import in Data Hub starten.

So starten Sie einen Import eines Quelldatensatzes für Microsoft Dynamics 365 Business Central (OData) in Data Hub:

1

Klicken Sie auf der Seite Integrationen in der Zeile des Quelldatensatzes, den Sie importieren möchten, auf das Symbol Drei-Punkte-Symbol.

2

Wählen Sie Import starten. Verwendet der Quelldatensatz keine Variablen, führt Data Hub den Import unmittelbar aus.

Wenn der Quelldatensatz Variablen verwendet, wird der Dialog Ausführung des Imports starten z. B. wie folgt angezeigt:

Zeigt den Dialog 'Ausführung des Imports starten' in Data Hub für den Datensatz 'dataset 2025-2026' mit dem Text 'Legen Sie die Importvariablen fest und führen Sie anschließend die Extraktion durch.', der Variable 'Periode' mit dem Wert 'Januar' und der geöffneten Dropdown-Liste der Variable 'Wirtschaftsjahr' mit den Werten '2025' und '2026'.
Dialog 'Ausführung des Imports starten' eines Quelldatensatzes mit zwei Variablen
3

Wählen Sie im Dialog Ausführung des Imports starten für jede Variable des Quelldatensatzes einen Wert und klicken Sie dann auf Ausführen.

Data Hub importiert die Daten und protokolliert die Ausführung im Ausführungsverlauf des Quelldatensatzes. Weitere Informationen zum Ausführungsverlauf finden Sie unter Daten importieren.

Checkliste für die Konfiguration der Integration Microsoft Dynamics 365 Business Central (OData) in Data Hub

Nach dem ersten Import kann ein Quelldatensatz der Integration Microsoft Dynamics 365 Business Central (OData) in Data Hub nicht mehr bearbeitet werden. Prüfen Sie deshalb vor dem ersten Import die folgenden Punkte:

  • Die Verbindung verwendet Microsoft Dynamics 365 Business Central (OData) als Vorsystem, und Endpunkt, Client-ID, Client-Geheimnis und Mandanten-ID im Bereich Authentifizierung sind ausgefüllt.
  • Der Endpunkt enthält den OData-v4-Dienststamm der Business-Central-Umgebung, ohne das Unternehmen.
  • Der Quelldatensatz verwendet diese Verbindung.
  • Auf dem Reiter Upload configuration sind Current company und Current entity ausgefüllt.
  • Bei einer Entität, die zu einem Unternehmen gehört, ist Use fixed navigation filter 'Company' gewählt.
  • In der Tabelle Query parameters wird jede Abfrageoption nur einmal verwendet und hat einen Wert.

Release Notes für die Integration Microsoft Dynamics 365 Business Central (OData) in Data Hub

Die Release Notes der Integration Microsoft Dynamics 365 Business Central (OData) in Data Hub listen die Änderungen jeder Version mit neuen oder geänderten Optionen auf, die neueste zuerst. Bugfix-Versionen werden nicht aufgeführt.

Version 1.4

Version 1.4 ist die erste dokumentierte Version der Integration Microsoft Dynamics 365 Business Central (OData) in Data Hub. Version 1.4 basiert auf der Version 1.4 des Skripts #3724-GenericDataUploadViaODatav4.

Dieser Inhalt wurde mithilfe von KI erstellt und vor der Veröffentlichung von Lucanet-Fachexperten geprüft.

Seiten-IDKB9484363

Zuletzt aktualisiert am 13.11.2026

Inhaltsverzeichnis
ÜberblickTechnische Details der Integration Microsoft Dynamics 365 Business Central (OData) in Data HubVoraussetzungen für die Integration Microsoft Dynamics 365 Business Central (OData) in Data HubDaten mit der Integration Microsoft Dynamics 365 Business Central (OData) in Data Hub importierenVerbindung für die Integration Microsoft Dynamics 365 Business Central (OData) in Data Hub erstellenQuelldatensatz für die Integration Microsoft Dynamics 365 Business Central (OData) in Data Hub erstellenReiter 'Upload configuration' konfigurierenQuelldatensatz speichernImport für die Integration Microsoft Dynamics 365 Business Central (OData) in Data Hub startenCheckliste für die Konfiguration der Integration Microsoft Dynamics 365 Business Central (OData) in Data HubRelease Notes für die Integration Microsoft Dynamics 365 Business Central (OData) in Data HubVersion 1.4
Verwandte Artikel

Unternehmen

Rechtliches

© Copyright 2026 - Lucanet AG