Adaptateur BizTalk pour la configuration de fichiers d’hôte
Vue d’ensemble
L’adaptateur BizTalk pour les fichiers hôtes est un adaptateur d’envoi et de réception qui permet aux orchestrations BizTalk d’interagir avec les systèmes hôtes. Plus précisément, l’adaptateur permet d’envoyer et de recevoir des opérations sur des connexions TCP/IP et APPC pour héberger des fichiers qui s’exécutent sur des plateformes mainframe et IBM i. Basé sur la technologie Host Integration Server, l’adaptateur utilise les assemblys de métadonnées de la bibliothèque d’accès aux données pour configurer les connexions, et le fournisseur de données Microsoft .NET Framework pour les fichiers hôtes afin d’émettre des commandes SQL et des procédures stockées.
L’adaptateur remplit deux fonctions main :
Pour les opérations d’envoi (à la fois unidirectionnel et sollicitation de réponse), l’adaptateur envoie des commandes SQL et des commandes système à un fichier hôte instance, avec la possibilité de solliciter une réponse.
Pour les opérations de réception (unidirectionnel uniquement), l’adaptateur crée une commande SQL qui interroge les objets de fichier hôte et crée des messages par ligne, qui sont ensuite envoyés au système de messages BizTalk.
En outre, l’adaptateur BizTalk pour les fichiers hôtes utilise l’outil de suivi de l’adaptateur BizTalk standard comme mécanisme de résolution des problèmes.
Notes
L’adaptateur BizTalk pour les fichiers hôtes est un adaptateur non transactionnel. Cela signifie qu’une fois qu’une action est effectuée, elle ne peut pas être annulée ou restaurée.
Créer un assembly de métadonnées
Après avoir installé l’adaptateur, vous pouvez créer un assembly de métadonnées qui décrit votre système distant à BizTalk Server.
Une partie du processus de création d’une application de fichier hôte dans Visual Studio décrit la disposition du système de fichiers hôte. Ce processus crée à la fois un assembly de métadonnées et un schéma. L’assembly de métadonnées est une représentation programmatique du système de fichiers hôte distant, tandis que le schéma est une représentation XML du système de fichiers hôte. Vous allez utiliser l’assembly de métadonnées pour décrire le système de fichiers hôte à BizTalk Server.
Pour plus d’informations sur la création d’une application de fichier hôte dans Visual Studio, consultez Création d’une application avec le fournisseur de données managées pour les fichiers hôtes.
Créer un port d'envoi
Connectez-vous avec un compte membre du groupe BizTalk Server Administrateurs.
Dans BizTalk Server Administration, développez Groupe BizTalk, Applications, puis sélectionnez votre application.
Cliquez avec le bouton droit sur Ports d’envoi, sélectionnez Nouveau, puis Port d’envoi unidirectionnel statique ou Sollicitation du port d’envoi de réponse.
Dans Propriétés du port d’envoi, définissez le type de transport sur Fichier hôte. Sélectionnez Configurer, puis entrez les propriétés suivantes :
Propriété Pour Chaîne de connexion Nom d’un chaîne de connexion utilisé pour se connecter à la base de données du fichier hôte.
Pour configurer un chaîne de connexion nouveau ou existant, cliquez sur les points de suspension (...). L’Assistant Source de données démarre. Pour accéder à l’aide, cliquez sur Aide dans les pages de l’Assistant, ou ouvrez l’aide de Host Integration Server et recherchez l’Assistant Source de données (Fichiers hôtes).Espace de noms cible du document Espace de noms cible utilisé dans les documents XML envoyés à l’hôte. Nom de l'élément racine de la réponse Nom de l’élément racine utilisé dans les documents XML reçus de l’hôte. (Cette propriété peut être vide pour un port unidirectionnel.) URI Identificateur de ressource uniforme. Nom permettant d’identifier l’emplacement du port d’envoi. Sélectionnez OK pour enregistrer vos modifications.
Pour le gestionnaire d’envoi, sélectionnez l’hôte instance exécuter l’adaptateur, puis sélectionnez le pipeline d’envoi.
Sélectionnez OK pour enregistrer vos modifications.
Dans le volet Ports d’envoi, cliquez avec le bouton droit sur votre nouveau port d’envoi, sélectionnez Inscrire , puis Démarrer.
Créer un port de réception et un emplacement
Connectez-vous avec un compte membre du groupe BizTalk Server Administrateurs.
Dans BizTalk Server Administration, développez Groupe BizTalk, Applications, puis sélectionnez votre application.
Cliquez avec le bouton droit sur Ports de réception, sélectionnez Nouveau, puis Port de réception unidirectionnel statique. Configurez vos propriétés de port de réception, puis sélectionnez OK pour enregistrer vos modifications.
Cliquez avec le bouton droit sur Emplacements de réception, sélectionnez Nouveau, puis Sélectionnez Emplacement de réception unidirectionnel. Sélectionnez le port de réception que vous avez créé, puis OK.
Dans propriétés de l’emplacement de réception, définissez le type de transport sur HostFiles. Sélectionnez Configurer, puis entrez les propriétés suivantes :
Propriété Pour Chaîne de connexion Entrez le nom d’un chaîne de connexion qui sera utilisé pour se connecter à la base de données hôte.
Pour configurer un chaîne de connexion nouveau ou existant, cliquez sur les points de suspension (...). L’Assistant Source de données démarre. Pour accéder à l’aide, cliquez sur Aide sur les écrans de l’Assistant, ou ouvrez l’aide de Host Integration Server et recherchez l’Assistant Source de données (Fichiers hôtes).
Lors de la configuration d’un emplacement de réception ou d’un port d’envoi basé sur l’adaptateur BizTalk pour les fichiers hôtes, la définition de métadonnées doit être créée en tant que fichier de métadonnées XML Designer (HIDX) d’intégration hôte pour l’encodage et le décodage des enregistrements. Pour obtenir des instructions sur la création d’un fichier HIDX, consultez Création d’une application avec le fournisseur de données managées pour les fichiers hôtes.Nom de l'élément racine du document Nom de l’élément racine utilisé dans les documents XML reçus de l’hôte. Espace de noms cible du document Espace de noms cible utilisé dans les documents XML reçus de l’hôte. Commande SQL Commande Select exécutée une fois pour chaque intervalle d’interrogation. Update Command Commande exécutée après le traitement de chaque ligne de l’opération de réception. Il peut s’agir d’une instruction delete qui supprime la ligne de la table dans la commande SQL, ou d’une commande de mise à jour qui modifie statiquement une ou plusieurs lignes. Lorsque cette option est spécifiée, la commande SQL doit être une instruction Select et accéder à une table unique.
Vous pouvez spécifier des propriétés supplémentaires en cliquant sur le bouton de sélection (...). La boîte de dialogue Modifier la commande s’ouvre, qui fournit trois options :
- Ne rien faire efface les deux autres options si elles sont sélectionnées.
- Supprimer après lecture supprime la ligne une fois que l’adaptateur l’a lue.
- Update vous permet de taper une commande SQL à mettre à jour.URI Identificateur de ressource uniforme. Nom identifiant l’emplacement du port de réception. Intervalle d’interrogation Nombre d’unités entre les demandes d’interrogation. La plage autorisée est comprise entre 1 et 65535. Unité de mesure de l'interrogation Unité de mesure (secondes, minutes ou heures) utilisée entre les demandes d’interrogation. La valeur par défaut est secondes. Sélectionnez OK pour enregistrer vos modifications.
Pour le gestionnaire de réception, sélectionnez le instance hôte. Le gestionnaire de réception doit être exécuté sur cet hôte. Sélectionnez votre pipeline de réception.
Sélectionnez OK pour enregistrer vos modifications.
Dans emplacements de réception, cliquez avec le bouton droit sur l’emplacement de réception, puis sélectionnez Activer.
Créer un schéma
Utilisez l’Assistant Génération de schéma de fichier hôte pour créer les schémas XSD pour l’adaptateur BizTalk pour les fichiers hôtes. Après avoir créé le schéma, vous êtes prêt à poursuivre la configuration côté BizTalk Server.
Ouvrez votre projet Visual Studio BizTalk Server.
Cliquez avec le bouton droit sur le projet, sélectionnez Ajouter, Ajouter des éléments générés, puis ajouter des métadonnées d’adaptateur.
Dans l’Assistant Ajout d’adaptateur, dans la page Sélectionner l’adaptateur , sélectionnez Fichier hôte, puis Suivant.
Dans l’Assistant Génération de schéma de l’adaptateur de fichier hôte :
Dans Informations de base de données, accédez à un chaîne de connexion existant ou créez-en un.
Il peut s’agir du catalogue initial, de la collection de packages (adresse TCP et port) ou (LU locale APPC, LU distante et mode), (nom d’utilisateur et mot de passe) ou (sécurité intégrée). La longueur maximale est 1 024.
Dans Informations de schéma, définissez l’espace de noms par défaut, les éléments racine et le type de port que vous souhaitez utiliser dans le schéma.
Si vous sélectionnez Port de réception, seul un nom d’élément racine de document de demande est nécessaire. Si vous sélectionnez Envoyer le port, les noms d’éléments racine du document de requête et de réponse sont requis.
Dans Informations sur le type d’instruction, sélectionnez le type de commande de base de données à émettre.
Si vous avez sélectionné les ports d’envoi dans la page précédente, vous pouvez choisir d’émettre un code de mise à jour, une procédure stockée ou une instruction SELECT. Si vous avez sélectionné des ports de réception, cette étape n’est pas nécessaire.
Dans Informations sur l’instruction, entrez les détails du fichier hôte. Selon les informations que vous avez entrées précédemment dans les pages précédentes, entrez les propriétés suivantes. Si vous avez sélectionné le port d’envoi :
Envoyer le code de mise à jour Si vous avez choisi d’utiliser un port d’envoi et des codes de mise à jour, vous pouvez sélectionner l’opération de mise à jour ici, ainsi que la table et les colonnes qui seront présentes dans le code de mise à jour.
Envoyer la commande système Si vous avez choisi d’utiliser un port d’envoi et d’émettre une procédure stockée, vous pouvez sélectionner une procédure stockée dans le catalogue de la connexion actuelle. Vous n’avez pas besoin d’entrer des valeurs pour tous les paramètres de cette page.
Envoyer l’instruction Select Si vous avez choisi d’utiliser un port d’envoi avec une instruction SQL Select, vous pouvez sélectionner ou accéder à l’instruction ici.
Si vous avez sélectionné le port de réception :
Recevoir l’instruction Select Si vous avez choisi d’utiliser un port de réception avec une instruction SQL, vous pouvez sélectionner ou accéder à l’instruction ici.
Envoyer le code de mise à jour Si vous avez choisi d’utiliser un port d’envoi et des codes de mise à jour, vous pouvez sélectionner l’opération de mise à jour ici, ainsi que la table et les colonnes qui seront présentes dans le code de mise à jour.
Envoyer une procédure stockée Si vous avez choisi d’utiliser un port d’envoi et d’émettre une procédure stockée, vous pouvez sélectionner une procédure stockée dans le catalogue de la connexion actuelle. Vous n’avez pas besoin d’entrer des valeurs pour tous les paramètres de cette page.
Envoyer l’instruction Select Si vous avez choisi d’utiliser un port d’envoi avec une instruction SQL Select, vous pouvez sélectionner ou accéder à l’instruction ici.
Sélectionnez Terminer lorsque vous avez terminé.
Créer une application BizTalk
Après avoir créé le schéma, vous pouvez coder votre application BizTalk. Votre application utilise l’assembly de métadonnées que vous avez créé dans Visual Studio, en plus du schéma et des ports que vous avez créés.
Créez un projet BizTalk dans Visual Studio.
Utilisez le schéma que vous avez créé pour décrire le système de fichiers hôte à l’application BizTalk.
Utilisez le port d’envoi que vous avez créé pour envoyer des données au système de fichiers hôte.
Si nécessaire, utilisez le port de réception et l’emplacement que vous avez créés.
Ajoutez des orchestrations, des composants ou du code supplémentaires, si nécessaire.
Testez votre application.
Une fois que vous avez terminé le test de votre application, créez un package .msi pour déplacer votre application vers un serveur intermédiaire ou actif. Lorsque vous créez un package BizTalk Server .msi, veillez à inclure l’assembly de métadonnées de fichier hôte que vous avez créé.