Partager via

Didacticiel : utilisation de l'adaptateur BizTalk pour TIBCO Rendezvous pour recevoir des données

  • Article

L'adaptateur BizTalk pour TIBCO Rendezvous permet de recevoir des données d'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

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.

À propos de l’exemple

  • Cet exemple utilise l'adaptateur BizTalk pour TIBCO Rendezvous pour recevoir des données d'un système TIBCO. Une orchestration traite le message et écrit les données dans un fichier XML situé dans un dossier spécifié à l'aide de l'adaptateur FILE.

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

    Notes

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

  • L’emplacement par défaut de l’exemple est C:\Program Files\Microsoft BizTalk Adapters for Enterprise Applications\TIBCO(r) Rendezvous(r)\Sdk\OneWayReceive, et inclut les fichiers suivants :

    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.
    PureMessage.xsd, Fichier de schéma de l'application.
    TIBCORvOWR.odx Orchestration utilisée par l'application.
    TIBCORv.snk Fichier de clé de nom fort.

Étape 1 : Ajouter l’adaptateur à BizTalk Administration

  1. Dans BizTalk Server Administration, développez BizTalk Group, Paramètres de plateforme, puis cliquez sur Adaptateurs.

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

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

  4. Sélectionnez TIBCO(r) Rendezvous(r) dans la liste des cartes disponibles dans la liste déroulante Adaptateur , puis cliquez sur OK.

Étape 2 : Créer un port de réception

  1. Dans BizTalk Server Administration, développez 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 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 TIBCORvOneWayRP, puis cliquez sur OK.

Étape 3 : Créer un emplacement de réception

  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, entrez TIBCORvOneWayRL.

  3. Sélectionnez l’adaptateur TIBCO Rendez-vous 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 dans la console d’administration BizTalk Server.

  4. Entrez une valeur pour RendezvousSubjectName sous AdapterRequiredProperties.

  5. Entrez des valeurs pour les propriétés de l’écouteur certifié :

    Propriété Valeur
    Nom du fichier de comptabilité Nom du fichier de comptabilité à utiliser pour la remise des messages certifiés persistants.
    Nom réutilisable Nom de destinataire réutilisable à utiliser pour la remise des messages certifiés. Le nom doit être unique parmi les noms de destinataires de messages certifiés sur le réseau.

  6. Entrez des valeurs pour les informations d’identification :

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

  7. Entrez les valeurs de RendezvousTransport :

    Propriété Valeur
    Daemon Paramètre Daemon du transport Rendezvous.
    Réseau Paramètre Réseau du transport Rendezvous.
    Service Paramètre Service du transport Rendezvous.

    Pour plus d’informations sur les propriétés, consultez Créer des artefacts de réception.

  8. Cliquez sur OK.

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

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

Étape 4 : Créer un port d’envoi 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 Administration BizTalk Server, BizTalk Group, Applications, BizTalk Application 1, puis cliquez sur Envoyer des ports.

  3. Cliquez avec le bouton droit sur Envoyer les ports et pointez sur Nouveau, statique One-Way port d’envoi... pour afficher la boîte de dialogue Propriétés du port d’envoi .

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

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

Étape 5 : Générer et déployer le projet

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

Étape 6 : Lier, inscrire et démarrer 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 de la console Administration BizTalk Server ou appuyez sur la touche F5 de votre clavier pour actualiser l’affichage de la console d’administration BizTalk Server.

  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
    SendPort TIBCORvOneWayFileSP
    ReceivePort TIBCORvOneWayRP

  6. Cliquez sur OK.

  7. Cliquez avec le bouton droit sur l’orchestration, puis cliquez sur Démarrer pour inscrire et démarrer l’orchestration.

Étape 7 : Confirmer que l’application reçoit un message

  • Ouvrez le dossier vers lequel le port d’envoi du fichier est configuré pour envoyer et vérifiez qu’un document de sortie a été généré.

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

  1. L'adaptateur TIBCO Rendezvous reç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 Rendezvous pour envoyer des données
Didacticiels : Utilisation de l’adaptateur Microsoft BizTalk pour TIBCO Rendezvous
Prise en main