Créer une activité JMS

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 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 cliente JMS est écrite avec un modèle Java EE typique et peut prendre en charge ces opérations :
    • 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. Lors de la connexion à un fournisseur JMS, consultez la documentation de votre utilisateur tiers.

    Procédure

    1. Créez ou vérifiez vos informations d’identification JMS .
      Vos informations d’identification JMS doivent disposer de l’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 configurées 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
      Configurez vos informations d’identification Renseignez les champs nécessaires à 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.
      Destination Type 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 n’est prise en charge que 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 la rubrique configurée sur le fournisseur JMS.
      Type du message Valeur du type de message JMS. Seul le type de message texte est pris en charge. La file d’attente ou la destination de la rubrique doit être configurée pour recevoir ou envoyer uniquement un message texte. Les autres types de messages sont abandonnés, car l’activité JMS ne peut pas les traiter.
      Opération L’opération programmatique à effectuer sur la destination. Les choix sont PUT ou GET.
      Délai d’expiration (sec.) Temps d’attente autorisé d’un message dans la file d’attente des messages avant son expiration, en secondes. La valeur par défaut est 30.
      En-têtes de message personnalisés Valeurs d’en-tête personnalisées au format de paire nom/valeur, disponibles sur la destination JMS.
      Remarque :
      Ceci n’est pris en charge que pour une opération put .
      Charge utile du message Contenu ou charge utile du message réel qui est envoyé à la destination JMS.
      Remarque :
      Ceci n’est pris en charge que pour une opération put .
      Balise d’informations d’identification Balise permettant d’obtenir des informations d’identification individuelles pour une activité JMS dans un workflow Orchestration.
      Capacités du serveur MID requises 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é Orchestration JMS personnalisée.

    Avant de commencer

    Rôle requis : admin

    Pourquoi et quand exécuter cette tâche

    Le serveur MID 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é, qui se trouve dans Serveur MID > Propriétés. Les valeurs par défaut de cette propriété peuvent être modifiées par n’importe quelle valeur ou liste de valeurs séparées par des virgules que le fournisseur JMS tiers annonce.

    Procédure

    1. Accédez à la Serveur MID > Fichiers JAR.
    2. Cliquez sur Nouveau et ajoutez.
      OptionDescription
      Nom 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 objectif dans l’instance.
    3. Cliquez sur l’icône du 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 proposent en tant que produit distinct. Consultez la documentation du fournisseur JMS pour déterminer quels fichiers JAR de pilote client JMS nécessitent une connexion des applications clientes 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 Envoyer.
      OptionDescription
      Nom Nom unique de cette fabrique 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 fournissez 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 les 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é
    Nom de destination destination_name Chaîne
    Type du message message_type Énuméré
    Opération operation Énuméré
    Délai d'expiration atteint time_out Entier Durée d’attente des résultats de la requête.
    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 serveur MID requises.
    Capacités moyennes midCapabilities Chaîne (séparée par des virgules)
    ValueCapabilities valueCapabilities Tableau de la carte de hachage Valeurs d’aptitude utilisées pour sélectionner le serveur MID. Pour plus d’informations, voir Options du serveur MID. Si des options supplémentaires sont affectées par valeur, utilisez cet exemple pour personnaliser la sélection de serveur MID :
    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 Statut de l’opération (Put ou Get) sur la destination JMS.
    En-têtes standard 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 au cours d’une opération Get. Ce champ ne s’applique qu’aux opérations Obtenir.
    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 au cours d’une opération Obtenir. Ce champ ne s’applique qu’aux opérations Obtenir.
    Charge MessagePayload messagePayload Chaîne Charge utile du message obtenue dans le cadre du message JMS au cours d’une opération Get. Ce champ ne s’applique qu’aux opérations Obtenir.
    EccSysID 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 errorMessages Chaîne Contient tous les messages d’erreur récupérés à partir de la commande JMS. Cette valeur est nulle en l’absence de message d’erreur.