主機檔案的 BizTalk 配接器設定
概觀
BizTalk Adapter for Host Files 是一種傳送和接收配接器，可讓 BizTalk 協調流程與主機系統互動。 具體而言，配接器可透過 TCP/IP 和 APPC 連線來傳送和接收作業，以裝載在大型主機和 IBM i 平臺上執行的檔案。 根據主機整合伺服器技術，配接器會使用數據存取連結庫元數據元件來設定連線，而 Microsoft .NET Framework 主機檔案的數據提供者發出 SQL 命令和預存程式。
配接器提供兩個主要功能：
對於 傳送 作業 (One Way 和 Solicit Response) ，配接器會將 SQL 命令和系統命令傳送至主機檔案實例，並提供要求回應的選項。
針對 [接收 ] 作業 (僅) 配接器會建立 SQL 命令來輪詢主機檔案物件，並建立個別數據列訊息，然後提交至 BizTalk 訊息系統。
此外，BizTalk Adapter for Host Files 使用標準的 BizTalk 配接器追蹤工具作為疑難解答機制。
注意
BizTalk Adapter for Host Files 是非交易式配接器。 這表示一旦執行動作，就無法復原或復原。
建立元數據元件
安裝配接器之後，您可以建立元數據元件來描述遠端系統以 BizTalk Server。
在 Visual Studio 中建立主機檔案應用程式的一部分是描述主機文件系統的配置。 此程式會建立元數據元件和架構。 元數據元件是遠端主機檔系統的程式設計表示法，而架構則是主機檔系統的 XML 表示法。 您將使用元數據元件來描述主機檔系統以 BizTalk Server。
如需如何在Visual Studio中建立主機檔案應用程式的詳細資訊，請參閱 使用 Managed Data Provider for Host Files 建立應用程式。
建立傳送埠
使用 BizTalk Server Administrators 群組成員的帳戶登入。
在 [BizTalk Server 系統管理] 中，依序展開 [BizTalk 群組]、[應用程式] 和 [應用程式]。
以滑鼠右鍵按兩下 [ 傳送埠]，選取 [ 新增]，然後選取 [靜態單向傳送埠 ] 或 [ 要求回應傳送埠]。
在 [ 傳送埠屬性] 中，將 [傳輸類型 ] 設定為 [主機檔案]。 選擇 [ 設定]，然後輸入下列屬性：
使用 作法 連接字串 用來連線到主機檔案資料庫的 連接字串 名稱。
若要設定新的或現有的 連接字串，請按下省略號 (...) 。 這會啟動 [數據源精靈]。 若要存取說明，請按兩下精靈頁面上的 [ 說明 ]，或開啟 [主機整合伺服器說明]，然後查看 [ 數據源精靈] ([主機檔案]) 。文件目標命名空間 傳送至主機之 XML 檔中使用的目標命名空間。 回應根項目名稱 從主機接收之 XML 檔中使用的根元素名稱。 (這個屬性可能是單向埠的空白。) URI 統一資源標識碼。 用來識別傳送埠位置的名稱。 選取 [ 確定 ] 以儲存變更。
針對 傳送處理程式，選取要執行配接器的主機實例，然後選取 [傳送管線]。
選取 [ 確定 ] 以儲存變更。
在 [ 傳送埠] 中，以滑鼠右鍵按兩下新的傳送埠，然後選取 [ 登記 ]，然後選取 [ 啟動]。
建立接收埠和位置
使用 BizTalk Server Administrators 群組成員的帳戶進行簽署。
在 [BizTalk Server 系統管理] 中，依序展開 [BizTalk 群組]、[應用程式] 和 [應用程式]。
以滑鼠右鍵按兩下 [接收埠]，選取 [ 新增]，然後選取 [ 靜態單向接收埠]。 設定接收 埠內容，然後選取 [ 確定 ] 以儲存變更。
以滑鼠右鍵按兩下 [接收位置]，選取 [ 新增]，然後選取 [單向接收位置]。 選取您建立的接收埠，然後 選取 [確定]。
在 [ 接收位置屬性] 中，將 [傳輸類型 ] 設定為 HostFiles。 選擇 [ 設定]，然後輸入下列屬性：
使用 作法 連接字串 輸入將用來連接到主機資料庫的 連接字串 名稱。
若要設定新的或現有的 連接字串，請按下省略號 (...) 。 這會啟動 [數據源精靈]。 若要存取 [說明]，請按兩下精靈畫面上的 [ 說明 ]，或開啟 [主機整合伺服器說明]，然後查看 [ 數據源精靈] ([主機檔案]) 。
根據 BizTalk Adapter for Host Files 設定接收位置或傳送埠時，元數據定義應該建立為主機整合 Designer XML (HIDX) 元數據檔案進行編碼和譯碼記錄。 如需如何建立 HIDX 檔案的指示，請參閱 使用 Managed Data Provider for Host Files 建立應用程式。文件根項目名稱 從主機接收之 XML 檔中使用的根元素名稱。 文件目標命名空間 從主機接收之 XML 檔中所使用的目標命名空間。 SQL 命令 針對每個輪詢間隔執行一次的 Select 命令。 更新命令 處理接收作業中每個數據列之後執行的命令。 它可以是刪除語句，從 SQL 命令中的數據表刪除數據列，或是靜態修改一或多個數據列的更新命令。 指定此選項時，SQL 命令必須是 Select 語句，並存取單一數據表。
您可以按下省略號 (...) 按鈕來指定其他屬性。 這會開啟 [ 變更命令 ] 對話框，其中提供三個選項：
- 如果 選取其他兩個選項，請勿清除其他兩個選項。
- 讀取後刪除 會在配接器讀取之後刪除數據列。
- Update 可讓您輸入要更新的 SQL 命令。URI 統一資源標識碼。 識別接收埠位置的名稱。 輪詢間隔 輪詢要求之間的單位數目。 允許的範圍是 1 - 65535。 輪詢的度量單位 輪詢要求之間使用的測量單位 (秒、分鐘或小時) 。 預設值為秒。 選取 [ 確定 ] 以儲存變更。
針對 [接收處理程式]，選取主機實例。 接收處理常式必須在此主控件上執行。 選取您的 接收管線。
選取 [ 確定 ] 以儲存變更。
在 [接收位置] 中，以滑鼠右鍵按下接收位置，然後選取 [ 啟用]。
建立架構
使用主機檔案架構產生精靈來建立 BizTalk 配接器主機檔案的 XSD 架構。 建立架構之後，您就可以在 BizTalk Server 端繼續設定。
開啟 Visual Studio 專案 BizTalk Server。
以滑鼠右鍵按兩下項目，選取 [ 新增]，選取 [ 新增產生的專案]，然後選取 [ 新增配接器元數據]。
在 [新增配接器精靈] 的 [ 選取 配接器] 頁面上，選取 [ 主機檔案]，然後選取 [ 下一步]。
在 [主機檔案配接器架構產生精靈] 中：
在 [資料庫資訊] 中，流覽至現有的 連接字串 或建立新的 連接字串。
這可以是初始目錄、套件集合、 (TCP 位址和埠) 或 (APPC 本機 LU、遠端 LU 和模式) 、 (使用者名稱和密碼) ，或 (整合式安全性) 。 最大長度為 1024。
在 [架構資訊] 中，定義您想要在架構中使用的預設命名空間、根元素和埠類型。
如果您選取 [接收埠]，則只需要要求檔根元素名稱。 如果您選取 [傳送埠]，則需要要求和回應檔根元素名稱。
在 [語句類型資訊] 中，選取要發出的資料庫命令類型。
如果您在上一頁選取了傳送埠，您可以選擇發出Updategram、預存程式或SELECT語句。 如果您選取了接收埠，則不需要此步驟。
在 [語句資訊] 中，輸入主機檔案的詳細數據。 根據您先前在先前頁面上輸入的資訊，輸入下列屬性。 如果您選取了傳送埠：
傳送 Updategram 如果您選擇使用傳送埠和 Updategram，您可以在這裡選取 Updategram 作業，以及更新報中將存在的數據表和數據行。
傳送系統命令 如果您選擇使用傳送埠並發出預存程式，您可以從目前的連線目錄選取預存程式。 您不需要在此頁面上輸入所有參數的值。
傳送 Select 語句 如果您選擇搭配 SQL Select 語句使用傳送埠，您可以在這裡選取或瀏覽至 語句。
如果您選取了接收埠：
接收 Select 語句 如果您選擇搭配 SQL 語句使用接收埠，您可以在這裡選取或瀏覽至 語句。
傳送 Updategram 如果您選擇使用傳送埠和 Updategram，您可以在這裡選取 Updategram 作業，以及更新報中將存在的數據表和數據行。
傳送預存程式 如果您選擇使用傳送埠並發出預存程式，您可以從目前的連線目錄選取預存程式。 您不需要在此頁面上輸入所有參數的值。
傳送 Select 語句 如果您選擇搭配 SQL Select 語句使用傳送埠，您可以在這裡選取或瀏覽至 語句。
完成時選取 [ 完成 ]。
建立 BizTalk 應用程式
建立架構之後，您可以撰寫 BizTalk 應用程式的程式代碼。 除了您在 Visual Studio 中建立的架構和埠之外，您的應用程式還會使用您在 Visual Studio 中建立的元數據元件。
在 Visual Studio 中建立 BizTalk 專案。
使用您建立的架構，將主機文件系統描述至 BizTalk 應用程式。
使用您建立的傳送埠，將數據傳送至主機文件系統。
如有必要，請使用您所建立的接收埠和位置。
視需要新增任何其他協調流程、元件或程序代碼。
測試您的應用程式。
完成測試應用程式之後，請建立 .msi 套件，將應用程式移至預備或實時伺服器。 當您建立 BizTalk Server .msi 套件時，請務必包含您建立的主機檔案元數據元件。