Auf Englisch lesen

Freigeben über


Adapterkomponenten

Für einen benutzerdefinierten Adapter werden die gleichen standardisierten Mechanismen zur Konfiguration, Verwaltung und Einrichtung verwendet wie für systemeigene Adapter. Mit der Standardisierung für das Adapterframework wird ein benutzerdefinierter Adapter mithilfe der BizTalk Server-Verwaltungskonsole verwaltet.

Die folgende Abbildung zeigt die Standard Komponenten eines benutzerdefinierten Adapters: die Adapterregistrierungsdatei, die Entwurfszeitkomponente des Adapters und die Laufzeitkomponente des Adapters.

Abbildung, die die Standard Komponenten eines benutzerdefinierten Adapters zeigt.

Registrierungsdatei des Adapters

Bestimmte Informationen über Adapter müssen in der Registrierung und in der BizTalk-Verwaltungsdatenbank registriert werden. Informationen wie der Alias eines Adapters, Empfangshandler, Empfangsspeicherort und Transporttyp werden als Metadaten bezeichnet. Diese Metadateneinträge werden während der manuellen Adapterregistrierung mithilfe der BizTalk Server Verwaltungskonsole erstellt. Wahlweise können Sie auch das SDK-Hilfsprogramm Adapterregistrierungs-Assistent (AdapterRegistryWizard.exe) verwenden, um eine Registrierungsdatei für Ihren benutzerdefinierten Adapter zu generieren. Wenn Sie mit dem Registrierungs-Editor (regedit32.exe) auf diese Registrierungsdatei doppelklicken oder im Menü Datei auf Importieren klicken, werden die Metadaten in die Registrierung geschrieben.

Hinweis

Beim Ausführen dieser Registrierungsdatei werden keine Adapterinformationen zur BizTalk-Verwaltungsdatenbank hinzugefügt. Hierzu müssen Sie die BizTalk Server-Verwaltungskonsole manuell verwenden.

Entwurfszeitkomponente

Die Benutzeroberfläche für einen benutzerdefinierten Adapter wird mithilfe des Adapterframeworks implementiert. Hierbei handelt es sich um einen produktiven Ansatz zur Entwicklung von Benutzeroberflächen, da die Benutzeroberfläche aus einem XML-Schema generiert wird, das als Teil der Assembly des Adapters bereitgestellt wird. Eine geringe Menge an Code ist erforderlich, um die Inhalte des Schemas in eine Benutzeroberfläche zu transformieren, mit der die Eigenschaften des Adapters konfiguriert werden können.

Für Orchestrierungen, die mit einem Anwendungsadapter wie dem SQL-Adapter kommunizieren müssen, können Sie Adapter-Metadaten wie Schemas, Nachrichtentypen und Porttypen mithilfe des Assistenten zum Hinzufügen von Adapter-Metadaten einem BizTalk-Projekt hinzufügen. Verwenden Sie den Assistenten zum Hinzufügen von Adapter-Metadaten für Anwendungsadapter, um zugehörige Schemas in das System einzubinden. Um diesen Assistenten in einem BizTalk-Projekt (ohne Adapter) aufzurufen, klicken Sie mit der rechten Maustaste auf das Projekt, zeigen Sie auf Generierte Elemente hinzufügen, klicken Sie auf Adaptermetadaten hinzufügen , und wählen Sie dann aus der Liste der registrierten Adapter aus, um die Adaptermetadaten zu importieren.

Run-Time-Komponente

In der Regel besteht ein Adapter aus zwei öffentlichen Laufzeitkomponenten: der Komponente, die den Nachrichtenempfänger implementiert, und der Komponente, die den Nachrichtensender implementiert. Diese Komponenten können in der gleichen Assembly oder in zwei verschiedenen Assemblys bereitgestellt werden.

Empfangsadapter

Empfangsadapter erstellen eine neue BizTalk-Nachricht, indem sie den Netzwerk-/Datenquellenstrom an den Nachrichtentext anhängen. Außerdem fügen sie Metadaten für den Endpunkt hinzu, über den die Daten empfangen wurden, und übermitteln diese Nachricht dann an die Messaging-Engine. Der Adapter löscht die Daten vom Empfangsendpunkt oder sendet die entsprechende Bestätigungsmeldung an den Client, die angibt, dass die Daten in BizTalk Server akzeptiert wurden.

Sendeadapter

Sendeadapter senden eine BizTalk-Nachricht mithilfe des entsprechenden Transportprotokolls an den angegebenen Endpunkt.

Weitere Informationen

Was ist das Adapterframework?