SOAP-Webdienste verwenden

  • 5 Minuten

Mit SOAP-Webdiensten können Sie auf Daten aus Business Central in anderen Anwendungen über SOAP zugreifen. Wenn Sie einen formellen Vertrag zwischen dem Server und dem SOAP-Client definieren müssen, oder wenn Ihre Clientanwendung nicht mit REST-Diensten funktioniert, sind SOAP-Webdienste möglicherweise vorteilhafter als OData.

Microsoft hat stark in REST und OData investiert, sicherlich mit Online-Apps wie Power BI, Power Apps, und Power Automate. Daher sind SOAP-Dienste zu diesem Zeitpunkt nicht mehr die primäre Wahl für Webdienste, sie sind jedoch weiterhin verfügbar und aktiviert.

Sie finden die verfügbaren SOAP-Webdienste auf derselben Seite wie die OData-Webdienste, und Sie können jederzeit einen neuen Dienst erstellen. Sie können eine Liste aller verfügbaren SOAP-Webdienste abrufen oder einen neuen Webdienst erstellen, indem Sie Webdienste in das Suchfeld eingeben.

  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.

Die Seite, auf der alle 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 SOAP-Webdienst kann nur mit den Objekttypen Seite und Codeunit verwendet werden, nicht mit Abfrage-Typen. Jedes veröffentlichte Objekt generiert einen Link, über den Sie auf den Webdienst zugreifen können.

Screenshot aller verfügbaren Webdienste, die zum Aktivieren des Zugriffs verwendet werden

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 SOAP können Sie entweder Seite oder Codeunit auswählen. Wählen Sie die Objekt-ID aus, und geben Sie dem Dienst einen Namen. Im folgenden Beispiel wird das Objekt Kundenkarte verwendet, um die Kundendatensätze als SOAP-Webdienst verfügbar zu machen, der Kunden genannt wird. 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 SOAP-Link.

Screenshot des Webdienstes mit markiertem Kontrollkästchen Kontrollkästchen „Veröffentlicht“

Der generierte Link folgt immer der gleichen Struktur.

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

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

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