Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Wenn die Nachrichtenverarbeitung in Ihrer benutzerdefinierten Pipeline fehlschlägt, können Sie das Debuggen auf Quellebene verwenden, um Probleme zu identifizieren und zu beheben. Das Debuggen auf Quellebene erfolgt mithilfe des Visual Studio-Debuggers durch Anfügen an BTSNTSVC.exe (wenn die benutzerdefinierte Pipeline bereitgestellt wird) oder Pipeline.exe (wenn das eigenständige Pipelinetool verwendet wird).
Prozeduren
Verwenden Sie die folgenden Verfahren, um benutzerdefinierte Pipelines zu debuggen.
So debuggen Sie eine bereitgestellte Pipeline
Das Nachverfolgen von Abfragen von der Group Hub-Seite und den Ereignisanzeigen bietet nützliche Informationen zu Nachrichtenverarbeitungsfehlern in bereitgestellten Komponenten. Diese Informationen können häufig verwendet werden, um den Ursprung eines Problems einzugrenzen. Nachdem eine benutzerdefinierte Pipeline beteiligt wurde, kann das Debuggen auf Quellebene verwendet werden, um problematischen Code zu identifizieren.
So debuggen Sie eine bereitgestellte benutzerdefinierte Pipeline mit Visual Studio
Laden Sie die benutzerdefinierte Pipeline-Projektlösung in Visual Studio.
Ändern Sie den Ausgabepfad für Ihre Lösung in <"Installationsordner>\Pipelinekomponenten". Klicken Sie im 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 die Projektmappe in Visual Studio bereit, indem Sie auf Erstellen | Bereitstellen klicken.
Starten Sie die Hostinstanz neu, die die Pipeline ausführt. Navigieren Sie mithilfe der BizTalk Server-Verwaltungskonsole zu der Hostinstanz, die die Pipeline ausführt, und klicken Sie mit der rechten Maustaste auf die Hostinstanz, und klicken Sie dann auf "Neu starten".
Fügen Sie den Visual Studio-Debugger an BTSNTSVC.exean. Dazu klicken Sie auf "Debug | An Prozess anfügen", klicken Sie auf "Prozesse in allen Sitzungen anzeigen", und doppelklicken Sie dann auf BTSNTSVC.exe.
Legen Sie Haltepunkte fest.
Legen Sie eine Nachricht an dem entsprechenden Speicherort ab, um die benutzerdefinierte Pipelinekomponente zu initiieren. Die Verarbeitung sollte an den von Ihnen festgelegten Haltepunkten angehalten werden.
Hinweis
Wenn Ihr Code eine Ausnahme auslöst, wird BizTalk Server sie abfangen und die Nachricht letztendlich anhalten. Um dieses Verhalten zu vermeiden, sollten Sie bei First-Chance-Ausnahmen unterbrechen.
So debuggen Sie mithilfe von Pipeline.exe
Sie können auch benutzerdefinierte Pipelines mit Pipeline.exetesten. Dies hat den Vorteil, dass Sie die Pipeline nicht bereitstellen müssen, auch wenn sie nicht unter produktionsähnlichen Bedingungen läuft.
Hinweis
Wenn Ihre benutzerdefinierte Pipeline den Flachdateiassembler/Disassembler verwendet, wird Pipeline.exe nicht ordnungsgemäß ausgeführt. Dies liegt daran, dass Pipeline.exe nicht auf die BizTalk-Datenbank zugreift. Eine Lösung besteht darin, die Montage-/Demontagekomponenten zu entfernen und separat mit FFDasm.exe und FFAsm.exezu testen. Weitere Informationen finden Sie unter Pipelinetools .
So debuggen Sie eine benutzerdefinierte Pipeline mit Pipeline.exe und Visual Studio
Laden Sie die Projektlösung für eine benutzerdefinierte Pipeline in Visual Studio.
Ändern Sie den Ausgabepfad für Ihre Lösung in <"Installationsordner>\Pipelinekomponenten". Klicken Sie im 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 im Projektmappen-Explorer mit der rechten Maustaste auf Ihr Projekt, klicken Sie auf die Registerkarte "Debuggen", klicken Sie auf "Externes Programm starten", und klicken Sie dann auf ... und navigieren Sie zu <Installationsordner>\SDK\Utilities\PipelineTools and choose Pipeline.exe. Geben Sie unter "Startoptionen" die für die Komponente geeigneten Befehlszeilenargumente ein. Weitere Informationen zu Pipeline.exefinden Sie unter Pipelinetools. Eine typische Konfiguration gibt die Pipeline und eine Beispieldatei an:
<Path>\YourPipeline.btp -d <Path>\YourTestFile.txt -cLegen Sie Ihre Haltepunkte fest.
Drücken Sie F5, um mit dem Debuggen zu beginnen.