消息检查器管道组件

使用此管道组件,你可以检查由多个部分组成的消息的所有部分和消息上下文,以便确定消息是否存在问题。 你可以用此组件来排除故障。

该管道组件将 XML 文件放入你指定的目录中。 这些文件中的每一个都包含 RNIFv2.0 消息的四个部分(前导头、传递头、服务头和服务内容)中的一个或 RNIFv1.1 消息的三个部分(前导头、服务头和服务内容)中的一个。 另一个 XML 文件中包含消息上下文。

你可以将此组件构建到自定义管道中,然后将其附加到发送端口。 你可以在发送端口中创建一个筛选器,用于订阅要监视的消息。 除了 Microsoft® BizTalk Accelerator for RosettaNet (BTARN) 已执行的标准处理之外,还会进行此故障排除。

使用消息检查器管道组件构建自定义管道

若要使用消息检查器管道组件,你必须构建并部署一个包含该组件的自定义管道。 有关详细信息,请参阅BizTalk Server帮助中的“使用管道Designer创建管道”。

部署消息检查器管道组件

  1. 启动 Visual Studio。

  2. 在“ 文件 ”菜单上,指向“ 打开”,然后单击“ 项目”。

  3. 移动到 C:\Program Files (x86) \Microsoft BizTalk <version> Accelerator for RosettaNet\SDK\Message Inspector Pipeline Component,选择 MessageInspector.csproj,然后单击“ 打开”。

  4. 打开 Visual Studio 命令提示符。

  5. 在命令提示符下,移动到 C:\Program Files (x86) \Microsoft BizTalk <version> Accelerator for RosettaNet\SDK\Message Inspector Pipeline Component\obj\debug。

  6. 在命令提示符下,键入 “sn -k MessageInspector.snk” 以创建键,然后按 Enter。

  7. 在 Visual Studio 解决方案资源管理器中,右键单击“MessageInspector”,然后单击“属性”。

  8. “MessageInspector 属性 ”页中,单击“ 签名 ”选项卡,然后单击“ 对程序集进行签名 ”复选框。

  9. “选择强名称密钥文件 ”下拉列表中,浏览到 C:\Program Files (x86) \Microsoft BizTalk <version> Accelerator for RosettaNet\SDK\Message Inspector Pipeline Component\obj\debug,然后选择 “MessageInspector.snk ”,然后单击“ 打开”。

  10. 在“解决方案资源管理器”中,右键单击“ MessageInspector”,然后单击“ 生成”。 在输出窗格中检验该生成操作是否成功。

  11. 单击“ 开始”,指向 “所有程序”,指向“ 附件”,然后单击“ Windows 资源管理器”。

  12. 在 Windows 资源管理器中,移动到 C:\Program Files (x86) \Microsoft BizTalk <version> Accelerator for RosettaNet\SDK\Message Inspector Pipeline Component\obj\debug,右键单击 “Microsoft.Solutions.BTARN.SDK.MessageInspector.dll”,然后单击“ 复制”。

  13. 移动到 C:\Program Files (x86) \Microsoft BizTalk <version> Accelerator for RosettaNet\Pipeline Components,右键单击“ 管道组件”,然后单击“ 粘贴”。

  14. 在 Visual Studio 的“ 文件 ”菜单上,指向“ 新建”,然后单击“ 项目”。

  15. 在“新建项目”对话框的“模板”窗格中,选择“空BizTalk Server项目”,在“名称”框中键入项目的名称。 在“ 位置 ”框中,移动到要在其中保存项目的文件夹,然后单击“ 确定”。

  16. 在解决方案资源管理器中,右键单击项目名称,指向“添加”,然后单击“添加新项”。

  17. “添加新项 ”对话框中,选择“ 发送管道”,在“ 名称 ”框中键入自定义管道文件的名称,然后单击“ 打开”。

    注意

    请只将消息检查器管道组件添加到发送端口,而不要添加到接收端口。

  18. 在“工具箱”窗格的“BizTalk 管道组件”窗格中右键单击,然后单击“ 添加/删除项”。

  19. 在“ 自定义工具箱 ”对话框中的“ BizTalk 管道组件 ”选项卡上,选择“ BTARN 消息检查器组件”,然后单击“ 确定”。

  20. 在“工具箱”窗格的“BizTalk 管道组件”窗格中,单击并按住 “BTARN 消息检查器组件”,然后将该组件拖到“ 拖放到此处! ”框。

  21. 在 Visual Studio 解决方案资源管理器 中,右键单击管道项目的名称,然后单击“属性”。

  22. 在“ 属性页 ”对话框中,单击“ 通用属性”,然后单击“ 程序集”。

  23. 在右窗格中,在与 程序集密钥文件关联的文本框中,单击省略号,移动到 C:\Program Files (x86) \Microsoft BizTalk <version> Accelerator for RosettaNet\SDK\Message Inspector Pipeline Component\obj\debug,选择“ MessageInspector.snk”,然后单击“ 确定”。

  24. 在 Visual Studio 管道Designer中,选择 BTARN 消息检查器组件形状。

  25. 在 Visual Studio 属性窗口的“目录”框中,键入要将 XML 文件拖放到的目录的名称。

  26. 在“解决方案资源管理器”中,右键单击项目名称,然后单击“生成”。 检验该生成操作是否成功。

  27. 在“解决方案资源管理器”中,右键单击项目名称,然后单击“部署”。 检验该部署操作是否成功。

  28. 在 Visual Studio 的“ 视图 ”菜单上,单击“ BizTalk 资源管理器”。

  29. 右键单击“ 发送端口”,然后单击“ 添加发送端口”。

  30. “新建发送端口 ”对话框中,单击“ 确定”。

  31. 在“ 发送端口属性 ”对话框的“ 名称 ”框中,键入发送端口的名称,并在左窗格中选择“ 主要 ”,单击右窗格中的“ 传输类型 ”,然后选择“ 文件”。

  32. 在“ 发送端口属性 ”对话框中 的“地址 (URI) ”框中,单击省略号按钮 (...) 。

  33. 在“ 文件传输属性 ”对话框中,键入 “目标 ”文件夹名称,在左窗格中单击“ 发送 ”,然后在右窗格中为“ 发送管道 ”选择刚刚创建的自定义管道。

  34. 在左窗格中 单击“筛选器 & 映射 ”,然后单击“ 筛选器”。

  35. 在右窗格中输入筛选器表达式,指定希望该管道为哪种类型的文件放置 XML 文件。 例如,如果要删除所有 RNIF v1.1 消息的文件,对于 “属性” ,请选择“Microsoft.Solutions.BTARN.Schemas.RNIFv11.GlobalBusinessAction”,对于 “运算符 ”,请选择“存在”,然后单击“ 确定”。

  36. 在 BizTalk 资源管理器中,右键单击刚创建的发送端口,单击“ 登记”,再次右键单击发送端口,然后单击“ 启动”。

注解

在常规的处理操作中,你一次只能检查消息的一部分,即已在业务流程中指定为消息正文的部分。 因此,你只能在 BizTalk 管理控制台中检查消息的各个部分中的一个,这样,排除故障的能力就受到限制。 消息检查器管道组件可以帮助你突破此限制。

另请参阅

实用程序