Débogage des pipelines personnalisés
Lorsque le traitement d'un message dans votre pipeline personnalisé échoue, utilisez les outils de débogage au niveau du code source pour identifier et corriger les problèmes. Le débogage au niveau de la source est effectué à l’aide du débogueur Visual Studio en l’attachant à BTSNTSVC.exe (si le pipeline personnalisé est déployé) ou Pipeline.exe (si vous utilisez l’outil de pipeline autonome).
Procédures
Les procédures suivantes permettent de déboguer les pipelines personnalisés.
Débogage d'un pipeline déployé
Les requêtes de suivi via la page Hub du groupe et les observateurs d'événements fournissent des informations utiles au sujet des échecs de traitement des messages dans les composants déployés. Ces informations permettent souvent de déterminer l'origine d'un problème. Dans le cas d'un pipeline personnalisé, le débogage au niveau du code source permet d'identifier les sections de code problématiques.
Pour déboguer un pipeline personnalisé déployé à l'aide de Visual Studio
Chargez la solution de projet de pipeline personnalisé dans Visual Studio.
Remplacez le chemin de sortie de votre solution par <Dossier> d’installation\Composants de pipeline. Dans Explorateur de solutions, cliquez avec le bouton droit sur votre projet, cliquez sur l’onglet Générer, puis modifiez le chemin de sortie en cliquant sur le bouton Parcourir et en sélectionnant le <répertoire Dossier> d’installation\Composants de pipeline.
À partir de Visual Studio, déployez la solution en cliquant sur Générer | déployer.
Redémarrez l'instance de l'hôte qui exécute le pipeline. À l’aide de la console de gestion BizTalk Server, accédez à l’instance hôte qui exécute le pipeline, cliquez avec le bouton droit sur l’hôte instance puis cliquez sur Redémarrer.
Attachez le débogueur Visual Studio à BTSNTSVC.exe. Pour ce faire, cliquez sur Déboguer | attacher au processus, cliquez sur Afficher les processus dans toutes les sessions, puis double-cliquez sur BTSNTSVC.exe.
Définir les points d'arrêt.
Laissez un message à l'emplacement approprié pour initier le composant de pipeline personnalisé. Le traitement doit s'arrêter aux points d'arrêt définis.
Notes
Si votre code génère une exception, BizTalk Server l'intercepte et suspend le message. Pour éviter cela, interrompez le traitement aux exceptions de première chance.
Débogage à l'aide de Pipeline.exe
Vous pouvez également tester des pipelines personnalisés à l’aide de Pipeline.exe. Cela présente l’avantage de ne pas vous obliger à déployer le pipeline au détriment de ne pas s’exécuter dans des conditions similaires à celles de la production.
Notes
Si votre pipeline personnalisé utilise l'assembleur ou le désassembleur de fichier plat, Pipeline.exe ne s'exécutera pas correctement. Cela est dû au fait que Pipeline.exe n'a pas accès à la base de données BizTalk. Une solution consiste à supprimer les composants assembleur/désassembleur et à les tester séparément avec FFDasm.exe et FFAsm.exe. Pour plus d’informations, consultez Outils de pipeline .
Pour déboguer un pipeline personnalisé à l'aide de Pipeline.exe et de Visual Studio
Chargez la solution de projet de pipeline personnalisé dans Visual Studio.
Remplacez le chemin de sortie de votre solution par <Dossier> d’installation\Composants de pipeline. Dans Explorateur de solutions, cliquez avec le bouton droit sur votre projet, cliquez sur l’onglet Générer, puis modifiez le chemin de sortie en cliquant sur le bouton Parcourir et en sélectionnant le <répertoire Dossier> d’installation\Composants de pipeline.
Modifiez l'action de démarrage pour votre solution. Dans Explorateur de solutions, cliquez avec le bouton droit sur votre projet, cliquez sur l’onglet Déboguer, cliquez sur Démarrer le programme externe, puis sur ... et accédez à <Dossier> d’installation\SDK\Utilitaires\PipelineTools et choisissez Pipeline.exe. Sous Options de démarrage, entrez les arguments de ligne de commande appropriés pour votre composant. Pour plus d’informations sur Pipeline.exe, consultez Outils de pipeline. La configuration typique spécifie le pipeline et un exemple de fichier :
<Path>\YourPipeline.btp -d <Path>\YourTestFile.txt -cDéfinissez vos points d'arrêt.
Appuyez sur F5 pour commencer le débogage.