Compartir a través de

Cómo utilizar el Asistente para consumición del Servicio WCF de BizTalk para consumir un Servicio WCF

  • Artículo

El marco de trabajo de adaptadores proporciona un medio para agregar esquemas de adaptador y tipos de BizTalk a proyectos de BizTalk. El Asistente para consumición del Servicio WCF de BizTalk le permite agregar adaptadores de envío WCF a un proyecto de BizTalk. Para los adaptadores de envío WCF, debe seleccionar un extremo de intercambio de metadatos (MEX) existente en los puertos de envío. A continuación tendrá que especificar la información que se ha utilizado para generar los tipos y los esquemas. Una vez que ha finalizado el asistente, los esquemas y los tipos necesarios para consumir servicios WCF se agregan al proyecto de BizTalk.

Para agregar esquemas y tipos de adaptadores de envío WCF a su proyecto

  1. En el proyecto de BizTalk de Microsoft Visual Studio, en Explorador de soluciones, haga clic con el botón derecho en el proyecto, haga clic en Agregar y, a continuación, haga clic en Agregar elementos generados.

  2. En el cuadro de diálogo Agregar elementos generados : <nombre del proyecto> , en la sección Plantillas , seleccione Consumir servicio WCF y, a continuación, haga clic en Agregar.

  3. En la página Asistente para consumo de servicios WCF de BizTalk , haga clic en Siguiente.

  4. En la página Origen de metadatos , seleccione el origen de los metadatos que se van a importar y, a continuación, haga clic en Siguiente.

    de metadatosPágina de origen

    Para descargar documentos de metadatos desde el punto de conexión de intercambio de metadatos de un servicio en ejecución, seleccione la opción De punto de conexión de Intercambio de metadatos (MEX). Esto permite crear un puerto de envío que actúe como cliente del servicio WCF. Para usar esta opción, el extremo del servicio debe publicar los metadatos de servicio que va a recuperar por medio de una solicitud HTTP/GET o HTTPS/GET. Además, el extremo del servicio debe permitir el acceso a los metadatos con credenciales de usuario anónimo o credenciales de usuario compuestas por nombre de usuario y contraseña con el esquema de autenticación básico.

    Nota

    Con el esquema de autenticación básico, las credenciales se envían como texto simple, y podrían ser interceptadas con facilidad. Asimismo, el esquema no proporciona protección para la información que se devuelve desde el servicio. Debe utilizar una conexión de Secure Sockets Layer (SSL) para cifrar los datos.

    Para que se importen otros documentos de metadatos, seleccione la opción Archivos de metadatos (WSDL y XSD) para importar metadatos desde un sistema de archivos.

    Nota

    No todos los servicios deben publicar metadatos. Deshabilitar la publicación de metadatos reduce la superficie de ataque de su servicio y disminuye el riesgo de divulgación involuntaria de información.

  5. Si seleccionó la opción Punto de conexión de Intercambio de metadatos (MEX) en la página Origen de metadatos , aparecerá la página Punto de conexión de metadatos . En la página Punto de conexión de metadatos , especifique la dirección URL del servicio en ejecución que proporciona metadatos para su descarga a través de WS-Metadata Exchange o Http-Get. Para obtener el documento de metadatos de la dirección URL, haga clic en Obtener. Si el servicio en ejecución requiere una credencial de usuario con el esquema de autenticación básico, haga clic en Editar para abrir el cuadro de diálogo Asistente para consumo de servicios WCF de BizTalk en el que puede proporcionar el nombre de usuario y la contraseña que se usarán al acceder a la ejecución del servicio.

    conexión de metadatosPágina de punto de

    Nota

    Para descargar los metadatos de los servicios WCF publicados a través de HTTP o HTTPS, no puede usar el punto de conexión MEX como http://localhost:8087/CalculatorService/mex para el cuadro de texto Dirección de metadatos . Para los servicios WCF, debe usar los metadatos de WSDL para descargar los metadatos de la siguiente manera: http://localhost:8087/CalculatorService o http://localhost:8087/CalculatorService?wsdl

  6. Si seleccionó la opción Archivos de metadatos (WSDL y XSD) en la página Origen de metadatos , aparecerá la página Punto de conexión de metadatos . En la página Punto de conexión de metadatos , especifique los archivos de metadatos que se van a importar. Haga clic en Agregar para agregar los archivos de metadatos que se van a importar en la vista Archivos de metadatos . Se abrirá el cuadro de diálogo Agregar archivos de metadatos en el que puede buscar ubicaciones de disco para archivos de metadatos.

    En el cuadro de diálogo Agregar archivos de metadatos , seleccione un conjunto completo de archivos WSDL y XSD que se van a usar para los metadatos. Estos archivos de metadatos pueden generarse especificando el comando siguiente en el símbolo del sistema:

    svcutil.exe /t:metadata http://localhost/service.svc/mex

    Haga clic en Quitar para quitar los archivos de metadatos seleccionados en la vista Archivos de metadatos .

    Página de archivos de metadatos

    Nota

    El archivo SvcUtil.exe está incluido en el kit de desarrollo de software (SDK) de Microsoft Windows de los componentes en tiempo de ejecución de .NET Framework y Windows Vista.

    Nota

    Los metadatos de servicio pueden manipularse o suplantarse cuando se recuperan de manera insegura. Unos metadatos alterados podrían redirigir el cliente hacia un servicio malicioso, contener configuraciones de seguridad comprometidas o estructuras XML maliciosas. Los documentos de metadatos pueden ser muy grandes y con frecuencia se guardan en el sistema de archivos. Debe asegurarse de que no se han alterado los archivos de metadatos.

  7. En la página Import WCF Service Metadata Summary (Importar resumen de metadatos del servicio WCF ), revise la configuración. Puede hacer clic en Atrás para realizar cualquier cambio. A continuación, haga clic en Importar para crear los artefactos y tipos de BizTalk que se usarán para consumir el servicio WCF.

  8. En la página Finalización del Asistente para consumo de servicios WCF de BizTalk , haga clic en Finalizar. Si desea volver a ejecutar este asistente, seleccione la opción Ejecutar este asistente de nuevo y, a continuación, haga clic en Finalizar.

    El Asistente para consumición del Servicio WCF de BizTalk crea los tipos y esquemas de BizTalk necesarios para consumir servicios WCF en el proyecto de BizTalk. Los tipos de BizTalk, como los tipos de puerto y los tipos de mensaje de varias partes se crean en una orquestación. Se recomienda no modificar la orquestación que crea el asistente. En su lugar, puede agregar orquestaciones nuevas en el proyecto de BizTalk para cumplir sus fines. El Asistente para consumo de servicios WCF de BizTalk también crea dos archivos de enlace, BizTalkServiceInstance.BindingInfo.xml y BizTalkServiceInstance_Custom.BindingInfo.xml. BizTalkServiceInstance.BindingInfo.xml es un archivo de enlace de BizTalk que puede importar la herramienta de línea de comandos de desarrollo o el asistente para configurar los puertos de envío con los adaptadores WCF de enlace estándar, por ejemplo, los adaptadores de WCF-NetMsmq y WCF-WSHttp. BizTalkServiceInstance.BindingInfo.xml es un archivo de enlace de BizTalk que puede importar la herramienta de línea de comandos de desarrollo o el asistente para configurar los puertos de envío con el adaptador de WCF-Custom.

    Al importar el archivo de enlace generado, rellena WCF. Propiedad Action en el formato de asignación de acciones. Para ver cómo se configura esta propiedad, examine el cuadro de texto Acción de la ficha General del cuadro de diálogo Propiedades de transporte de puerto de envío wcF en la consola de administración de BizTalk.

    Puede especificar el WCF. Propiedad Action de dos maneras diferentes: el formato de acción única y el formato de asignación de acciones. Si establece esta propiedad en el formato de acción única( por ejemplo, , http://contoso.com/Svc/Op1 el encabezado SOAPAction para los mensajes salientes siempre se establece en el valor especificado en esta propiedad. Si establece esta propiedad en el formato de asignación de acciones, el encabezado SOAPAction saliente viene determinado por BTS. Propiedad de contexto de la operación . Por ejemplo, si esta propiedad se establece en el siguiente formato XML y BTS. La propiedad Operation se establece en Op1, el adaptador de envío de WCF usa http://contoso.com/Svc/Op1 para el encabezado SOAPAction saliente.

    <BtsActionMapping>

    <Operation Name="Op1" Action="http://contoso.com/Svc/Op1" />

    <Operation Name="Op2" Action="http://contoso.com/Svc/Op2" />

    </BtsActionMapping>

    Si los mensajes salientes proceden de un puerto de orquestación, las instancias de orquestación establecen dinámicamente el BTS. Propiedad Operation con el nombre de la operación del puerto. Si los mensajes salientes se enrutan con enrutamiento basado en contenido, puede establecer bts. Propiedad Operation en los componentes de canalización. Los puertos generados por el Asistente para consumo de WCF de BizTalk tienen operaciones con nombres que coinciden con los atributos Name del <elemento BtsActionMapping> . No es necesario establecer explícitamente el BTS. Propiedad Operation en orquestaciones al enviar mensajes a través de puertos generados por el asistente.

Consulte también

Cómo utilizar el Asistente para publicación de Servicio WCF de BizTalk para publicar orquestaciones como servicios WCF
Cómo utilizar el Asistente para publicación de Servicio WCF de BizTalk para publicar esquemas como servicios WCF