Soporte de un juego de caracteres local mixto o una base de datos multilíngüe en UTF-8

Este tema facilita directrices para dar soporte al despliegue de un juego de caracteres local mixto o a una base de datos multilíngüe en UTF-8 (8-bit Unicode Transformation Format).
Si trabaja en un entorno en el que se conectan sistemas diferentes con juegos de caracteres locales distintos al mismo conjunto de bases de datos de Rational ClearQuest, o si ha seleccionado la página de códigos de datos UTF-8 (65001) de ClearQuest, entonces debe tener en cuenta los siguientes problemas de representación de caracteres:

En versiones de Rational ClearQuest anteriores a la 7.0, las operaciones de grabación no estaban permitidas a no ser que el juego de caracteres local coincidiera con la página de códigos de datos de ClearQuest. Si los valores no coincidían, únicamente se permitían las operaciones de sólo lectura. La modalidad de sólo lectura se necesitaba debido a que las aplicaciones de ClearQuest utilizaban el juego de caracteres local del cliente o servidor web para grabar datos en la base de datos, en lugar de la página de códigos de datos de ClearQuest para el conjunto de bases de datos.

A partir de la versión 7.0, el software Rational ClearQuest procesa datos en Unicode y las aplicaciones utilizan la página de códigos de datos de ClearQuest para grabar en las bases de datos. Estas aplicaciones pueden conectar a la base de datos de ClearQuest en modalidad de lectura/grabación aunque el juego de caracteres local no coincida con la página de códigos de datos de ClearQuest.

Comenzando con la versión 7.1.1 de Rational ClearQuest, puede seleccionar una página de códigos de datos de ClearQuest en UTF-8 para los conjuntos de base de datos Oracle y DB2. Una página de códigos de datos en UTF-8 permite un almacenamiento de caracteres multilíngüe en la base de datos de usuario. Cuando selecciona UTF-8 como la página de códigos de datos, trabaja en un despliegue de juego de caracteres local mixto, a no ser que la página de códigos local del sistema operativo esté también en UTF-8. Esto último no es una opción en los sistemas Windows.

Esta nueva funcionalidad permite una gran flexibilidad en un entorno ClearQuest, que incluye sistemas con juegos de caracteres locales diferentes. Sin embargo, los scripts y enganches grabados para estos entornos deben manejar los datos de caracteres de ClearQuest que podrían no estar incluidos en el juego de caracteres local. Los scripts y enganches se deben haber codificado para dar soporte a Unicode con el objeto de aprovechar al máximo las ventajas de esta posibilidad en dichos entornos.

El Diseñador incluye un nuevo valor: Unicode Aware. Los enganches grabados para la versión 7.0 pueden especificar si los caracteres de las series devueltos desde las llamadas de API de ClearQuest deben estar únicamente en el juego de caracteres local (RETURN_STRING_LOCAL) o si pueden ser cualquier carácter Unicode (RETURN_STRING_UNICODE). Además, hay nuevas funciones de API disponibles para controlar la modalidad de la serie de retorno. En la modalidad RETURN_STRING_LOCAL, una llamada de API devuelve una excepción si la serie de retorno incluye caracteres que no se pueden representar en el juego de caracteres local. En RETURN_STRING_UNICODE, una llamada de API devuelve todos los caracteres sin error.

Para asegurarse de que los ganchos y los scripts manejan todos los datos en un juego de caracteres local mixto o en un despliegue UTF-8, debe establecer la modalidad en RETURN_STRING_UNICODE y manejar correctamente los caracteres Unicode que se pueden devolver. Establecer la modalidad de serie de retorno en RETURN_STRING_UNICODE no es suficiente; debe verificar que el código pueda manejar caracteres Unicode de forma correcta. Las pautas que aparecen a continuación resultan útiles, pero en última instancia debe utilizar las técnicas adecuadas de programación Unicode para el lenguaje de creación de scripts.

Si actualiza a la versión 7.0, los cambios no afectan a los esquemas existentes si todos los juegos de caracteres locales del entorno coinciden con la página de códigos de datos de ClearQuest, como sucedía en versiones anteriores. La modalidad predeterminada es RETURN_STRING_LOCAL, que permite que todos los enganches y scripts sigan funcionando.

Si despliega la versión 7.0 en un entorno en el que los juegos de caracteres locales no coinciden con la página de códigos de datos de ClearQuest, debe asegurarse de que los scripts puedan procesar datos de caracteres Unicode para software ClearQuest, establecer la modalidad de retorno para los scripts en RETURN_STRING_UNICODE y actualizar los paquetes a la versión 7.0. Para obtener una lista de los paquetes de ClearQuest que soportan Unicode, consulte la Tabla 1. Se pueden ejecutar scripts que no manejen Unicode, pero se devuelve un error si el sistema intenta devolver al script cualquier dato de tipo carácter que no esté incluido en el juego de caracteres local. Estos scripts siguen funcionando siempre que los datos que procesen estén restringidos al juego de caracteres local del cliente o servidor web.

Tabla 1. Modalidad de serie de retorno de paquetes
Paquete Modalidad de serie de retorno
AMWorkActivitySchedule RETURN_STRING_UNICODE
ATStateTypes RETURN_STRING_UNICODE
Attachments RETURN_STRING_UNICODE
AuditTrail RETURN_STRING_UNICODE
BTStateTypes RETURN_STRING_UNICODE
BuildTracking RETURN_STRING_UNICODE
CQTM RETURN_STRING_UNICODE
Customer RETURN_STRING_UNICODE
DeploymentTracking RETURN_STRING_UNICODE
DTStateTypes RETURN_STRING_UNICODE
EMail RETURN_STRING_UNICODE
EnhancementRequest RETURN_STRING_UNICODE
eSignature RETURN_STRING_UNICODE
Historial RETURN_STRING_UNICODE
Notes RETURN_STRING_UNICODE
Project RETURN_STRING_UNICODE
Resolution RETURN_STRING_UNICODE
TPM RETURN_STRING_UNICODE
Al desplegar una aplicación que deba manejar despliegues de juegos de caracteres mixtos, se deben tener en cuenta diversas consideraciones.

Si los juegos de caracteres locales de todos los clientes conectados a un conjunto de bases de datos o clan coinciden con la página de códigos de datos, no debe tener en cuenta estas cuestiones. Para obtener más información sobre sobre las representaciones de los caracteres y los valores de las páginas de códigos, consulte la ayuda en línea sobre administración de Rational ClearQuest.


Comentarios