Training
Modul
Mit Webdiensten in Dynamics 365 Business Central arbeiten - Training
Verwenden Sie SOAP und OData, um Datensätze zu lesen und zu aktualisieren und die UI-Interaktion in Business Central zu handhaben.
Dieser Browser wird nicht mehr unterstützt.
Führen Sie ein Upgrade auf Microsoft Edge durch, um die neuesten Features, Sicherheitsupdates und den technischen Support zu nutzen.
Dieses Thema enthält Informationen, die Sie berücksichtigen sollten, bevor Sie Ihre Webdienste veröffentlichen.
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.
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.
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.
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).
Wenn Sie über ein Umschlagschema verfügen und es als Webdienst veröffentlichen, müssen Sie das generierte Webprojekt manuell ändern.
Öffnen Sie die <myWebService
>Datei .asmx.cs.
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.
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.
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.
Webdienste unterstützen keine Zeichen vom Typ CJK (Chinese/Japanese/Korean, chinesisch/japanisch/koreanisch) Unified Ideograph Extension A.
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.
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.
Training
Modul
Mit Webdiensten in Dynamics 365 Business Central arbeiten - Training
Verwenden Sie SOAP und OData, um Datensätze zu lesen und zu aktualisieren und die UI-Interaktion in Business Central zu handhaben.