Testen eines BizTalk-Webdiensts

Artikel
05/04/2023

Überblick

Sie können Ihren veröffentlichten Webdienst testen, ohne eine Webclientanwendung schreiben zu müssen. Sie können den veröffentlichten Webdienst mit einem Webbrowser (z. B. Internet Explorer) testen. Obwohl Sie mit einem Webbrowser auf jeden veröffentlichten Webdienst zugreifen können, können Sie nur Webdienste mit Webmethoden testen, deren Parameter einfache Typen haben. Um Ihre Webmethode in einem Webbrowser zu testen, können Ihre Nachrichtenteile für die Anforderungs- und Antwortnachrichten, die im Empfangsport verwendet werden, nur ein einfacher Typ sein, z . B. System.String oder System.Int32. Wird für irgendeinen Nachrichtenteil ein Schema als Nachrichtentyp verwendet, können Sie die Webmethode nicht mit einem Browser testen.

Wenn Sie einen Ihrer veröffentlichten Webdienste mit HTTP-GET oder HTTP-POST testen möchten, müssen Sie Ihren BizTalk-Empfangsspeicherort für den SOAP-Adapter konfigurieren und die Datei Web.config für den veröffentlichten Webdienst ändern.

Ändern der Empfangsspeicherorte

Wenn der SOAP-Adapter Empfangsspeicherorte konfiguriert, legt der SOAP-Adapter üblicherweise den URI des jeweiligen Empfangsspeicherorts fest, indem er das virtuelle Verzeichnis und den Dateinamen der ASMX-Datei des Webdiensts angibt:

/PurchaseOrder/POOrchestration.asmx

Dadurch wird es dem SOAP-Adapter ermöglicht, Webdienstanforderungen über das HTTP-SOAP-Protokoll zu empfangen. Soll der Empfangsspeicherort so konfiguriert werden, dass für ihn das HTTP-GET- oder HTTP-POST-Protokoll verwendet wird, müssen Sie den Methodennamen an den URI anfügen:

/PurchaseOrder/POOrchestration.asmx/Operation_1

Der Methodenname ist mit dem Portoperationsnamen in der Orchestrierung identisch.

Ändern der Datei „Web.config“

Standardmäßig konfiguriert der Assistent einen Webdienst so, dass der Dienst das HTTP-SOAP-Protokoll verwendet. HTTP-GET und HTTP-POST werden explizit deaktiviert. Damit Sie einen Webdienst mit einem Webbrowser testen können, müssen Sie HTTP-GET aktivieren.

Aktualisieren des Web.config

Öffnen Sie die Datei Web.config für den veröffentlichten Webdienst.

Hinweis

Sie finden die Datei Web.config in dem Verzeichnis, das Sie für das virtuelle IIS-Stammverzeichnis konfiguriert haben, das den Webdienst enthält.

Suchen Sie den <Abschnitt protokolle> :

<webServices>  
   <protocols>  
     <remove name="HttpPost" />  
     <remove name="HttpGet" />  
     <remove name="HttpPostLocalhost" />  
   </protocols>  

</webServices>

Entfernen Sie zum Testen von HTTP-GET, HTTP-POST oder HTTP-POST vom lokalen Computer die entsprechende Zeile aus dem <Abschnitt protokolle> .

Weitere Informationen zu den Konfigurationsoptionen finden Sie unter Konfigurationsoptionen für mit ASP.NET erstellte XML-Webdienste.

Zugreifen auf einen Webdienst mit Internet Explorer

Geben Sie in Internet Explorer im Feld Adresse die URL für den Webdienst im Format http:// servername/apppath/webservicename.asmx ein.

Parameter	Wert
Servername	Der Name des Servers, auf dem Sie Ihren XML-Dienst bereitgestellt haben.
Apppath	Der Name Ihres virtuellen Verzeichnisses und der Webanwendungspfad.
webservicename.asmx	Der Name der ASMX-Datei des XML-Webdiensts.

In der Beschreibung des Webdiensts werden alle Webdienstmethoden aufgeführt, die der betreffende Webdienst unterstützt. Die Seite mit der Beschreibung des Webdiensts enthält Links für jede verfügbare Webmethode und die Dienstbeschreibung des Webdiensts.

Testen eines Webdiensts mit Internet-Explorer mithilfe von HTTP-GET

Greifen Sie auf die Seite mit der Beschreibung des Webdiensts zu, und klicken Sie auf eine der Webmethoden, die auf der Seite aufgelistet sind.
Geben Sie die erforderlichen Parameter für die Webmethode ein, und klicken Sie dann auf Aufrufen.
Der Server gibt eine XML-Antwort an den Browser zurück. Wenn der Rückgabewert des Webdiensts eine Gleitkommazahl mit doppelter Genauigkeit (double) ist, könnte das Ergebnis so aussehen:
```
<?xml version="1.0" ?>  
<double>74.5</double>  
```

Testen eines Webdiensts mit Internet Explorer mithilfe von HTTP-GET (alternative Methode)

Geben Sie in Internet Explorer im Feld Adresse die URL für den Webdienst im Format einhttp://servername/vdir/webservicename.asmx/Methodname?parameter=value.

Parameter	Wert
Servername	Der Name des Servers, auf dem Sie Ihren XML-Dienst bereitgestellt haben.
Apppath	Der Name Ihres virtuellen Verzeichnisses und der Webanwendungspfad.
webservicename.asmx	Der Name der ASMX-Datei des XML-Webdiensts.
Methodname	Der Name einer öffentlichen Methode, die der XML-Webdienst verfügbar macht. Ist hier nichts angegeben, wird die Seite mit der Beschreibung des XML-Webdiensts angezeigt. Auf dieser Seite werden alle öffentlichen Methoden aufgelistet, die in der ASMX-Datei verfügbar sind. (Optional)
Parameter	Der Name und der Wert für einen der Parameter, die für die Methode erforderlich sind. Ist hier nichts angegeben, wird die Seite mit der Beschreibung des XML-Webdiensts angezeigt. Auf dieser Seite werden alle öffentlichen Methoden aufgelistet, die in der ASMX-Datei verfügbar sind. (Optional)

Hinweis

In dieser Syntax wird für den Namen einer Methode des XML-Webdiensts die Groß-/Kleinschreibung beachtet. Für alle anderen Namen (Server-, Projekt- und XML-Webdienstname) wird die Groß-/Kleinschreibung nicht beachtet.

Drücken Sie die EINGABETASTE. Im Webbrowser wird die entsprechende XML-Antwort des Servers angezeigt.

Hinweis

Sie können den Webdienst auch über HTTP-POST aufrufen. Informationen und Beispiele zum Aufrufen von XML-Webdiensten über einen Webbrowser finden Sie unter Zugreifen auf XML-Webdienste über einen Browser.

Weitere Informationen

Testen der veröffentlichten Webdienste

Freigeben über