Partager via

Didacticiel : utilisation de l'adaptateur BizTalk pour TIBCO Enterprise Message Service pour la réception de données

  • Article

L'adaptateur BizTalk pour TIBCO Enterprise Message Service (EMS) permet de recevoir des données depuis un système TIBCO. Cette procédure pas à pas décrit un exemple de KIT de développement logiciel (SDK) qui illustre cela.

Prérequis

  • L'adaptateur BizTalk pour TIBCO Enterprise Message Service requiert l'ajout de l'API TIBCO EMS C# et du fichier TIBCO.EMS.dll au GAC (Global Assembly Cache). Pour plus d’informations sur l’installation de l’assembly, consultez TibCO Enterprise Message Service Requirements and Limitations.

  • Installez Visual Studio sur le BizTalk Server sur lequel l’adaptateur s’exécute afin de générer et de déployer l’exemple.

Fonctions de l'exemple

Cet exemple récupère un fichier XML dans un dossier, le transmet à une orchestration, puis utilise l'adaptateur BizTalk pour TIBCO Enterprise Message Service pour récupérer des données d'un système TIBCO. Le résultat est écrit dans un fichier XML.

Comment cet exemple est conçu et pourquoi

Cet exemple, conçu dans Visual Studio, illustre les fonctionnalités de base de l’adaptateur BizTalk pour TIBCO Enterprise Message Service avec une orchestration BizTalk.

Notes

Cet exemple part du principe que vous savez envoyer un message de TIBCO pour son traitement par l'application.

Accès à l'exemple

L'emplacement par défaut de l'exemple est

C:\Program Files\Microsoft BizTalk Adapters for Enterprise Applications\TIBCO(r) Enterprise Message Service(TM)\Sdk\OneWayReceive

Le tableau suivant présente les fichiers de cet exemple et décrit leur fonction.

Nom du fichier de projet au moment de l'exécution Description du fichier de projet au moment de l'exécution
OneWayReceive.btproj,

OneWayReceive.sln		 Fichiers de projet et de solution de l'application.
Schema.xsd, Fichier de schéma de l'application.
Orchestration.odx Orchestration utilisée par l'application.
TIBCOEMSOneWaySend.snk Fichier de clé de nom fort.

Guide pratique pour utiliser cet exemple

Pour créer une instance de l'adaptateur BizTalk pour TIBCO EMS

  1. Lancez la console Administration BizTalk Server. Cliquez sur Démarrer, Programmes, MicrosoftBizTalk Server, BizTalk Server Administration.

  2. Dans la console Administration BizTalk Server, développez BizTalk Server Administration, Groupe BizTalk, Paramètres de plateforme, puis cliquez sur Adaptateurs.

  3. Cliquez avec le bouton droit sur Adaptateurs et pointez sur Nouveau, Adaptateur pour afficher la boîte de dialogue Propriétés de l’adaptateur .

  4. Entrez une valeur pour le champ Nom , par exemple TIBCO EMS.

  5. Sélectionnez TIBCO Enterprise Message System dans la liste des adaptateurs disponibles dans la liste déroulante Adaptateur , puis cliquez sur OK.

Pour créer un port de réception BizTalk

  1. Dans la console Administration BizTalk Server, développez BizTalk Server Administration, Groupe BizTalk, Applications, BizTalk Application 1, puis cliquez sur Ports de réception.

  2. Cliquez avec le bouton droit sur le dossier Ports de réception, puis cliquez sur Nouveau port de réception unidirectionnel pour afficher la boîte de dialogue Propriétés du port de réception.

  3. Entrez une valeur pour le champ Nom , par exemple TIBCOEMSOneWayRP, puis cliquez sur OK.

Pour créer un emplacement de réception BizTalk

  1. Cliquez avec le bouton droit sur le nouveau port de réception, puis cliquez sur Nouveau, Emplacement de réception pour afficher la boîte de dialogue Propriétés de l’emplacement de réception.

  2. Entrez une valeur pour le champ Nom , par exemple TIBCOEMSOneWayRL.

  3. Sélectionnez l’adaptateur TIBCO EMS dans la liste des adaptateurs disponibles dans la zone déroulante Type , puis cliquez sur le bouton Configurer pour afficher la boîte de dialogue Propriétés de transport de l’adaptateur.

    Notes

    Cette valeur est le nom qui a été spécifié lors de la création de l’adaptateur TIBCO dans la console d’administration BizTalk Server.

  4. Entrez les valeurs pour la définition de connexion au serveur :

    Propriété Valeur
    Destination File d'attente de destination ou nom de la rubrique du serveur.
    Numéro de port Port sur lequel le serveur TIBCO écoute. La valeur par défaut est 7222.
    Nom du serveur Nom du serveur TIBCO EMS.

  5. Entrez des valeurs pour les informations d’identification de l’utilisateur :

    Propriété Valeur
    Mot de passe Mot de passe pour le serveur TIBCO EMS.
    Nom d’utilisateur Nom d'utilisateur pour le serveur TIBCO EMS.

    Pour plus d’informations sur les propriétés, consultez Création de gestionnaires de réception TIBCO Enterprise Message Service.

  6. Cliquez sur OK.

  7. Sélectionnez XMLReceive dans la liste des pipelines disponibles dans la zone de liste déroulante Recevoir le pipeline , puis cliquez sur OK.

  8. Cliquez avec le bouton droit sur l’emplacement de réception, puis cliquez sur Activer.

Pour créer un port d'envoi de fichier unidirectionnel

  1. Créez un dossier cible destiné à l'usage du port d'envoi (par exemple, C:\FilesOut).

  2. Dans la console Administration BizTalk Server, développez BizTalk Server Administration, Groupe BizTalk, Applications, Application BizTalk 1, puis cliquez sur Envoyer des ports.

  3. Cliquez avec le bouton droit sur Ports d’envoi et pointez sur Nouveau port d’envoi unidirectionnel statique pour afficher la boîte de dialogue Propriétés du port d’envoi .

  4. Entrez une valeur pour le champ Nom , par exemple TIBCOEMSOneWayFileSP.

  5. Sélectionnez FICHIER dans la liste des adaptateurs disponibles dans la zone de liste déroulante Type , puis cliquez sur le bouton Configurer pour afficher la boîte de dialogue Propriétés de transport de l’adaptateur.

  6. Pour la propriété Dossier de destination , entrez l’emplacement du dossier que vous avez créé précédemment, puis cliquez sur OK.

  7. Sélectionnez le pipeline XMLTransmit dans la liste des pipelines disponibles dans la liste déroulante Envoyer le pipeline , puis cliquez sur OK.

  8. Cliquez avec le bouton droit sur le port d’envoi, puis cliquez sur Démarrer pour inscrire et démarrer le port d’envoi.

création et déploiement du projet ;

  1. Cliquez avec le bouton droit sur le projet OneWayReceive dans Explorateur de solutions, puis cliquez sur Propriétés pour lancer la Designer du projet.

  2. Cliquez sur l’onglet Déploiement .

  3. Entrez les valeurs appropriées pour la propriété Server et la propriété Base de données de configuration sous la catégorie Groupe BizTalk .

  4. Cliquez avec le bouton droit sur le projet OneWayReceive dans Explorateur de solutions, puis cliquez sur Déployer pour générer le projet et déployer l’assembly dans la base de données de configuration BizTalk Server.

Pour lier et inscrire l'orchestration

  1. Dans la console Administration BizTalk Server, développez BizTalk Server Administration, Groupe BizTalk, Applications, Application BizTalk 1, puis cliquez sur Orchestrations.

  2. Cliquez sur le bouton Actualiser dans la barre d’outils BizTalk Server console Administration ou appuyez sur la touche F5 de votre clavier pour actualiser l’affichage BizTalk Server console Administration.

  3. Double-cliquez sur l’orchestration pour afficher la boîte de dialogue Propriétés de l’orchestration .

  4. Cliquez sur Liaisons dans le volet gauche de la boîte de dialogue pour afficher les options Liaisons pour l’orchestration.

  5. Spécifiez les valeurs appropriées pour les options de liaison, par exemple :

    Paramètre Valeur
    Host BizTalkServerApplication
    FileSendPort TIBCOEMSOneWayFileSP
    TibcoEMSOneWayReceiveOperation TIBCOEMSOneWayRP

  6. Cliquez sur OK.

Démarrer l'orchestration

  • Dans la console Administration BizTalk Server, cliquez avec le bouton droit sur l’orchestration, puis cliquez sur Démarrer pour inscrire et démarrer l’orchestration.

Pour vérifier que l'application a reçu un message

  • Ouvrez le dossier utilisé par le port d'envoi du fichier et vérifiez qu'un document de sortie a été généré. Ce fichier doit contenir les résultats de la requête traitée par l'adaptateur BizTalk pour TIBCO Enterprise Message Service.

    La séquence suivante d'événements se produit si l'instance de document est traitée avec succès :

  1. L'adaptateur TIBCO EMSreçoit un message du système TIBCO et le publie dans la base de données MessageBox en tant que message BizTalk.

  2. L’orchestration s’abonne à ce message publié afin que le moteur de messagerie BizTalk active une instance de l’orchestration et envoie le message à l’instance d’orchestration.

  3. L'instance d'orchestration republie le message dans la base de données MessageBox.

  4. Le port d'envoi du fichier s'abonne à ce message et BizTalk envoie le message à l'adaptateur FILE.

  5. L'adaptateur FILE écrit le message contenant l'ensemble des résultats dans le dossier de sortie désigné.

Voir aussi

Didacticiel : utilisation de l'adaptateur BizTalk pour TIBCO Enterprise Message Service pour l'envoi de données
Didacticiels : Utilisation de l’adaptateur Microsoft BizTalk pour TIBCO Enterprise Message Service
Prise en main