Debug di pipeline personalizzate

Quando l'elaborazione dei messaggi non riesce nella pipeline personalizzata, è possibile usare il debug a livello di origine per identificare e correggere i problemi. Il debug a livello di origine viene eseguito usando il debugger di Visual Studio collegando a BTSNTSVC.exe (se la pipeline personalizzata viene distribuita) o Pipeline.exe (se si usa lo strumento di pipeline autonomo).

Le procedure

Usare le procedure seguenti per eseguire il debug di pipeline personalizzate.

Come eseguire il debug di una pipeline distribuita

Tenere traccia delle query dalla pagina Hub di gruppo e i visualizzatori di eventi forniscono informazioni utili sugli errori di elaborazione dei messaggi nei componenti distribuiti. Queste informazioni possono spesso essere usate per limitare l'origine di un problema. Una volta implicata una pipeline personalizzata, è possibile usare il debug a livello di origine per identificare qualsiasi codice problematico.

Per eseguire il debug di una pipeline personalizzata distribuita con Visual Studio

1. Caricare la soluzione di progetto della pipeline personalizzata in Visual Studio.

2. Modificare il percorso di output della 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 Compila, quindi modificare il percorso di output facendo clic sul pulsante Sfoglia e selezionando la <directory Cartella> di installazione\Componenti della pipeline.

3. In Visual Studio distribuire la soluzione facendo clic su Compila | distribuisci.

4. Riavvia l'istanza host che esegue la pipeline. Usando la console di gestione di 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.

5. Collegare il debugger di Visual Studio a BTSNTSVC.exe. A tale scopo, fare clic su Debug | Collega a processo, fare clic su Mostra processi in tutte le sessioni e quindi fare doppio clic su BTSNTSVC.exe.

6. Impostare i punti di interruzione.

7. Invia un messaggio nella posizione appropriata per avviare il componente della pipeline personalizzata. L'elaborazione deve interrompersi nei punti di interruzione impostati.

Annotazioni

Se il codice genera un'eccezione, BizTalk Server lo intercetta e sospende il messaggio. Per evitare questo comportamento, è consigliabile interrompere le eccezioni di prima probabilità.

Come eseguire il debug tramite Pipeline.exe

È anche possibile testare pipeline personalizzate usando Pipeline.exe. Ciò ha il vantaggio di non richiedere la distribuzione della pipeline, ma non consente di operare in condizioni simili a quelle di produzione.

Annotazioni

Se la pipeline personalizzata utilizza l'assembler/disassembler di file piatti, Pipeline.exe non verrà eseguito correttamente. Ciò è dovuto al fatto che Pipeline.exe non accede al database BizTalk. Una soluzione consiste nel rimuovere i componenti assembler/disassembler e testarli separatamente con FFDasm.exe e FFAsm.exe. Per ulteriori informazioni, vedere Strumenti pipeline.

Per eseguire il debug di una pipeline personalizzata usando Pipeline.exe e Visual Studio

1. Caricare la soluzione di progetto della pipeline personalizzata in Visual Studio.

2. Modificare il percorso di output della 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 Compila, quindi modificare il Percorso di output facendo clic sul pulsante Sfoglia e selezionando la directory <Cartella di Installazione>\Componenti della pipeline.

3. 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 and choose Pipeline.exe. In Opzioni di avvio immettere gli argomenti della riga di comando appropriati per il componente. Per altre informazioni su Pipeline.exe, vedere Strumenti della pipeline. Una configurazione tipica specifica la pipeline e un file di esempio:

   <Path>\YourPipeline.btp -d <Path>\YourTestFile.txt -c  
   

4. Impostare i punti di interruzione.

5. Premere F5 per avviare il debug.

Vedere anche

Strumenti della pipeline