Compartir a través de

MQSSendPipelineComponent (ejemplo de BizTalk Server)

  • Artículo

En este ejemplo se muestra cómo escribir un componente de canalización que lea un conjunto de valores de propiedades de MQSeries a partir de un archivo XML y que los aplique a un mensaje.

Descripción del ejemplo

Este ejemplo se compone de dos proyectos de Visual Studio, un proyecto de componente de canalización y un proyecto de canalización que usa el componente de canalización.

Ubicación del ejemplo

  • <SamplesPath>\AdaptersUsage\MQSeriesAdapter\MQSSendPipelineComponent\SetMQSeriesHeaderPropertyComponent

  • <SamplesPath>\AdaptersUsage\MQSeriesAdapter\MQSSendPipelineComponent\SetMQSeriesHeaderPropertyPipeline

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

Archivo Descripción
SetMQSeriesHeaderPropertyComponent\SetMQSeriesHeaderPropertyComponent.sln,

SetMQSeriesHeaderPropertyComponent\SetMQSeriesHeaderPropertyComponent.csproj		 Archivos de proyectos y soluciones para el componente de canalización.
SetMQSeriesHeaderPropertyComponent\CSetMQSeriesHeaderPropertyComponent.cs Archivo de origen de Visual C#® para el componente de canalización.
SetMQSeriesHeaderPropertyComponent\SetMQSMQMDHdrProps.xml Propiedades de MQSeries leídas y usadas por el componente de canalización.
SetMQSeriesHeaderPropertyPipeline\SetMQSeriesHeaderPropertyPipeline.btproj,

SetMQSeriesHeaderPropertyPipeline\SetMQSeriesHeaderPropertyPipeline.sln		 Archivos de proyectos y soluciones para la canalización de BizTalk.
SetMQSeriesHeaderPropertyPipeline\SetMQSeriesHeaderPropertyPipeline.snk Archivo de clave de nombre seguro para el proyecto de canalización de BizTalk.
SetMQSeriesHeaderPropertyPipeline\SetMQSeriesHeaderPropertyPipeline.btp Canalización de BizTalk Server.

Uso del ejemplo

Para crear la aplicación, debe realizar los siguientes pasos:

  1. Crear las carpetas para la aplicación.

  2. Modifique y compile el proyecto de Visual Studio para el componente de canalización.

  3. Copiar el ensamblado compilado y el archivo de encabezado en las carpetas adecuadas.

  4. Modifique el proyecto de Visual Studio para la canalización de BizTalk Server.

  5. Compilar e implementar el proyecto de canalización de BizTalk Server.

  6. Configurar una ubicación de recepción de BizTalk Server.

  7. Crear una cola de MQSeries.

  8. Configurar un puerto de envío.

  9. Habilitar la ubicación de recepción e iniciar el puerto de envío.

Crear las carpetas para la aplicación

Este procedimiento crea las carpetas correspondientes para la aplicación.

Para crear las carpetas para la aplicación

  1. Cree una carpeta denominada temp en la unidad C:\ si aún no existe.

  2. Cree una carpeta en el directorio C:\temp denominado Pickup3.

Modificar y compilar el proyecto para el componente de canalización

Este procedimiento modifica y compila el proyecto de Visual Studio para el componente de canalización.

Para modificar y compilar el proyecto para el componente de canalización

  1. Haga doble clic en el archivo de solución , SetMQSeriesHeaderPropertyComponent\SetMQSeriesHeaderPropertyComponent.sln para abrir la solución en Visual Studio.

  2. Haga doble clic en el archivo de clase CSetMQSeriesHeaderPropertyComponent.cs para abrir el archivo de clase en Visual Studio.

  3. Busque la variable samplesDir y compruebe que esta variable está establecida en la ubicación C:\temp.

  4. Haga clic con el botón derecho en la solución en el Explorador de soluciones y haga clic en Compilar. Esto compilará el proyecto en un archivo DLL ubicado en el directorio SetMQSeriesHeaderPropertyComponent\SetMQSeriesHeaderPropertyComponent\bin\Debug\ .

Copiar el ensamblado y el archivo de encabezado en las carpetas adecuadas

Este procedimiento copia el ensamblado compilado y el archivo de encabezado en las carpetas adecuadas.

Para copiar el ensamblado compilado y el archivo de encabezado en las carpetas adecuadas

  1. Copie el ensamblado compilado SetMQSeriesHeaderPropertyComponent.dll en la carpeta de componentes de canalización de BizTalk. La ubicación predeterminada de la carpeta de componentes de canalización de BizTalk es \Program Files (x86)\Microsoft BizTalk Server <VERSION>Pipeline Components.

  2. Copie el archivo de propiedades MQHeader SetMQSMQMDHdrProps.xml en el directorio C:\temp .

Modificar el proyecto para la canalización de BizTalk Server

Este procedimiento modifica el proyecto de Visual Studio para la canalización de BizTalk Server.

Para modificar el proyecto para la canalización de BizTalk Server

  1. En Visual Studio, abra la solución haciendo doble clic en el archivo de solución , SetMQSeriesHeaderPropertyPipeline\SetMQSeriesHeaderPropertyPipeline.sln.

  2. Cree un archivo de clave de nombre seguro para el proyecto. Para ello, haga lo siguiente:

    1. Abra un símbolo del sistema de Visual Studio.

    2. Cambie los directorios a <SamplesPath>\AdaptersUsage\MQSeriesAdapter\MQSSendPipelineComponent.

    3. Escriba lo siguiente:

      sn -k MQSSendPipelineComponent.snk

    4. Presione ENTRAR. Al hacerlo, se creará el archivo de clave.

  3. En Explorador de soluciones, haga clic con el botón derecho en el proyecto y haga clic en Propiedades para iniciar Project Designer para el proyecto (en la ventana central).

    1. En el Designer proyecto, haga clic en la pestaña Firma.

    2. En el panel derecho, seleccione la opción Firmar el ensamblado .

    3. Haga clic en la lista desplegable para la opción Elegir un archivo de clave de nombre seguro y haga clic en Examinar.

    4. Vaya a <SamplesPath>\AdaptersUsage\MQSeriesAdapter\MQSSendPipelineComponent\MQSSendPipelineComponent.snk, haga clic en Abrir.

  4. El componente de canalización que creó anteriormente ya se ha agregado a la fase de preensamblado de este proyecto de canalización. En caso de que no se haya agregado, debería completar los pasos siguientes para agregarlo:

    1. En el IDE de Visual Studio, haga clic en la pestaña Cuadro de herramientas del lado izquierdo.

    2. Haga clic con el botón derecho en el Cuadro de herramientas y haga clic en Elegir elementos.

    3. En el cuadro de diálogo Elegir elementos del cuadro de herramientas , haga clic en la pestaña Componentes de canalización de BizTalk , seleccione el Componente personalizado para establecer el componente de propiedades del encabezado MQseriesy, a continuación, haga clic en Aceptar.

    4. Arrastre el componente personalizado para establecer el componente de propiedades del encabezado MQseriesen la fase de preensamblado de esta canalización.

Compilar e implantar el proyecto de canalización

Este procedimiento compila e implementa el proyecto de canalización de BizTalk Server.

Para compilar e implantar el proyecto de canalización

  1. En la ventana Explorador de soluciones, haga clic con el botón derecho en la solución y, a continuación, haga clic en Implementar solución. Así se genera la solución y se implementa el ensamblado en la base de datos de administración de BizTalk.

  2. Verifique si el ensamblado se ha implementado en la base de datos de administración de BizTalk:

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

    2. Haga clic para expandir grupo de BizTalk [<nombreServidor>:<base de datos> de administración] y, a continuación, haga clic para expandir la carpeta Ensamblados .

      El ensamblado de canalización implementado debe estar visible en la carpeta Ensamblados .

Crear la ubicación de recepción

Este procedimiento crea una ubicación de recepción de BizTalk Server.

Para crear la ubicación de recepción

  1. En la consola de administración de BizTalk Server, 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.

  2. En el cuadro de diálogo Propiedades de puerto de recepción unidireccionales , en el cuadro Nombre escriba "MQReply" y haga clic en Aceptar.

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

  4. En el cuadro de diálogo Propiedades de ubicación de recepción, en el campo Nombre , escriba "ReceiveFile".

  5. En el cuadro Tipo de transporte , seleccione ARCHIVO.

  6. En el campo Controlador de recepción, seleccione BizTalkServerApplication.

  7. En el campo Canalización de recepción , seleccione Microsoft.BizTalk.DefaultPipelines.PassThruReceive.

  8. En el campo Carpeta de recepción , escriba "C:\temp\Pickup3".

  9. En el campo Máscara de archivo , escriba "*.*".

  10. Haga clic en Aceptar y, a continuación, vuelva a hacer clic en Aceptar para salir del cuadro de diálogo Propiedades de ubicación de recepción.

Crear una cola de MQSeries mediante el explorador de MQSeries

Si dispone de los permisos necesarios para la instalación de MQSeries Server para Windows, puede crear la cola de MQSeries mediante los cuadros de diálogo del adaptador y puede omitir el procedimiento siguiente.

Si no dispone de este acceso, puede usar el procedimiento siguiente para crear la cola mediante IBM WebSphere MQ Explorer.

Para crear una cola de MQSeries mediante el explorador de MQSeries

  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 SETHEADER y, a continuación, haga clic en Aceptar.

Crear el puerto de envío y la cola MQSeries

Este procedimiento crea el puerto de envío para el mensaje de salida. También se crea la cola de MQSeries al crear el puerto de envío si no lo ha creado anteriormente.

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 del puerto de envío, en el cuadro Nombre , escriba "MQSolicitResponse".

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

  4. En el cuadro Enviar canalización , seleccione SetMQSeriesHeaderPropertyPipeline.SetMQSeriesHeadersSendPipeline.

  5. En Filtros, agregue una nueva entrada con los siguientes pares nombre-valor:

    • Establezca Property en "BTS. ReceivePortName".

    • Establezca Operador en "==".

    • Establezca Valor en "ReceiveFile".

      Nota

      De este modo, se establece el puerto de envío para suscribirse a mensajes que se reciban en el puerto de recepción ReceiveFile.

  6. Haga clic en Transporte.

  7. En el campo Dirección (URI), haga clic en el botón de puntos suspensivos (...) .

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

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

  10. En el campo Administrador de colas , seleccione el administrador de colas predeterminado.

  11. En el campo Cola, escriba "SETHEADER" y, a continuación, haga clic en Exportar.

  12. 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 todo el cuadro de diálogo.

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

Este procedimiento habilita la ubicación de recepción e inicia el puerto de envío.

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 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 SetMQHeader y haga clic en Iniciar.

Probar la aplicación

Este procedimiento comprueba la aplicación.

Para probar la aplicación

  1. Coloque un archivo en la carpeta C:\Temp\Pickup3 .

  2. Inicie WebSphere MQ Explorer y haga doble clic en la cola SETHEADER para examinar los mensajes de dicha cola.

    Para ver todas las propiedades de contexto correspondientes a los mensajes de la cola SETHEADER, debe llevar a cabo los pasos siguientes:

    1. Haga doble clic en la cola SETHEADER para mostrar el cuadro de diálogo Explorador de mensajes.

    2. En el cuadro de diálogo Explorador de mensajes, haga clic en Columnas para mostrar el cuadro de diálogo Mostrar u ocultar columnas para mensajes .

    3. En Columnas disponibles, haga doble clic en cada entrada para que sea visible en el cuadro de diálogo Explorador de mensajes y, a continuación, haga clic en Aceptar.

  3. Las propiedades de contexto del mensaje para cada mensaje deben estar visibles en el cuadro de diálogo Explorador de mensajes.

Consulte también

Ejemplos del adaptador de MQSeries