Considérations à prendre en compte lors de la publication de services Web
Cette rubrique fournit des informations que vous devez prendre en compte avant de publier vos services Web.
Publication de schémas et de l'élément include
Il existe quelques scénarios dans lesquels les schémas qui contiennent l’élément include ne peuvent pas être publiés en tant que service Web. Une erreur se produira lorsque vous aurez terminé d'utiliser l'Assistant Publication de services Web BizTalk. Ces restrictions sont les suivantes :
Inclut circulaire (le schéma inclus a un élément include au schéma d’inclusion)
Un attribut schemaLocation non résolu provoque une erreur
Pour plus d’informations sur la limitation de l’élément include, consultez « Include Element Binding Support » sur https://go.microsoft.com/fwlink/?LinkId=62312.
Publication de schémas et de l'élément import
L'Assistant Publication de services Web BizTalk a la même restriction que XSD.exe inclus dans .NET Framework. Pour plus d’informations, consultez « Import Element Binding Support » sur https://go.microsoft.com/fwlink/?LinkId=62311.
Publication de schémas et de l'élément redefine
L'Assistant Publication de services Web BizTalk a la même restriction que XSD.exe inclus dans .NET Framework. Pour plus d’informations, consultez « Redéfinir la prise en charge de la liaison d’éléments » sur https://go.microsoft.com/fwlink/?LinkId=62313.
Publication de schémas qui spécifient les valeurs des attributs minOccurs ou maxOccurs
Si vous publiez un schéma qui contient des attributs minOccurs ou maxOccurs avec des valeurs spécifiques, ces valeurs peuvent être différentes dans le schéma exposé par le service Web publié. En guise de point de repère général, tous les attributs minOccurs sont convertis en 0 (minOccurs=0) et les attributs maxOccurs sont convertis en 1 ou unbounded (maxOccurs=1 ou maxOccurs=unbounded).
Publication de schémas d'enveloppe
Si vous avez un schéma d'enveloppe que vous publiez en tant que service Web, vous devez modifier manuellement le projet Web généré.
Pour modifier le projet Web généré pour les schémas d'enveloppe
Ouvrez le <
myWebService>fichier .asmx.cs.Modifiez le fichier et remplacez par
bodyTypeAssemblyQualifiedName = <dll.name.version.>bodyTypeAssemblyQualifiedName = null.
Notes
Vous devrez peut-être rétablir les services Internet (IIS) si le fichier .dll précédent est toujours dans le processus de travail ASPNET.
Attributs du service Web et de la méthode Web
L'Assistant Publication de services Web BizTalk ne vous permet pas de personnaliser les attributs du service Web ou de la méthode Web que vous utilisez dans ASP.NET. Certains attributs sont automatiquement définis en fonction des informations fournies par l'Assistant. L'Assistant n'utilise pas les autres attributs.
La modification des attributs existants ou l'ajout de nouveaux attributs aux services Web générés par l'Assistant Publication de services Web BizTalk peut entraîner le dysfonctionnement du service Web.
Pour plus d’informations sur les services Web et les attributs de méthode Web, consultez les classes WebServiceAttribute et WebMethodAttribute dans la documentation du Kit de développement logiciel (SDK) .NET Framework.
Méthode Web requise
Un service Web doit avoir au moins une méthode Web. Sans au moins une méthode Web, les types de ports n'auront pas leurs opérations créées. XLANG/s ne prend pas en charge les types de ports qui n'ont pas d'opérations.
Prise en charge des caractères DBCS
Les services Web ne prennent pas en charge les idéographes unifiés CJC (chinois/japonais/coréens) - extension A.
Republication de services Web à l'aide de l'Assistant Publication de services Web BizTalk
Vous pouvez utiliser l'Assistant Publication de services Web BizTalk pour republier un service Web publié. Dans la page Projetde serviceweb, vous pouvez sélectionner l’option Remplacer le serviceweb.
L'Assistant ne stocke pas les paramètres précédemment utilisés. Si vous modifiez les paramètres lors de la nouvelle exécution de l'Assistant, tout client Web qui utilise (appelle) le service Web publié risque d'échouer. Vous devez mettre à jour les références Web des clients qui utilisent (appellent) un service Web republié.
Les clients de services Web publiés risquent de ne pas recevoir des erreurs de délai d'expiration de script du serveur.
Les services web générés avec l’Assistant Publication des services web dans BizTalk Server sont configurés par défaut avec une valeur de délai d’expiration de script de 110 secondes. Il s'agit de la valeur par défaut pour la propriété Propriété HttpServerUtility.ScriptTimeout . Les clients web qui utilisent .NET Framework sont configurés par défaut avec une valeur de délai d’expiration de requête de 100 secondes. Il s’agit de la valeur par défaut de la propriété HttpWebRequest.Timeout .NET Framework.
Si les clients Web qui utilisent .NET Framework appellent un service web généré avec l’Assistant Publication des services web BizTalk Server, il est possible que le client ne puisse pas recevoir d’erreurs de délai d’expiration du script serveur, car le délai d’expiration de la demande client se produit en premier par défaut. Pour résoudre ce problème, vous pouvez effectuer l’une des opérations suivantes :
Augmentez le délai d’expiration de la requête client à une valeur supérieure au délai d’expiration du script serveur en augmentant la valeur de la propriété HttpWebRequest.Timeout sur le client.
Réduisez le délai d’expiration du script serveur à une valeur inférieure au délai d’expiration de la demande cliente en réduisant la valeur de la propriété HttpServerUtility.ScriptTimeout sur le serveur.