共用方式為

HTTP 配接器 (BizTalk Server 範例)

  • 發行項

HTTP 配接器範例示範如何實作BizTalk Server中使用的要求/回應和要求/回應通訊架構。

可在何處找到此範例

< 範例路徑 >\AdaptersDevelopment\HttpAdapter\

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

檔案 Description
\Design-Time\Adapter Management 包含實作此配接器之設計階段部分的專案。
\Run-Time\HttpReceive 包含實作要求/回應配接器通訊模式的專案。 這是外掛式接收器。
\Run-Time\HttpSend 包含實作請求/回應配接器通訊模式的專案。

如何使用此範例

此範例是一種架構，可供您在開發自訂配接器時使用。 在某些情況下，BizTalk Server可能需要將訊息傳輸至特定自訂應用程式，或使用原生配接器不存在的通訊協定。 有些協力廠商有撰寫配接器以支援其他的通訊協定。 在決定要撰寫自訂配接器之前，您必須判斷是否有適用於通訊協定的配接器。 如果您找不到支援您通訊需求的配接器，即可開發自己的自訂配接器。

撰寫自訂配接器可能會是具有挑戰性的工作。 為了簡化這項程序，Microsoft 開發了稱為「配接器架構」的基礎。 您可以使用此架構作為開發的基礎，以及 BizTalk Server SDK 中的範例配接器原始程式碼。 For more information on custom adapters, and the Adapter Framework, please refer to the See Also section at the end of this document.

建置和初始化範例配接器

重要

如果 BizTalk 安裝是 64 位元，或安裝位置已有修改，則需要隨之變更 OutboundAssemblyPath、InboundAssemblyPath、AdapterMgmtAssemblyPath。

若要建置和初始化 HTTP 配接器範例

  1. 在命令視窗中，瀏覽至下列資料夾：

    <範例路徑>\AdaptersDevelopment\HttpAdapter

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

    • 編譯 HTTP 配接器及其所有相依性。

    • 建立由配接器的接收者端所使用 Internet Information Services (IIS) 應用程式。

    在 IIS 7.0 上，您必須確定正在執行此 IIS 應用程式之應用程式集區的識別屬於下列群組的成員：

  • BizTalk 外掛式主控件使用者群組。

  • IIS_WPG 群組。

  • 在 IIS 7.0 上，您必須移轉應用程式，才能使其在整合式 .NET 模式下運作。 您可以從命令列視窗中使用下列命令來移轉應用程式組態，包括 HTTPHandlers > 組態區段的內容 < ， (視窗必須以系統管理員身分執行) ：

    %systemroot%\system32\inetsrv\APPCMD.EXE migrate config "Default Web Site/HttpReceive"

  • 在移轉應用程式之後，該應用程式便會在「一般」與「整合式 .NET」兩種模式下執行，而且也會在下層的平台上執行。

注意

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

注意

若您選擇不執行 Setup.bat 檔案就開啟和建置此範例中的專案，您必須先使用 .NET Framework Strong Name Utility (sn.exe) 建立強式名稱金鑰組。 使用此金鑰組簽署所產生的組件。

注意

若要復原 Setup.bat 所進行的變更，請執行 Cleanup.bat。 您必須先執行 Cleanup.bat 才能再度執行 Setup.bat。

註冊範例配接器

若要註冊此 HTTP 配接器範例

  1. 在 Windows 檔案總管中，流覽至 BizTalk Server 的安裝磁片磁碟機，然後流覽至 < [範例路徑 > \AdaptersDevelopment\HTTPAdapter]。

  2. 若要將範例配接器新增至登錄，請按兩下 [HTTP]。NET.reg.

    注意

    HTTP。NET.reg 包含BizTalk Server安裝目錄的硬式編碼路徑。 如果您未在預設位置安裝BizTalk Server，或從舊版的 BizTalk Server 升級BizTalk Server安裝，則必須修改檔案 HTTP。具有適當路徑的 NET.reg。 更新與 "OutboundAssemblyPath" 和 "AdapterMgmtAssemblyPath" 值關聯的路徑，使它們指向特定檔案的正確位置。

    重要

    如果您在 64 位電腦上安裝 BizTalk，請將 HKEY_CLASSES_ROOT\CLSID\ 登錄專案的所有實例變更為 HTTP 中的 HKEY_CLASSES_ROOT\Wow6432Node\CLSID\ 。NET.reg 登錄檔。

  3. 在 [ 登錄編輯器] 對話方塊中，按一下 [ 是 ] 將範例配接器新增至登錄，然後按一下 [ 確定]。

  4. 若要關閉 Windows 檔案總管，請在 [ 檔案 ] 功能表上，按一下 [ 關閉]。

安裝範例配接器

若要安裝此 HTTP 配接器範例

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

  2. 在 BizTalk Server 管理主控台中，展開 [BizTalk Server系統管理] 樹狀結構，然後展開[BizTalk 群組] 樹狀結構，然後展開 [平臺設定] 樹狀結構。

  3. 以滑鼠右鍵按一下 [ 配接器]，按一下 [ 新增]，然後按一下 [ 配接器]。

  4. 在 [ 配接器屬性 ] 對話方塊中，執行下列動作。

    使用 作法
    名稱 輸入 HTTP.NET。
    配接器 從下拉式清單中選取 [HTTP.NET ]。
    Description 類型 範例 HTTP.NET 配接器。

  5. 按一下 [確定]。

  6. 配接器隨即會出現在 BizTalk 管理主控台右側視窗的配接器清單中。

停止並重新啟動主控件執行個體

若要停止並重新啟動 HTTP 配接器範例的主控件執行個體

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

  2. 在 BizTalk Server 管理主控台中，展開 [BizTalk Server系統管理] 樹狀結構，然後展開 [平臺設定]，然後按一下 [主機實例]。

  3. 在結果窗格中，以滑鼠右鍵按一下主機實例 (通常是電腦名稱稱) ，然後按一下 [ 停止]。

    主機實例的狀態會變更為 [已停止]。

  4. 在結果窗格中，以滑鼠右鍵按一下主機實例，然後按一下 [ 啟動]。

    現在，您的應用程式可開始使用 HTTP.NET 配接器。 設定配接器時， Virtual Directory 傳輸屬性的格式為：/HTTPreceive/HTTPreceive.aspx？optionalQueryString。

註解

HTTP.NET 配接器會使用Samples Path > \AdaptersDevelopment\BaseAdapter\v1.0. 中 <提供的 BaseAdapter 類別。2\. 這些提供於 BaseAdapter 專案中的類別是為了加速配接器的開發。 如需所提供類別的詳細資料，請參閱 BaseAdapter 程式碼註解。

另請參閱

註冊配接器
配接器範例 - 用法
開發自訂配接器
何謂配接器架構？
使用配接器架構工具
開發接收配接器
開發傳送配接器
如何部署自訂配接器
設計配接器的祕訣
配接器設計階段設定