Webdienst veröffentlichen

Webdienste sind eine einfache Art, Anwendungsfunktionen für eine Vielzahl von externen Systemen und Benutzern zugänglich zu machen. Business Central enthält die Anzahl von Objekten, die als Webdienste standardmäßig gegenüber die Integration anderer Microsoft-Dienstleistungen bereitgestellt werden, Sie können weitere Web Services hinzufügen.

Sie richten im Internet einen Webdienst ein im Business Central Client. Sie müssen dann den Webdienst veröffentlichen, so dass er für Serviceanforderungen über das Netzwerk bereitsteht. Benutzer können Webdienste erkennen, indem Sie auf einen Browser auf den Computer verweisen, der ausführt und eine Liste der verfügbaren Services anfordern. Wenn Sie einen Webdienst veröffentlichen, ist er über das Netzwerk für authentifizierte Benutzer sofort verfügbar. Alle autorisierten Benutzer können auf Metadaten für Webdienste zugreifen, aber nur Benutzer mit ausreichenden -Berechtigungen können auf tatsächliche Daten zugreifen.

Erstellen und Veröffentlichen eines Webdienstes

Die folgenden Schritte erläutern, wie ein Webdienst erstellt und veröffentlicht wird.

So erstellen und veröffentlichen Sie einen Webdienst

  1. Wählen Sie das Symbol Glühbirne, das die Funktion „Sie wünschen“ öffnet aus, geben Sie Webdienste ein und wählen Sie dann den entsprechenden Link.

  2. Wählen Sie auf der Seite Webdienste Neu aus. Fahren Sie über ein Feld, um eine Kurzbeschreibung zu lesen.

    Note

    Codeunit und Seite sind gültige Arten für SOAP-Webdienste. Seite und Abfrage sind gültige Arten für OData-Webdienste.
    Wenn die Datenbank mehrere Unternehmen enthält, können Sie eine Objekt-ID auswählen, die für eines der Unternehmen eindeutig ist.
    Der Dienstname ist für Nutzer Ihres Webdiensts sichtbar und wird zum Identifizieren und Unterscheiden von Webdiensten verwendet, Sie sollten daher einen aussagefähigen Namen wählen.

  3. Aktivieren Sie das Kontrollkästchen in der Spalte Veröffentlicht.

Wenn Sie den Webdienst veröffentlichen, sehen Sie in den Feldern OData-URL und SOAP-URL die URLs, die für den Webdienst erzeugt wurden. Sie können den Webdienst sofort testen, indem Sie die Links in den OData-URL und SOAP-URL-Feldern auswählen. Optional können Sie den Wert des Felds kopieren und ihn für die spätere Verwendung speichern.

Note

Wenn die als Webdienste bereitgestellten Objekt nicht online über Business Central aufgerufen werden dürfen, müssen Sie die im Code verfügbaren Methoden als [Scope('OnPrem')] markieren. Weitere Informationen finden Sie unter Bereichsattribut .

Nachdem Sie einen Webdienst veröffentlichen, ist er für externe Seiten verfügbar. Sie können die Verfügbarkeit dieses Webdienstes prüfen, indem Sie einen Browser verwenden, oder Sie können den Link in den OData-URL und SOAP-URL -Feldern auf der Seite Webdienste auswählen. Im folgenden Verfahren wird gezeigt, wie Sie die Verfügbarkeit des Webdienstes für die spätere Verwendung prüfen können.

So prüfen Sie die Verfügbarkeit eines Webdienstes

  1. Geben Sie in Ihrem Browser die entsprechende URL ein. Die folgende Tabelle zeigt die Arten von URLs, die Sie für unterschiedliche Webservicearten eingeben können.

    Typ Syntax Beispiel
    SOAP https://api.businesscentral.dynamics.com/*version*/*tenant*/Production/WS/*CompanyName*/*entity*/ https://api.businesscentral.dynamics.com/v2.0/7acc9d3d-d354-4616-8bbd-c4fc9f2b15b3/Production/WS/CRONUS%20USA%2C%20Inc./Page/InvoiceDocument
    OData-V4 https://api.businesscentral.dynamics.com/*version*/*tenant*/Production/ODataV4/Company('*CompanyName*')/*entity* https://api.businesscentral.dynamics.com/v2.0/7acc9d3d-d354-4616-8bbd-c4fc9f2b15b3/Production/ODataV4/Company('CRONUS%20USA%2C%20Inc.')/InvoiceDocument
    Das Feld „Unternehmensname“ berücksichtigt Groß-/Kleinschreibung.

  2. Überprüfen Sie die Informationen, die im Browser angezeigt werden. Vergewissern Sie sich, dass Sie den Namen des Webdienstes sehen, den Sie erstellt haben.

Wenn Sie auf einen Webdienst zugreifen und Daten wieder auf Business Central schreiben möchten, müssen Sie den Firmennamen angeben. Sie können den Mandanten als Teil des URI, wie in Beispielen angezeigt, angeben, oder Sie können den Mandanten als Teil der Abfrageparameter angeben. Beispielsweise verweisen die folgenden URIs auf denselben OData-Webdienst, und beide sind gültige URIs.

https://api.businesscentral.dynamics.com/v1.0/OData/Company('CRONUS International Ltd.')/Customer  

https://api.businesscentral.dynamics.com/v1.0/OData/Customer?company='CRONUS International Ltd.'

Siehe auch

Verwaltung
Business Central-Web Services für Entwickler
OData-Anforderungslimits