Compartir a través de

OrderedSample (ejemplo de BizTalk Server)

  • Artículo

El ejemplo OrderedSample muestra cómo usar una orquestación para recibir y enviar un serie ordenada de mensajes en un modo de envío y recepción.

Descripción del ejemplo

El ejemplo asume que existen mensajes en la cola MQSeries desde la que recibe mensajes. Cuando el adaptador lee los mensajes de la cola MQSeries, lo hace en orden y los envía a BizTalk Server.

El puerto de recepción de la orquestación, mqreceive, tiene su propiedad Ordered Delivery establecida en True.

En cuanto al envío, la orquestación envía un mensaje y, a continuación, espera por la notificación de entrega antes de enviar el siguiente mensaje. El puerto de envío, mqsend tiene su propiedad Delivery Notification establecida en Transmitido. Para que el ejemplo siga siendo sencillo, la orquestación usa un bucle infinito.

La orquestación puede recibir lotes de mensajes, así como un único mensaje.

Ubicación del ejemplo

<Ruta de acceso> de ejemplos\AdaptersUsage\MQSeriesAdapter\OrderedSample

En la tabla siguiente se enumeran los archivos del ejemplo y se describe su propósito.

Archivo Descripción
OrderedReceiveSend.btproj,

OrderedReceiveSend.sln		 Archivos de proyectos y soluciones para la aplicación.
OrderedReceiveSendOrchestration.odx La orquestación de la aplicación.
OrderedSample.snk Archivo de clave de nombre seguro.
Setup.bat Crea e inicializa este ejemplo.

Compilación y ejecución del ejemplo

Para generar e implementar el ejemplo

  1. En una ventana de comandos, desplácese a la siguiente carpeta:

    <Samples Path>\AdaptersUsage\MQSeriesAdapter\OrderedSample

  2. Ejecute el archivo Setup.bat que realiza las acciones siguientes:

    1. Crea una clave de nombre seguro para el proyecto.

    2. Compila e implementa el proyecto de orquestación.

    Si dispone de los permisos necesarios para la instalación de MQSeries Server para Windows, puede crear la cola MQSeries mediante los cuadros de diálogo del adaptador y puede omitir el procedimiento siguiente. Si no dispone de este acceso, puede crear la cola con IBM WebSphere MQ Explorer. Para crear las colas con WebSphere MQ Explorer, realice los siguientes pasos.

Crear las colas MQSeries con WebSphere MQ Explorer

Para crear las colas MQSeries con WebSphere MQ Explorer

  1. Haga clic en Inicio, seleccione Todos los 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. El administrador de colas predeterminado se denomina normalmente 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 "queue1" y, a continuación, haga clic en Aceptar.

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

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

Crear la ubicación de recepción y la cola MQSeries

Este procedimiento crea el puerto de envío y la ubicación de recepción para enviar el mensaje y recibir el mensaje de correlación de MQSeries. La cola MQSeries también se creará al crear la ubicación de recepción si no se ha creado anteriormente.

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

  1. Abra la consola de administración de BizTalk Server.

  2. Expanda administración de BizTalk Server, grupo de BizTalk, aplicaciones y, a continuación, expanda la aplicación necesaria.

  3. Haga clic con el botón derecho en Puertos de recepción, seleccione Nuevoy, a continuación, haga clic en Puerto de recepción unidireccional.

  4. En el cuadro de diálogo Propiedades de puerto de recepción unidireccional , en el cuadro Nombre , escriba OrderedSampleReceive y haga clic en Aceptar.

  5. En el panel izquierdo, haga clic en la pestaña Ubicaciones de recepción y, a continuación, haga clic en Nuevo.

  6. En el cuadro de diálogo Propiedades de ubicación de recepción , en el cuadro Nombre , escriba "OrderedSampleReceiveLocation".

  7. En el cuadro Tipo de transporte , seleccione MQSeries.

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

  9. En el cuadro Canalización de recepción , seleccione Microsoft.BizTalk.DefaultPipelines.PassThruReceive.

  10. Haga clic en Configurar.

  11. En el cuadro de diálogo Propiedades de transporte de MQSeries, en el cuadro Intervalo de sondeo, escriba "10".

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

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

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

  15. En el cuadro Cola , escriba " queue1" y, a continuación, haga clic en Exportar.

  16. En el cuadro de diálogo Exportar , haga clic en Crear cola y, a continuación, haga clic en Aceptar o Listo hasta que haya salido de todos los cuadros de diálogo.

Crear el puerto de envío y la cola MQSeries

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

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

  2. En el cuadro de diálogo Propiedades de puerto estático, escriba "OrderedSampleSend" en el cuadro Nombre.

  3. En el cuadro Tipo de transporte , seleccione MQSeries.

  4. En el cuadro Enviar canalización , seleccione Microsoft.BizTalk.DefaultPipelines.PassThruTransmit.

  5. Haga clic en Configurar.

  6. 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 (...) .

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

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

  9. En el cuadro Cola , escriba " queue2" y, a continuación, haga clic en Exportar.

  10. En el cuadro de diálogo Exportar , haga clic en Crear cola y, a continuación, haga clic en Aceptar o Listo hasta que haya salido de todos los cuadros de diálogo.

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

  1. En la consola de administración de BizTalk Server, haga clic en Puertos de recepción.

  2. En el panel de detalles, haga clic con el botón derecho en la ubicación de recepción de MQIn y haga clic en Habilitar.

  3. En el panel de detalles, haga clic con el botón derecho en el puerto de envío MQOut y haga clic en Inicio.

Para enlazar e iniciar la Orquestación

  1. En la consola de administración de BizTalk Server, expanda la carpeta Orquestaciones.

  2. Haga doble clic en la orquestación OrderedSampleOrchestration y, a continuación, haga clic en Enlaces.

  3. Enlace los puertos de orquestación con los siguientes puertos de envío y ubicaciones de recepción:

    Puerto de orquestación Puerto de mensajería/ubicación de recepción
    mqreceive OrderedSampleReceive
    mqsend OrderedSampleSend

  4. Haga clic en Host.

  5. En el cuadro Host , seleccione BizTalkServerApplication y haga clic en Aceptar.

  6. Haga clic con el botón derecho en Orchestration (Orquestación) y haga clic en Start (Iniciar).

Para ejecutar el ejemplo

  1. Iniciar la orquestación.

  2. Colocar los mensajes en la cola MQSeries desde la que ha configurado la ubicación de recepción para realizar la lectura.

  3. Ver los mensajes en la cola de envío de WebSphere MQ Explorer en la que ha configurado el puerto de envío para enviar mensajes.

Consulte también

Ejemplos del adaptador de MQSeries