消息检查器管道组件

此管道组件允许检查多部分消息的所有部分和消息上下文,以确定消息是否存在问题。 使用此组件进行故障排除。

管道组件将 XML 文件拖放到指定的目录中。 其中每个文件都包含 RNIFv2.0 消息的四个部分之一(Preamble Header、Delivery Header、Service Header 和 Service Content)或 RNIFv1.1 消息的三个部分(Preamble Header、Service Header 和 Service Content)。 另一个 XML 文件包含消息上下文。

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

使用消息检查器管道组件生成自定义管道

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

部署消息检查器管道组件

  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 <版本> 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 <版本> 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 <版本> Accelerator for RosettaNet\SDK\Message Inspector Pipeline Component\obj\debug,选择 MessageInspector.snk,然后单击“ 确定”。

  24. 在 Visual Studio 管道设计器中,选择 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,对于 运算符 ,请选择“Exists”,然后单击 确定

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

注解

在典型的处理过程中,您只能一次检查一个消息部分(在业务流程中指定为消息正文的部分)。 因此,你只能检查 BizTalk 管理控制台中的一个部分,并且无法进行故障排除。 消息检查器管道组件可帮助你克服此限制。

另请参阅

实用工具