Compartir vía

Consideraciones al publicar servicios web

  • Artículo

En este tema se proporciona información que debe tener en cuenta antes de publicar servicios Web.

Publicar esquemas y el elemento include

Hay algunos escenarios en los que los esquemas que contienen el elemento include no se pueden publicar como un servicio web. Se producirá un error al finalizar el Asistente para publicación de servicios Web de BizTalk. Entre estas restricciones se incluyes las siguientes:

  • Incluye circular (el esquema incluido tiene un elemento include para el esquema incluido)

  • Un atributo schemaLocation sin resolver provocará un error.

    Para obtener más información sobre la limitación del elemento include, vea "Incluir compatibilidad con enlaces de elementos" en https://go.microsoft.com/fwlink/?LinkId=62312.

Publicar esquemas y el elemento import

El Asistente para publicar servicios Web de BizTalk Server tiene la misma limitación que el XSD.exe incluido en .NET Framework. Para obtener más información, vea "Importar compatibilidad con enlaces de elementos" en https://go.microsoft.com/fwlink/?LinkId=62311.

Publicar esquemas y el elemento redefine

El Asistente para publicar servicios Web de BizTalk Server tiene la misma limitación que el XSD.exe incluido en .NET Framework. Para obtener más información, vea "Redefinir compatibilidad con enlaces de elementos" en https://go.microsoft.com/fwlink/?LinkId=62313.

Publicar esquemas que especifiquen valores para los atributos minOccurs o maxOccurs

Si publica un esquema que contiene atributos minOccurs o maxOccurs con valores específicos, estos valores pueden ser diferentes en el esquema expuesto por el servicio web publicado. Como regla general, todos los atributos minOccurs están convertidos a 0 (minOccurs=0), y los atributos maxOccurs están convertidos a 1 o están sin enlazar (maxOccurs=1 o maxOccurs=sin enlazar).

Publicar esquemas de sobre

Si dispone de un esquema de sobres que va a publicar como servicio Web, debe modificar manualmente el proyecto Web que se genera.

Para modificar el proyecto Web generado de los esquemas de sobres

  1. Abra el <myWebService>archivo .asmx.cs.

  2. Edite el archivo y cambie bodyTypeAssemblyQualifiedName = <dll.name.version.> a bodyTypeAssemblyQualifiedName = null.

Nota

Puede tener que restablecer los Servicios de Internet Information Server (IIS) si el archivo .dll anterior se encuentra aún en el proceso de trabajo de ASPNET.

Atributos de métodos Web y de servicios Web

El Asistente para publicar servicios Web de BizTalk no permite personalizar el servicio Web ni los atributos de métodos Web usados en ASP.NET. Algunos atributos se establecen automáticamente en función de la información que proporciona el asistente. El asistente no usa los otros atributos.

La modificación de los atributos existentes o la agregación de nuevos atributos a servicios Web generados por el Asistente para publicar servicios Web de BizTalk puede provocar que el servicio Web no funcione correctamente.

Para obtener más información sobre los servicios web y los atributos de método web, consulte las clases WebServiceAttribute y WebMethodAttribute en la documentación del SDK de .NET Framework.

Método Web necesario

Un servicio Web debe tener como mínimo un método Web. Sin por lo menos un método Web, las operaciones de los tipos de puertos no se crearán. XLANG/s no admite tipos de puertos que no tengan operaciones.

Compatibilidad de caracteres de DBCS

Los servicios Web no admiten caracteres de extensión A de ideogramas unificados de chino/japonés/coreano (CJK).

Volver a publicar servicios Web mediante el Asistente para publicación de servicios Web de BizTalk

Puede usar el Asistente para publicación de servicios Web de BizTalk para crear un servicio Web publicado. En la página Proyectode servicioweb, puede seleccionar la opción Sobrescribirservicioweb.

El asistente no almacena la configuración usada anteriormente. Si realiza cambios en la configuración al volver a ejecutar el asistente, puede producirse un error en cualquiera de los clientes Web que consuman el servicio Web publicado (o lo llamen). Debe actualizar las referencias Web de los clientes que consuman un servicio Web que se ha vuelto a publicar (o lo llamen).

Puede que los clientes de los servicios Web publicados no reciban errores de tiempo de espera de la secuencia de comandos de servidor

Los servicios web generados con el Asistente para publicación de servicios web en BizTalk Server se configuran de forma predeterminada con un valor de tiempo de espera de script de 110 segundos. Éste es el valor predeterminado para la propiedad Propiedad HttpServerUtility.ScriptTimeout . Los clientes web que usan .NET Framework se configuran de forma predeterminada con un valor de tiempo de espera de solicitud de 100 segundos. Este es el valor predeterminado de la propiedad HttpWebRequest.Timeout de .NET Framework.

Si los clientes web que usan .NET Framework llaman a un servicio web generado con el Asistente para publicación de servicios web de BizTalk Server, es posible que el cliente no pueda recibir errores de tiempo de espera del script de servidor porque el tiempo de espera de la solicitud de cliente se produce primero de forma predeterminada. Para resolver el problema, puede llevar a cabo uno de los siguientes procedimientos:

  • Aumente el tiempo de espera de la solicitud de cliente a un valor mayor que el tiempo de espera del script de servidor aumentando el valor de la propiedad HttpWebRequest.Timeout en el cliente.

  • Reduzca el tiempo de espera del script de servidor a un valor menor que el tiempo de espera de la solicitud de cliente al reducir el valor de la propiedad HttpServerUtility.ScriptTimeout en el servidor.

Consulte también

Publicación de servicios web