Bloc XML EmailRelay <CQDatabase>

Le bloc XML EmailRelay <CQDatbase> contient des attributs que le mode EmailRelay PostOffice utilise pour établir une communication avec le serveur Web IBM® Rational ClearQuest. Cette communication est requise pour interroger la base de données ClearQuest pour connaître les nouveaux enregistrements de courrier électronique EmailPlus.
Si vous configurez l'application EmailRelay pour plusieurs bases de données utilisateur ClearQuest, vous retrouverez une section <référentiel> séparée pour chaque base de données utilisateur.
Remarque : Lorsque vous configurez l'application EmailRelay dans le mode relais PostOffice, la section <référentiel> est ignorée.
Cet exemple montre comment utiliser les paramètres de serveur Web ClearQuest :
<CQDatabase>
  <repository connection_timeout="30000" dbname="SAMPL" dbset="EmailPlus" is_enabled="yes" keyfile="" password="" payloaddumpdir="C:\EmailRelay" retries="3" socket_timeout="30000" url="http://your.cqweb.com/cqweb/oslc/" username="admin"/>
</CQDatabase>
Tableau 1. Attributs du bloc XML <référentiel>
Nom d'attribut Description
connection_timeout Contient un entier qui indique, en millisecondes, combien de temps EmailRelay attendra avant d'abandonner une demande de connexion au serveur Web ClearQuest. La valeur par défaut est 30000, ce qui correspond à 30 secondes. Si votre serveur Web ClearQuest est fortement utilisé et qu'EmailRelay rapporte des dépassements du délai d'attente de connexion, augmentez cette valeur. N'oubliez pas qu'il faudra plus de temps pour que le courrier électronique soit envoyé.
Remarque : Pour obtenir de meilleurs résultats, connection_timeout et socket_timeout doivent avoir la même valeur.
dbname Contient le nom de base de données utilisateurs ClearQuest. Vous ne pouvez pas modifier la valeur de cet attribut. Il est généré automatiquement selon le paramètre que vous transmettez au paramètre -userdb.
dbset Contient le nom de la base de données maître ClearQuest. Vous ne pouvez pas modifier la valeur de cet attribut. Il est généré automatiquement selon le paramètre que vous transmettez au paramètre -dbset.
is_enabled Contient la valeur yes ou no. La valeur par défaut est yes. Vous pouvez modifier temporairement la valeur de cet attribut pour désactiver l'envoi de courriers électroniques pour ce référentiel ClearQuest. Par exemple, vous pouvez désactiver les notifications par courrier électronique lorsque vous réalisez des mises à jour par lots.
keyfile Contient le nom du fichier de clés qui possède la clé permettant de déchiffrer le mot de passe de l'utilisateur stocké dans l'attribut mot_de_passe. Vous ne devez pas changer la valeur de cet attribut. Il est automatiquement généré pour vous selon la valeur du paramètre -relaycfgdir.
Important : Si vous modifiez la valeur de cet attribut, comme le nom de fichier ou le chemin de répertoire, vous devez également apporter le même changement au fichier de clé physique.
password Contient le mot de passe chiffré de l'utilisateur ClearQuest.
Remarque : Vous ne pouvez pas modifier la valeur de cet attribut. Il est généré automatiquement selon le paramètre que vous transmettez au paramètre -password.
payloadddumpdir Contient le répertoire dans lequel le contenu est exporté. Le contenu correspond aux données de courrier électronique reçues du package EmailPlus. La valeur de cet attribut s'appuie sur la valeur de l'attribut -dumppayload. Vous pouvez modifier la valeur de l'attribut pour spécifier un emplacement différent.
Remarque : Cet attribut est facultatif. L'attribut n'est généré que lorsque l'attribut -dumppayload est utilisé. Utilisez l'attribut uniquement pour déboguer les problèmes d'application EmailRelay.
retries Contient un entier supérieur à -1. Cette valeur représente le nombre de tentatives de nouvel essai de communication avec le serveur Web ClearQuest lorsqu'une tentative de connexion échoue. La valeur par défaut est 3. Vous pouvez modifier la valeur de cet attribut. S'il existe des problèmes de communication entre l'application EmailRelay et votre serveur Web ClearQuest, augmentez la valeur de cet attribut.
socket_timeout Contient un entier qui indique, en millisecondes, combien de temps EmailRelay attendra avant d'abandonner une demande de connexion socket au serveur Web ClearQuest. La valeur par défaut est 30000, ce qui correspond à 30 secondes. Si votre environnement de réseau et votre serveur Web ClearQuest sont fortement utilisés et qu'EmailRelay rapporte des dépassements du délai d'attente de connexion, augmentez cette valeur. N'oubliez pas qu'il faudra plus de temps pour que le courrier électronique soit envoyé.
Remarque : Pour obtenir de meilleurs résultats, connection_timeout et socket_timeout doivent avoir la même valeur.
url Contient l'URL utilisée par le serveur EmailRelay pour interroger la base de données ClearQueset et connaître les nouveaux enregistrements de courrier électronique EmailPlus. Cette valeur d'attribut est générée automatiquement d'après la valeur de l'attribut -servername. Vous pouvez modifier la valeur de cet attribut. Vous pouvez modifier la valeur, par exemple, lorsque votre emplacement de serveur Web ClearQuest a changé que vous souhaitez que les changements soient répercutés dans ce bloc XML sans devoir exécuter le script cqemailrelay.pl.
username Contient le nom que ClearQuest utilise lorsque l'application EmailRelay se connecte au serveur Web ClearQuest. La valeur de cette attribut est générée automatiquement d'après le paramètre transmis à l'attribut -password.

Commentaires