Vorgehensweise: Veröffentlichen eines Webdiensts
Webdienste sind eine einfache Art, Anwendungsfunktionen für eine Vielzahl von externen Systemen und Benutzern zugänglich zu machen. Dynamics NAV 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 können einen Webdienst im Windows-Client oder im Webclienten einrichten. 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
Wählen Sie das Symbol
und geben Internetquellen ein. Wählen Sie dann den zugehörigen Link aus.Wählen Sie auf der Seite Webdienste Neu aus. Wählen Sie ein Feld aus, um eine kurze Beschreibung des Feldes zu lesen oder einen Link für weitere Informationen zu öffnen.
Hinweis
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.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.
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 im Fenster 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
Geben Sie in Ihrem Browser die entsprechende URL ein. Die folgende Tabelle zeigt die Arten von URLs, die Sie eingeben können. Für SOAP-Webdienste verwenden Sie das folgende Format für Ihr URI.
Webdiensttyp Syntax Beispiel SOAP https://*Server*:*SOAPWebServicePort*/*ServerInstance*/WS/*CompanyName*/salesDocuments/ https://mycompany.financials.dynamics.com:7047/MS/WS/MyCompany/Page/salesDocuments?tenant=mycompany.financials.dynamics.com OData https://*Server*:*ODataWebServicePort*/*ServerInstance*/OData/Company('*CompanyName*') https://MyCompany.financials.dynamics.com:7048/MS/OData/Company('MyCompany')/salesDocuments?tenant=MyCompany.financials.dynamics.com The company name is case-sensitive.</td>Ü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 Dynamics NAV 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://localhost:7048/server/OData/Company('CRONUS International Ltd.')/Customer
https://localhost:7048/server/OData/Customer?company='CRONUS International Ltd.'