消息编辑器管道组件
此组件可用于在发送或接收管道内自动编辑多部分消息的任何部分。 向现有管道添加此组件可以在典型处理中设置替换部分。
在现有管道中构建消息编辑器管道组件
要使用消息编辑器管道组件,必须向现有管道添加该组件。 有关详细信息,请参阅BizTalk Server帮助中的“使用管道Designer创建管道”。
向现有管道添加消息编辑器管道组件
启动 Visual Studio。
在“ 文件 ”菜单上,指向“ 打开”,然后单击“ 项目”。
移动到 C:\Program Files (x86) \Microsoft BizTalk <version> Accelerator for RosettaNet\SDK\Message Editor Pipeline Component,选择 MessageEditor.csproj,然后单击“ 打开”。
启动 Visual Studio 命令提示符。
在命令提示符下,移动到 C:\Program Files (x86) \Microsoft BizTalk <version> Accelerator for RosettaNet\SDK\Message Editor Pipeline Component\obj\debug。
在命令提示符下,键入 sn -k MessageEditor.snk 以创建键,然后按 Enter。
在 Visual Studio 解决方案资源管理器中,右键单击“MessageEditor”,然后单击“属性”。
在 “MessageEditor 属性 ”页中,单击“ 签名 ”选项卡,然后单击“ 为程序集签名 ”复选框。
在 “选择强名称密钥文件 ”下拉列表中,浏览到 C:\Program Files (x86) \Microsoft BizTalk <version> Accelerator for RosettaNet\SDK\Message Editor Pipeline Component\obj\debug,然后选择“ MessageEditor.snk ”,然后单击“ 打开”。
在解决方案资源管理器中,右键单击“MessageEditor”,然后单击“生成”。 在输出窗格中检验该生成操作是否成功。
单击“ 开始”,指向 “所有程序”,指向“ 附件”,然后单击“ Windows 资源管理器”。
在 Windows 资源管理器中,移动到 C:\Program Files\Microsoft BizTalk 2013 Accelerator for RosettaNet\SDK\Message Editor Pipeline Component\obj\debug,右键单击 “Microsoft.Solutions.BTARN.SDK.MessageEditor.dll”,然后单击“ 复制”。
移动到 C:\Program Files\Microsoft BizTalk Server 2013\Pipeline Components,右键单击“管道组件”,然后单击“粘贴”。
在 Visual Studio 的“ 文件 ”菜单上,指向 “打开”,然后单击“ 项目”。
打开包含要添加编辑器的管道的项目。
在解决方案资源管理器中,双击管道名称,在“管道设计器”中打开该管道。
右键单击“工具箱”窗格的“BizTalk 管道组件”窗格,然后单击“ 添加/删除项”。
在“ 自定义工具箱 ”对话框中的“ BizTalk 管道组件 ”选项卡上,选择“ BTARN 消息编辑器组件”,然后单击“ 确定”。
在“工具箱”窗格的“BizTalk 管道组件”窗格中,单击并按住 BTARN 消息编辑器组件,然后将该组件拖动到管道中所需的位置。
在“工具箱”窗格的“BizTalk 管道组件”窗格中,单击并按住 BTARN 消息编辑器组件,然后将该组件拖动到管道中所需的位置。
注意
建议你在接收管道组件的“拆装”阶段后或在发送管道组件的“预组装”阶段中,添加消息编辑器管道组件。
在 Visual Studio 的“管道Designer”中,选择“BTARN 消息编辑器组件”形状。
在“属性”窗格的与 XPath 查询关联的文本框中,键入要更改其值的 XPath 元素的名称。
在与 XPath 值关联的文本框中,键入要将 XPath 元素设置为的值。
在“解决方案资源管理器”中,右键单击项目名称,然后单击“ 生成”。 检验该生成操作是否成功。
在“解决方案资源管理器”中,右键单击项目名称,然后单击“ 部署”。 检验该部署操作是否成功。
示例
若要更改 0C1 PIP 架构中 元素 ProprietaryDocumentIdentifier
的值,请将以下 Code 部分所示的 XPath 查询添加到消息编辑器管道组件的 XPath Query 属性中。
/*[local-name()='Pip0C1AsynchronousTestNotification' and namespace-uri()='http://schemas.microsoft.com/biztalk/btarn/2004/0C1_MS_R01_02_AsynchronousTestNotification.dtd']/*[local-name()='thisDocumentIdentifier' and namespace-uri()='http://schemas.microsoft.com/biztalk/btarn/2004/0C1_MS_R01_02_AsynchronousTestNotification.dtd']/*[local-name()='ProprietaryDocumentIdentifier' and namespace-uri()='http://schemas.microsoft.com/biztalk/btarn/2004/0C1_MS_R01_02_AsynchronousTestNotification.dtd']
若要获取完整的 XPath 查询,请在 BizTalk 编辑器中打开架构,然后从 Instance XPath
属性窗口下的 属性复制 Xpath。 你提供的 XPath 查询应在其中具有所有命名空间引用。