此管道组件允许检查多部分消息的所有部分和消息上下文,以确定消息是否存在问题。 使用此组件进行故障排除。
管道组件将 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 帮助中的“使用管道设计器创建管道”。
部署消息检查器管道组件
启动 Visual Studio。
在“ 文件 ”菜单上,指向 “打开”,然后单击“ 项目”。
移动到 C:\Program Files (x86)\Microsoft BizTalk <version> Accelerator for RosettaNet\SDK\Message Inspector Pipeline Component,选择 MessageInspector.csproj,然后单击“ 打开”。
打开 Visual Studio 命令提示符。
在命令提示符下,转到 C:\Program Files (x86)\Microsoft BizTalk <版本> Accelerator for RosettaNet\SDK\Message Inspector Pipeline Component\obj\debug。
在命令提示符下,键入 “sn -k MessageInspector.snk” 以创建键,然后按 Enter。
在 Visual Studio 的解决方案资源管理器中,右键单击 MessageInspector,然后单击“ 属性”。
在 MessageInspector 属性 页中,单击“ 签名 ”选项卡,然后单击“ 为程序集签名 ”复选框。
在 “选择强名称密钥文件”下拉列表 中,浏览至 C:\Program Files (x86)\Microsoft BizTalk <version> Accelerator for RosettaNet\SDK\Message Inspector Pipeline Component\obj\debug,然后选择 MessageInspector.snk 文件,最后单击打开。
在解决方案资源管理器中,右键单击 MessageInspector,然后单击“生成”。 在“输出”窗格中验证生成是否成功。
单击“ 开始”,指向 “所有程序”,指向 “附件”,然后单击“ Windows 资源管理器”。
在 Windows 资源管理器中,导航到 C:\Program Files (x86)\Microsoft BizTalk <版本> Accelerator for RosettaNet\SDK\Message Inspector Pipeline Component\obj\debug,右键单击 Microsoft.Solutions.BTARN.SDK.MessageInspector.dll,然后单击“复制”。
移动到 C:\Program Files (x86)\Microsoft BizTalk <version> Accelerator for RosettaNet\ Pipeline Components,右键单击“管道组件”,然后单击“ 粘贴”。
在 Visual Studio 的“ 文件 ”菜单上,指向“ 新建”,然后单击“ 项目”。
在“ 新建项目 ”对话框中的“模板”窗格中,选择“ 空 BizTalk Server 项目”,在“ 名称 ”框中键入项目的名称。 在 “位置” 框中,移动到要在其中保存项目的文件夹,然后单击“ 确定”。
在解决方案资源管理器中,右键单击项目名称,指向 “添加”,然后单击“ 添加新项”。
在“ 添加新项 ”对话框中,选择“ 发送管道”,在 “名称 ”框中键入自定义管道文件的名称,然后单击“ 打开”。
注释
仅添加消息检查器管道组件以发送端口,而不是接收端口。
右键单击工具箱窗格的 BizTalk 管道组件窗格,然后单击 “添加/删除项”。
在“ 自定义工具箱 ”对话框中的 “BizTalk 管道组件 ”选项卡上,选择 BTARN 消息检查器组件,然后单击“ 确定”。
在工具箱窗格的 BizTalk 管道组件窗格中,单击并按住 BTARN 消息检查器组件,然后将组件拖到 “放置此处!” 框中。
在 Visual Studio 的解决方案资源管理器中,右键单击管道项目的名称,然后单击“ 属性”。
在“ 属性页 ”对话框中,单击“ 通用属性”,然后单击“ 程序集”。
在右窗格中,在与 程序集密钥文件关联的文本框中,单击省略号,移动到 C:\Program Files (x86)\Microsoft BizTalk <版本> Accelerator for RosettaNet\SDK\Message Inspector Pipeline Component\obj\debug,选择 MessageInspector.snk,然后单击“ 确定”。
在 Visual Studio 管道设计器中,选择 BTARN 消息检查器组件 形状。
在 Visual Studio 属性窗口中的 “目录” 框中,键入要删除 XML 文件的目录的名称。
在解决方案资源管理器中,右键单击项目名称,然后单击“ 生成”。 验证生成是否成功。
在解决方案资源管理器中,右键单击项目名称,然后单击“ 部署”。 验证部署是否成功。
在 Visual Studio 的 “视图 ”菜单上,单击 “BizTalk 资源管理器”。
右键单击 “发送端口”,然后单击“ 添加发送端口”。
在“ 新建发送端口 ”对话框中,单击“ 确定”。
在“ 发送端口属性 ”对话框中的“ 名称 ”框中,键入发送端口的名称,并在左窗格中选择 “主要 ”,单击右窗格中的“ 传输类型 ”,然后选择“ 文件”。
在 “发送端口属性 ”对话框中的 “地址”(URI) 框中,单击省略号按钮(...)。
在“ 文件传输属性 ”对话框中,键入 “目标 ”文件夹名称,在左窗格中单击“ 发送 ”,然后在右侧窗格中单击 “发送管道 ”,选择刚刚创建的自定义管道。
在左窗格中单击筛选器和映射,然后单击筛选器。
在右窗格中输入筛选器表达式,指定希望管道删除 XML 文件的文件类型。 例如,如果要删除所有 RNIF v1.1 消息的文件,对于 属性 ,可以选择Microsoft.Solutions.BTARN.Schemas.RNIFv11.GlobalBusinessAction,对于 运算符 ,请选择“Exists”,然后单击 确定。
在 BizTalk 资源管理器中,右键单击刚刚创建的发送端口,单击“登记”,再次右键单击发送端口,然后单击“开始”。
注解
在典型的处理过程中,您只能一次检查一个消息部分(在业务流程中指定为消息正文的部分)。 因此,你只能检查 BizTalk 管理控制台中的一个部分,并且无法进行故障排除。 消息检查器管道组件可帮助你克服此限制。