Créer une activité JMS

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 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. Lors de la connexion à un fournisseur JMS, reportez-vous à 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 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 les informations d’identification JMS valides définies 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.

   Option	Description
   Configurez 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 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	La 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. D’autres types de messages sont abandonnés, car l’activité JMS ne peut pas les traiter.
   Opération	Opération programmatique à effectuer sur la destination. Vous avez le choix entre PUT ou GET.
   Délai d’expiration (sec.)	Temps d’attente autorisé pour un message dans la file d’attente de messages avant son expiration, en secondes. Le nombre par défaut est 30.
   En-têtes de messages personnalisés	Les valeurs d’en-tête personnalisées dans un format de paire nom/valeur, qui sont 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 envoyé à 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 pour une activité JMS dans un workflow Orchestration.
   Options de Serveur MID requises	Serveur MID à utiliser, par aptitudes.

Que faire ensuite

• Utiliser le mappage automatique pour générer des sorties et des règles d’analyse
• Si vous n’utilisez pas le mappage automatique, vous pouvez créer manuellement des variables de sortie et créer des règles d’analyse

Créer une connexion JMS pour une Orchestration activité

Configurez votre système pour utiliser le service de messagerie Java (JMS) avec une activité JMS d’orchestration personnalisée.

Avant de commencer

Rôle requis : administrateur

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 remplacées par n’importe quelle valeur ou par une liste de valeurs séparées par des virgules annoncées par le fournisseur JMS tiers.

Procédure

1. Accédez à la Serveur MID > Fichiers JAR.
2. Cliquez sur Nouveau et ajoutez.

   Option	Description
   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 sa fonction 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 rendent disponibles en tant que produit distinct. Consultez la documentation du fournisseur JMS pour déterminer quels fichiers jar de pilote client JMS nécessitent que les applications clientes se connectent 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.

   Option	Description
   Nom	Nom unique de cette fabrique de connexions.
   Instanciateur de contexte initial	Nom de la classe JNDI utilisée pour créer l’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 du message	message_type	Énumérés
Opération	operation	Énumérés
Délai d'expiration atteint	time_out	Entier	Délai d’attente pour que la requête 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 Serveur MID requises.
Capacités MID	Capacité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 serveur MID. Pour plus d’informations, consultez Options de Serveur MID. Si des options supplémentaires sont affectées par valeur, utilisez cet exemple pour personnaliser la sélection du 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 lors d’une opération Get. Ce champ ne s’applique qu’aux opérations d’obtention.
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 GET. Ce champ ne s’applique qu’aux opérations d’obtention.
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 GET. Ce champ ne s’applique qu’aux opérations d’obtention.
EccSysID (en anglais seulement)	eccSysID	Chaîne	Contient l’ID de référence associé au message d’entrée 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 à l’aide de la commande JMS. Cette valeur est nulle s’il n’y a pas de messages d’erreur.