Freigeben über


Schnittstelle des statischen Adapters 'IstaticAdapterConfig'

Ein statischer Entwurfszeitadapter muss die IStaticAdapterConfig-Schnittstelle implementieren. Dadurch kann er mit dem Assistenten zum Hinzufügen von Adapter-Metadaten interagieren und Dienstorganisationen und einzelne Dienstbeschreibungen vom Adapter abrufen. Der Assistent ruft die Methoden GetServiceOrganization und GetServiceDescription auf, um Metadateninformationen abzurufen, mit denen der Adapter interagiert, und sie einem BizTalk-Projekt in Visual Studio hinzuzufügen.

Die GetServiceOrganization-Methode ruft ein XML-instance-Dokument ab, das die hierarchische organization der verfügbar gemachten Dienste des Adapters darstellt. Diese Struktur generiert die Dienststruktur organization, die auf der Seite Zu importierende Dienste auswählen im Assistenten zum Hinzufügen von Adaptermetadaten angezeigt wird.

Nachdem Sie die zu importierenden Dienste ausgewählt haben, ruft der Assistent die GetServiceDescription-Methode auf, um ein Array von WSDL-Dateien (Web Services Description Language) abzurufen, die den Dienstkategorien entsprechen, die in der Struktur Zum Hinzufügen von Adaptermetadaten-Assistenten ausgewählt wurden. Nach Abschluss des Assistenten zum Hinzufügen von Adapter-Metadaten werden Schemas, die die Dienste darstellen, als XSD-Dateien generiert und zum BizTalk-Projekt hinzugefügt.

Im Dateiadapterbeispiel befinden sich die Methoden GetServiceOrganization und GetServiceDescription in der Klasse StaticAdapterManagement in der Klassendatei AdapterManagement.cs. Der Assistent ruft die GetServiceOrganization-Methode auf, um die Strukturstruktur abzurufen, die auf der Seite Zu importierende Dienste auswählen angezeigt werden soll. In GetServicesOrganization wird der hartcodierte Rückgabewert von AdapterManagement.CategorySchema.xml Datei verwendet, wie im folgenden Codefragment gezeigt. Als Entwickler eines Adapters müssen Sie die Logik hinzufügen, um die entsprechende XML-Datei zurückzugeben.

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

Hinweis

Achten Sie darauf, die GetServiceDescription-Methode der StaticAdapterManagement-Klasse und nicht der DynamicAdapterManagement-Klasse zu ändern, die zuerst in der Datei angezeigt wird.

Der folgende Code stammt aus der GetServiceDescription-Methode der Datei AdapterManagement.cs. Die Datei service1.wsdl ist als WSDL-Datei fest programmiert, die zurückgegeben wird. Sie gibt Schemas zurück, die als WSDL-Dateien dargestellt werden. Der wsdls Parameter ist ein Array eindeutiger WSDL-Verweise, die den WSDL-Verweisen in der von GetServicesOrganization geladenen Quell-XML entsprechen. Der zurückgegebene Satz von WSDL-Beschreibungen wird für das Generieren von Porttypen und Nachrichtentypen für das BizTalk-Projekt verwendet. Wenn in der Baumstruktur mehrere Schematypen zur Verfügung stehen, benötigen Sie mehrere WSDL-Dateien. Wenn mehrere mögliche Schemas und WSDL-Dateien verfügbar sind, könnten Sie eine Datenbanksuche hinzufügen, um die korrekte WSDL-Datei zurückzugeben.

/// <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;  
        }  

Weitere Informationen

Konfiguration des statischen Entwurfszeitadapters