Den Zugriff auf OData-Webdienste aktivieren

  • 5 Minuten

Mit OData-Webdiensten können Sie mithilfe von REST in anderen Anwendungen auf Daten aus Business Central zugreifen. Diese OData-Webdienste werden häufig in Power BI-Berichten zum Abrufen von Daten aus Business Central verwendet. Die OData-Webdienste sind sofort aktiviert, sodass Sie sofort beginnen können.

Um eine Liste aller verfügbaren OData-Webdienste zu erhalten oder einen neuen Webdienst zu erstellen, suchen Sie im Suchfeld nach Webdiensten.

  1. Wählen Sie das Suchsymbol in der rechten oberen Ecke aus.

  2. Geben Sie Webdienste in das Suchfeld Was möchten Sie tun? ein.

  3. Wählen Sie Webdienste in der angezeigten Liste aus.

Screenshot der Suchergebnisse „Was möchten Sie tun?“ für Webdienste

Die Seite, auf der die verfügbaren Webdienste angezeigt werden, wird verwendet, um den Zugriff auf OData‑ und SOAP-Webdienste zu ermöglichen. Webdienste in Business Central basieren auf vorhandenen Objekten wie Seiten, Abfragen und Codeunits.

Ein OData-Webdienst kann nur mit den Objekttypen Seite und Abfrage verwendet werden, nicht mit Codeunits. Jedes veröffentlichte Objekt generiert einen Link, über den Sie auf den Webdienst zugreifen können. Links werden für OData Version 4 und für den SOAP-Webdienst bereitgestellt.

Screenshot der Übersicht zu Webdiensten

Wenn Sie einen neuen OData-Webdienst hinzufügen möchten, wählen Sie die Schaltfläche Neu im Menü und anschließend den Objekttyp aus. Für OData können Sie entweder Seite oder Abfrage auswählen. Wählen Sie die Objekt-ID aus, und geben Sie dem Dienst einen Namen. Im folgenden Beispiel wird das Objekt Debitorenkarte verwendet, um die Kundendatensätze als OData-Webdienst mit dem Namen Debitoren anzuzeigen. Aktivieren Sie schließlich das Kontrollkästchen Veröffentlicht. Nachdem Sie die Schaltfläche Neu laden im Menü ausgewählt haben, generiert Business Central einen OData v4-Link.

Screenshot des Objekts „Debitorenkarte“ zum Anzeigen von Datensätzen als OData-Webdienst mit dem Kontrollkästchen „Veröffentlicht“

Der generierte Link folgt immer der gleichen Struktur.

https://api.businesscentral.dynamics.com/v2.0/<tenant\>/ODataV4/<service\>

Für die Sandbox-Umgebung können Sie die folgende Struktur verwenden.

https://api.businesscentral.dynamics.com/v2.0/<tenant\>/sandbox/ODataV4/<service\>