配接器設計階段組態
配接器會同時包含執行階段元件和設計階段元件。 使用者看不到執行階段元件。 它明確地負責傳輸、接收和處理BizTalk Server訊息。
配接器的設計階段元件則可透過管理使用者介面顯示。 該元件負責顯示可用屬性、接受管理輸入,並驗證該輸入以設定配接器。 設計階段元件必須可用來正確設定配接器的屬性,以啟用正確交換訊息的執行階段功能,這點非常重要。
本節僅討論配接器的設計階段元件。 因此,我們的討論只會著重於如何顯示及設定配接器的組態。 有兩種設定配接器的方式:
屬性瀏覽器 傳送或接收埠或傳送或接收處理常式的配接器屬性是透過其 [屬性] 功能表設定,方法是使用 BizTalk Server 管理主控台。 在這些成品的設定期間會選取配接器 (傳輸),而且藉由使用屬性瀏覽器來設定其屬性。 可套用的屬性會透過結構描述,以固定的名稱顯示。 例如,如果是傳送 (傳輸) 處理常式,則其屬性會在 TransmitHandler.xsd 檔案中;如果是接收位置,則屬性會在 ReceiveLocation.xsd 檔案中。 配接器會實作 IAdapterConfig 介面,以尋找並載入適當的架構,以在屬性瀏覽器中公開特定屬性。 IAdapterConfigValidation介面可用來驗證這些專案,並在儲存組態資料之前,先對值進行任何最終修改。
新增配接器中繼資料精靈 在應用程式和資料庫配接器的情況下,您可能需要匯入支援架構,描述 Visual Studio 中 BizTalk 專案中配接器所需的訊息類型和埠類型。 或者,有時候也需要使用配接器所提供的服務。 新增配接器中繼資料精靈可用來檢視配接器所支援的服務,並將相關的訊息類型和連接埠類型匯入至專案中。 此程式稱為「元資料收集」。身為配接器開發人員,您會建立描述這些服務的 XML 檔案,並在設計階段透過 IStaticAdapterConfig 或 IDynamicAdapterConfig 介面向精靈公開,結果如下:
靜態配接器 :此精靈提供標準的預設階層樹狀結構,該結構可用來顯示配接器的服務。 靜態配接器是定義為使用精靈所提供之標準樹狀結構使用者介面 (UI) 的配接器。 使用 IStaticAdapterConfig.GetServiceOrganization 和 GetServiceDescription 方法來允許將選取的服務新增至 BizTalk 專案。 對配接器開發人員來說,這是最簡單的組態選項,但缺點是顯示格式缺乏彈性。
動態配接器 :如果此精靈所提供的基本服務選擇 UI 彈性不足,無法滿足您的 UI 需求,您可以建立自訂 UI,由精靈以動態的方式顯示。 使用 IDynamicAdapterConfig.DisplayUI 方法可顯示自訂 UI,以允許將服務選取新增至 BizTalk 專案。
本節提供以靜態或動態方式處理設計階段組態的兩組指導方針。
Microsoft BizTalk Server軟體發展工具組 (SDK) 包含範例檔案配接器,可用來建立和自訂您自己的配接器設計階段組態解決方案。 在每一個設計階段組態主題中,都有提供關於該範例 FILE 配接器的注意事項及參考,可協助您修改自己的自訂配接器組態需求。 若要進一步瞭解這些指導方針,可能需要安裝、建置及執行 SDK 中提供的範例 FILE 配接器。 如需詳細資訊,請參閱檔案配接器 (BizTalk Server 範例) 。