HelloWorld (BizTalk Server 範例)
HelloWorld 範例示範如何使用 BizTalk 協調流程，將 XML 訊息 (訂單) 轉換為相關但不同的訊息類型 (發票)。
此範例的用途
此範例會將 In 資料夾設定為接收位置。 當您將檔案例如範例檔案SamplePOInput.xml放入此資料夾中時，BizTalk Server使用下列步驟來處理訊息：
BizTalk Server 從接收位置資料夾擷取 XML 訂單訊息。
協調流程使用對應檔案，從 XML 訂單建立 XML 發票。
BizTalk Server將產生的 XML 發票訊息放入傳送配接器Out資料夾中。
此範例的設計方式和原因
在公司間的訊息交換案例中，通常必須將從交易夥伴收到的輸入訊息轉換為內部應用程式可辨識的格式。 此範例使用 Receive 圖形、 轉換 圖形和 傳送 圖形來達成此結果。 轉換圖形在此範例中扮演重要角色，因為它是訊息格式轉換發生的位置。 您可以將 轉換 圖形拖曳到協調流程中，並為其設定來源訊息、對應名稱和目的地訊息。 在執行階段，會使用您所指定的對應將來源訊息對應到目的訊息。
如需 轉換 圖形的詳細資訊，請參閱 如何設定轉換圖形。 如需建置地圖的詳細資訊，請參閱 使用 BizTalk 地圖工具建立地圖。
可在何處找到此範例
< 範例路徑>\Orchestrations\HelloWorld\
下表顯示此範例中的檔案，並描述其用途。
| 檔案 | Description |
|---|---|
| Cleanup.bat | 用來解除部署組件，以及將它從全域組件快取中移除。 移除傳送埠和接收埠。 視需要移除 Microsoft Internet Information Services (IIS) 虛擬目錄。 |
| HelloOrchestration.odx | 協調訂單到發票之轉換的協調流程。 |
| HelloWorld.btproj, HelloWorld.sln | 這個範例的專案及解決方案檔案。 |
| HelloWorldBinding.xml | 用於自動化設定，例如連接埠繫結。 |
| InvoiceSchema.xsd, POSchema.xsd | 分別是發票和訂單訊息的結構描述。 |
| POToInvoice.btm | 將訂單轉換為發票的對應。 |
| SamplePOInput.xml | 範例輸入檔案。 |
| Setup.bat | 用來建置和初始化此範例。 |
建置和初始化此範例
建置和初始化 HelloWorld 範例
在命令視窗中，瀏覽至下列資料夾：
< 範例路徑>\Orchestrations\HelloWorld
執行檔案 Setup.bat，這會執行下列動作：
在下列資料夾中為這個範例建立輸入 (In) 和輸出 (Out) 資料夾：
< 範例路徑>\Orchestrations\HelloWorld
編譯此範例的 Visual Studio 專案。
建立 BizTalk Server 接收位置以及傳送埠和接收埠，並將其繫結至協調流程。
啟用接收位置並啟動傳送埠。 登錄和啟動協調流程。
注意
在嘗試執行此範例之前，您應該確認 BizTalk Server 沒有在建置和初始化程序期間報告任何錯誤。 您可檢視事件記錄進行確認。
執行此範例
執行 HelloWorld 範例
將檔案的複本貼到 [In ] 資料夾中 SamplePOInput.xml。
觀察在 Out 資料夾中建立的 .xml 檔案。 此檔案包含從輸入檔案 SamplePOInput.xml 建構的 XML 發票。 此檔案名的格式是 <MessageID>.xml，其中< MessageID >是產生來唯一識別訊息的 GUID。
解除安裝這個範例
解除安裝 HelloWorld 範例
在命令視窗中，瀏覽至下列資料夾：
< 範例路徑>\Orchestrations\HelloWorld\
執行 Cleanup.bat。