Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Lorsque le traitement des messages échoue dans votre pipeline personnalisé, vous pouvez utiliser le débogage au niveau source pour identifier et corriger les problèmes. Le débogage au niveau source est effectué à l’aide du débogueur Visual Studio en se connectant à BTSNTSVC.exe (si le pipeline personnalisé est déployé) ou Pipeline.exe (si vous utilisez l’outil de pipeline autonome).
Procédures
Utilisez les procédures suivantes pour déboguer des pipelines personnalisés.
Guide pratique pour déboguer un pipeline déployé
Le suivi des requêtes à partir de la page Hub de groupe et des observateurs d’événements fournit des informations utiles sur les échecs de traitement des messages dans les composants déployés. Ces informations peuvent souvent être utilisées pour limiter l’origine d’un problème. Une fois qu’un pipeline personnalisé a été impliqué, le débogage au niveau source peut être utilisé pour identifier tout code problématique.
Pour déboguer un pipeline personnalisé déployé à l’aide de Visual Studio
Chargez la solution de projet de pipeline personnalisée dans Visual Studio.
Remplacez le chemin de sortie de votre solution par <Dossier> d’installation\Composants de pipeline. Dans l’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 hôte qui exécute le pipeline. À l’aide de la console d’administration BizTalk Server, accédez à l’instance hôte qui exécute le pipeline, cliquez avec le bouton droit sur l’instance hôte, 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éfinissez des points d’arrêt.
Déposez un message dans l'emplacement approprié pour lancer le composant de pipeline personnalisé. Le traitement doit s’arrêter sur les points d’arrêt que vous avez définis.
Remarque
Si votre code lève une exception, BizTalk Server l’intercepte et suspend finalement le message. Pour éviter ce comportement, vous devez interrompre les exceptions de première chance.
Guide pratique pour déboguer à 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 exiger que vous déployiez le pipeline, mais au détriment de ne pas fonctionner dans un environnement proche de la production.
Remarque
Si votre pipeline personnalisé utilise l’assembleur/désassembleur de fichiers plats, Pipeline.exe ne s’exécute pas correctement. Cela est dû au fait que Pipeline.exe n’accède pas à 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 Les 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ée dans Visual Studio.
Remplacez le chemin de sortie de votre solution par <Dossier> d’installation\Composants de pipeline. Dans l’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 de votre solution. Dans l’Explorateur de solutions, cliquez avec le bouton droit sur votre projet, cliquez sur l’onglet Débogage, cliquez sur Démarrer le programme externe, puis cliquez sur ... et accédez au <dossier> d’installation\SDK\Utilities\PipelineTools and choose 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. Une configuration classique 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.