Le jeu de caractères local est celui qui est utilisé pour saisir et afficher des données dans l'interpréteur de commandes du système d'exploitation client. Sous UNIX, il est défini par la variable d'environnement LANG. Sous Windows, il est contrôlé par les paramètres sélectionnés dans l'applet Options régionales et linguistiques du Panneau de configuration. Pour plus d'informations, voir l'aide en ligne relative à l'administration de Rational ClearQuest.
On désigne le jeu de caractères fournisseur pour Oracle comme jeu de caractères ou charset, comme page de codes ou jeu de codes sous IBM DB2, ou encore comme page de codes ou classement (collation) pour SQL Server.
Avant la version 7.0, les opérations d'écriture n'étaient autorisées que si le jeu de caractères local correspondait à la page de codes Rational ClearQuest. Dans le cas contraire, seules les opérations de lecture étaient possibles, Le mode lecture seule était nécessaire, car les applications Rational ClearQuest utilisaient le jeu de caractères local du client ou serveur Web pour écrire des données dans la base de données et non dans la page de codes de données Rational ClearQuest pour l'ensemble de bases de données.
Depuis la version 7.0, le logiciel Rational ClearQuest traite les données au format Unicode. Les applications utilisent la page de codes de Rational ClearQuest pour écrire dans les bases de données. Ces applications peuvent donc maintenant se connecter à la base de données Rational ClearQuest en mode lecture/écriture, même si le jeu de caractères local ne correspond pas à la page de codes de données Rational ClearQuest.
Cette nouvelle fonctionnalité permet une grande souplesse dans un environnement Rational ClearQuest comprenant plusieurs machines qui utilisent des jeux de caractères locaux différents. Cependant, les caractères utilisés par Rational ClearQuest mais ne faisant pas partie du jeu de caractères local doivent être traités au moyen de scripts et de points d'ancrage, Pour bénéficier pleinement de cette possibilité dans ces environnements, ces scripts et points d'ancrage doivent être codés pour prendre en charge Unicode.
Designer dispose d'un nouveau paramètre nommé Sensible à Unicode. Les points d'ancrage écrits pour la version 7.0 peuvent indiquer si les chaînes renvoyées par les appels d'API Rational ClearQuest doivent impérativement utiliser le jeu de caractères local (RETURN_STRING_LOCAL), ou si elles peuvent contenir des caractères Unicode (RETURN_STRING_UNICODE). Par ailleurs, de nouvelles fonctions de l'API permettent de contrôler le mode de la chaîne de retour. En mode RETURN_STRING_LOCAL, un appel d'API renvoie une exception si la chaîne de retour contient des caractères ne pouvant pas être représentés dans le jeu de caractères local. En mode RETURN_STRING_UNICODE, un appel d'API renvoie tous les caractères ne générant aucune erreur.
Pour vous assurer que les points d'ancrage et les scripts traiteront toutes les données requises lors du déploiement dans une configuration comprenant plusieurs jeux de caractères, vous devez utiliser le mode RETURN_STRING_UNICODE et traiter de façon appropriée tous les caractères Unicode pouvant être renvoyés. Définir le mode RETURN_STRING_UNICODE n'est pas suffisant ; vous devez également faire en sorte que le code traite correctement les caractères Unicode. Les instructions suivantes peuvent vous être utiles, mais il est impératif d'utiliser les techniques de programmation Unicode adéquates pour le langage d'écriture de scripts.
Si vous mettez le produit à niveau vers la version 7.0, ces changements n'auront pas d'incidence sur les schémas existants, si tous les jeux de caractères utilisés dans l'environnement correspondent à la page de codes de Rational ClearQuest, ce qui était courant dans les versions précédentes. Le mode par défaut, RETURN_STRING_LOCAL, permet aux points d'ancrage et aux scripts de continuer à fonctionner.
Si vous déployez la version 7.0 dans un environnement utilisant des jeux de caractères locaux qui ne correspondent pas à la page de codes de Rational ClearQuest, vous devez vous assurer que les scripts pourront traiter les données du logiciel Rational ClearQuest au format Unicode, définir le mode de retour des scripts sur RETURN_STRING_UNICODE et mettre les packages à niveau vers la version 7.0. Pour obtenir la liste des packages Rational ClearQuest prenant en charge le jeux de caractères Unicode, voir Tableau 1. Les scripts non compatibles avec ce dernier peuvent s'exécuter, mais une erreur est générée si le système renvoie des données n'utilisant pas le jeu de caractères local. Ces scripts ne peuvent fonctionner correctement que si les données traitées lors de leur exécution contiennent uniquement des caractères issus du jeu de caractères local du client ou du serveur Web.
Package | Mode de chaîne de retour |
---|---|
AMWorkActivitySchedule | RETURN_STRING_UNICODE |
ATStateTypes | RETURN_STRING_UNICODE |
Pièces jointes | RETURN_STRING_UNICODE |
Analyse rétrospective | RETURN_STRING_UNICODE |
BTStateTypes | RETURN_STRING_UNICODE |
BuildTracking | RETURN_STRING_UNICODE |
CQTM | RETURN_STRING_UNICODE |
Client | RETURN_STRING_UNICODE |
DeploymentTracking | RETURN_STRING_UNICODE |
DTStateTypes | RETURN_STRING_UNICODE |
RETURN_STRING_UNICODE | |
EnhancementRequest | RETURN_STRING_UNICODE |
eSignature | RETURN_STRING_UNICODE |
Historique | RETURN_STRING_UNICODE |
Notes | RETURN_STRING_UNICODE |
Projet | RETURN_STRING_UNICODE |
Résolution | RETURN_STRING_UNICODE |
TPM | RETURN_STRING_UNICODE |
Le logiciel Rational ClearQuest traite toutes les données comme des caractères Unicode. Cependant, il est possible que les points d'ancrage de schéma (Perl et Visual Basic) et d'autres applications ou intégrations de l'API Rational ClearQuest ne reconnaissent pas les caractères Unicode. Dans la version 7.0, vous pouvez résoudre ce problème en sélectionnant la case Sensible à Unicode dans l'éditeur de script Designer. Cette option permet d'indiquer que le script doit être exécuté en mode RETURN_STRING_UNICODE. Les scripts peuvent appeler la méthode SetPerlReturnStringMode ou SetBasicReturnStringMode pour définir le mode de chaîne de retour sur RETURN_STRING_UNICODE.
Le mode de chaîne de retour est utilisé pour limiter (RETURN_STRING_LOCAL) ou autoriser la représentation des caractères en (RETURN_STRING_UNICODE) complet lorsque les chaînes sont renvoyées par l'API de Rational ClearQuest API pour les langages Perl ou COM.
Il est recommandé d'écrire des scripts et des points d'ancrage pouvant traiter les caractères Unicode. Le mode de chaîne de retour par défaut, RETURN_STRING_LOCAL, permet aux scripts et points d'ancrage écrits pour les versions précédentes du logiciel Rational ClearQuest de fonctionner sans aucun changement. Même si vous n'utilisez pas le format Unicode, vous devez cependant envisager de modifier ces scripts ultérieurement pour qu'ils puissent fonctionner en mode RETURN_STRING_UNICODE.
Par défaut, une exception est générée à l'étape 2, lorsque le script de l'API Rational ClearQuest renvoie une chaîne contenant des caractères qui ne font pas partie du jeu de caractères local. Cette exception empêche que les données ne soient altérées. Après avoir vérifié que le code est en mesure de traiter les caractères Unicode, vous pouvez définir le mode de chaîne de retour sur RETURN_STRING_UNICODE. Pour ce faire, utilisez l'API Rational ClearQuest ou l'éditeur de scripts de ClearQuest Designer. Une fois ce changement effectué, si la chaîne renvoyée à l'étape 2 contient des données ne faisant pas partie du jeu de caractères local, l'API Rational ClearQuest pour Perl renvoie la valeur correspondante au format UTF8 (UNICODE). L'API Rational ClearQuest pour VBScript, Visual Basic ou COM renvoie, elle, des caractères Unicode non restreints. Les caractères ne pouvant pas être représentés dans le jeu de caractères local peuvent alors être renvoyés au point d'ancrage ou au script et traités comme étant des caractères Unicode.
En mode RETURN_STRING_LOCAL, il est possible d'exécuter des opérations (requêtes, etc.) dont le résultat contient des caractères Unicode. Une exception est générée uniquement si les données sont extraites de l'ensemble de résultats par une méthode d'API Rational ClearQuest, et si les caractères renvoyés par l'appel de l'API n'utilisent pas le jeu de caractères local. Par exemple, une intégration ou une application externe peut traiter une demande de changement si les données renvoyées à l'intégration utilisent uniquement le jeu de caractères local. Le code de l'intégration doit pouvoir gérer l'exception générée par la méthode d'API Rational ClearQuest lorsque des caractères renvoyés ne font pas partie du jeu de caractères local. Si l'API de l'intégration est en mode RETURN_STRING_UNICODE, l'exception n'est pas générée, mais l'application doit pouvoir traiter correctement tous les caractères Unicode renvoyés. En mode RETURN_STRING_LOCAL et RETURN_STRING_UNICODE, des exceptions sont également renvoyées à l'intégration ou à l'application appelante si celle-ci écrit des caractères ne pouvant pas être représentés dans la page de codes Rational ClearQuest.
Pour plus d'informations, voir Définition du mode de chaîne de retour pour les points d'ancrage et les scripts dans le IBM Rational ClearQuest - Référence de l'API .
Certains packages ou schémas ne sont pas conçus pour traiter le format Unicode et les jeux de caractères non locaux. La prise en charge fournie par les scripts de chaque package est indiquée dans l'éditeur de script de Designer (la case Sensible à Unicode est cochée). Les schémas DefectTracking et Common prennent en charge le format Unicode. Cependant, un schéma contenant un package non compatible avec ce format ne peut pas être utilisé dans une configuration utilisant plusieurs jeux de caractères. Voir Tableau 1.
Vous pouvez éditer ou ajouter des points d'ancrage qui accèdent aux zones du package ; ils sont alors considérés comme en faisant partie. Ces points d'ancrage héritent de la prise en charge Unicode par défaut assurée par le package, mais Designer n'affiche pas ce paramètre pour le point d'ancrage.
Si les jeux de caractères locaux de tous les clients connectés à un ensemble de bases de données sont compatibles avec la page de codes, vous n'avez pas à vous préoccuper des points énumérés ci-dessus. Pour plus d'informations sur la représentation des caractères et les paramètres des pages de codes, consultez l'aide en ligne relative à l'administration de Rational ClearQuest.