建立轉換或對應

更新日期: 2015年7月

您可以定義輸入 XML 文件之間的關聯性、新增 對應作業 以修改資料,然後輸出 XML 文件。轉換 或對應是 Visual Studio 中 BizTalk 服務 SDK 範本的一部分。請參閱安裝 Azure BizTalk 服務 SDK

本主題內容:

選擇您的專案類型

新增您的結構描述

新增您的對應作業

設計區域秘訣與技巧

更多對應內容

建立新轉換的方法有兩種:在 BizTalk 服務專案中加入對應,或建立新的 [BizTalk 服務成品] 專案。

當對應新增或建立於 BizTalk 服務專案 時,它會是專案的一部分,並且應該用於 XML 單向橋接器 或 XML 要求-回覆橋接器 中。當您建立 [BizTalk 服務成品] 專案時,您會建立獨立於其他任何專案以外的對應。轉換完成後可以儲存、新增至企業對企業協議,或新增至現有的 BizTalk 服務專案。

許多開發人員會想要將其結構描述保存在中央位置。在此情況下,您可以使用 [BizTalk 服務成品] 專案來儲存您的結構描述和對應。然後,您可以儲存/備份一個專案及其資源。當您需要這些結構描述或對應時,您可以直接將其新增至其他專案。

  1. 以管理員的身分開啟 Visual Studio,然後開啟您的 BizTalk 服務專案。

  2. 在 BizTalk 服務專案中,移至 [方案總管]。

  3. 以滑鼠右鍵按一下專案、選取 [新增],然後選取 [新增項目] 或 [現有項目]。

  4. 輸入您的對應詳細資料,然後選取 [新增]。

在對應建立完成後,您可以將對應新增至 XML 橋接器 的轉換階段。請參閱建立 XML 單向橋接器建立 XML 要求-回覆橋接器橋接器的用法和階段提供有關轉換階段的詳細資訊。

  1. 以管理員的身分開啟 Visual Studio

  2. 選取 [新增專案]。

  3. 展開 Visual C# 範本,然後選取 [BizTalk 服務]。

  4. 選取 [BizTalk 服務成品]。

  5. 輸入專案 [名稱]、專案 [位置]、[方案名稱] 屬性,以及 [建立方案的目錄] 喜好設定。

  6. 選取 [確定]

開啟專案時,即會自動建立 Map.trfm、Schema1.xsd 和 Schema2.xsd。這些檔案是空的,因此您可以自行加以變更、刪除或新增。BizTalk 服務 轉換 具有 .trfm 副檔名,且在開啟 .trfm 檔案時,將會開啟 轉換 設計工具,您可以在此處新增結構描述、新增 對應作業,並繪製您的連結。

您可以使用內建的結構描述編輯器來建立和修改結構描述。新增對應之後,請新增您的來源結構描述 (輸入) 和目標結構描述 (輸出):

  1. 以管理員的身分,在 Visual Studio 中開啟 BizTalk 服務 或 [BizTalk 服務成品] 專案。

  2. 在專案中新增現有結構描述 (.xsd) 或新的結構描述 (.xsd)。

    1. 在專案上按一下滑鼠右鍵,然後選取 [新增]。

    2. 選取 [現有項目],以新增已建立的結構描述。選取 [新增項目]、[結構描述],以建立新的結構描述。

  3. 選取 [新增]。

  4. 按兩下結構描述 (.xsd) 以開啟結構描述編輯器。

開發 EDI 結構描述提供有關建立和修改現有結構描述的資訊。

新增結構描述之後,您可以使用內建的 對應作業 變更或操作傳入的資料,以符合輸出結構描述:

  1. 從 [工具箱] 中按住 對應作業,並將其拖曳至 轉換 設計工具:

    按兩下 對應作業 以設定輸入。

  2. 按住項目,並將其從您的輸入結構描述拖曳至對應作業或輸出結構描述。對應作業 支援三種輸入來源類型:

    • 從樹狀節點連結

    • 從對應作業連結

    • 常數值

Tip提示
  • 如果不允許來自樹狀節點或對應作業的連結,狀態列會出現訊息來說明原因。

  • 部分對應作業在 [設定] 對話方塊視窗中有 [類型] 屬性。此 [類型] 屬性是唯讀的。

 

   

剪下、複製和貼上

對應作業可使用剪下/複製與貼上來進行移動。無法使用剪下/複製與貼上移動連結。如果使用剪下/複製與貼上移動對應作業,則會移除連結。

無法拖放 對應作業 和連結。若要移動對應作業及其連結,請使用 Ctrl + 按一下來選取要移動的項目。Ctrl + 按一下可剪下項目,再貼到您要的位置。

XSLT 支援

BizTalk 服務 或 [BizTalk 服務成品] 專案中,轉換 (.trfm) 檔案可使用 XSLT。XSLT 選項包含輸入 XSLT 語法及匯入現有 XSLT 檔案,包含 XML 延伸檔案 (EXT XML)。

若要匯入現有的 XSLT 檔案,請選取 轉換 設計區域。在 [內容] 中,選取 [匯入 XSLT]。您可以選取檔案或直接輸入 XSLT 語法。

若要匯入現有的 XML 延伸模組檔案,請選取 轉換 設計區域。在 [內容] 中,選取 [匯入 EXTXML]。您可以選取檔案或直接輸入 XML 語法。

選取 [使用 XslCompiledTransform 以獲得較佳的效能],經由編譯 XSLT 樣式表和執行 XSLT 轉換來轉換 XML 資料。樣式表經過編譯之後,即可快取和重複使用。若未啟用此選向,則會使用 XslTransform 類別,這在轉換執行一次時表現最好。

具有重複記錄的直接連結

將來源文件的重複記錄連結至目標文件的重複記錄時,需要 MapEach 迴圈。在每個來源節點到目標節點之間建立這些連結通常很耗費時間。因此,BizTalk 服務包含直接連結功能。

「直接連結」只是從輸入節點複製至輸出節點,而不需要進行其他處理。連結非重複記錄時也會使用直接連結;此作法不需要 MapEach 迴圈。

迴圈對應作業 - 使用方式與範例描述直接連結功能。

捲動

可使用兩種方式在轉換設計工具中垂直捲動:

  • 捲動滑鼠滾輪

  • 使用向上鍵和向下鍵

可使用兩種方式在轉換設計工具中水平捲動:

  • 按住 SHIFT 鍵 + 捲動滑鼠滾輪

  • 使用向左鍵和向右鍵

繪圖介面

轉換設計工具中的繪圖介面預設大小為 200*200 儲存格。若要修改大小:

  1. 移至 [工具] 功能表並選取 [選項]。

  2. 展開 [轉換設計工具],並按一下 [一般]。

  3. 修改 [方格介面 X 軸上的方格儲存格數目] 和 [方格介面 Y 軸上的方格儲存格數目] 值。值的範圍是從 100 到 1000。

  4. 按一下 [確定]

頁面

可在轉換設計介面中新增、刪除和重新命名頁面。每頁都有 對應作業 及其領域容器。

若要新增、移除或重新命名頁面,請在設計介面底部的 [頁面 1] 索引標籤上按一下滑鼠右鍵來檢視可用的選項。

另請參閱

顯示: