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

L'adaptateur BizTalk pour TIBCO Enterprise Message Service (EMS) permet d'envoyer des données à 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 EMS 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 créer un enregistrement dans le système TIBCO.

Comment cet exemple est conçu et pourquoi

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

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\OneWaySend

Le tableau suivant répertorie et décrit les fichiers de l'exemple.

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

OneWaySend.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.

Comment 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, Tous les programmes, MicrosoftBizTalk Server, BizTalk Server Administration.

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

  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 cartes disponibles dans la liste déroulante Adaptateur , puis cliquez sur OK.

Pour créer un port d'envoi BizTalk

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

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

  3. Entrez une valeur pour le champ Nom , par exemple TIBCOEMSOneWaySP.

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

    Notes

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

  5. Entrez des valeurs pour la définition de connexion de 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.
  6. 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 d’envoi TIBCO Enterprise Message Service.

  7. Cliquez sur OK.

  8. Sélectionnez le pipeline de transmission XML dans la liste des pipelines disponibles dans la liste déroulante Envoyer le pipeline , puis cliquez sur OK.

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

Pour créer un port de réception du fichier

  1. Dans la console Administration BizTalk Server, développez BizTalk Server Administration, BizTalk Group, 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 Nouveauport 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 TIBCOEMSOneWayFileRP, puis cliquez sur OK.

Pour créer un emplacement de réception du fichier

  1. Créez un dossier correspondant à l'emplacement de réception du fichier à analyser (par exemple, C:\Filesource).

  2. 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 .

  3. Entrez une valeur pour le champ Nom , par exemple TIBCOEMSOneWayFileRL.

  4. 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 du transport de l’adaptateur.

  5. Entrez l’emplacement du dossier que vous avez créé précédemment pour la propriété Dossier de réception , puis cliquez sur OK.

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

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

Pour générer une instance de document à partir du schéma de l'adaptateur

  1. Cliquez avec le bouton droit sur Schema.xsd dans Explorateur de solutions, puis cliquez sur Propriétés.

  2. Dans le Fenêtre Propriétés, cliquez pour sélectionner l’option Nom de fichier de l’instance de sortie sous la catégorie Général.

  3. Cliquez sur le bouton de sélection (...) pour afficher la boîte de dialogue Sélectionner un fichier de sortie .

  4. Spécifiez un dossier et un nom pour le fichier de sortie instance, par exemple C:\instance.xml, puis cliquez sur Enregistrer.

    Notes

    Ne spécifiez pas l'emplacement de dossier spécifié pour l'emplacement de réception du fichier dans ce champ.

  5. Cliquez avec le bouton droit sur Schema.xsd dans Explorateur de solutions, puis cliquez sur Générer une instance pour générer un document instance à l’emplacement spécifié.

Pour modifier l'instance de document générée

  1. Ouvrez l'instance de document générée dans un éditeur de texte tel que le Bloc-notes et modifiez-en le contenu de telle sorte que les données génèrent un enregistrement unique dans le système TIBCO. Par exemple, le code suivant illustre la première partie du fichier de données :

    <ns0:Root xmlns:ns0="http://TibcoEMSOne_WaySend.TibcoEMSOneWaySendSchema">  
      <Name>Punya Palit</Name>  
      <MailAddress>Prose Ware, Inc.</MailAddress>  
    </ns0:Root>  
    
  2. Enregistrez l'instance de document modifiée.

création et déploiement du projet ;

  1. Cliquez avec le bouton droit sur le projet OneWaySend dans Explorateur de solutions, puis cliquez sur Propriétés pour lancer le Designer de projet pour le 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 OneWaySend 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, BizTalk Group, Applications, BizTalk Application 1, puis cliquez sur Orchestrations.

  2. Cliquez sur le bouton Actualiser dans la barre d’outils MMC 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
    FileReceivePort TIBCOEMSOneWayFileRP
    TibcoEMSOneWaySendPort TIBCOEMSOneWaySP
  6. Cliquez sur OK.

Démarrer l'orchestration

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

Pour placer une instance de document dans le dossier surveillé par l'emplacement de réception du fichier

  • Copiez l'instance de document créée précédemment dans le dossier correspondant à l'emplacement de réception du fichier surveillé par l'application.

Pour vérifier la mise à jour du système TIBCO

  • Utilisez l'interface Web TIBCO pour vérifier que l'enregistrement a été créé à partir des données du fichier XML.

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

  1. L'adaptateur FILE récupère le fichier dans le dossier et le publie dans la base de données MessageBox comme message BizTalk.

  2. L'orchestration s'abonne à ce message publié et le moteur de messagerie BizTalk active une instance de l'orchestration avant d'envoyer le message à l'instance d'orchestration.

  3. L'instance d'orchestration traite le message à l'aide de la logique spécifiée dans l'orchestration, puis republie le message dans la base de données MessageBox.

  4. Le port d'envoi TIBCO s'abonne à ce message publié et le moteur de messagerie BizTalk envoie le message au port d'envoi TIBCO.

  5. Le port d'envoi remet le message à l'adaptateur BizTalk pour TIBCO Enterprise Message Service.

  6. L'adaptateur BizTalk pour TIBCO Enterprise Message Service envoie le message au système TIBCO.

Voir aussi

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