共用方式為


靜態配接器 IStaticAdapterConfig 介面

靜態設計階段配接器必須實作 IStaticAdapterConfig 介面。 這可讓它和「新增配接器中繼資料精靈」進行互動,並從配接器取得服務組織和個別的服務描述。 精靈會呼叫 GetServiceOrganizationGetServiceDescription 方法,以提取配接器互動的中繼資料資訊,並在 Visual Studio 中將其新增至 BizTalk 專案。

GetServiceOrganization方法會取得 XML 實例檔,代表配接器公開服務的階層式組織。 此結構會產生您在 [新增配接器中繼資料精靈] 的 [ 選取要匯入的服務 ] 頁面上看到的服務組織樹狀結構。

選取要匯入的服務之後,精靈會呼叫 GetServiceDescription 方法來取得 Web 服務描述語言陣列, (WSDL) 檔案,這些檔案對應至 [新增配接器中繼資料精靈] 樹狀目錄中選取的服務類別。 表示服務的結構描述會產生為 XSD 檔案,並在您完成「新增配接器中繼資料精靈」後新增至您的 BizTalk 專案。

在檔案配接器範例中, GetServiceOrganizationGetServiceDescription 方法位於 AdapterManagement.cs 類別檔案中的 StaticAdapterManagement 類別中。 精靈會呼叫 GetServiceOrganization 方法來取得樹狀結構,以顯示在 [ 選取要匯入的服務 ] 頁面上。 在 GetServicesOrganization 中,會使用 AdapterManagement.CategorySchema.xml 檔案的硬式編碼傳回值,如下列程式碼片段所示。 身為配接器開發人員,您必須加入此邏輯,以傳回適當的 XML 檔案。

public string GetServiceOrganization(IPropertyBag endPointConfiguration, string NodeIdentifier)   
{  
   string result = GetResource("AdapterManagement.CategorySchema.xml");  
   return result;  
}  

注意

請務必修改StaticAdapterManagement類別的GetServiceDescription方法,而不是DynamicAdapterManagement類別,該類別會先出現在檔案中。

下列程式碼來自 AdapterManagement.cs 檔案的 GetServiceDescription 方法。 service1.wsdl 但會被硬式編碼為傳回的 WSDL 檔案。 它會傳會表示為 WSDL 檔案的結構描述。 參數 wsdls 是唯一 WSDL 參考的陣列,對應至 GetServicesOrganization所載入之來源 XML 中的 WSDL 參考。 WSDL 描述的傳回集用來產生 BizTalk 專案的連接埠類型和訊息類型。 如果您在樹狀結構中有一個以上的結構描述類型可供選取,您將需要一個以上的 WSDL 檔案。 如果您有很多可能的結構描述和 WSDL 選擇,您可新增資料庫尋查來傳回正確的 WSDL 檔案。

/// <summary>     
        /// Get the WSDL file name for the selected WSDL  
        /// </summary>  
        /// <param name="wsdls">place holder</param>  
        /// <returns>An empty string[]</returns>  
        public string[] GetServiceDescription(string[] wsdls)   
      {  
            string[] result = new string[1];  
            result[0] = GetResource("AdapterManagement.service1.wsdl");  
            return result;  
        }  

另請參閱

靜態設計階段配接器設定