錯誤擷取程式範例類別

Microsoft BizTalk Accelerator for SWIFT (A4SWIFT) 反組譯程式會將錯誤序列化為 XML 物件，並將 XML 物件附加至多部分訊息的錯誤區段。 反組譯程式接著會將失敗的訊息發佈至 MessageBox 資料庫，就像是有效的訊息一樣。 因此，失敗的訊息會將錯誤詳細資料帶入 MessageBox 資料庫。 您可以使用錯誤擷取器範例類別，從失敗的訊息中擷取錯誤詳細資料，並產生一個檔案，其中包含錯誤詳細資料和另一個具有原始訊息的檔案。

重要

錯誤擷取器範例類別是 SDK 中的範例程式碼。 它不適用於生產環境。

若要使用錯誤擷取器範例類別，您必須建立協調流程來處理失敗的訊息。 此協調流程包含擷取失敗訊息本文、擷取失敗訊息的錯誤部分，然後將本文和錯誤部分寫入個別 XML 檔案的步驟。 協調流程代表運算式階段中的每個步驟，該階段會在錯誤擷取器範例類別中呼叫下列一或多個方法：

GetBodyPartAsString 方法

這個方法會傳回字串，其中包含 XLANG 訊息 'xm' 主體部分中找到的 XML。 方法預期 XLANG 訊息 'xm' 包含名為 「BodySegment」 的本文部分。因此，您必須在此主體元件名稱的呼叫協調流程中宣告 'xm'。 如果 「BodySegment」 不存在為 'xm' 的一部分， GetBodyPartAsString 會擲回例外狀況。

SWIFTErrorExtractor.ErrorExtractor.GetBodyPartAsString(XLANGMessage xm);  

GetErrorPartAsString 方法

這個方法會傳回字串，其中包含 XLANG 訊息 'xm' 錯誤部分中找到的 XML。 方法預期 XLANG 訊息 'xm' 包含名為 「ErrorSegment」 的錯誤部分。因此，您必須在呼叫協調流程中宣告 'xm'，並具有此錯誤部分名稱。 如果 「ErrorSegment」 不存在為 'xm' 的一部分， GetErrorPartAsString 會擲回例外狀況。

SWIFTErrorExtractor.ErrorExtractor.GetErrorPartAsString(XLANGMessage xm);  

WriteToFile 方法

這個方法會將 訊息 參數中的字串寫入 filePath 參數所指定的檔案。

SWIFTErrorExtractor.ErrorExtractor.WriteToFile(string filePath, string message);  

A4SWIFT安裝程式會將錯誤擷取器範例類別 (SWIFTErrorExtractor.dll) 安裝為磁片磁碟機> ：\Program Files\Microsoft BizTalk Accelerator for SWIFT\SDK\Tutorial\SWIFTErrorExtractor 中A4SWIFT SDK 的 < 一部分。 此資料夾也包含範例類別的原始程式碼， (ErrorExtractor.cs) 。

若要從協調流程呼叫 SWIFTErrorExtractor.dll，您必須將 .dll 檔案發佈至全域組件快取。

另請參閱

工具