Debuggen benutzerdefinierter Pipelines

Artikel
07/21/2023

Wenn die Nachrichtenverarbeitung in Ihrer benutzerdefinierten Pipeline fehlschlägt, können Sie die Probleme durch Debuggen auf Quellcodeebene ermitteln und beheben. Das Debuggen auf Quellebene erfolgt mithilfe des Visual Studio-Debuggers, indem an BTSNTSVC.exe (wenn die benutzerdefinierte Pipeline bereitgestellt wird) oder Pipeline.exe (bei Verwendung des eigenständigen Pipelinetools) angefügt wird.

Prozeduren

Verwenden Sie die folgenden Verfahren zum Debuggen benutzerdefinierter Pipelines.

Debuggen einer bereitgestellten Pipeline

Die Überwachung von Abfragen von der Seite Gruppenhub und der Ereignisanzeigen bietet nützliche Informationen zu Fehlern bei der Nachrichtenverarbeitung in bereitgestellten Komponenten. Diese Informationen können häufig zum Eingrenzen der Ursache eines Problems verwendet werden. Wenn eine benutzerdefinierte Pipeline eingebunden wurde, kann problematischer Code durch Debuggen auf Quellcodeebene identifiziert werden.

So debuggen Sie eine bereitgestellte benutzerdefinierte Pipeline mit Visual Studio

Laden Sie die projektmappe für die benutzerdefinierte Pipeline in Visual Studio.
Ändern Sie den Ausgabepfad für Ihre Projektmappe in <Installationsordner>\Pipelinekomponenten. Klicken Sie in Projektmappen-Explorer mit der rechten Maustaste auf Ihr Projekt, klicken Sie auf die Registerkarte Erstellen, und ändern Sie dann den Ausgabepfad, indem Sie auf die Schaltfläche Durchsuchen klicken und das <Verzeichnis Installationsordner>\Pipelinekomponenten auswählen.
Stellen Sie in Visual Studio die Projektmappe bereit, indem Sie auf Bereitstellen erstellen | klicken.
Starten Sie die Hostinstanz neu, auf der die Pipeline ausgeführt wird. Navigieren Sie in der BizTalk Server Verwaltungskonsole zu dem Host instance, der die Pipeline ausführt, klicken Sie mit der rechten Maustaste auf den Host instance klicken Sie dann auf Neu starten.
Fügen Sie den Visual Studio-Debugger an BTSNTSVC.exe an. Klicken Sie dazu auf Debuggen | An Prozess anfügen, klicken Sie auf Prozesse in allen Sitzungen anzeigen, und doppelklicken Sie dann auf BTSNTSVC.exe.
Legt Haltepunkte fest.
Legen Sie eine Nachricht am entsprechenden Speicherort ab, um die benutzerdefinierte Pipelinekomponente zu initiieren. Die Verarbeitung sollte an den von Ihnen festgelegten Haltepunkten anhalten.

Hinweis

Wenn Ihr Code eine Ausnahme ausgibt, wird dies von BizTalk Server festgestellt und die Nachricht anschließend angehalten. Um dieses Verhalten zu vermeiden, sollten Sie bei "Erste Chance"-Ausnahmen anhalten.

Debuggen mithilfe von 'Pipeline.exe'

Sie können auch benutzerdefinierte Pipelines mit Pipeline.exe testen. Dies hat den Vorteil, dass Sie die Pipeline nicht auf Kosten der Nichtausführung unter ähnlichen Produktionsbedingungen bereitstellen müssen.

Hinweis

Pipeline.exe wird nicht ordnungsgemäß ausgeführt, wenn von Ihrer benutzerdefinierten Pipline der Flatfile-Assembler/Disassembler verwendet wird. Der Grund hierfür ist, dass Pipeline.exe nicht auf die BizTalk-Datenbank zugreift. Eine Lösung besteht darin, die Assembler-/Disassemblerkomponenten zu entfernen und separat mit FFDasm.exe und FFAsm.exe zu testen. Weitere Informationen finden Sie unter Pipelinetools .

So debuggen Sie eine benutzerdefinierte Pipeline mit „Pipeline.exe“ und Visual Studio

Laden Sie die projektmappe für die benutzerdefinierte Pipeline in Visual Studio.
Ändern Sie den Ausgabepfad für Ihre Projektmappe in <Installationsordner>\Pipelinekomponenten. Klicken Sie in Projektmappen-Explorer mit der rechten Maustaste auf Ihr Projekt, klicken Sie auf die Registerkarte Erstellen, und ändern Sie dann den Ausgabepfad, indem Sie auf die Schaltfläche Durchsuchen klicken und das <Verzeichnis Installationsordner>\Pipelinekomponenten auswählen.
Ändern Sie die Startaktion für Ihre Lösung. Klicken Sie in Projektmappen-Explorer mit der rechten Maustaste auf Ihr Projekt, klicken Sie auf die Registerkarte Debuggen, klicken Sie auf Externes Programm starten, klicken Sie dann auf ... und navigieren Sie zu <Installationsordner>\SDK\Utilities\PipelineTools, und wählen Sie Pipeline.exe aus. Geben Sie unter Startoptionen die für Ihre Komponente geeigneten Befehlszeilenargumente ein. Weitere Informationen zu Pipeline.exe finden Sie unter Pipelinetools. In der Konfiguration werden normalerweise die Pipeline und eine Beispieldatei festgelegt:
```
<Path>\YourPipeline.btp -d <Path>\YourTestFile.txt -c  
```
Legen Sie die Haltepunkte fest.
Drücken Sie F5, um mit das Debuggen zu starten.

Weitere Informationen

Pipelinetools

Freigeben über