Tutorial 1: Migrieren von BizTalk-Projekten zum SQL-Adapter
Die vorherige Version des SQL-Adapters, der im Lieferumfang von Microsoft BizTalk Server enthalten ist, unterscheidet sich vom WCF-basierten SQL-Adapter in vielen Aspekten, einschließlich:
Die Entwurfszeiterfahrung beim Erstellen eines BizTalk-Projekts.
Die Benutzeroberfläche zum Abrufen von Metadaten.
Schemadateiname und Namespace.
Datentypzuordnungen.
Die Vorgänge, die mit dem Adapter ausgeführt werden können.
Konfiguration des physischen Ports in der BizTalk Server-Verwaltungskonsole
Diese Unterschiede werden in den Themen unter Migrieren von BizTalk-Projekten erläutert, die mit der vorherigen Version des SQLadapters erstellt wurden.
Sie können jedoch Änderungen am BizTalk-Projekt vornehmen, das mit der vorherigen Version des Adapters erstellt wurde, und dafür sorgen, dass es mit dem WCF-basierten SQL-Adapter funktioniert.
Dieses Tutorial enthält Anweisungen zu den Änderungen, die Sie an dem vorhandenen BizTalk-Projekt vornehmen sollten, das mit der vorherigen Version des Adapters erstellt wurde.
Hinweis
In diesem Tutorial wird der Einfachheit halber die vorherige Version des SQL-Adapters als vPrev SQL-Adapter bezeichnet. Entsprechend wird ein BizTalk-Projekt, das den vPrev SQL-Adapter verwendet, als vPrev BizTalk-Projekt bezeichnet.
Wichtig
In diesem Tutorial erfahren Sie, wie Sie ein BizTalk-Projekt mit vPrev SQL-Adapter migrieren, das einen einfachen Einfügevorgang für eine SQL Server Datenbanktabelle ausführt. In diesem Tutorial werden nicht alle möglichen Szenarien für die Migration vom vPrev-SQL-Adapter zum neuen WCF-basierten SQL-Adapter behandelt. Sie müssen dieses Migrationstutorial als Grundlage verwenden und entsprechend ändern, um Änderungen vorzunehmen, die für Ihr vorhandenes Projekt relevant sind.
Beispiel für das Tutorial
Dieses Tutorial basiert auf einem Beispiel (SQL_Migration), das veranschaulicht, wie ein vPrev BizTalk-Projekt migriert wird. Das Beispiel wird mit dem Microsoft BizTalk Adapter Pack bereitgestellt. Weitere Informationen finden Sie unter Beispiele.
Voraussetzungen
Sie benötigen ein vPrev BizTalk-Projekt. Dieses Tutorial umfasst ein BizTalk-Projekt, das einen Einfügevorgang für eine Customer-Tabelle in der SQL Server-Datenbank ausführt. Die Tabelle Customer hat den folgenden Entwurf:
Spaltenname Beschreibung v_custid Primärschlüssel, Ganzzahltyp, Identitätsfeld Name nchar(10)-Typ Sie benötigen eine Anforderungsmeldung, um einen Einfügevorgang für die SQL Server-Datenbank mithilfe des vPrev SQL-Adapters auszuführen. Die Anforderungsnachricht muss dem Schema des Insert-Vorgangs entsprechen, der mit dem vPrev SQL-Adapter generiert wurde.
Machen Sie sich mit dem Erstellen von BizTalk-Projekten in Visual Studio vertraut. Weitere Informationen finden Sie unter Verwenden des BizTalk-Projektsystems.
Grundlegendes zu einem BizTalk-Projekt, das mit der vorherigen Version des Adapters erstellt wurde
Die wichtigsten Bestandteile eines erstellten vPrev BizTalk-Projekts sind:
BizTalk-Orchestrierung. Dies ist eine einfache Orchestrierung, die Anforderungsnachrichten aus einem Dateispeicherort auswählt, die Anforderungsnachricht über einen WCF-Custom Sende-Empfang-Port an die SQL Server-Datenbank sendet, die Antwort empfängt und an einem anderen Dateispeicherort speichert.
Schema für den Vorgang, den Sie für die SQL Server-Datenbank ausführen möchten. Dieses Tutorial umfasst ein BizTalk-Projekt, das einen Einfügevorgang für die Tabelle Customer ausführt. Das für die Tabelle Customer generierte Schema lautet InsertCustomerService.xsd. Dieses Schema wird mithilfe des vPrev SQL-Adapters generiert.
Anforderungsnachricht. Die Anforderungsnachricht zum Ausführen eines Einfügevorgangs für die Tabelle Customer. Das Schema der Anforderungsmeldung entspricht dem Schema des Einfügevorgangs, wie in der vorherigen Version des SQL-Adapters angezeigt.
Migrieren eines BizTalk-Projekts, das mit der vorherigen Version des Adapters erstellt wurde
Das Ziel dieses Migrationstutorials besteht darin, ihnen das Senden einer Anforderungsnachricht zu ermöglichen, die dem vom vPrev SQL-Adapter generierten Schema entspricht, wobei ein WCF-Custom Port verwendet wird, der nur Nachrichten verarbeiten kann, die dem WCF-basierten SQL-Adapter entsprechen. Kurz gesagt, die Migrationsübung umfasst das Konfigurieren des WCF-Custom-Ports für die Verarbeitung von Nachrichten, die nicht dem SCHEMA des WCF-basierten SQL-Adapters entsprechen.
Um den WCF-Custom Port jedoch ordnungsgemäß konfigurieren zu können, müssen Sie die folgenden Aufgaben ausführen:
Generieren Sie Metadaten für den Insert-Vorgang in der Tabelle Customer mithilfe des WCF-basierten SQL-Adapters.
Ordnen Sie die Anforderungsnachricht zum Ausführen eines Insert-Vorgangs mithilfe des vPrev SQL-Adapters einer Anforderungsmeldung zum Ausführen eines Insert-Vorgangs mithilfe des WCF-basierten SQL-Adapters zu.
Ordnen Sie die mit dem WCF-basierten SQL-Adapter empfangene Antwortnachricht der Antwortnachricht für den vPrev SQL-Adapter zu.
Erstellen Sie einen WCF-Custom SQL-Sende-Empfangen-Port in der BizTalk Server-Verwaltungskonsole.
Konfigurieren Sie den WCF-Custom Port, um die Anforderungs- und Antwortzuordnungen zu verwenden.
In diesem Abschnitt
Schritt 1: Ändern des BizTalk-Projekts vPrev mithilfe des SQL-Adapters
Schritt 3: Testen der migrierten Anwendung, die den SQL-Adapter verwendet