共用方式為

擴充對應工具 (BizTalk Server 範例)

  • 發行項

「擴充對應工具」範例會示範如何使用和擴充「BizTalk 對應工具」。 此範例包含數個 BizTalk Server 對應檔案 (.btm)，每個檔案都代表「BizTalk 對應工具」的不同功能。

此範例的用途

「擴充對應工具」範例會使用根據訊息內容決定路由 (CBR)，而且不會使用協調流程。 藉由對範例傳送埠指定篩選條件，它會直接連接至範例接收埠。 此外，還會對傳送埠指定對應，以套用到處理過的文件。

可在何處找到此範例

< Samples Path >\XmlTools\ExtendingMapper

下表顯示此範例中的檔案，並描述其用途。

檔案 Description
MapperClassLibrary\AssemblyInfo.cs、MapperClassLibrary\MapperClassLibrary.csproj、MapperClassLibrary\MapperHelper.cs、MapperClassLibrary\MapperClassLibrary.sln Microsoft® Visual Studio® 專案檔和 Visual C#® 原始程式檔。
Cleanup.bat 用來解除部署組件，並將這些組件從全域組件快取 (GAC) 移除。
Destination.xsd 結構描述檔案。
ExtendingMapper.btproj、ExtendingMapper.sln 此範例的 BizTalk 專案和方案檔。
ExtendingMapper.xml 來源 XML。
ExtendingMapperBinding.xml 繫結 XML。
ExternalAssembly.xml 外部組件 XML。
OverridingMapXslt.btm 對應檔案。
OverridingMapXslt.xml 覆寫對應 XML。
OverridingMapXslt.xslt 覆寫對應樣式表。
Scriptor_CallExternalAssembly.btm 範例對應檔案。
Scriptor_GlobalVariableInInlineScript.btm 範例對應檔案。
Scriptor_InlineScripts.btm 範例對應檔案。
Scriptor_InlineXslt.btm 範例對應檔案。
Scriptor_InlineXsltCallingExternalAssembly.btm 範例對應檔案。
Scriptor_XsltCalltemplate.btm 範例對應檔案。
Setup.bat 用來建置和初始化範例。
Source.xsd 結構描述檔案。

建置和初始化此範例

請使用下列程序，建置和初始化「擴充對應工具」範例。

若要建置並初始化這個範例

  1. 在命令視窗中，將目錄 (cd) 變更為下列資料夾：

    < Samples Path >\XmlTools\ExtendingMapper

  2. 執行檔案 Setup.bat，這會執行下列動作：

    • 建立此範例的輸入 (\In) 和輸出 (\Out) 資料夾。

    • 為這個範例編譯和部署 Visual Studio 專案。

    • 建立並繫結 BizTalk Server 接收位置以及傳送和接收埠。

      如果您要使用 Scriptor_CallExternalAssembly.btm 或 Scriptor_InlineXsltCallingExternalAssembly.btm 對應，請在 Visual Studio 中開啟 ExtendingMapper.sln，然後進行下列修改 (否則請移至步驟 3)：

    1. 在 [方案總管] 中，開啟 Scriptor_CallExternalAssembly.btm。

    2. 在對應工具方格中，選取 [指令碼處理] 運算質。

    3. 在屬性方格中，選取 [腳本 ] 屬性，然後按一下省略號 (...) 按鈕來設定運算質腳本。

    4. 在 [ 設定腳本運算質 ] 對話方塊中，選取 [ 腳本運算質組態]，然後指定下列專案：

      設定此項 為此值
      腳本類型 外部組件
      指令碼組件 Microsoft.Samples.BizTalk.ExtendingMapper.MapperClassLibrary
      腳本類別 Microsoft.Samples.BizTalk.ExtendingMapper.MapperHelper
      指令碼方法 MyConcat

    5. 從 Visual Studio[檔案 ] 功能表中，選擇 [ 儲存 ] 以儲存對應檔案的變更，然後關閉方案。

  3. 按任何鍵繼續執行 Setup.bat。

    重要

    如果您要使用 Scriptor_InlineXsltCallingExternalAssembly.btm，則必須編輯 ExternalAssembly.xml 檔案。 BizTalk 會使用 ExternalAssembly.xml，將對應工具延伸模組物件註冊命名空間對應至 .NET 組件。 由於參考相依組件時是根據其完整格式名稱 (包括自動產生的公開金鑰 Token)，所以您必須更新此值。 如果您不要使用 Scriptor_InlineXsltCallingExternalAssembly.btm，則不需要完成步驟 a 至 e。

  4. 在 Windows 檔案總管中，流覽至 < Windows 資料夾 > \assembly\。

    1. 以滑鼠右鍵按一下 [Microsoft.Samples.BizTalk.ExtendingMapper.MapperClassLibrary ]，然後選取 [ 屬性]。

    2. 複製公開金鑰 Token 值。

    3. 在文字編輯器中，開啟< [範例路徑 >\XML] Tools\ExtendingMapper\ExternalAssembly.xml。

    4. 選取 AssemblyName=「Microsoft.Samples.BizTalk.ExtendingMapper.MapperClassLibrary，Version=1.0.0.0， Culture=neutral， PublicKeyToken=68496d20c737d84b」屬性，並以您在步驟 c 中複製的公開金鑰權杖值取代 PublicKeyToken 值。

    5. 儲存並關閉 ExternalAssembly.xml。

    注意

    在嘗試執行此範例之前，您應該確認在建置和初始化程序期間沒有報告錯誤。

若要設定、登錄和啟動傳送埠

  1. 按一下[開始]，選取[所有程式]，選取[Microsoft BizTalk Server]，然後選取[BizTalk Server系統管理]。

  2. 在BizTalk Server管理主控台中，按一下以展開[BizTalk Server系統管理]，按一下以展開BizTalk 群組 [ < servername > ： < management database > ]，然後按一下以展開[應用程式]。

  3. 按一下以展開 ExpandMapperApplication，然後按一下 [ 傳送埠]。

  4. 在右窗格中，以滑鼠右鍵按一下 [ 傳送埠]，然後按一下 [ 屬性]。

  5. 在 [ ExtendingMapperSP – 傳送埠屬性 ] 對話方塊中，按一下 [ 輸出對應 ] 頁面。

    在 [ 對應] 資料 行中，從下拉式清單中選取必要的地圖，然後按一下 [ 確定]。 下表說明地圖。

    要套用的對應屬性 Description
    Microsoft.Samples.BizTalk.ExtendingMapper. Scriptor_CallExternalAssembly 示範如何根據這個運算質的輸入參數，從對應中的 腳本 運算質呼叫外部 .NET 元件中的函式。 這有助於將任何處理邏輯與對應檔案清楚劃分開來。 此對應檔案會使用本範例隨附的 MapperClassLibrary.dll 組件。
    Microsoft.Samples.BizTalk.ExtendingMapper. Scriptor_InlineScripts 示範如何使用 C#、Visual Basic.NET 和 JScript.NET 等 .NET 語言，在對應檔中撰寫簡單的內嵌腳本。
    Microsoft.Samples.BizTalk.ExtendingMapper. Scriptor_GlobalVariableInInlineScript 示範如何在 腳本 運算質的內嵌腳本中使用全域變數。 全域變數通常用來維護對應檔中跨不同 腳本 運算質的狀態資訊。
    Microsoft.Samples.BizTalk.ExtendingMapper. Scriptor_InlineXslt 示範如何在地圖的 腳本 運算質內，使用原始內嵌 XSLT 在目的地檔中建構結構。 您可以使用 腳本 運算質搭配內嵌 XSLT 建構目的地檔的一些部分，只要無法使用其他運算質在 BizTalk Mapper 中執行此動作即可。
    Microsoft.Samples.BizTalk.ExtendingMapper. Scriptor_XsltCalltemplate 示範如何在對應中使用 腳本 運算質內的 XSLT 呼叫範本，在目的地檔中建立結構。 XSLT 呼叫範本優於內嵌 XSLT 的優點是呼叫範本可以接受參數，因此您可以根據 腳本 運算質的輸入參數來建立結構。 您可以使用 腳本 運算質搭配內嵌 XSLT 建構目的地檔的一些部分，只要無法使用其他運算質在 BizTalk Mapper 中執行此動作即可。
    Microsoft.Samples.BizTalk.ExtendingMapper. Scriptor_InlineXsltCallingExternalAssembly 示範如何從對應中 腳本 運算質的內嵌 XSLT 內呼叫外部 .NET 元件。 說明如何使用自訂副檔名檔案來覆寫 BizTalk Mapper 方格的 自訂延伸模組 XML 屬性，ExternalAssembly_extxml.xml 包含要叫用之外部 .NET 元件的詳細資料。 您可以使用 腳本 運算質搭配內嵌 XSLT 在 Mapper UI 中使用其他運算質，來建構目的地檔的一些部分。
    Microsoft.Samples.BizTalk.ExtendingMapper. OverridingMapXslt 示範如何使用自訂 XSLT 檔案完全覆寫「BizTalk 對應工具」檔案的已編譯 XSLT。 您可以覆寫 自訂 XSL Path屬性，並選擇性地覆寫 BizTalk 對應程式方格的 自訂延伸模組 XML 屬性來執行此動作。 您提供的自訂 XSLT 檔案會包含在執行階段要使用之專案的已編譯 BizTalk Server 組件中。 在這種情況下，對應檔案 (.btm) 的內容會被忽略。 此對應檔案分別針對 自訂 XSL 路徑 和 自訂延伸模組 XML 屬性使用 OverridingMapXslt.xslt 和 OverridingMapXslt.xml。

    您可以在 [方案總管] 中驗證對應檔案。 然後，您可以使用它做為範本檔案，您可以編輯並用於 BizTalk 對應程式方格的 自訂 XSL Path 屬性。 只要無法使用「BizTalk 對應工具」產生此 XSLT，您便可尋求這種解決方式。

執行此範例

請使用下列程序執行「擴充對應工具」範例。

執行此範例

  1. 將輸入檔 ExtendingMapper.xml 複製到範例路徑 > \XmlTools\ExtendingMapper\In 的 <輸入資料夾中。

  2. 請注意檔案如何轉換並路由傳送至< Samples Path >\XmlTools\ExtendingMapper\Out 資料夾。 這裡執行的轉換是根據您所套用的對應而來。

另請參閱

XML 工具 (BizTalk Server Samples 資料夾)