Compartir a través de

Tutorial: Crear una aplicación de BizTalk que utilice el adaptador de MQSeries

  • Artículo

Esta sección le lleva a través de la creación de una sencilla aplicación de Microsoft BizTalk Server que usa el adaptador MQSeries.

Nota

La aplicación supone que tiene instalado IBM WebSphere MQ, componente del servidor para las plataformas de Windows, en el mismo equipo que BizTalk Server. Asimismo, supone que todavía no ha creado ningún puerto de envío o ubicaciones de recepción. Si dispone de puertos de envío o ubicaciones de recepción existentes, sustituya los nombres correspondientes cuando siga los pasos.

La aplicación es una sencilla aplicación de enrutamiento por contenidos que sólo utiliza un puerto de envío o una ubicación de recepción. La ubicación de recepción lee de una cola de IBM WebSphere MQ. El puerto de envío obtiene el mensaje a partir de la ubicación de recepción y lo envía a una cola diferente de IBM WebSphere MQ.

Para crear la aplicación, debe crear las colas de IBM WebSphere MQ, configurar el puerto de envío y la ubicación de recepción de BizTalk Server, iniciar el puerto de envío, habilitar la ubicación de recepción y colocar un mensaje de prueba en la cola.

Si dispone de los permisos necesarios para instalar IBM WebSphere MQ, puede crear colas de IBM WebSphere MQ mediante los cuadros de diálogo del adaptador y omitir el procedimiento siguiente. Si no dispone de este acceso, puede crear colas mediante IBM WebSphere MQ, componentes cliente para el explorador de las plataformas de Windows. Para crear las colas mediante el complemento de IBM WebSphere MQ Explorer, realice el procedimiento siguiente:

Para crear las colas de IBM WebSphere MQ mediante IBM WebSphere MQ Explorer

Para crear las colas de IBM WebSphere MQ mediante IBM WebSphere MQ Explorer, siga estos pasos:

  1. Haga clic en Inicio, seleccione Programas, IBM WebSphere MQ y, a continuación, haga clic en WebSphere MQ Explorer.

  2. Haga doble clic en Administradores de colas y, a continuación, haga doble clic en el administrador de colas predeterminado. Normalmente, el administrador de colas predeterminado se denomina QM_<machine_name> donde machine_name es el nombre del equipo.

  3. Haga clic con el botón derecho en Colas, seleccione Nuevoy, a continuación, haga clic en Cola local.

  4. En el cuadro de diálogo Crear cola local , en Nombre de cola, escriba BTStoMQS y, a continuación, haga clic en Aceptar.

  5. Haga clic con el botón derecho en Colas, seleccione Nuevoy, a continuación, haga clic en Cola local.

  6. En el cuadro de diálogo Crear cola local , en Nombre de cola, escriba MQStoBTS y, a continuación, haga clic en Aceptar.

    En los siguientes pasos se crea el puerto de envío y la ubicación de recepción, se inicia el puerto de envío y la ubicación de recepción. También se crean las colas de IBM WebSphere MQ.

Para crear la ubicación de recepción y la cola de MQSeries

Para crear la ubicación de recepción y la cola de MQSeries, siga estos pasos:

  1. En la consola de administración de BizTalk Server, expanda administración BizTalk Server, expanda Grupo de BizTalk, expanda Aplicaciones y, a continuación, expanda la aplicación predeterminada (Aplicación de BizTalk 1 de forma predeterminada).

  2. Haga clic con el botón derecho en el nodo Puertos de recepción , haga clic en Nuevo y seleccione Puerto unidireccional.

  3. En el cuadro de diálogo Propiedades del puerto de recepción , en el cuadro Nombre , escriba MQStoBTS.

  4. En el panel izquierdo, haga clic en Ubicaciones de recepción y, en el panel derecho, haga clic en Nuevo.

  5. En el cuadro de diálogo Propiedades de ubicación de recepción , en el cuadro Nombre , escriba MQStoBTS.

  6. Seleccione MQSeries en la lista desplegable situada junto a la opción Tipo .

  7. En la sección Transporte , haga clic en Configurar.

  8. En el cuadro de diálogo Propiedades de transporte de MQSeries , en el cuadro Intervalo de sondeo , escriba 1.

  9. En el cuadro Definición de cola , haga clic en el botón de puntos suspensivos (...).

  10. En el cuadro de diálogo Definición de cola , en el cuadro Nombre del servidor , escriba el nombre del equipo.

  11. En el cuadro Administrador de colas , seleccione el administrador de colas predeterminado.

  12. En el cuadro Cola , escriba MQStoBTS y, a continuación, haga clic en Exportar.

  13. En el cuadro de diálogo Exportar , haga clic en Crear colay, a continuación, haga clic en Aceptar y en Aceptar de nuevo para volver al cuadro de diálogo Propiedades de ubicación de recepción .

  14. En el cuadro Controlador de recepción , seleccione BizTalkServerApplication.

  15. En el cuadro Canalización de recepción , seleccione PassThruReceive.

  16. Haga clic en Aceptar para aplicar los cambios.

Para crear el puerto de envío y la cola de MQSeries

Para crear el puerto de envío y la cola de MQSeries, siga estos pasos:

  1. Haga clic con el botón derecho en Puertos de envío, haga clic en Nuevoy seleccione Puerto de envío unidireccional estático.

  2. En el cuadro de diálogo Propiedades del puerto de envío, en el cuadro Nombre , escriba BTStoMQS.

  3. Seleccione MQSeries en la lista desplegable situada junto a la opción Tipo .

  4. En la sección Transporte , haga clic en Configurar.

  5. En el cuadro de diálogo Propiedades de transporte de MQSeries , en el cuadro Definición de cola , haga clic en el botón de puntos suspensivos (...).

  6. En el cuadro de diálogo Definición de cola , en el cuadro Nombre del servidor , escriba el nombre del equipo.

  7. En el cuadro Administrador de colas , seleccione el administrador de colas predeterminado.

  8. En el cuadro Cola , escriba BTStoMQS y, a continuación, haga clic en Exportar.

  9. En el cuadro de diálogo Exportar , haga clic en Crear cola y, a continuación, haga clic en Aceptar y en Aceptar de nuevo para volver al cuadro de diálogo Propiedades de puerto de envío.

  10. En el cuadro Enviar canalización , seleccione PassThruTransmit.

  11. Haga clic para seleccionar Filtros en el panel izquierdo y, a continuación, configure las opciones de filtro en el panel derecho.

  12. En la lista desplegable Propiedad , seleccione BTS. ReceivePortName.

  13. En el cuadro Valor , escriba MQStoBTS.

  14. Haga clic en Aceptar para aplicar los cambios.

Para habilitar la ubicación de recepción e iniciar el puerto de envío

Para habilitar la ubicación de recepción e iniciar el puerto de envío, siga estos pasos:

  1. Haga clic con el botón derecho en la ubicación de recepción de MQStoBTS y, a continuación, haga clic en Habilitar.

  2. Haga clic con el botón derecho en el puerto de envío BTStoMQS y, a continuación, haga clic en Iniciar.

    El paso siguiente es comprobar la aplicación mediante el envío de un mensaje de prueba a la cola de recepción.

Para probar la aplicación

Para probar la aplicación, siga estos pasos:

  1. Haga clic en Inicio, seleccione Programas, IBM WebSphere MQ y, a continuación, haga clic en WebSphere MQ Explorer.

  2. Haga clic con el botón derecho en MQStoBTS y, a continuación, haga clic en Put Test Message (Colocar mensaje de prueba).

  3. En el cuadro Datos de mensaje, escriba un mensaje de prueba. Haga clic en OK.

    Después de escribir los datos, la profundidad actual de la cola MQStoBTS es una (1). Cuando la aplicación procesa el mensaje, el recuento vuelve a cero (0) y la profundidad actual de BTStoMQS se convierte en una (1). También puede ver el contenido del mensaje.

Para ver el mensaje

Para ver el mensaje, siga estos pasos:

  1. Haga doble clic en la cola BTStoMQS .

  2. Haga doble clic en el mensaje y, a continuación, seleccione la hoja Datos . Puede ver el texto del mensaje en el cuadro Datos del mensaje.

  3. Haga clic en OK.

Consulte también

¿Qué es el adaptador de MQSeries?
Arquitectura del adaptador de MQSeries