Partager via


Créer des artefacts TIBCO Rendezvous Receive

La création de notifications ou d’événements est similaire à la création d’autres appels dans BizTalk Server. Cette section décrit la création d'un emplacement de réception pour écouter les messages TIBCO Rendezvous.

Événements et emplacements de réception

Un système TIBCO Rendezvous peut envoyer des messages vers le nom d'objet de son choix. Le concept d’événement est la génération de messages par d’autres programmes TIBCO Rendezvous.

Les étapes suivantes décrivent le cycle de vie d'un emplacement de réception :

  1. création d'un emplacement de réception ;

  2. association de l'emplacement de réception à un hôte ;

  3. liaison de l'emplacement de réception à une orchestration ;

  4. activation de l'emplacement de réception ;

  5. réception de messages sur l'emplacement de réception.

Important

Le nom de chaque emplacement de réception doit être unique. Deux emplacements de réception ne peuvent pas avoir le même nom dans le même déploiement BizTalk Server.

Important

Il est recommandé de définir des listes de contrôle d'accès renforcées dans l'emplacement de dépôt des emplacements de réception. Par exemple, vous devez définir des listes de contrôle d'accès renforcées pour le répertoire dans lequel l'emplacement de réception des fichiers sélectionne des messages, afin que seuls les utilisateurs autorisés puissent déposer des messages dans cet emplacement.

Créer un port de réception

  1. Dans BizTalk Server Administration, développez Groupe BizTalk, Applications, puis développez votre application.

  2. Cliquez avec le bouton droit sur Ports de réception, pointez sur Nouveau, puis cliquez sur Ports de réception unidirectionnel.

  3. Dans la fenêtre Propriétés du port de réception, dans la page Général , procédez comme suit :

    1. Dans le champ Nom , tapez ReceiveFromTIBCORV.

    2. Dans la zone Groupe d’authentification , spécifiez comment les messages sont gérés lors de l’utilisation de l’authentification.

    3. Cochez la case Activer le routage pour les messages ayant échoué .

  4. Dans la page Emplacements de réception , procédez comme suit :

    1. Cliquez sur Nouveau.

    2. Dans la fenêtre Emplacements de réception, dans la page Général , tapez le Nom de l’emplacement de réception.

    3. Dans la liste déroulante Type , sélectionnez BizTalkServerIsolatedHost, puis, dans la liste déroulante Gestionnaire de réception, sélectionnez l’adresse de transport.

    4. Dans la liste déroulante Recevoir le pipeline , sélectionnez XMLReceive ou un pipeline équivalent.

    5. Dans la page Planification , sélectionnez la date de début et la date de fin pour restreindre la réception des documents.

    6. Cochez la case Activer la fenêtre de service .

    7. Cliquez sur OK.

  5. Dans la page Cartes entrantes , sélectionnez les mappages entrants pour la transformation des documents sur le port sélectionné.

  6. Dans la page Suivi , sélectionnez les corps de message de suivi souhaités et les propriétés de message de suivi.

  7. Cliquez sur OK.

Définir les propriétés de transport

Lorsque vous configurez l'adaptateur Microsoft BizTalk pour TIBCO Rendezvous pour écouter les messages, vous spécifiez les noms d'objet à écouter. Il s'agit de la seule propriété requise.

  1. Dans la boîte de dialogue Propriétés du transport tibco rendez-vous, développez Propriétés requises de l’adaptateur, entrez le nom de l’objet du rendez-vous.

    Il s'agit du nom de l'objet (les caractères génériques de Rendezvous sont autorisés) que l'adaptateur écoute. Dans le scénario de déploiement le plus simple, ceci est la seule propriété requise.

    Image montrant la boîte de dialogue Propriétés requises de l’adaptateur.

  2. Dans les paramètres de l’écouteur certifié, indiquez le nom réutilisable et le nom du fichier de registre si vous souhaitez une messagerie certifiée.

    Ce champ est obligatoire si vous définissez une file d'attente distribuée. Si une messagerie certifiée n'est pas nécessaire, laissez ces entrées vides. Le nom du fichier de comptabilité et le nom réutilisable doivent être uniques parmi tous les ports définis sur cet hôte et les autres programmes TIBCO Rendezvous s'exécutant sur cet hôte. Si tel n'est pas le cas, l'interface utilisateur ne le détecte pas mais une erreur est interceptée et consignée au moment de l'exécution.

  3. Dans les paramètres de file d’attente distribuée, si la file d’attente distribuée n’est pas requise, ne modifiez pas les entrées.

    Les valeurs suivantes sont utilisées avec un groupe BizTalk Server. L'adaptateur BizTalk pour TIBCO Rendezvous utilise ces valeurs dans les appels d'API à TIBCO RV.

    Propriété Pour
    Nom du fichier de comptabilité Nom du fichier de comptabilité de l'écouteur certifié (ou du membre du groupe). La valeur par défaut est Null.

    Si aucune valeur n'est spécifiée, un fichier de comptabilité en mémoire est utilisé.
    Nom réutilisable Nom réutilisable de l'écouteur certifié (ou du membre du groupe). La valeur par défaut est Null.

    Un nom réutilisable est requis pour garantir un processus en cours de redémarrage. Si aucune valeur n'est spécifiée, un nom (non réutilisable) généré est utilisé.

    Les files d'attente distribuées sont utiles en cas de déploiement d'un emplacement de réception TIBCO Rendezvous dans un groupe BizTalk Server. Dans ce cas, entrez les valeurs d'intervalle et de stratégie souhaitées. Les intervalles d'activation et Heart Beat sont fournis en l'état à TIBCO Rendezvous. Comme les intervalles doivent être identiques parmi tous les participants d'une file d'attente distribuée, les valeurs sont entrées une fois seulement. Avec les stratégies, il se peut que les valeurs soient différentes sur chaque hôte. Toutes les valeurs de stratégie suivent la même syntaxe : paires hôte/valeur séparées par un deux-points (:) séparées par un point-virgule (;).

    Par exemple, host1 :10 ; host2 :20 ; host3 :30

    Le nom de l'hôte doit être un nom d'hôte DNS valide ou une adresse IP. Pour chacune de ces stratégies, l'adaptateur trouve la valeur associée à son hôte et l'utilise avec l'API TIBCO Rendezvous.

    Si les valeurs doivent être identiques sur tous les ordinateurs, vous pouvez enteOn le Tibr une valeur simple au lieu de la liste des paires nom :valeur (par exemple, 20).

    Propriété Pour
    Intervalle d'activation Planificateur Stratégie de poids utilisé pour cette file d'attente distribuée. Il s'agit de l'intervalle sans message Heart Beat du planificateur, après lequel TIBCO RV active un nouveau planificateur. La valeur par défaut est 20 secondes.
    Intervalle Heart Beat Intervalle Heart Beat utilisé dans cette file d'attente distribuée. Il est utilisé avec le paramètre Groupe BizTalk Server. L'adaptateur BizTalk pour TIBCO Rendezvous utilise ces valeurs dans les appels d'API à TIBCO RV. La valeur est utilisée par l'instance de l'adaptateur qui est le planificateur actif pour le groupe et diffuse les messages Heart Beat à cet intervalle (en secondes). La valeur par défaut est 10.
    Planificateur Stratégie de poids Par défaut (valeur nulle), tous les membres d'un groupe ont la même chance de devenir planificateur. Une liste de valeurs de paire hôte-poids prévoit une stratégie de poids différente. La valeur par défaut est Null.
    Stratégie de capacité de travail Stratégie de capacité de travail utilisée pour cette file d'attente distribuée. Cette valeur indique le nombre de tâches simultanées qu'un membre du groupe peut gérer. Si aucune valeur n'est spécifiée, la valeur par défaut est 1. Une liste de valeurs de paire hôte-capacité prévoit une stratégie de capacité différente.
    Stratégie de poids de travail Stratégie de poids de travail utilisée pour cette file d'attente distribuée. Cette valeur fournit une valeur de poids pour aider TIBCO à attribuer des tâches dans une file d'attente distribuée. En commençant par le poids le plus élevé, des tâches sont attribuées aux employés disponibles. La valeur par défaut est 1.
  4. Développez Paramètres généraux et entrez toutes les informations requises pour la connexion au serveur TIBCO Rendezvous.

    Propriété Pour
    Substitution de caractères génériques de l'annexe Spécifiez un texte de substitution des caractères génériques. Les noms d'objet qu'un emplacement de réception écoute sont utilisés pour générer l'espace de noms cible XML dans les messages obtenus. Par défaut, l’adaptateur remplace tout caractère générique «> » par le texte GTWILDCARD dans les messages générés. Vous pouvez spécifier un caractère générique différent dans ce champ.
    Numéro Page de codes Identifie la page de code utilisée par l'expéditeur du message pour coder les chaînes contenues dans les messages entrants. La valeur par défaut est 65001. (L'adaptateur ne peut pas avoir les mêmes objets de message générés à partir de deux environnements de page de code différents.)
    Substitution de caractères génériques de l'élément Spécifier un texte générique différent Remplacer Les noms d’objet qu’un emplacement de réception écoute sont utilisés pour générer l’espace de noms cible XML dans les messages résultants. Par défaut, l'adaptateur remplace tout caractère générique « * » par le texte STARWILDCARD dans les messages générés. Vous pouvez spécifier un caractère générique différent dans ce champ.
    Nom de la file d'attente d'événements Spécifiez un nom à utiliser lors de la création de l'objet File d'attente Rendezvous. Il est fourni pour des raisons de commodité car les messages du journal associés affichent le nom de cette file d'attente. La valeur par défaut est vide,
    Filter Lorsque vous spécifiez des caractères génériques dans les noms d'objet à écouter, l'orchestration cible risque de ne s'intéresser qu'à un sous-ensemble de l'ensemble potentiellement très large d'objets qu'elle pourrait concerner. Pour réduire l'impact sur BizTalk Server et l'accès associé aux bases de données, vous pouvez continuer à spécifier les messages à envoyer à BizTalk Server. Cette entrée contient une liste séparée par un point-virgule des noms d'objet (sans caractère générique autorisé). Tout message correspondant à un nom d'objet spécifié avec un caractère générique mais dont le nom d'objet ne figure pas dans cette liste est filtré (non envoyé à BizTalk Server). La logique du filtre peut être inversée en ajoutant un caractère « ! » au début de la valeur de filtre. Par défaut, aucune valeur n'est spécifiée (aucun filtre).
    Mapper des types non pris en charge à une chaîne Les types non pris en charge génèrent une erreur ou sont mappés à la chaîne. Utilisable si l'adaptateur est utilisé avec une version plus récente de TIBCO Rendezvous où de nouveaux types auraient été ajoutés.
    Membre du groupe BizTalk Si défini sur True, les paramètres de file d'attente distribuée (qui font référence au nœud Paramètres de file d'attente distribuée) et les paramètres d'écouteur certifié (qui font référence au nœud Paramètres de l'écouteur certifié) doivent être définis. La valeur par défaut est FALSE.
    Chemin d’accès Défini pour pointer sur les binaires TIBCO Rendezvous si cette information n'est pas déjà dans la variable d'environnement PATH.
    Conserver l'ordre L'adaptateur distribue les messages entrants à BizTalk Server dans l'ordre de leur réception (par exemple, à l'aide d'un simple thread de distribution). Notez que si les paramètres de messagerie certifiée ne sont pas définis, cela ne signifie pas que l'adaptateur reçoit les messages dans l'ordre de leur envoi (en faisant référence à une seule source).
    Identificateur de l'emplacement de réception Nom de l'emplacement de réception.
    Reserved Champ réservé à un usage particulier.
  5. Développez le transport Rendezvous et entrez toutes les informations requises pour la communication entre les démons et les programmes TIBCO Rendezvous.

    Le transport (réseau, démon, service) spécifie comment les démons TIBCO Rendezvous échangent des messages. Ces paramètres sont envoyés en l'état à l'API TIBCO Rendezvous. L'utilisation des valeurs par défaut (vides) revient à utiliser la stratégie de communication par défaut.

    Un transport TIBCO Rendezvous définit l'étendue de remise, c'est-à-dire l'ensemble des destinations possibles auxquelles envoyer le message. Cet ensemble de propriétés définit un transport.

    Paramètre Description
    Démon Tapez l'identificateur numérique du paramètre Démon du transport Rendezvous.
    Réseau Tapez le nom du paramètre Réseau Rendezvous.
    Service Name Tapez le nom du service du transport Rendezvous.
  6. Indiquez les informations d'identification à l'aide de l'authentification unique (SSO).

    Vous pouvez utiliser deux méthodes pour accéder au système TIBCO Rendezvous. Vous pouvez utiliser les informations d'identification (paramètres Nom d'utilisateur et Mot de passe) ou l'authentification unique.

    1. Sélectionnez Oui dans Utiliser l’authentification unique pour utiliser l’authentification unique.

      Notes

      Pour plus d’informations sur la configuration de l’authentification unique, consultez Sécurité .

    2. Sélectionnez une application associée dans la liste.

      Une application associée (créée par les outils d'authentification unique de l'entreprise) représente une application telle que TIBCO Rendezvous. L'adaptateur Microsoft BizTalk pour TIBCO Rendezvous utilise les informations d'identification d'un utilisateur de l'application. Celles-ci sont extraites de la base de données SSO pour le système de serveur pour une application associée spécifiée.

      Notes

      Pour plus d’informations sur la création d’une application affiliée, consultez Création d’applications affiliées.

  7. Après avoir fourni toutes les informations requises, cliquez sur Appliquer, puis sur OK.

    Vous devez définir les paramètres de connexion pour l'adaptateur BizTalk pour TIBCO Rendezvous afin de recevoir les messages TIBCO Rendezvous.

Étapes suivantes