错误提取程序示例类

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 方法

此方法将 message 参数中的字符串写入 filePath 参数指定的文件。

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

A4SWIFT安装程序将错误提取程序示例类 (SWIFTErrorExtractor.dll) 作为A4SWIFT SDK 的一部分安装在 drive>:\Program Files\Microsoft BizTalk Accelerator for SWIFT\SDK\Tutorial\SWIFTErrorExtractor 中<。 此文件夹还包括示例类的源代码 (ErrorExtractor.cs) 。

若要从业务流程调用 SWIFTErrorExtractor.dll,必须将 .dll 文件发布到全局程序集缓存。

另请参阅

工具