Componente de canalización del inspector de mensajes
Este componente de canalización le permite examinar todas las partes de un mensaje de varias partes y el contexto del mensaje para determinar si hay un problema con el mensaje. Este componente se usa para solucionar problemas.
El componente de canalización coloca los archivos XML en el directorio que usted designe. Cada uno de estos archivos contiene una de las cuatro partes de un mensaje de RNIFv2.0 (encabezado de preámbulo, encabezado de entrega, encabezado de servicio y contenido de servicio) o las tres partes de un mensaje de RNIFv1.1 (encabezado de preámbulo, encabezado de servicio y contenido de servicio). Otro archivo XML contiene el contexto del mensaje.
Debe generar este componente en una canalización personalizada y adjuntarlo a un puerto de envío. Cree un filtro en el puerto de envío para suscribirse a los mensajes que desea supervisar. Esta solución de problemas se produce además del procesamiento estándar que ya realiza el Acelerador de Microsoft® BizTalk para RosettaNet (BTARN).
Generación de una canalización personalizada mediante el componente de canalización del inspector de mensajes
Para usar el componente de canalización del inspector de mensajes, debe generar e implementar una canalización personalizada que incluya el componente. Para obtener más información, consulte "Creación de canalizaciones con Designer de canalización" en BizTalk Server Ayuda.
Para implementar el componente de canalización del inspector de mensajes
Inicie Visual Studio.
En el menú Archivo , seleccione Abriry haga clic en Proyecto.
Vaya a C:\Archivos de programa (x86)\Acelerador de versiones de Microsoft BizTalk <> para RosettaNet\SDK\Componente de canalización del inspector de mensajes, seleccione MessageInspector.csproj y, a continuación, haga clic en Abrir.
Abra el símbolo del sistema de Visual Studio.
En el símbolo del sistema, vaya a C:\Archivos de programa (x86)\Acelerador de versiones de Microsoft BizTalk <> para RosettaNet\SDK\Message Inspector Pipeline Component\obj\debug.
En el símbolo del sistema, escriba "sn -k MessageInspector.snk" para crear una clave y, a continuación, presione ENTRAR.
En Visual Studio, en Explorador de soluciones, haga clic con el botón derecho en MessageInspector y, a continuación, haga clic en Propiedades.
En la página Propiedad MessageInspector , haga clic en la pestaña Firmay , a continuación, haga clic en Firmar el ensamblado casilla.
En la lista desplegable Elegir un archivo de clave de nombre seguro, vaya a C:\Archivos de programa (x86)\Acelerador de versiones de Microsoft BizTalk <> para RosettaNet\SDK\Message Inspector Pipeline Component\obj\debug y seleccione MessageInspector.snk y, a continuación, haga clic en Abrir.
En el Explorador de soluciones, haga clic con el botón derecho en MessageInspectory, a continuación, haga clic en Generar. En el panel de salida, compruebe que la compilación se realizó correctamente.
Haga clic en Inicio, seleccione Todos los programas, Accesorios y, a continuación, haga clic en Explorador de Windows.
En el Explorador de Windows, vaya a C:\Archivos de programa (x86)\Acelerador de versiones de Microsoft BizTalk <> para RosettaNet\SDK\Message Inspector Pipeline Component\obj\debug, haga clic con el botón derecho enMicrosoft.Solutions.BTARN.SDK.MessageInspector.dlly, a continuación, haga clic en Copiar.
Vaya a C:\Archivos de programa (x86)\Acelerador de versiones de Microsoft BizTalk <> para RosettaNet\Pipeline Components, haga clic con el botón derecho en Componentes de canalización y, a continuación, haga clic en Pegar.
En Visual Studio, en el menú Archivo , seleccione Nuevo y, a continuación, haga clic en Proyecto.
En el cuadro de diálogo Nuevo proyecto , en el panel Plantillas, seleccione Proyecto vacío de servidor BizTalk Servery, en el cuadro Nombre , escriba un nombre para el proyecto. En el cuadro Ubicación , vaya a la carpeta en la que desea guardar el proyecto y, a continuación, haga clic en Aceptar.
En el Explorador de soluciones, haga clic con el botón derecho en el nombre del proyecto, seleccione Agregary luego haga clic en Agregar nuevo elemento.
En el cuadro de diálogo Agregar nuevo elemento , seleccione Canalización de envíoy, en el cuadro Nombre , escriba un nombre para el archivo de canalización personalizada y, a continuación, haga clic en Abrir.
Nota:
Agregue el componente de canalización del inspector de mensajes solo para puertos de envío, no para puertos de recepción.
Haga clic con el botón derecho en el panel de componentes de canalización de BizTalk del panel Cuadro de herramientas y, a continuación, haga clic en Agregar o quitar elementos.
En el cuadro de diálogo Personalizar cuadro de herramientas , en la pestaña Componentes de canalización de BizTalk , seleccione Componente del inspector de mensajes de BTARNy haga clic en Aceptar.
En el panel Componentes de canalización de BizTalk del panel Cuadro de herramientas, haga clic y mantenga presionado el componente Inspector de mensajes de BTARN y, a continuación, arrastre el componente en un cuadro Colocar aquí.
En Visual Studio, en Explorador de soluciones, haga clic con el botón derecho en el nombre del proyecto de canalización y, a continuación, haga clic en Propiedades.
En el cuadro de diálogo Páginas de propiedades , haga clic en Propiedades comunesy, a continuación, haga clic en Ensamblado.
En el panel derecho, en el cuadro de texto asociado al archivo de clave de ensamblado, haga clic en los puntos suspensivos, vaya a C:\Archivos de programa (x86)\Microsoft BizTalk <version> Accelerator for RosettaNet\SDK\Message Inspector Pipeline Component\obj\debug, seleccione MessageInspector.snk y, a continuación, haga clic en Aceptar.
En Visual Studio Pipeline Designer, seleccione la forma BTARN Message Inspector Component (Componente del inspector de mensajes de BTARN).
En Visual Studio ventana Propiedades, en el cuadro Directorio, escriba el nombre del directorio al que desea quitar los archivos XML.
En el Explorador de soluciones, haga clic con el botón secundario en el nombre del proyecto y, a continuación, haga clic en Versión de compilación. Compruebe que la compilación se realiza correctamente.
En el Explorador de soluciones, haga clic con el botón secundario en el nombre del proyecto y, a continuación, haga clic en Implementar. Compruebe que la implementación se realiza correctamente.
En Visual Studio, en el menú Ver , haga clic en Explorador de BizTalk.
Haga clic con el botón secundario en Puertos de envíoy seleccione Agregar puerto de envío.
En el cuadro de diálogo Crear nuevo puerto de envío , haga clic en Aceptar.
En el cuadro de diálogo Propiedades de puerto de envío , en el cuadro Nombre , escriba un nombre para el puerto de envío; con Principal seleccionado en el panel izquierdo, haga clic en Tipo de transporte en el panel derecho, y seleccione Archivo.
En el cuadro de diálogo Propiedades de puerto de envío , en el cuadro Dirección (URI) , haga clic en el botón de puntos suspensivos (...).
En el cuadro de diálogo Propiedades de transporte de archivo , escriba el nombre de la carpeta de destino , haga clic en Enviar en el panel izquierdo y, a continuación, para la Canalización de envío en el panel derecho, seleccione la canalización personalizada que acaba de crear.
Haga clic en Filtros & Mapas en el panel izquierdo y, a continuación, haga clic en Filtros.
Escriba una expresión de filtro en el panel derecho, que designe el tipo de archivos para los que la canalización debe colocar archivos XML. Por ejemplo, si desea colocar archivos para todos los mensajes de RNIF v1.1, para Propiedad seleccione Microsoft.Solutions.BTARN.Schemas.RNIFv11.GlobalBusinessAction y, para Operador , seleccione "Existe" y, a continuación, haga clic en Aceptar.
En el Explorador de BizTalk, haga clic en el puerto de envío que acaba de crear, haga clic en Dar de alta, haga clic con el botón derecho en el puerto de envío de nuevo y, a continuación, haga clic en Iniciar.
Comentarios
En el procesamiento normal, solo puede examinar una de las partes del mensaje cada vez (la parte que ha designado como el cuerpo del mensaje en la orquestación). Por lo tanto, solo puede examinar una de las partes en la consola de administración de BizTalk y su capacidad para solucionar problemas es limitada. El componente de canalización del inspector de mensajes le ayuda a superar esta limitación.