Tutoriel : Utiliser les descripteurs de message TIBCO EMS
Vue d’ensemble
Ce didacticiel présente l'utilisation des propriétés de contexte de BizTalk Server pour définir les champs du descripteur de message de TIBCO Enterprise Message Service (EMS) dans votre orchestration. Ce didacticiel suppose que vous disposez d'une orchestration qui reçoit un message en provenance d'un port de réception et qui l'envoie vers un port d'envoi lié à l'adaptateur Microsoft BizTalk pour TIBCO Enterprise Message Service.
La procédure suivante décrit la manière de modifier la priorité du message TIBCO EMS en modifiant la valeur de la propriété de contexte TibcoEMS.Priority. Dans BizTalk Server, les messages sont immuables. Par conséquent, pour modifier une valeur de propriété, vous devez créer et modifier un nouveau message. Pour ce faire, insérez une forme Assignation de message entre les formes Réception et Envoi. Toutefois, vous devez commencer par référencer le fichier DLL du schéma pour accéder aux propriétés TIBCO EMS.
Référencer la DLL de schéma
Dans Visual Studio, ouvrez votre projet BizTalk Server, puis ouvrez Explorateur de solutions .
Cliquez avec le bouton droit sur Références, puis sélectionnez Ajouter une référence.
La boîte de dialogue Ajouter une référence s’affiche.
Cliquez sur l’onglet Parcourir .
La boîte de dialogue Sélectionner un composant s’affiche.
Recherchez <TIBCO EMS_Adapter_installation_directory>\bin, puis sélectionnez Microsoft.Adapters.TibcoEMSProperties.dll.
Cliquez sur Ouvrir.
La DLL s’affiche dans les composants sélectionnés de la boîte de dialogue Ajouter une référence .
Cliquez sur OK, puis double-cliquez sur votre orchestration pour accéder au Designer d’orchestration.
Dans le menu Affichage , pointez sur Autres fenêtres, puis cliquez sur Vue orchestration.
Dans la vue Orchestration, cliquez avec le bouton droit sur Messages , puis sélectionnez Nouveau message.
Modifiez vos nouvelles propriétés de message et affectez un type de message.
Vous allez affecter Message_1 à Message_2. Vous devez donc attribuer le même type de message aux deux messages.
Dans le menu Affichage , cliquez sur Boîte à outils.
Faites glisser une forme d’affectation de message sur votre orchestration où vous souhaitez créer un nouveau message.
Modifiez la forme de ConstructMessage_1 externe et sélectionnez votre nouveau message, Message_2, dans la propriété Messages construits .
Double-cliquez sur la forme interne MessageAssignment_1.
L'Éditeur d'expression BizTalk s'affiche.
Dans l'Éditeur d'expression BizTalk, tapez votre code.
Copiez d'abord un message existant puis affectez des valeurs aux propriétés de contexte.
La syntaxe est
Message(property) = value;. Par exemple :Message_2 = Message_1; Message_2( TibcoEMS.Priority) = 6;Pour obtenir une liste des propriétés prises en charge que vous pouvez utiliser dans vos messages personnalisés, consultez TIBCO EMS.
Cliquez sur OK pour fermer l’éditeur d’expressions BizTalk et enregistrer votre code.
Cliquez sur la forme Envoyer et affectez le message à Message_2.
Vérifiez que les formes dans le reste du flux de messages fonctionnent sur le message approprié.
Cliquez avec le bouton droit sur votre projet dans Explorateur de solutions, puis sélectionnez Générer.
Cliquez avec le bouton droit sur votre projet, puis sélectionnez Déployer.
Sélectionnez Lier, Inscrire et Démarrer dans le Explorer BizTalk pour tester votre orchestration.