Tutoriel 1 : Migrer des projets BizTalk vers l’adaptateur SQL
La version précédente de l’adaptateur SQL fourni avec Microsoft BizTalk Server diffère de l’adaptateur SQL basé sur WCF sous de nombreux aspects, notamment :
Expérience au moment de la conception de la création d’un projet BizTalk.
Expérience de récupération des métadonnées.
Nom et espace de noms du fichier de schéma.
Mappages de types de données.
Opérations qui peuvent être effectuées à l’aide de l’adaptateur.
Configuration du port physique dans la console Administration BizTalk Server
Ces différences sont expliquées dans les rubriques de migration de projets BizTalk créés à l’aide de la version précédente de SQLadapter.
Toutefois, vous pouvez apporter des modifications au projet BizTalk qui a été créé à l’aide de la version précédente de l’adaptateur et le faire fonctionner avec l’adaptateur SQL wcf.
Ce didacticiel fournit des instructions sur les modifications que vous devez apporter au projet BizTalk existant créé à l’aide de la version précédente de l’adaptateur.
Notes
Dans ce didacticiel, par souci de concision, la version précédente de l’adaptateur SQL sera appelée adaptateur SQL vPrev. De même, un projet BizTalk qui utilise l’adaptateur SQL vPrev sera appelé projet BizTalk vPrev.
Important
Ce tutoriel fournit des conseils sur la migration d’un projet BizTalk d’adaptateur SQL vPrev qui effectue une opération d’insertion de base sur une table de base de données SQL Server. Ce tutoriel ne couvre pas tous les scénarios possibles de migration de l’adaptateur SQL vPrev vers la nouvelle carte SQL basée sur WCF. Vous devez utiliser ce tutoriel de migration comme base et modifier en conséquence pour apporter des modifications pertinentes à votre projet existant.
Exemple utilisé pour le tutoriel
Ce didacticiel est basé sur un exemple (SQL_Migration) qui montre comment migrer un projet BizTalk vPrev. L’exemple est fourni avec Microsoft BizTalk Adapter Pack. Pour plus d’informations, consultez Exemples.
Prérequis
Vous devez disposer d’un projet BizTalk vPrev. Ce tutoriel implique un projet BizTalk qui effectue une opération d’insertion sur une table Customer dans la base de données SQL Server. La table Customer a la conception suivante :
Nom de la colonne Description v_custid Clé primaire, type entier, champ identité Nom type nchar(10) Vous devez disposer d’un message de demande pour effectuer une opération d’insertion sur la base de données SQL Server à l’aide de l’adaptateur SQL vPrev. Le message de demande doit être conforme au schéma de l’opération Insérer générée à l’aide de l’adaptateur SQL vPrev.
Familiarisez-vous avec la création de projets BizTalk dans Visual Studio. Pour plus d’informations, consultez Utilisation du système de projet BizTalk.
Présentation d’un projet BizTalk créé à l’aide de la version précédente de l’adaptateur
Les composants clés d’un projet BizTalk vPrev créé sont les suivants :
Orchestration BizTalk. Il s’agit d’une orchestration simple qui sélectionne les messages de requête à partir d’un emplacement de fichier, envoie le message de demande à la base de données SQL Server à l’aide d’un port d’envoi-réception WCF-Custom, reçoit la réponse et l’enregistre dans un autre emplacement de fichier.
Schéma de l’opération que vous souhaitez effectuer sur la base de données SQL Server. Ce tutoriel implique un projet BizTalk qui effectue une opération d’insertion sur la table Customer. Le schéma généré pour la table Customer est InsertCustomerService.xsd. Ce schéma est généré à l’aide de l’adaptateur SQL vPrev.
Message de demande. Message de demande d’effectuer une opération d’insertion sur la table Customer. Le schéma du message de demande est conforme au schéma de l’opération Insertion tel qu’il a été mis en évidence par la version précédente de l’adaptateur SQL.
Comment migrer un projet BizTalk créé à l’aide de la version précédente de l’adaptateur
L’objectif de ce tutoriel de migration est de vous permettre d’envoyer un message de demande conforme au schéma généré par l’adaptateur SQL vPrev, à l’aide d’un port WCF-Custom qui peut traiter uniquement les messages conformes à l’adaptateur SQL wcf. Par conséquent, en bref, l’exercice de migration implique la configuration du port WCF-Custom pour traiter les messages qui ne sont pas conformes au schéma de l’adaptateur SQL basé sur WCF.
Toutefois, pour pouvoir configurer le port WCF-Custom de manière appropriée, vous devez effectuer les tâches suivantes :
Générez des métadonnées pour l’opération Insertion dans la table Customer à l’aide de l’adaptateur SQL wcf.
Mapper le message de requête pour effectuer une opération d’insertion à l’aide de l’adaptateur SQL vPrev à un message de demande pour effectuer une opération d’insertion à l’aide de l’adaptateur SQL wcf.
Mapper le message de réponse reçu à l’aide de l’adaptateur SQL basé sur WCF au message de réponse de l’adaptateur SQL vPrev.
Créez un port d’envoi-réception SQL WCF-Custom dans la console Administration BizTalk Server.
Configurez le port WCF-Custom pour utiliser les mappages de requête et de réponse.
Dans cette section
Étape 1 : Modifier le projet BizTalk vPrev à l’aide de l’adaptateur SQL
Étape 3 : Tester l’application migrée qui utilise l’adaptateur SQL