¿Le resultó útil esta página?
Sus comentarios sobre este contenido son muy importantes. Háganos saber su opinión.
¿Tiene comentarios adicionales?
Caracteres restantes: 1500
Tutorial: Uso de los puentes del servicio de BizTalk para enviar y recibir mensajes desde el servicio de retransmisión de bus de servicio.

Tutorial: Uso de los puentes del servicio de BizTalk para enviar y recibir mensajes desde el servicio de retransmisión de bus de servicio.

Actualizado: mayo de 2015

En este tutorial se proporcionan instrucciones sobre cómo enviar mensajes XML con distintos esquemas a un único extremo de puente implementado mediante los Servicios de BizTalk de Microsoft Azure. El puente procesa el mensaje y lo enruta a varios servicios de retransmisión de acuerdo con la lógica de negocios definida como parte de la solución. Valiéndose de este escenario, el tutorial presenta otras funcionalidades de los Servicios de BizTalk, como:

  • Filtros de ruta: El puente permite enrutar mensajes al destinatario deseado basándose en filtros. Los filtros se configuran con determinados valores que se pasan como parte del mensaje. Por ejemplo, si el valor del elemento <Destinatario> del mensaje XML se establece en Finanzas, se envía el mensaje al Servicio A. De lo contrario, el mensaje se envía al Servicio B. Para obtener más información, vea The Routing Condition.

  • Acción de enrutamiento: Las acciones de enrutamiento ayudan a eliminar las discrepancias de protocolo. Por ejemplo, tomemos dos aplicaciones: Aplicación A y Aplicación B. La Aplicación A envía mensajes mediante el protocolo REST, mientras que la Aplicación B solo recibe mensajes SOAP. Si por el contrario la Aplicación A envía el mensaje al puente, el puente incluirá encabezados SOAP en el mensaje como parte de la acción de enrutamiento. El puente enviará después el mensaje a la Aplicación B. Para obtener más información, vea The Routing Action.

  • Acción de respuesta: La acción de respuesta proporciona la misma funcionalidad al enviar una respuesta al cliente que la acción de enrutamiento proporciona al enviar un mensaje al receptor. Por tanto, si la Aplicación B envía una respuesta a la Aplicación A, los puentes utilizarán las funcionalidades de la Acción de respuesta para marcar la respuesta con los encabezados requeridos por el cliente. Para obtener más información, vea Reply Action.

En este tutorial se muestran, además de otras funcionalidades, aquellas que corresponden al puente, valiéndose de un escenario empresarial.

Northwind Traders es una aseguradora de automóviles. Northwind Traders recibe solicitudes para la elaboración de nuevas cotizaciones para pólizas en un formato XML que cumpla con el esquema ACORD, una norma del sector para mensajes de seguros. Los mensajes entrantes pueden estar en cualquier formato que se ajuste a la norma ACORD. Por tanto, Northwind Traders tiene que configurar una solución capaz de procesar mensajes XML que cumplan con más de un esquema XML. Una vez que Northwind Traders recibe el mensaje, este se valida de acuerdo con los esquemas ACORD para mensajería que les han sido facilitados y se transforma en un esquema interno de Northwind. Northwind envía en mensaje a un servicio back-end que lo sigue procesando. Sin embargo, hay que cumplir ciertas condiciones de enrutamiento antes de enviar el mensaje al servicio.

  • Si el importe de la cotización incluida en el mensaje es inferior a 10.000 dólares, deberá enviarse a un servicio de retransmisión, como RelayReceiverServiceA. Antes de enviar el mensaje al servicio de retransmisión, debe agregarse al encabezado del mensaje un encabezado SOAP denominado QuoteType. El valor del encabezado debe establecerse en SmallAmounts.

  • Si el importe de la cotización incluida en el mensaje es superior a 10.000 dólares, se considerará que es una notificación de alto riesgo y se enviará a otro servicio de retransmisión, como RelayReceiverServiceB. Antes de enviar el mensaje al servicio, debe agregarse al encabezado del mensaje un encabezado SOAP denominado QuoteType. El valor de este encabezado debe establecerse en LargeAmounts.

Tras recibir el mensaje, los servicios generan una respuesta, agregan los encabezados y envían una respuesta al puente. Los servicios agregan los siguientes encabezados:

 

Respuesta de servicio Encabezados agregados

RelayServiceA

 

Nombre de encabezado Valor de encabezado

MsgStatus

Correcto

Idoneidad

ApprovedForSmallAmounts

RelayServiceB

 

Nombre de encabezado Valor de encabezado

MsgStatus

Correcto

Idoneidad

ApprovedForLargeAmounts

La respuesta del servicio tiene el mismo formato que la solicitud interna de Northwind. Después de que el puente reciba la respuesta, la transformará al esquema de mensajes de respuesta de acuerdo con las normas ACORD. El puente también extrae el valor del encabezado MsgStatus y lo asigna a un elemento del esquema de respuestas. Por último, antes de volver a enviar el mensaje al cliente, el puente agrega otro encabezado denominado ProcessingStatus y establece su valor en Completo. En la ilustración siguiente se representa este escenario.

Usar puentes con servicios de retransmisión

Northwind Traders usa Servicios de BizTalk para configurar este escenario. Esto es lo que Northwind Traders hace desde su extremo para que este escenario funcione de un extremo a otro:

  • Northwind crea dos servicios de retransmisión: RelayReceiverServiceA y RelayReceiverServiceB. RelayReceiverServiceA recibe mensajes con cotizaciones inferiores a los 10.000 dólares. RelayServiceB recibe mensajes con cotizaciones superiores a los 10.000 dólares. Tras recibir el mensaje, ambos servicios generan un mensaje de respuesta y lo marcan con los encabezados, tal y como se describe en el escenario empresarial.

  • Northwind crea un Proyecto de servicio de BizTalk y agrega un Puente de solicitud y respuesta XML para procesar los mensajes XML entrantes y enviar una respuesta. Northwind agrega también dos componentes de servicio de retransmisión bidireccional, uno para RelayReceiverServiceA y el otro para RelayReceiverServiceB.

  • Northwind agrega todos los artefactos requeridos (esquemas y transformaciones) al Proyecto de servicio de BizTalk.

  • Northwind configura la ruta de solicitud del Puente de solicitud y respuesta XML para hacer lo siguiente:

    • Configurar la fase de Validación para validar los mensajes XML de acuerdo con los esquemas ACORD.

    • Configurar la fase de Enriquecimiento para promocionar las propiedades en base a las cuales los mensajes se enrutan a los servicios back-end.

    • Configurar la fase de Transformación para transformar los mensajes del esquema ACORD al esquema interno de Northwind.

  • Northwind configura la ruta de respuesta del Puente de solicitud y respuesta XML para hacer lo siguiente:

    • Configurar la fase de Enriquecimiento para extraer el encabezado MsgStatus agregado por los servicios de retransmisión al mensaje de respuesta.

    • Configurar la fase de Transformación para transformar la respuesta de los servicios de retransmisión a un esquema de mensajes que cumpla con las normas ACORD. En esta fase, el puente también asigna el valor del encabezado MsgStatus a un elemento del esquema de respuesta.

    • Configurar la Acción de respuesta para incluir el encabezado ProcessingStatus en el mensaje de respuesta que se le envía al cliente.

  • Northwind agrega dos extremos de retransmisión externos al Proyecto de servicio de BizTalk que representa a los dos servicios de retransmisión y los conecta al Puente de solicitud y respuesta XML. Como parte de estos conectores de enrutamiento, Northwind realiza lo siguiente:

    • Conectar todos los componentes de la superficie de diseño de Configuración del puente y establecer las condiciones de filtrado en base al importe de la cotización.

    • Marcar el encabezado QuoteType del mensaje y fijar su valor en SmallAmounts o en LargeAmounts dependiendo del servicio al que se va a enrutar el mensaje.

  • Por último, Northwind implementa los dos servicios de retransmisión en el CmdLets y el Proyecto de servicio de BizTalk en los Servicios de BizTalk y envía un mensaje al extremo del puente.

Este tutorial se ha escrito en torno a un ejemplo, Bridges_RelayServices.zip, que está disponible como parte de la descarga de la Galería de código de MSDN. Puede usar el ejemplo y seguir este tutorial para entender cómo se creó. O bien, puede usar este tutorial para crear su propia aplicación. Este tutorial está destinado al segundo enfoque, de modo que entienda cómo se compiló esta aplicación. Además, en la medida de lo posible, el tutorial es coherente con el ejemplo y utiliza los mismos nombres para los artefactos (por ejemplo, esquemas, transformaciones) que se usan en el ejemplo.

Aunque Microsoft recomienda que siga el tutorial para entender los conceptos y procedimientos, si desea utilizar el ejemplo, haga lo siguiente:

  • Descargue el ejemplo Bridges_RelayServices y haga los cambios necesarios, como, por ejemplo, proporcionar el espacio de nombres de su CmdLets, su nombre del emisor o su clave del emisor. Después de realizar los cambios necesarios, compile e implemente la aplicación.

  • Compile y hospede los dos servicios de retransmisión para aceptar los mensajes de solicitud recibidos a través del puente.

  • Use la herramienta MessageSender incluida en el paquete para enviar mensajes de solicitud al puente. Compruebe los símbolos del sistema de los servicios, así como la herramienta MessageSender para ver si los mensajes se han procesado correctamente. Si los mensajes se han procesado correctamente, los esquemas de solicitud y respuesta se guardan en la carpeta del proyecto \bin\Debug. La ubicación y el nombre de los archivos de mensajes se muestran también en los respectivos símbolos del sistema.

En la ubicación de descarga de los Servicios de BizTalk (http://go.microsoft.com/fwlink/?LinkId=235057), descargue e instale el SDK de Servicios de BizTalk. Para obtener instrucciones, vea Instalar el SDK de servicios de BizTalk de Azure. Al instalar el SDK se instala la plantilla del Proyecto de servicio de BizTalk en Visual Studio. Esta plantilla de proyecto se usa para crear puentes que validen, transformen y enruten los mensajes a distintos extremos, tal y como se describe en el escenario empresarial.

Vea también

Otros recursos

Tutoriales y muestras

Mostrar:
© 2015 Microsoft