Depurar canalizaciones personalizadas

Artículo
07/21/2023

Cuando se produce un error de procesamiento de mensaje en la canalización personalizada, puede usar la depuración del nivel de origen para identificar y corregir problemas. La depuración de nivel de origen se realiza mediante el depurador de Visual Studio mediante la asociación a BTSNTSVC.exe (si se implementa la canalización personalizada) o Pipeline.exe (si se usa la herramienta de canalización independiente).

Procedimientos

Use los procedimientos siguientes para depurar las canalizaciones personalizadas.

Cómo depurar una canalización implementada

Las consultas de seguimiento de la página Concentrador de grupo y los visualizadores de eventos proporcionan información útil acerca de los errores de procesamiento de mensajes que se han producido en los componentes implementados. Esta información puede usarse con frecuencia para encontrar el origen de un problema. Una vez que una canalización personalizada se ha implicado, la depuración de nivel de origen se puede usar para identificar cualquier código problemático.

Para depurar una canalización personalizada implementada mediante Visual Studio

Cargue la solución de proyecto de canalización personalizada en Visual Studio.
Cambie la ruta de acceso de salida de la solución a <Carpeta> de instalación\Componentes de canalización. En Explorador de soluciones, haga clic con el botón derecho en el proyecto, haga clic en la pestaña Compilar y, a continuación, cambie la ruta de acceso de salida haciendo clic en el botón Examinar y seleccionando el <directorio Carpeta> de instalación\Componentes de canalización.
Desde Visual Studio, implemente la solución haciendo clic en Compilar | implementación.
Reinicie la instancia de host que ejecuta la canalización. Con la consola de administración de BizTalk Server, vaya a la instancia de host que ejecuta la canalización, haga clic con el botón derecho en la instancia de host y, a continuación, haga clic en Reiniciar.
Adjunte el depurador de Visual Studio a BTSNTSVC.exe. Para ello, haga clic en Depurar | asociar al proceso, haga clic en Mostrar procesos en todas las sesiones y, a continuación, haga doble clic en BTSNTSVC.exe.
Establecer puntos de interrupción.
Deposite un mensaje en la ubicación adecuada para iniciar el componente de canalización personalizada. El procesamiento debería detenerse en los puntos de interrupción establecidos.

Nota

Si el código inicia una excepción, BizTalk Server la detectará y, en última instancia, suspenderá el mensaje. Para evitar este comportamiento, debería interrumpir en las excepciones de primera probabilidad.

Cómo depurar mediante Pipeline.exe

También puede probar canalizaciones personalizadas mediante Pipeline.exe. Esto tiene la ventaja de no requerir que implemente la canalización a costa de no ejecutarse en condiciones similares a la producción.

Nota

Si la canalización personalizada usa el ensamblador/desensamblador de archivo sin formato, Pipeline.exe no se ejecutará correctamente. Esto se debe a que Pipeline.exe no tiene acceso a la base de datos de BizTalk. Una solución consiste en quitar los componentes de ensamblador o desensamblador y probarlos por separado con FFDasm.exe y FFAsm.exe. Consulte Herramientas de canalización para obtener más información.

Para depurar una canalización personalizada mediante Pipeline.exe y Visual Studio

Cargue la solución de proyecto de canalización personalizada en Visual Studio.
Cambie la ruta de acceso de salida de la solución a <Carpeta> de instalación\Componentes de canalización. En Explorador de soluciones, haga clic con el botón derecho en el proyecto, haga clic en la pestaña Compilar y, a continuación, cambie la ruta de acceso de salida haciendo clic en el botón Examinar y seleccionando el <directorio Carpeta> de instalación\Componentes de canalización.
Cambie la acción de inicio de la solución. En Explorador de soluciones, haga clic con el botón derecho en el proyecto, haga clic en la pestaña Depurar, haga clic en Iniciar programa externo y, a continuación, haga clic en ... y vaya a <Carpeta> de instalación\SDK\Utilities\PipelineTools y elija Pipeline.exe. En Opciones de inicio, escriba los argumentos de la línea de comandos adecuados para el componente. Para obtener más información sobre Pipeline.exe, consulte Herramientas de canalización. Una configuración típica especifica la canalización y un archivo de ejemplo:
```
<Path>\YourPipeline.btp -d <Path>\YourTestFile.txt -c  
```
Establezca los puntos de interrupción.
Presione F5 para comenzar la depuración.

Consulte también

Herramientas de canalización

Compartir a través de