Cómo usar el Asistente para publicación de servicios web de BizTalk para publicar una orquestación como servicio web
El Asistente para publicar servicios Web de BizTalk se utiliza para publicar orquestaciones como servicios Web.
Nota
Debe compilar los proyectos de BizTalk antes de ejecutar el Asistente para publicación de BizTalk Web Services.
Nota
Puede utilizar una herramienta de línea de comandos, BTSWebSvcPub.exe, para publicar orquestaciones como servicios Web. Para obtener más información, vea BTSWebSvcPub Command-Line Reference( Referencia de BTSWebSvcPub).
Para publicar una orquestación como un servicio Web
Haga clic en Inicio, seleccione Todos los programas, Microsoft BizTalk Server y, a continuación, haga clic en Asistente para publicación de Servicios web de BizTalk.
En la página Asistente para publicación de Servicios web de BizTalk , haga clic en Siguiente.
En la página Crear servicio web , seleccione Publicar orquestaciones de BizTalk como servicios web y, a continuación, haga clic en Siguiente.
En la página Ensamblado de BizTalk , en el cuadro de texto Archivo de ensamblado de BizTalk (*.dll), escriba el nombre del archivo de ensamblado de BizTalk o haga clic en Examinar para ir al ensamblado que contiene las orquestaciones que se van a publicar y, a continuación, haga clic en Siguiente.
Nota
Antes de seleccionar un archivo de ensamblado de BizTalk, copie todos los ensamblados dependientes en la misma carpeta con el ensamblado de BizTalk o instale los ensamblados dependientes en la caché de ensamblados global (GAC).
Nota
Si instaló el archivo de ensamblado de BizTalk en la GAC, asegúrese de que el ensamblado de la GAC se ha actualizado con el ensamblado que seleccionará en el cuadro de diálogo Ensamblado de BizTalk . 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.
Nota
Si abre el Asistente para publicar servicios Web de BizTalk en el Visual Studio que contiene una orquestación, el archivo de ensamblado de BizTalk rellena con el ensamblado que contiene la orquestación.
Nota
Las rutas que contienen más de 260 caracteres pueden obtener un mensaje de error que informa que la ruta es demasiado larga.
En la página Orquestaciones y puertos , expanda los nodos de árbol de cada ensamblado y orquestación haciendo clic en el signo más. Seleccione las orquestaciones y puertos para publicar mediante la activación de las casillas de verificación de nodo de árbol correspondientes. Si desea crear un servicio web (.asmx) para todos los puertos de recepción seleccionados en lugar de un servicio web para cada puerto de recepción, seleccione la opción Combinar todos los puertos seleccionados en un único servicio web y, a continuación, haga clic en Siguiente.
Nota
Cuando combina todos los puertos seleccionados en un único servicio Web, todos los puertos seleccionados tiene el mismo tipo de puerto y los nombres de operaciones en los puertos son únicos.
En la página Propiedades del servicio web, en el cuadro Espacio de nombres destino del servicio web, escriba un espacio de nombres de destino para el servicio web, seleccione los cuadros adecuados para especificar cómo debe controlar el asistente los encabezados SOAP y SharePoint Portal Server 2007 Compatibilidad de Sign-On único (SSO) 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 es no forzar el indicador unidireccional. Forzar solicitud-respuesta No Esta opción especifica si se deben exponer las operaciones de BizTalk unidireccionales como métodos Web de solicitud-respuesta. El valor predeterminado es no forzar el indicador unidireccional. Forzar solicitud-respuesta Sí Esta opción especifica si se deben exponer las operaciones de BizTalk unidireccionales como métodos Web de solicitud-respuesta. El valor predeterminado es no forzar el indicador unidireccional. En la página Propiedades del servicio web , haga clic en Siguiente.
Nota
La selección de algunas de las opciones de encabezado SOAP se aplican globalmente a todos los servicios Web y los métodos Web que se crean al ejecutar esta instancia del asistente.
Si seleccionó la opción 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 Archivo de ensamblado de BizTalk (*.dll), escriba o busque el ensamblado que contiene el esquema de encabezado SOAP. 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 Encabezado SOAP para continuar con el asistente.
Nota
Un espacio de nombres de destino y un 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 Nombre del proyecto, escriba el nombre del proyecto. Puede aceptar la ubicación predeterminada (
http://localhost/<project_name>), escribir una ubicación para el proyecto en el cuadro de texto Ubicación del 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 una ubicación de recepción, no se sustituirá. Las ubicaciones de recepción del adaptador SOAP se resuelven con el formato /<virtual directory name>/<orchestration 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. Cuando se publique en un sitio Web que no sea predeterminado, incluya el número de puerto del sitio Web en la URL. Por ejemplo,
http://localhost:8080/<project_name>.Nota
Al utilizar el asistente para crear ubicaciones de recepción, éstas se crean mediante los valores predeterminados. El valor predeterminado de la canalización de recepción es la canalización Microsoft.BizTalk.DefaultPipelines.PassThruReceive . Si los mensajes recibidos a través del servicio web publicado requieren cualquier procesamiento de canalización especial (por ejemplo, validación, correlación o promoción de propiedades o asignaciones entrantes o salientes), debe establecer la canalización de recepción en Microsoft.BizTalk.DefaultPipelines.XMLReceive o en una canalización personalizada.
Nota
Cuando consume servicios Web (llamada) de una orquestación, el adaptador de SOAP sólo admite canalizaciones de envío de estilo de paso a través. Se puede usar una canalización de envío personalizada, pero no puede contener componentes que modifican las partes del cuerpo del mensaje. Estos componentes incluyen el ensamblador de XML y cualquier componente de codificación.
Nota
Cuando llegue a esta página y, si decide volver a salir de la opción Publicar esquemas como servicios web , en la página Servicios web , puede que vea la descripción del servicio web muestra los nombres de servicio y método del ensamblado de BizTalk anteriores seleccionados antes de volver de la opción Publicar orquestaciones de BizTalk como servicios web . Esto es así porque la descripción del servicio Web en memoria no se desactiva cuando se cambia el método de publicación.
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.
Nota
Si va a publicar una orquestación como un servicio Web en Windows Vista, debe actualizar el directorio virtual que aloja el servicio. Para ello, emita el siguiente comando desde el símbolo del sistema, reemplazando <vdir> por el nombre del directorio virtual: %systemroot%\system32\inetsrv\APPCMD.EXE migrar config "Default Web Site/<vdir name>".
Consulte también
Publicación de una orquestación como servicio webcómo asignar orquestaciones a servicios web