訊息編輯器管線元件
此元件可讓您自動編輯傳送或接收管線中多部分訊息的任何部分。 您可將此元件新增至現有的管線中,設定取代做為一般處理的一部分。
將訊息編輯器管線元件建置至現有的管線
如果要使用「訊息編輯器管線元件」,您必須將該元件新增至現有的管線。 For more information, see "Creating Pipelines with Pipeline Designer" in BizTalk Server Help.
將訊息編輯器管線元件新增至現有的管線
啟動 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 Query相關聯的文字方塊中,輸入您要變更值的 XPath 元素名稱。
在與 XPath Value相關聯的文字方塊中,輸入您要設定 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 查詢中應該具備所有的命名空間參考。