Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Cuando se produce un error en el procesamiento de mensajes en la canalización personalizada, puede utilizar la depuración en 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
Emplea los siguientes procedimientos para depurar canalizaciones personalizadas.
Depuración de una canalización implementada
El seguimiento de consultas desde la página centro de grupos y los visores de eventos proporciona información útil sobre los errores de procesamiento de mensajes en los componentes implementados. Esta información se puede usar a menudo para restringir el origen de un problema. Una vez que se ha implicado una canalización personalizada, se puede usar la depuración de nivel de origen 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 el 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 | implementar.
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.
Establezca puntos de interrupción.
Deje un mensaje en la ubicación adecuada para iniciar el componente personalizado de la tubería. El procesamiento debe detenerse en los puntos de interrupción establecidos.
Nota:
Si el código produce una excepción, BizTalk Server lo detectará y, en última instancia, suspenderá el mensaje. Para evitar este comportamiento, debe interrumpir las excepciones de primera oportunidad.
Cómo depurar mediante Pipeline.exe
También puede probar canalizaciones personalizadas mediante Pipeline.exe. Esto tiene la ventaja de no requerir que implementes la canalización, aunque implica no ejecutarse bajo condiciones similares a las de producción.
Nota:
Si la canalización personalizada usa el ensamblador o desensamblador de archivos planos, 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 desensamblar 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 el 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 el 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 and choose 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 Procesos. Una configuración típica especifica la canalización y un archivo de ejemplo:
<Path>\YourPipeline.btp -d <Path>\YourTestFile.txt -cEstablezca los puntos de interrupción.
Presione F5 para comenzar la depuración.