Publicar esquemas como un servicio web en BizTalk
El Asistente para publicar servicios Web de BizTalk permite publicar esquemas como servicio Web.
Publicación de esquemas como un servicio web
En Programas, seleccione BizTalk Server y, a continuación, seleccione Asistente para publicación de Servicios web de BizTalk.
Importante
Antes de ejecutar el Asistente para publicar servicios Web de BizTalk, debe crear los proyectos de BizTalk.
En la página principal, haga clic en Siguiente.
En la página Crear servicio web , seleccione Publicar esquemas como servicios web y, a continuación, haga clic en Siguiente.
En la página Servicio web , defina los servicios web que se van a publicar. Use el árbol en el cuadro de diálogo Descripción del servicio web para agregar, quitar, cambiar el nombre y editar los nodos de descripción del servicio web. El cuadro de diálogo Información proporciona información sobre el nodo seleccionado y muestra los errores en el nodo actual o en los sub nodos:
El nodo raíz del árbol (Descripción del servicio Web) describe el nombre del proyecto del servicio Web. El nombre del directorio virtual usa el nodo raíz como nombre predeterminado. Para modificar la descripción del servicio web, seleccione Cambiar nombre de la descripción del servicio web.
Para agregar un nuevo servicio web, haga clic con el botón derecho en el nodo Descripción del servicio web y, a continuación, haga clic en Agregar servicio web. Se creará un servicio Web nuevo sin ningún método Web. Para modificar el nombre del servicio web, haga clic con el botón derecho en el nodo Servicio web y seleccione Cambiar nombre del servicio web y presione Entrar para aceptar el nuevo nombre.
Para agregar un nuevo método web, haga clic con el botón derecho en el nodo Servicio web, seleccione Agregar método web y, a continuación, haga clic en Unidireccional (para un método web de solicitud) o Solicitud-respuesta (para un método web de solicitud-respuesta) en el menú contextual.
Para establecer los tipos de esquema de solicitud y respuesta, haga clic con el botón derecho en el nodo Solicitud o Respuesta y, a continuación, haga clic en Seleccionar tipo de esquema. En el cuadro de diálogo Tipo de mensaje de solicitud , escriba el nombre del ensamblado que contiene el esquema de documento en el cuadro de texto archivo de ensamblado de BizTalk o haga clic en Examinar para buscar el ensamblado. La vista de lista Tipos de esquema disponibles muestra cada elemento raíz del esquema. Seleccione un nodo raíz para agregar como el tipo de esquema de solicitud o de respuesta.
Nota
Si instaló el archivo de ensamblado de BizTalk en la caché global de ensamblados (GAC), asegúrese de que el ensamblado de la GAC se ha actualizado con el ensamblado que seleccionará en el cuadro de diálogo Tipo de mensaje de solicitud . Si la GAC tiene el mismo nombre completo, el Asistente para publicar servicios Web de BizTalk utiliza el archivo de ensamblado en la GAC en lugar del que ha seleccionado.
Puede cambiar el nombre de los nodos solicitud y respuesta sin afectar al código generado. Después de definir los esquemas, puede cambiar el nombre a los elementos de parte, lo que modifica el nombre de parámetro del método Web. Los cambios se pueden ver al consultar el código del servicio Web generado.
Nota
No se pueden usar espacios cuando se cambia el nombre de alguno de los nodos de descripción del servicio Web.
Haga clic en Siguiente para continuar con el asistente.
En la página Propiedades del servicio web , en el cuadro de diálogo Espacio de nombres de destino del servicio web , escriba un espacio de nombres de destino para el servicio web y seleccione los cuadros adecuados para especificar cómo debe controlar los encabezados SOAP y la compatibilidad de Sign-On única para el servicio web. Si desea personalizar aún más la implementación del servicio web, haga clic en el botón Avanzadas . Mostrará más opciones disponibles:
Opción Value Descripción Estilo de parámetro SOAP Valor predeterminado Esta opción especifica el modo en que se da formato a los parámetros de un mensaje SOAP. Para obtener más información, vea SoapParameterStyle (enumeración) en https://go.microsoft.com/fwlink/?LinkId=62259. Estilo de parámetro SOAP Desnudo Esta opción especifica el modo en que se da formato a los parámetros de un mensaje SOAP. Para obtener más información, vea SoapParameterStyle (enumeración) en https://go.microsoft.com/fwlink/?LinkId=62259. Estilo de parámetro SOAP Ajustado Esta opción especifica el modo en que se da formato a los parámetros de un mensaje SOAP. Para obtener más información, vea SoapParameterStyle (enumeración) en https://go.microsoft.com/fwlink/?LinkId=62259. Afirmaciones de conformidad None Esta opción especifica la interoperabilidad de servicios Web (WSI) en la que se afirma que el enlace se ajusta. Para obtener más información, vea Propiedad WebServiceBindingAttribute.ConformsTo en https://go.microsoft.com/fwlink/?LinkId=193064. Afirmaciones de conformidad Perfil básico de servicios Web WS-I, versión 1.1 Esta opción especifica la interoperabilidad de servicios Web (WSI) en la que se afirma que el enlace se ajusta. Para obtener más información, vea Propiedad WebServiceBindingAttribute.ConformsTo en https://go.microsoft.com/fwlink/?LinkId=193064. Forzar solicitud-respuesta [Predeterminado] Esta opción especifica si se deben exponer las operaciones de BizTalk unidireccionales como métodos Web de solicitud-respuesta. El valor predeterminado no fuerza la marca unidireccional. Nota
La selección de algunas de las opciones de encabezado SOAP se aplica globalmente a todos los servicios Web y los métodos Web que se crean al ejecutar esta instancia del asistente.
En la página Propiedades del servicio web , haga clic en Siguiente.
Si seleccionó Agregar encabezados SOAP adicionales, aparecerán las páginas Encabezados SOAP de solicitud y Encabezados SOAP de respuesta . Puede agregar y quitar encabezados SOAP de solicitud y respuesta mediante los botones Agregar y Quitar en los cuadros de diálogo siguientes:
Para agregar un encabezado SOAP, haga clic en Agregar. En el cuadro de texto Nombre de ensamblado de BizTalk (*.dll), escriba el nombre del ensamblado o busque el ensamblado que contiene el esquema de encabezado SOAP en el cuadro de texto Archivo de ensamblado de BizTalk . La vista de lista Tipos de esquema disponibles muestra cada elemento raíz del esquema. Seleccione un nodo raíz para agregar como un encabezado SOAP de solicitud o de respuesta. Para seleccionar varios elementos, mantenga presionada la tecla CTRL y haga clic en Aceptar.
Para quitar un encabezado SOAP de la lista, selecciónelo en la lista de encabezados SOAP agregados y, a continuación, haga clic en Quitar.
Haga clic en Siguiente en cada página de encabezado SOAP para continuar con el asistente.
Nota
El espacio de nombres de destino y el nombre de elemento raíz definen un encabezado SOAP.
Nota
Si se agrega la misma combinación de espacio de nombres de destino/nombre de elemento raíz como un encabezado SOAP de solicitud y de respuesta, no se tratará como un encabezado de entrada o salida. Debe copiar manualmente el encabezado entrante en el encabezado saliente en el interior de una orquestación.
Nota
La misma combinación de espacio de nombres de destino/nombre de elemento raíz sólo se puede agregar una vez como un encabezado SOAP de solicitud y una vez como encabezado SOAP de respuesta.
En la página Proyecto de servicio web , en el cuadro de texto Ubicación del proyecto, escriba la ubicación del proyecto. Puede aceptar la ubicación predeterminada (
http://localhost/your_project_name), escribir una ubicación para el proyecto o hacer clic en Examinar y seleccionar un directorio web. Seleccione cualquiera de las siguientes opciones:Sobrescribir proyecto existente: Esta opción únicamente está disponible si la ubicación del proyecto ya existe. Podrá publicar en la misma ubicación sólo si selecciona esta opción. De lo contrario, debe especificar una ubicación de proyecto diferente.
Permitir acceso anónimo al servicio Web: Esta opción agrega acceso anónimo al directorio virtual creado. De forma predeterminada, el directorio virtual hereda los privilegios de acceso de su directorio virtual principal o del sitio Web (si existe un directorio virtual de nivel superior).
Crear ubicaciones de recepción de BizTalk. esta opción crea de forma automática los puertos y las ubicaciones de recepción del adaptador de SOAP que correspondan a cada archivo .asmx generado. Si ya existe otra ubicación de recepción, no se sustituirá. Las ubicaciones de recepción para el adaptador SOAP se resuelven con el formato "/<nombre >de directorio virtual/<orquestación namespace_typename_portname.asmx>". Después de seleccionar esta opción, elija la aplicación donde se generarán los puertos y las ubicaciones de recepción.
Nota
La ubicación del proyecto puede producirse en un servidor distinto. Para publicar un servicio web en otro servidor, escriba el nombre del proyecto como
http://<servername>/<project_name>.Nota
La ubicación del proyecto puede producirse en un sitio Web que no sea predeterminado. Al publicar en un sitio web no predeterminado, incluya el número de puerto del sitio web en la dirección URL:
http://localhost:8080/<project_name>.Nota
Al usar el asistente para crear ubicaciones de recepción, éstas se crean mediante muchos valores predeterminados. Los valores predeterminados de las canalizaciones de recepción y envío son Microsoft.BizTalk.DefaultPipelines.PassThruReceive y Microsoft.BizTalk.DefaultPipelines.PassThruTransmit. Si los mensajes recibidos a través del servicio web publicado requieren un procesamiento de canalización especial (por ejemplo, validación, correlación o mapas entrantes o salientes), debe establecer las canalizaciones de envío y recepción en Microsoft.BizTalk.DefaultPipelines.XMLReceive, Microsoft.BizTalk.DefaultPipelines.XMLSend o en una canalización personalizada.
Haga clic en Siguiente para revisar la configuración del proyecto de servicio web de ASP.NET.
Haga clic en Crear para crear el servicio web de ASP.NET.
Haga clic en Finalizar para completar el Asistente para publicación de servicios web de BizTalk.