Adapter

Artikel
07/21/2023

Der Austausch von Nachrichten zwischen Microsoft BizTalk Server und externen Systemen, Anwendungen und Entitäten erfolgt über Adapter. Adapter sind COM oder . NET-basierte Komponenten, die Nachrichten an und von Geschäftsendpunkten (z. B. Dateisysteme, Datenbanken und benutzerdefinierte Geschäftsanwendungen) mithilfe verschiedener Kommunikationsprotokolle übertragen.

BizTalk Server verwendet Adapter zum Austausch von Nachrichten mit externen Entitäten bei Sende- und Empfangsvorgängen.

Sendevorgänge (oder Vorgänge auf der Sendeseite) werden ausgeführt, wenn BizTalk Server mithilfe der vom Adapter unterstützten Protokolle Informationen an eine externe Entität sendet.
Empfangsvorgänge (oder Vorgänge auf der Empfangsseite) finden statt, wenn der Adapter Informationen von einer externen Entität empfängt und diese an die BizTalk Server-Messaging-Engine weitergibt.

Das Adapterframework

In der folgenden Abbildung wird gezeigt, wie ein Adapter und das Adapterframework zusammenwirken, um eine Verbindung zwischen Ihrer Anwendung und BizTalk Server herzustellen.

Über einen Empfangsspeicherort, der auf Nachrichten eines bestimmten Protokolls an einer bestimmten Adresse wartet, werden Daten empfangen. Der Empfangsspeicherort ist einem Adapter und einer Empfangspipeline zugeordnet. Sie können sowohl den Adapter als auch die Pipelinekomponenten so konfigurieren, dass für Nachrichten mit einem zuvor festgelegten Protokoll bestimmte Logik ausgeführt wird.
Nach Eingang am Empfangsspeicherort wird die Nachricht an den Adapter gesendet, der eine neue BizTalk Server-Nachricht erstellt. Der Adapter fügt den Datenstrom an die Nachricht an (in der Regel im Textteil der Nachricht), fügt Metadaten für den Endpunkt hinzu, über den die Daten empfangen wurden, und übermittelt die Nachricht dann an die Messaging-Engine.
Die Messaging-Engine sendet die Nachricht an die Empfangspipeline, wo die Daten in XML transformiert werden. Der Absender der Nachricht wird authentifiziert, die Nachricht wird entschlüsselt, und die XML wird überprüft.
Die Messaging-Engine veröffentlicht die Nachricht in der MessageBox. Die MessageBox ist eine Microsoft SQL Server-Tabelle, die Nachrichten enthält, die verarbeitet werden müssen. Sowohl Orchestrierungen als auch Sendeports können Abonnenten für die MessageBox sein.
Die Messaging-Engine sendet die Nachricht entweder an einen Orchestrierungs- oder einen Sendeportabonnenten, abhängig von den Nachrichtenkontexteigenschaften mit den Spezifikationen, die im Filter für den Abonnenten festgelegt wurden.
Wenn eine Orchestrierung der Abonnent ist, verarbeitet sie die Nachricht und sendet sie über einen Sendeport. Erhält der Sendeport die Nachricht (oder ist der einzige Abonnent), durchläuft die Nachricht die Sendepipeline und wird an einen Sendeadapter übergeben, bevor sie abgesendet wird.

Das Adapterframework

Empfangsadapter

Empfangsadapter erstellen eine neue BizTalk Server-Nachricht, indem sie den Netzwerk-/Datenquellenstrom an den Nachrichtentext anhängen. Außerdem werden dem Endpunkt, über den die Daten empfangen wurden, alle relevanten Metadaten hinzugefügt, und diese Nachricht wird dann an die Messaging-Engine übermittelt.

Der Adapter löscht die Daten aus dem Empfangsendpunkt oder sendet die entsprechende Bestätigungsnachricht an den Client, um anzuzeigen, dass die Daten von BizTalk Server akzeptiert wurden.

Sendeadapter

Send adapters are responsible for send a BizTalk message to the specified endpoint using its specific transport protocol.

Weitere Informationen zu Adaptern, zur Struktur eines Adapters und zum Schreiben benutzerdefinierter Adapter finden Sie unter Entwickeln benutzerdefinierter Adapter.

Weitere Informationen

Artefakte

Freigeben über