Debug di pipeline personalizzate
Quando l'elaborazione dei messaggi ha esito negativo nell'ambito della pipeline personalizzata è possibile utilizzare il debug a livello di codice per individuare e correggere i problemi. Il debug a livello di origine viene eseguito usando il debugger di Visual Studio associandolo a BTSNTSVC.exe (se la pipeline personalizzata viene distribuita) o Pipeline.exe (se si usa lo strumento di pipeline autonomo).
Procedure
Per eseguire il debug delle pipeline personalizzate, utilizzare le procedure seguenti.
Come eseguire il debug di pipeline distribuite [BTS05]
Nelle query di rilevamento della pagina Hub gruppo e nei visualizzatori evento sono disponibili informazioni utili sugli errori di elaborazione dei messaggi nei componenti distribuiti. È spesso possibile utilizzare tali informazioni per individuare l'origine di un problema. Una volta implicata una pipeline personalizzata, il debug a livello di codice può essere utilizzato per individuare eventuale codice problematico.
Per eseguire il debug di pipeline distribuite tramite Visual Studio
Caricare la soluzione di progetto della pipeline personalizzata in Visual Studio.
Modificare il percorso di output per la soluzione in <Cartella> di installazione\Componenti della pipeline. In Esplora soluzioni fare clic con il pulsante destro del mouse sul progetto, fare clic sulla scheda Compilazione e quindi modificare il percorso di output facendo clic sul pulsante Sfoglia e selezionando la <directory Cartella> di installazione\Componenti della pipeline.
Da Visual Studio distribuire la soluzione facendo clic su Compila | distribuzione.
Riavviare l'istanza host che esegue la pipeline. Usando la console di gestione BizTalk Server, passare all'istanza host che esegue la pipeline, fare clic con il pulsante destro del mouse sull'istanza host e quindi scegliere Riavvia.
Collegare il debugger di Visual Studio a BTSNTSVC.exe. Questa operazione può essere eseguita facendo clic su Debug | Collegamento a processo, fare clic su Mostra processi in tutte le sessioni e quindi fare doppio clic su BTSNTSVC.exe.
Consente di impostare punti di interruzione.
Inserire un messaggio nel percorso appropriato per avviare il componente pipeline personalizzato. L'elaborazione deve interrompersi in base ai punti di interruzione impostati.
Nota
Se il codice genera un'eccezione, quest'ultima verrà rilevata da BizTalk Server che sospenderà il messaggio. Per evitare ciò, è necessario interrompere le eccezioni first-chance.
Come eseguire il debug tramite il file Pipeline.exe
È anche possibile testare pipeline personalizzate usando Pipeline.exe. Ciò offre il vantaggio di non richiedere la distribuzione della pipeline a spese dell'esecuzione in condizioni simili alla produzione.
Nota
Se la pipeline personalizzata utilizza l'assembler/disassembler del file flat, il file Pipeline.exe non verrà eseguito correttamente. Ciò in quanto il file Pipeline.exe non ha accesso al database BizTalk. Una soluzione consiste nel rimuovere i componenti assembler/disassembler e testarli separatamente con FFDasm.exe e FFAsm.exe. Per altre informazioni, vedere Strumenti di pipeline .
Per eseguire il debug di pipeline distribuite tramite Pipeline.exe e Visual Studio
Caricare la soluzione di progetto della pipeline personalizzata in Visual Studio.
Modificare il percorso di output per la soluzione in <Cartella> di installazione\Componenti della pipeline. In Esplora soluzioni fare clic con il pulsante destro del mouse sul progetto, fare clic sulla scheda Compilazione e quindi modificare il percorso di output facendo clic sul pulsante Sfoglia e selezionando la <directory Cartella> di installazione\Componenti della pipeline.
Modificare l'azione di avvio della soluzione. In Esplora soluzioni fare clic con il pulsante destro del mouse sul progetto, fare clic sulla scheda Debug, scegliere Avvia programma esterno, quindi fare clic su ... e passare a <Cartella> di installazione\SDK\Utilities\PipelineTools e scegliere Pipeline.exe. In Opzioni start immettere gli argomenti della riga di comando appropriati per il componente. Per altre informazioni su Pipeline.exe, vedere Strumenti di pipeline. Una configurazione tipica specifica la pipeline e un file di esempio.
<Path>\YourPipeline.btp -d <Path>\YourTestFile.txt -cImpostare punti di interruzione personalizzati.
Premere F5 per avviare il debug.