Partager via

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

  • Article

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

  • L'exemple utilise une DLL contenant des propriétés de contexte de message : Microsoft.BizTalk.Adapters.TibRV.Properties.dll. Vous devrez mettre la référence de solution à jour en fonction de cette bibliothèque. Pour plus d’informations, consultez propriétés du contexte de message BizTalk Server (gestionnaires d’envoi).

À propos 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 Rendezvous pour créer un enregistrement dans le système TIBCO.

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

  • L’emplacement par défaut de l’exemple est C:\Program Files\Microsoft BizTalk Adapters for Enterprise Applications\TIBCO(r) Rendezvous(r)\Sdk\OneWaySend, 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
    OneWaySend.btproj

    OneWaySend.sln    		 Fichiers de projet et de solution de l'application.
    Schema.xsd

    PropertySchema.xsd    		 Fichiers de schéma et fichiers de schéma de propriété pour l'application.
    Orchestration.odx Orchestration utilisée par l'application.
    TIBCORendezvousOneWaySend.snk Fichier de clé de nom fort.

Étape 1 : Ajouter l’adaptateur à l’administration BizTalk

  1. Dans BizTalk Server Administration, développez Groupe BizTalk, 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, entrez TIBCO Rendezvous.

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

Étape 2 : Créer un port d’envoi

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

  2. Cliquez avec le bouton droit sur Send Ports et pointez sur Nouveau, Static One-Way Send Port... pour afficher la boîte de dialogue Propriétés du port d’envoi .

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

  4. Sélectionnez l’adaptateur TIBCO Rendezvous 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.

    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 les propriétés de l’expéditeur 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 les artefacts d’envoi.

  8. Cliquez sur OK.

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

  10. 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 3 : Créer un port de réception

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

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

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

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

  5. Entrez l’emplacement du dossier que vous avez créé précédemment pour la propriété Receive Folder et 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.

Étape 5 : Générer un document instance à partir du schéma

  1. Dans Visual Studio, 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 section 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 et 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é.

Étape 6 : Mettre à jour le document généré instance

  1. Ouvrez le document généré instance dans un éditeur de texte (le Bloc-notes fonctionne) et modifiez le contenu du document instance pour vous assurer que les données généreront un enregistrement unique dans le système TIBCO. Par exemple, le code suivant montre la première partie du fichier de données :

    <ns0:Root xmlns:ns0="http://TibcoRendezvousOneWaySend.TibcoRendezvousOneWaySendSchema">  
    <Name>Punya Palit</Name>  
    <MailAddress>Prose Ware, Inc.</MailAddress>  
</ns0:Root>

  2. Enregistrez l'instance de document modifiée.

Étape 7 : Générer et déployer le 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 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.

Étape 8 : Lier, inscrire et démarrer l’orchestration

  1. Dans BizTalk Server Administration, développez Groupe BizTalk, 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 TIBCORndOneWayFileRP
    TibcoRendezvousSend TIBCORndOneWaySP

  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 9 : Supprimer un document et case activée le système TIBCO

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

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

  6. L'adaptateur BizTalk pour TIBCO Rendezvous envoie le message au système TIBCO.

Voir aussi

Didacticiel : Utiliser l’adaptateur BizTalk pour TIBCO Rendezvous pour la réception de données
Didacticiels : Utilisation de l’adaptateur Microsoft BizTalk pour TIBCO Rendezvous
Prise en main