Créer une activité JMS

  • Rversion finale: Washingtondc
  • Mis à jour 1 févr. 2024
  • 6 minutes de lecture

    • Créez une activité JMS personnalisée pour récupérer ou envoyer des messages à des systèmes externes à l’aide de Java Messaging Service.

    Avant de commencer

    Rôle requis : activity_creator ou workflow_admin

    Pourquoi et quand exécuter cette tâche

    L’activité JMS prend en charge les fournisseurs JMS tiers dont l’application client JMS est écrite avec un modèle Java EE classique et peut prendre en charge les opérations suivantes :
    • Utilisation de JNDI pour trouver un objet ConnectionFactory.
    • Utilisation de JNDI pour trouver un ou plusieurs objets de destination.
    • Utilisation de ConnectionFactory pour créer un objet de connexion JMS.
    • Utilisation de la connexion JMS pour créer un ou plusieurs objets de session JMS.
    • Utilisation d’une session JMS et des destinations pour créer les objets MessageProducer et MessageConsumer.
    • Démarrage de la connexion JMS pour activer la remise ou la consommation de messages.
    Remarque :
    Le concepteur d’activité JMS a été testé avec les fournisseurs JMS ActiveMQ et Tibco EMS. Lorsque vous vous connectez à un fournisseur JMS, reportez-vous à la documentation de l’utilisateur tiers.

    Procédure

    1. Créez ou vérifiez vos informations d’identification JMS .
      Vos informations d’identification JMS doivent disposer d’une autorisation pour la base de données cible et d’une configuration appropriée pour la connexion JMS correspondante. Les informations d’identification doivent être configurées avant de pouvoir créer une activité JMS.
    2. Créez ou vérifiez votre connexion JMS .
      Votre connexion JMS doit être configurée avec des informations d’identification JMS valides avant de pouvoir créer une activité JMS.
    3. Créez une activité personnalisée.
      Cette action crée une activité personnalisée à l’aide d’un modèle.
    4. Après avoir configuré les propriétés générales et créé des variables d’entrée, configurez la commande d’exécution JMS.
      OptionDescription
      Configurer vos informations d’identification Renseignez les champs nécessaires pour la connexion à votre base de données.
      Instanciateur de connexions Nom de l’instanciateur de connexions JMS. Vous devez créer ou vérifier votre connexion JMS. Cette configuration lie le nom de l’instanciateur de contexte initial à l’URL du fournisseur JMS.
      Type de destination Type de destination utilisé pour ce message :
      • File d’attente : le message est mis en file d’attente pour les communications point à point.
        Remarque :
        L’opération GET est uniquement prise en charge pour le type de destination File d’attente.
      • Rubrique : Le message est utilisé pour la communication de publication et d’abonnement.
      Nom de destination Nom de la file d’attente ou de la destination de rubrique configurée sur le fournisseur JMS.
      Type du message Valeur du type de message JMS. Seul le type Message texte est pris en charge. La destination de la file d’attente ou de la rubrique doit être configurée pour recevoir ou envoyer uniquement des messages texte. D’autres types de messages sont abandonnés, car l’activité JMS ne peut pas les traiter.
      Opération Opération de programmation à effectuer sur la destination. Les choix sont PUT ou GET.
      Délai d’expiration (sec.) Temps d’attente autorisé pour un message dans la file d’attente des messages avant qu’il n’expire, en secondes. Le nombre par défaut est 30.
      En-têtes de messages personnalisés Valeurs d’en-tête personnalisées dans un format de paire nom/valeur, disponible sur la destination JMS.
      Remarque :
      Ceci n’est pris en charge que pour une opération PUT .
      Charge utile du message Contenu du message réel ou charge utile envoyée à la destination JMS.
      Remarque :
      Ceci n’est pris en charge que pour une opération PUT .
      Balise d’informations d’identification Une balise pour les informations d’identification individuelles d’une activité JMS dans un workflow Orchestration.
      Options requises de Serveur MID Serveur MID à utiliser, par options.

    Que faire ensuite

    Créer une connexion JMS pour une Orchestration activité

    Configurez votre système pour utiliser Java Messaging Service (JMS) avec une activité JMS d’orchestration personnalisée.

    Avant de commencer

    Rôle requis : admin

    Pourquoi et quand exécuter cette tâche

    Le MID Server doit disposer des instanciateurs de connexions JMS appropriés pour votre organisation. Configurez ces valeurs dans la mid.property.jms.command.allowed_factory_names propriété, trouvée dans Serveur MID > Propriétés. Les valeurs par défaut de cette propriété peuvent être remplacées par n’importe quelle valeur ou liste de valeurs séparées par des virgules annoncée par le fournisseur JMS tiers.

    Procédure

    1. Accédez à la Serveur MID > Fichiers JAR.
    2. Cliquez sur Nouveau et ajoutez.
      OptionDescription
      Nom Un nom unique et descriptif permettant d’identifier le fichier dans l’instance.
      Version Numéro de version du fichier, le cas échéant.
      Source Emplacement du fichier JAR à des fins de référence. Les informations sources ne sont pas utilisées par le système.
      Description Brève description du fichier JAR et de son rôle dans l’instance.
    3. Cliquez sur l’icône de presse-papier dans la bannière et joignez le fichier jar du pilote JMS.
      Le fichier jar du pilote JMS doit être disponible dans le cadre de l’installation du fournisseur JMS. Peu de fournisseurs JMS les mettent à disposition en tant que produit distinct. Consultez la documentation du fournisseur JMS pour déterminer les fichiers jar du pilote client JMS dont les applications clientes ont besoin pour se connecter au fournisseur JMS. Par exemple, si vous essayez de vous connecter à ActiveMQ V5.10 (fournisseur JMS), vous avez besoin du fichier activemq-all-5.10.1.jar .
    4. Accédez à la Orchestration > Informations d'identification et connexions > Instanciateur de connexions JMS.
    5. Cliquez sur Nouveau, ajoutez les éléments suivants, puis cliquez sur Soumettre.
      OptionDescription
      Nom Nom unique de cette instanciateur de connexions.
      Instanciateur de contexte initial Nom de la classe JNDI utilisée pour créer InitialContext.
      Remarque :
      Par exemple, pour vous connecter à ActiveMQ V5.10 (fournisseur JMS), la valeur est org.apache.activemq.jndi.ActiveMQInitialContextFactory.
      URL du fournisseur Emplacement de l’installation du fournisseur JMS en cours d’exécution.
      Remarque :
      Par exemple, pour vous connecter à ActiveMQ V5.1 : tcp://ipAddressOrHostName:61616.
    6. Accédez à la Orchestration > Informations d'identification.
    7. Cliquez sur Nouveau, sélectionnez Informations d’identification JMS et indiquez le nom d’utilisateur et le mot de passe que le MID doit utiliser pour communiquer avec le fournisseur JMS.
      Pour plus d’informations, consultez Informations d’identification JMS Informations d’identification JMS.
    8. Cliquez sur Envoyer.
      Vous êtes prêt à créer une activité JMS personnalisée.

    Paramètres d’exécution du modèle JMS

    Vous utilisez des paramètres d’exécution pour créer le script de processus d’entrée dans le formulaire de prétraitement .

    Vous devez utiliser le préfixe executionParam. avec toutes les variables de cette table.
    Tableau 1. Paramètres d’exécution JDBC
    Nom Variable Type Utilisation
    Jms ds jms_ds Référence Source de données JMS sélectionnée.
    Type de destination destination_type Énumérés
    Nom de destination destination_name Chaîne
    Type de message message_type Énumérés
    Opération operation Énumérés
    Délai d'expiration atteint time_out Entier Délai d’attente avant que la requête ne renvoie des résultats.
    En-têtes personnalisés custom_headers Tableau d’objets JavaScript
    Charge utile du message message_payload Chaîne
    Balise d’informations d’identification credential_tag Chaîne Liste des options de MID Server requises.
    Capacités MID Fonctionnalités MID Chaîne (séparée par des virgules)
    Options de valeur valueCapabilities (en anglais seulement) Tableau de la carte de hachage Valeurs d’aptitude utilisées pour sélectionner le MID Server. Pour plus d’informations, consultez Options du MID Server. Si des options supplémentaires sont affectées par valeur, utilisez cet exemple pour personnaliser la sélection du MID Server :
    var valueCapability = {'NEW_MID_CAPABIILTY':'NEW_MID_CAPABILITY_VALUE'};
executionParam.valueCapabilities.push(valueCapability);

    Paramètres de post-traitement du modèle JMS

    Utilisez ces paramètres pour créer un script de post-traitement.

    Tableau 2. Paramètres de post-traitement JMS
    Nom Variable Type Utilisation
    Statut statut Chaîne État de l’opération (Put ou Get) sur la destination JMS.
    En-têtes standard standardHeaders (en-têtes standard) Chaîne Tous les en-têtes standard, tels que spécifiés par JMS, qui sont obtenus dans le cadre du message JMS lors d’une opération Get. Ce champ ne s’applique qu’aux opérations Get.
    En-têtes personnalisés en-têtes personnalisés Chaîne Tous les en-têtes personnalisés ajoutés par une application de créateur ou d’éditeur qui sont obtenus dans le cadre du message JMS lors d’une opération Get. Ce champ ne s’applique qu’aux opérations Get.
    Charge utile du message charge utile du message Chaîne Charge utile du message obtenue dans le cadre du message JMS au cours d’une opération Obtenir. Ce champ ne s’applique qu’aux opérations Get.
    EccSysID (en anglais) eccSysID Chaîne Contient l’ID de référence associé au message d’entrée de file d’attente ECC renvoyé par l’activité.
    Messages d’erreur messages d’erreur Chaîne Contient tous les messages d’erreur récupérés à partir de la commande JMS. Cette valeur est nulle s’il n’y a pas de messages d’erreur.