Teilen über

Konfiguration von Adaptern zur Entwurfszeit

  • Artikel

Ein Adapter enthält eine Laufzeit- und eine Entwurfszeitkomponente. Die Laufzeitkomponente ist für den Benutzer nicht sichtbar. Sie ist transparent für die Übermittlung, den Empfang und die Verarbeitung BizTalk Server Nachrichten verantwortlich.

Die Entwurfszeitkomponente eines Adapters wird auf den Benutzeroberflächen für die Verwaltung angezeigt. Sie ist zuständig für das Anzeigen verfügbarer Eigenschaften, die Annahme von Verwaltungseingaben und das Überprüfen der Eingaben zur Konfiguration eines Adapters. Für die ordnungsgemäße Laufzeitfunktionalität zum Austausch von Nachrichten muss die Entwurfszeitkomponente unbedingt die richtige Konfiguration der Adaptereigenschaften ermöglichen.

In diesem Abschnitt wird nur die Entwurfszeitkomponente eines Adapters erläutert. Dabei wird in erster Linie auf das Anzeigen und Festlegen der Adapterkonfiguration eingegangen. Zwei Methoden stehen für die Adapterkonfiguration zur Verfügung:

  • Eigenschaftenbrowser. Adaptereigenschaften für einen Sende- oder Empfangsport oder einen Sende- oder Empfangshandler werden über das Menü Eigenschaften mithilfe der BizTalk Server-Verwaltungskonsole konfiguriert. Während der Konfiguration dieser Elemente wird der Adapter (Transport) ausgewählt. Seine Eigenschaften werden in einem Eigenschaftenbrowser konfiguriert. Zutreffende Eigenschaften werden über ein Schema mit einem festgelegten Namen angezeigt. Für einen Sende-/Übertragungshandler sind die Eigenschaften beispielsweise in der Datei TransmitHandler.xsd enthalten, für einen Empfangsspeicherort befinden sie sich in der Datei ReceiveLocation.xsd. Der Adapter implementiert die IAdapterConfig-Schnittstelle , um das entsprechende Schema zu suchen und zu laden, um bestimmte Eigenschaften im Eigenschaftenbrowser verfügbar zu machen. Die IAdapterConfigValidation-Schnittstelle wird verwendet, um diese Einträge zu überprüfen und abschließende Änderungen an den Werten vorzunehmen, bevor die Konfigurationsdaten gespeichert werden.

  • Assistent zum Hinzufügen von Adapter-Metadaten. Im Fall von Anwendungs- und Datenbankadaptern müssen Sie möglicherweise unterstützende Schemas importieren, die Nachrichtentypen und Porttypen beschreiben, die der Adapter im BizTalk-Projekt in Visual Studio benötigt. In manchen Fällen kann auch die Notwendigkeit bestehen, vom Adapter bereitgestellte Dienste zu nutzen. Mit dem Assistenten zum Hinzufügen von Adapter-Metadaten können von einem Adapter unterstützte Dienste angezeigt und die zugeordneten Nachrichten- und Porttypen in Ihr Projekt importiert werden. Dieser Prozess wird als "Metadatengewinnung" bezeichnet. Als Adapterentwickler erstellen Sie eine XML-Datei, die diese Dienste beschreibt, und machen sie zur Entwurfszeit entweder über die IStaticAdapterConfig - oder IDynamicAdapterConfig-Schnittstelle für den Assistenten verfügbar, mit den folgenden Ergebnissen:

    • Statischer Adapter. Der Assistent stellt eine hierarchische Standardverzeichnisstruktur zur Verfügung, mit der die Dienste des Adapters angezeigt werden können. Ein statischer Adapter ist als Adapter definiert, der die vom Assistenten bereitgestellte Benutzeroberfläche mit der Standardstruktur verwendet. Verwenden Sie die Methoden IStaticAdapterConfig.GetServiceOrganization und GetServiceDescription , um das Hinzufügen ausgewählter Dienste zum BizTalk-Projekt zu ermöglichen. Dies ist die einfachste Konfigurationsoption für einen Adapterentwickler, das Anzeigeformat ist hierbei jedoch unflexibel.

    • Dynamischer Adapter. Wenn die vom Assistenten bereitgestellte Benutzeroberfläche zur Auswahl grundlegender Dienste nicht ausreichend flexibel ist bzw. Ihren Anforderungen nicht gerecht wird, kann eine benutzerdefinierte Benutzeroberfläche erstellt werden, die vom Assistenten dynamisch angezeigt wird. Verwenden Sie die IDynamicAdapterConfig.DisplayUI-Methode , um die benutzerdefinierte Benutzeroberfläche anzuzeigen, damit die Auswahl von Diensten einem BizTalk-Projekt hinzugefügt werden kann.

    Dieser Abschnitt enthält zwei Richtliniensätze zur Vorgehensweise bei der Entwurfszeitkonfiguration auf statische bzw. dynamische Weise.

    Das Microsoft BizTalk Server Software Development Kit (SDK) enthält einen Beispieldateiadapter, den Sie als Vorlage verwenden können, um Ihre eigenen Entwurfszeitkonfigurationslösungen für Adapter zu erstellen und anzupassen. Anmerkungen und Verweise zum Beispieldateiadapter sind in allen Themen zur Entwurfszeitkonfiguration enthalten, um Sie bei den Anforderungen bezüglich Ihrer eigenen benutzerdefinierten Adapterkonfiguration zu unterstützen. Zum besseren Verständnis dieser Richtlinien ist es hilfreich, den im SDK bereitgestellten Beispieldateiadapter zu installieren, erstellen und auszuführen. Weitere Informationen finden Sie unter Dateiadapter (BizTalk Server Beispiel).

In diesem Abschnitt