消息检查器管道组件
使用此管道组件,你可以检查由多个部分组成的消息的所有部分和消息上下文,以便确定消息是否存在问题。 你可以用此组件来排除故障。
该管道组件将 XML 文件放入你指定的目录中。 这些文件中的每一个都包含 RNIFv2.0 消息的四个部分(前导头、传递头、服务头和服务内容)中的一个或 RNIFv1.1 消息的三个部分(前导头、服务头和服务内容)中的一个。 另一个 XML 文件中包含消息上下文。
你可以将此组件构建到自定义管道中,然后将其附加到发送端口。 你可以在发送端口中创建一个筛选器,用于订阅要监视的消息。 除了 Microsoft® BizTalk Accelerator for RosettaNet (BTARN) 已执行的标准处理之外,还会进行此故障排除。
使用消息检查器管道组件构建自定义管道
若要使用消息检查器管道组件,你必须构建并部署一个包含该组件的自定义管道。 有关详细信息,请参阅BizTalk Server帮助中的“使用管道Designer创建管道”。
部署消息检查器管道组件
启动 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 <version> 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 <version> 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 <version> Accelerator for RosettaNet\SDK\Message Inspector Pipeline Component\obj\debug,选择“ MessageInspector.snk”,然后单击“ 确定”。
在 Visual Studio 管道Designer中,选择 BTARN 消息检查器组件形状。
在 Visual Studio 属性窗口的“目录”框中,键入要将 XML 文件拖放到的目录的名称。
在“解决方案资源管理器”中,右键单击项目名称,然后单击“生成”。 检验该生成操作是否成功。
在“解决方案资源管理器”中,右键单击项目名称,然后单击“部署”。 检验该部署操作是否成功。
在 Visual Studio 的“ 视图 ”菜单上,单击“ BizTalk 资源管理器”。
右键单击“ 发送端口”,然后单击“ 添加发送端口”。
在 “新建发送端口 ”对话框中,单击“ 确定”。
在“ 发送端口属性 ”对话框的“ 名称 ”框中,键入发送端口的名称,并在左窗格中选择“ 主要 ”,单击右窗格中的“ 传输类型 ”,然后选择“ 文件”。
在“ 发送端口属性 ”对话框中 的“地址 (URI) ”框中,单击省略号按钮 (...) 。
在“ 文件传输属性 ”对话框中,键入 “目标 ”文件夹名称,在左窗格中单击“ 发送 ”,然后在右窗格中为“ 发送管道 ”选择刚刚创建的自定义管道。
在左窗格中 单击“筛选器 & 映射 ”,然后单击“ 筛选器”。
在右窗格中输入筛选器表达式,指定希望该管道为哪种类型的文件放置 XML 文件。 例如,如果要删除所有 RNIF v1.1 消息的文件,对于 “属性” ,请选择“Microsoft.Solutions.BTARN.Schemas.RNIFv11.GlobalBusinessAction”,对于 “运算符 ”,请选择“存在”,然后单击“ 确定”。
在 BizTalk 资源管理器中,右键单击刚创建的发送端口,单击“ 登记”,再次右键单击发送端口,然后单击“ 启动”。
注解
在常规的处理操作中,你一次只能检查消息的一部分,即已在业务流程中指定为消息正文的部分。 因此,你只能在 BizTalk 管理控制台中检查消息的各个部分中的一个,这样,排除故障的能力就受到限制。 消息检查器管道组件可以帮助你突破此限制。