Freigeben über


Überlegungen beim Veröffentlichen von Webdiensten

Dieses Thema enthält Informationen, die Sie berücksichtigen sollten, bevor Sie Ihre Webdienste veröffentlichen.

Veröffentlichen von Schemas und das „include“-Element

Es gibt einige Szenarien, in denen Schemas, die das include-Element enthalten, nicht als Webdienst veröffentlicht werden können. Beim Ausführen des Assistenten für BizTalk-Webdienstpublishing tritt ein Fehler auf. Es gelten folgende Einschränkungen:

  • Circular includes (das eingeschlossene Schema verfügt über ein include-Element zum einschließenden Schema)

  • Ein nicht aufgelöstes schemaLocation-Attribut verursacht einen Fehler.

    Weitere Informationen zur Einschränkung des include-Elements finden Sie unter "Include Element Binding Support" unter https://go.microsoft.com/fwlink/?LinkId=62312.

Veröffentlichen von Schemas und das „import“-Element

Für den Assistenten für BizTalk-Webdienstpublishing gelten die gleiche Einschränkung wie bei der in .NET Framework enthaltenen Datei XSD.exe. Weitere Informationen finden Sie unter "Import Element Binding Support" unter https://go.microsoft.com/fwlink/?LinkId=62311.

Veröffentlichen von Schemas und das „redefine“-Element

Für den Assistenten für BizTalk-Webdienstpublishing gelten die gleiche Einschränkung wie bei der in .NET Framework enthaltenen Datei XSD.exe. Weitere Informationen finden Sie unter "Redefine Element Binding Support" unter https://go.microsoft.com/fwlink/?LinkId=62313.

Veröffentlichen von Schemas zur Angabe von Werten für die Attribute „minOccurs“ oder „maxOccurs“

Wenn Sie ein Schema veröffentlichen, das minOccurs- oder maxOccurs-Attribute mit bestimmten Werten enthält, können sich diese Werte im vom veröffentlichten Webdienst verfügbar gemachten Schema unterscheiden. Als allgemeine Faustregel werden alle minOccurs-Attribute in 0 (minOccurs=0) konvertiert und die maxOccurs-Attribute entweder in 1 oder aber in ungebunden (maxOccurs=1 bzw. maxOccurs=unbounded).

Veröffentlichen von Umschlagschemas

Wenn Sie über ein Umschlagschema verfügen und es als Webdienst veröffentlichen, müssen Sie das generierte Webprojekt manuell ändern.

So ändern Sie das generierte Webprojekt für Umschlagschemas

  1. Öffnen Sie die <myWebService>Datei .asmx.cs.

  2. Bearbeiten Sie die Datei, und ändern Sie bodyTypeAssemblyQualifiedName = <dll.name.version.> in bodyTypeAssemblyQualifiedName = null.

Hinweis

Möglicherweise müssen Sie Internetinformationsdienste (Internet Information Services, IIS) zurücksetzen, wenn sich die DLL-Datei weiterhin im ASPNET-Arbeitsprozess befindet.

Attribute für Webdienst und Webmethode

Im Assistenten für BizTalk-Webdienstpublishing können Sie die in ASP.NET verwendeten Attribute für den Webdienst oder die Webmethode nicht anpassen. Einige Attribute werden anhand der vom Assistenten bereitgestellten Informationen automatisch festgelegt. Der Assistent verwendet nicht die anderen Attribute.

Wenn die vorhandenen Attribute geändert oder den vom Assistenten für BizTalk-Webdienstpublishing generierten Webdiensten neue Attribute hinzugefügt werden, kann dies dazu führen, dass der Webdienst nicht ordnungsgemäß funktioniert.

Weitere Informationen zu Webdiensten und Webmethodenattributen finden Sie in den Klassen WebServiceAttribute und WebMethodAttribute in der Dokumentation zum .NET Framework SDK.

Erforderliche Webmethode

Ein Webdienst muss mindestens eine Webmethode aufweisen. Ohne mindestens eine Webmethode können keine Vorgänge für die Porttypen erstellt werden. XLANG/s unterstützt keine Porttypen ohne Vorgänge.

DBCS-Zeichenunterstützung

Webdienste unterstützen keine Zeichen vom Typ CJK (Chinese/Japanese/Korean, chinesisch/japanisch/koreanisch) Unified Ideograph Extension A.

Erneutes Veröffentlichen von Webdiensten mithilfe des Assistenten für BizTalk-Webdienstpublishing

Zum erneuten Veröffentlichen eines veröffentlichten Webdiensts können Sie den Assistenten für BizTalk-Webdienstpublishing verwenden. Auf der Seite Webdienstprojekt können Sie die OptionWebdienst überschreiben auswählen.

Der Assistent speichert keine zuvor verwendeten Einstellungen. Wenn Sie beim erneuten Ausführen des Assistenten Änderungen an den Einstellungen vornehmen, können bei Webclients, die den veröffentlichten Webdienst aufrufen, Fehler auftreten. Deshalb sollten Sie die Webverweise auf alle Clients aktualisieren, die einen erneut veröffentlichten Webdienst aufrufen.

Clients veröffentlichter Webdienste empfangen möglicherweise keine Timeoutfehler des Serverskripts

Webdienste, die mit dem Webdienstveröffentlichungs-Assistenten in BizTalk Server generiert werden, werden standardmäßig mit einem Skripttimeoutwert von 110 Sekunden konfiguriert. Dies ist der Standardwert für .NET Framework. HttpServerUtility.ScriptTimeout-Eigenschaft . Webclients, die .NET Framework verwenden, werden standardmäßig mit einem Anforderungstimeoutwert von 100 Sekunden konfiguriert. Dies ist der Standardwert für die .NET Framework HttpWebRequest.Timeout-Eigenschaft.

Wenn Webclients, die .NET Framework verwenden, einen Webdienst aufrufen, der mit dem BizTalk Server Webdienstveröffentlichungs-Assistenten generiert wurde, kann der Client möglicherweise Keine Serverskripttimeoutfehler empfangen, da das Clientanforderungstimeout standardmäßig zuerst auftritt. Führen Sie zum Lösen dieses Problems eine der folgenden Aktionen aus:

  • Erhöhen Sie das Clientanforderungstimeout auf einen Wert, der größer als das Timeout des Serverskripts ist, indem Sie den Wert für die HttpWebRequest.Timeout-Eigenschaft auf dem Client erhöhen.

  • Reduzieren Sie das Timeout des Serverskripts auf einen Wert, der kleiner als das Timeout der Clientanforderung ist, indem Sie den Wert für die HttpServerUtility.ScriptTimeout-Eigenschaft auf dem Server verringern.

Weitere Informationen

Veröffentlichen von Webdiensten