Beispielklasse zum Extrahieren von Fehlern
Der Microsoft BizTalk Accelerator for SWIFT-Disassembler (A4SWIFT) serialisiert Fehler an ein XML-Objekt und fügt das XML-Objekt an den Fehlerabschnitt einer mehrteiligen Nachricht an. Der Disassembler veröffentlicht dann die fehlerhafte Nachricht in der MessageBox-Datenbank, genau wie eine gültige Nachricht. Daher enthalten fehlerhafte Nachrichten Fehlerdetails in die MessageBox-Datenbank. Sie können die Error Extractor Sample Class verwenden, um die Fehlerdetails aus einer fehlerhaften Meldung zu extrahieren und eine Datei mit den Fehlerdetails und eine andere Datei mit der ursprünglichen Meldung zu generieren.
Wichtig
Die Error Extractor Sample Class ist Beispielcode im SDK. Es ist nicht für den Einsatz in der Produktion vorgesehen.
Um die Error Extractor Sample Class zu verwenden, müssen Sie eine Orchestrierung erstellen, um die fehlerhafte Meldung zu verarbeiten. Diese Orchestrierung umfasst Schritte zum Extrahieren des Textkörpers der fehlerhaften Nachricht, zum Extrahieren des Fehlerteils der fehlerhaften Nachricht und zum Anschließenden Schreiben des Textkörpers und des Fehlerteils in separate XML-Dateien. Die Orchestrierung stellt jeden dieser Schritte in einer Ausdrucksphase dar, die eine oder mehrere der folgenden Methoden in der Error Extractor Sample Class aufruft:
GetBodyPartAsString-Methode
Diese Methode gibt eine Zeichenfolge zurück, die den XML-Code enthält, der im Textteil der XLANG-Nachricht "xm" gefunden wurde. Die -Methode erwartet, dass die XLANG-Nachricht "xm" einen Textteil namens "BodySegment" enthält. Daher müssen Sie "xm" in der aufrufenden Orchestrierung mit diesem Textteilnamen deklarieren. Wenn "BodySegment" nicht als Teil von "xm" vorhanden ist, löst GetBodyPartAsString eine Ausnahme aus.
SWIFTErrorExtractor.ErrorExtractor.GetBodyPartAsString(XLANGMessage xm);
GetErrorPartAsString-Methode
Diese Methode gibt eine Zeichenfolge zurück, die den XML-Code enthält, der im Fehlerteil der XLANG-Meldung "xm" gefunden wurde. Die -Methode erwartet, dass die XLANG-Meldung "xm" einen Fehlerteil namens "ErrorSegment" enthält. Daher müssen Sie "xm" in der aufrufenden Orchestrierung mit diesem Fehlerteilnamen deklarieren. Wenn "ErrorSegment" nicht als Teil von "xm" vorhanden ist, löst GetErrorPartAsString eine Ausnahme aus.
SWIFTErrorExtractor.ErrorExtractor.GetErrorPartAsString(XLANGMessage xm);
WriteToFile-Methode
Diese Methode schreibt die Zeichenfolge aus dem message-Parameter in die datei, die durch den filePath-Parameter angegeben wird.
SWIFTErrorExtractor.ErrorExtractor.WriteToFile(string filePath, string message);
A4SWIFT Setup installiert die Error Extractor Sample Class (SWIFTErrorExtractor.dll) als Teil des A4SWIFT SDK in <Laufwerk>:\Programme\Microsoft BizTalk Accelerator for SWIFT\SDK\Tutorial\SWIFTErrorExtractor. Dieser Ordner enthält auch den Quellcode für die Beispielklasse (ErrorExtractor.cs).
Um SWIFTErrorExtractor.dll aus der Orchestrierung aufzurufen, müssen Sie die .dll-Datei im globalen Assemblycache veröffentlichen.