# tMessagingConnection

Ce composant ouvre une connexion vers un serveur MQ dans un but de communication.

Ce composant n'est pas intégré par défaut à votre Studio Talend. Vous devez l'installer à l'aide du gestionnaire des fonctionnalités. Pour plus d'informations, consultez [Installer les fonctionnalités à l'aide du Gestionnaire des fonctionnalités](https://help.qlik.com/talend/r/fr-FR/8.0/studio-user-guide/install-features-to-talend-studio).

Note InformationsRemarque : Ce composant est disponible uniquement si vous avez installé la mise à jour mensuelle 8.0.1-R2022-11 du Studio Talend ou une plus récente fournie par Talend. Pour plus d'informations, contactez votre administrateur ou administratrice.

## Propriétés du tMessagingConnection Standard

Ces propriétés sont utilisées pour configurer le tMessagingConnection s'exécutant dans le framework de Jobs Standard.

Le composant tMessagingConnection Standard appartient à la famille Messaging.

## Basic settings

| Propriétés | Description |
| --- | --- |
| Property Type | Peut-être Built-In ou Repository.<br><br><ul> <li> <span>Built-in</span>&nbsp;: Propriétés utilisées ponctuellement.</li> <li> <span>Repository</span> : sélectionnez le référentiel dans lequel sont stockées les propriétés. Les champs suivants concernant la connexion à la base de données sont alors pré-remplis à l'aide des données collectées.</li> </ul> |
| JMS Provider | Sélectionnez dans la liste déroulante le type des serveurs MQ à connecter : ActiveMQ (JMS v1), ActiveMQ Artemis (JMS v2) ou WebSphere MQ. |
| Server URL | Saisissez l'URL du serveur MQ.<br><br>L'URL du serveur MQ doit suivre un format spécifique. Le format doit être tcp://localhost:61616 (pour les serveurs ActiveMQ et ActiveMQ Artemis) ou localhost(1414) (pour les serveurs WebSphere MQ), comme demandé dans ce champ. |
| Use Specified User Identity | Si vous devez vous identifier, cochez la case et saisissez votre nom d'utilisateur ou d'utilisatrice et votre mot de passe dans les champs correspondants.<br><br>Pour saisir le mot de passe, cliquez sur le bouton [...] près du champ Password pour ouvrir la boîte de dialogue Enter a new password, saisissez le mot de passe dans le champ et cliquez sur OK. Vous pouvez saisir le mot de passe comme une chaîne de caractères JSON en mode pure password ou comme une expression Java en mode Java mode. Vous pouvez passer d'un mode à l'autre en cliquant sur switch to Java mode ou switch to pure password mode au-dessus du champ de texte. |
| Durable subscription | Cochez cette case pour activer la souscription durable.<br><br><ul> <li> <span>Client ID</span>&nbsp;: saisissez l'ID client pour la souscription durable.</li> <li> <span>Subscriber name</span>&nbsp;: saisissez le nom du souscripteur ou de la souscriptrice pour la souscription durable.</li> </ul> |

## Advanced settings

| Propriétés | Description |
| --- | --- |
| tStatCatcher Statistics | Cochez cette case pour collecter les données de log au niveau des composants. |
| Acknowledge mode | Sélectionnez le mode d'accusé réception dans la liste déroulante : Auto acknowledge, Client acknowledge, DUPS ok acknowledge, Session/Transaction ou Do not acknowledge. |
| Advanced context properties | Configurez les autres propriétés du composant, selon vos besoins. Pour configurer une propriété dans cette table, ajoutez une ligne à la table en cliquant sur le bouton [+], sous la table, saisissez le nom de la propriété dans la colonne Key et saisissez la valeur de la propriété dans la colonne Value. Cette table supporte les variables globales et les variables de contexte. Consultez [Configure JMS producers](https://doc.akka.io/docs/alpakka/current/jms/producer.html) (en anglais) pour plus d'informations concernant les propriétés des serveurs MQ ActiveMQ et ActiveMQ Artemis. Consultez [Propriétés du connecteur WebSphere MQ](https://www.ibm.com/docs/fr/iis/11.5?topic=connector-websphere-mq-properties) pour plus d'informations concernant les propriétés des serveurs WebSphere MQ.<br><br>Note InformationsRemarque : Si vous utilisez un fournisseur JMS WebSphere MQ, vous devez configurer les propriétés obligatoires (CHANNEL et QUEUE\_MANAGER) dans cette table. |

## Variables globales

| Variables | Description |
| --- | --- |
| Variables globales | ERROR\_MESSAGE : message d'erreur généré par le composant lorsqu'une erreur survient. Cette variable est une variable After et retourne une chaîne de caractères. Cette variable fonctionne uniquement si la case Die on error est décochée, lorsque le composant contient cette case.<br><br>NB\_LINE : nombre de lignes lues par un composant d'entrée ou passées à un composant de sortie. Cette variable est une variable After et retourne un entier.<br><br>Une variable Flow fonctionne durant l'exécution d'un composant. Une variable After fonctionne après l'exécution d'un composant.<br><br>Pour renseigner un champ ou une expression à l'aide d'une variable, appuyez sur les touches Ctrl+Espace pour accéder à la liste des variables. À partir de cette liste, vous pouvez choisir la variable que vous souhaitez utiliser.<br><br>Pour plus d'informations concernant les variables, consultez [Utiliser les contextes et les variables](https://help.qlik.com/talend/r/fr-FR/8.0/studio-user-guide/contexts-and-variables). |

## Utilisation

| Conseils d'utilisation | Description |
| --- | --- |
| **Règle d'utilisation** | Ce composant s'utilise avec d'autres composants tMessaging\*, notamment avec le tMessagingCommit et le tMessagingRollback. |
| Limitation | Ce composant supporte les serveurs ActiveMQ et WebSphereMQ. |