Componente de canalización del editor de mensajes
Este componente permite editar automáticamente cualquier parte de un mensaje de varias partes dentro de una canalización de envío o recepción. Este componente se agrega a una canalización existente para configurar el reemplazo como parte del procesamiento normal.
Crear el componente de canalización del editor de mensajes en una canalización existente
Para usar el componente de canalización del editor de mensajes, debe agregar el componente a una canalización existente. Para obtener más información, consulte "Creación de canalizaciones con Designer de canalización" en BizTalk Server Ayuda.
Para agregar el componente de canalización del editor de mensajes en una canalización existente
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 Editor de mensajes, seleccione MessageEditor.csproj y, a continuación, haga clic en Abrir.
Inicie 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 Editor Pipeline Component\obj\debug.
En el símbolo del sistema, escriba sn -k MessageEditor.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 MessageEditor y, a continuación, haga clic en Propiedades.
En la página Propiedad de MessageEditor , haga clic en la ficha Firma y, a continuación, haga clic en la casilla Firmar el ensamblado .
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 Editor Pipeline Component\obj\debug y seleccione MessageEditor.snk y, a continuación, haga clic en Abrir.
En el Explorador de soluciones, haga clic con el botón derecho en MessageEditory, a continuación, haga clic en Compilar. 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\Microsoft BizTalk 2013 Accelerator for RosettaNet\SDK\Message Editor Pipeline Component\obj\debug, haga clic con el botón derecho enMicrosoft.Solutions.BTARN.SDK.MessageEditor.dlly, a continuación, haga clic en Copiar.
Vaya a C:\Program Files\Microsoft BizTalk Server 2013\Pipeline Components, haga clic con el botón derecho en Componentes de canalizacióny haga clic en Pegar.
En Visual Studio, en el menú Archivo , seleccione Abrir y, a continuación, haga clic en Proyecto.
Abra el proyecto que contiene la canalización a la que desea agregar el editor.
En el Explorador de soluciones, haga doble clic en el nombre de la canalización para abrir la canalización en el Diseñador de canalizaciones.
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 de la pestaña Componentes de canalización de BizTalk , seleccione Componente del editor de mensajes de BTARNy haga clic en Aceptar.
En el panel de componentes de canalización de BizTalk del panel Cuadro de herramientas, mantenga presionado Componente del editor de mensajes de BTARNy arrastre el componente a la posición que desee en la canalización.
En el panel de componentes de canalización de BizTalk del panel Cuadro de herramientas, mantenga presionado Componente del editor de mensajes de BTARNy arrastre el componente a la posición que desee en la canalización.
Nota
Se recomienda agregar el componente de canalización del editor de mensajes después de la fase de desensamblado del componente de canalización de recepción o en la fase de preensamblado del componente de canalización de envío.
En Visual Studio, en Canalización Designer, seleccione la forma Componente del Editor de mensajes BTARN.
En el panel de propiedades, en el cuadro de texto asociado a Consulta XPath, escriba el nombre del elemento XPath para el que desea cambiar el valor.
En el cuadro de texto asociado a Valor XPath, escriba el valor en el que desea establecer el elemento XPath.
En el Explorador de soluciones, haga clic con el botón derecho en el nombre del proyecto y, a continuación, haga clic en Compilar. Compruebe que la compilación se realiza correctamente.
En el Explorador de soluciones, haga clic con el botón derecho en el nombre del proyecto y, a continuación, haga clic en Implementar. Compruebe que la implementación se realiza correctamente.
Ejemplo
Para cambiar el valor del elemento ProprietaryDocumentIdentifier
en el esquema de PIP 0C1, agregue la consulta XPath que se muestra en la sección de código siguiente a la propiedad de la consulta XPath del componente de canalización del editor de mensajes.
/*[local-name()='Pip0C1AsynchronousTestNotification' and namespace-uri()='http://schemas.microsoft.com/biztalk/btarn/2004/0C1_MS_R01_02_AsynchronousTestNotification.dtd']/*[local-name()='thisDocumentIdentifier' and namespace-uri()='http://schemas.microsoft.com/biztalk/btarn/2004/0C1_MS_R01_02_AsynchronousTestNotification.dtd']/*[local-name()='ProprietaryDocumentIdentifier' and namespace-uri()='http://schemas.microsoft.com/biztalk/btarn/2004/0C1_MS_R01_02_AsynchronousTestNotification.dtd']
Para obtener una consulta XPath completa, abra el esquema en el Editor de BizTalk y, a continuación, copie Xpath de la propiedad Instance XPath
que aparece en la ventana Propiedades. La consulta XPath que proporcione debe incluir todas las referencias de espacio de nombres.