此组件允许在发送或接收管道中自动编辑多部分消息的任何部分。 将此组件添加到现有管道中,以在典型的处理过程中设置替代功能。
将消息编辑器管道组件构建到现有管道中
若要使用消息编辑器管道组件,必须将组件添加到现有管道。 有关详细信息,请参阅 BizTalk Server 帮助中的“使用管道设计器创建管道”。
将消息编辑器管道组件添加到现有管道
启动 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 <版本> 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 <版本> 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 的管道设计器中,选择 BTARN 消息编辑器组件 形状。
在“属性”窗格中,在与 XPath 查询关联的文本框中,键入要为其更改值的 XPath 元素的名称。
在与 XPath 值关联的文本框中,键入要设置 XPath 元素的值。
在解决方案资源管理器中,右键单击项目名称,然后单击“ 生成”。 验证生成是否成功。
在解决方案资源管理器中,右键单击项目名称,然后单击“ 部署”。 验证部署是否成功。
示例:
若要更改 0C1 PIP 架构中元素 ProprietaryDocumentIdentifier
的值,请将以下代码部分中所示的 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 查询应包含其中的所有命名空间引用。