En este capítulo se explican las funciones y consideraciones exclusivas del desarrollo de aplicaciones de HATS que proporcionan soporte para el juego de caracteres de doble-byte (DBCS).
Además de las funciones generales, HATS proporciona las siguientes funciones específicas para dar soporte a DBCS:
En este capítulo se explican estas funciones específicas y consideraciones especiales si se utilizan las funciones generales de HATS para dar soporte a DBCS.
HATS da soporte a los siguientes tipos de campos DBCS y SBCS.
| Tipo de campo | Contenido que se puede utilizar para el campo | Plataforma |
|---|---|---|
| DBCS mixto | Caracteres SBCS y DBCS con caracteres de fin e inicio (SO/SI) de DBCS | 3270 |
| Sólo DBCS (G) | Caracteres DBCS sin SO/SI | 3270 |
| Sólo alfanumérico | Todos los caracteres SBCS, pero sin caracteres DBCS | 3270 |
| Sólo numérico | Sólo dígitos del 0 al 9, coma (,), punto (.), signo más (+), signo menos (-), y espacio ( ) | 3270 |
| DBCS abierto (O) | Caracteres SBCS y DBCS con SO/SI | 5250 |
| DBCS gráfico (G) | Caracteres gráficos de DBCS sin SO/SI | 5250 |
| Sólo DBCS (J) | Caracteres DBCS con SO/SI | 5250 |
| Cualquier DBCS (E) | Cualquier DBCS con SO/SI o caracteres SBCS | 5250 |
| Sólo alfabético (X) | Sólo caracteres de la A a la Z, coma (,), punto (.), signo menos (-) y espacio ( ) | 5250 |
| Cambio (Mayús) alfanumérico (A) | Todos los caracteres SBCS, pero sin caracteres DBCS | 5250 |
| Cambio (Mayús) numérico (N) | Todos los caracteres SBCS, pero sin caracteres DBCS | 5250 |
| Numérico con signo (S) | Sólo dígitos del 0 al 9 | 5250 |
| Sólo numérico (Y) | Sólo dígitos del 0 al 9, coma (,), punto (.), signo más (+), signo menos (-), y espacio ( ) | 5250 |
| Campo Katakana (W) | Todos los caracteres SBCS, pero sin caracteres DBCS | 5250 |
| Inhibir entrada de teclado (I) | Sin entrada del teclado, excepto de dispositivos especiales, por ejemplo un lápiz fotosensible | 5250 |
| Sólo dígitos (D) | Sólo dígitos del 0 al 9 | 5250 |
| Carácter sólo numérico (M) | Sólo dígitos del 0 al 9, coma (,), punto (.), signo más (+), signo menos (-), y espacio ( ) | 5250 |
Cada tipo de campo DBCS sólo debe contener el tipo de datos que se puede utilizar. Por ejemplo, el campo DBCS gráfico (G) sólo debe contener caracteres gráficos DBCS sin caracteres SO/SI. HATS efectúa la comprobación del tipo de datos para asegurarse de que sólo se pueden entrar tipos de datos permitidos en campos DBCS.
En un campo de una pantalla de sistema principal, los caracteres DBCS tienen una longitud de dos. En un campo de una página de GUI, los caracteres DBCS tienen una longitud de uno. Esta función de HATS comprueba la longitud de caracteres DBCS que se entran en un campo de GUI y no permite más caracteres de los que quepan en el campo de sistema principal correspondiente.
Esta función de HATS evita que un usuario copie y pegue datos con un tipo de datos incorrecto en un campo. Si se copian datos mixtos, se recortan todos los caracteres que siguen al primer carácter no permitido. Por ejemplo, si el usuario intenta pegar abc&cde en un campo, pero & es un carácter no permitido para el tipo de campo, sólo se pega abc.
El Editor de método de entrada (IME) es un procesador frontal (FEP) que maneja la entrada de teclado y genera series DBCS. Normalmente, el IME es un componente del sistema operativo, pero puede ser un único producto o formar parte de otra aplicación como un procesador de textos.
Los usuarios de DBCS pueden generar miles de caracteres diferentes con un teclado de tamaño normal. Normalmente, un usuario escribe una secuencia de caracteres y, a continuación, utiliza el IME para convertir la secuencia a caracteres de doble-byte. Es posible que la conversión tenga que volverse a intentar porque pueden haber varias traducciones o candidatos posibles para la misma secuencia de caracteres. Mientras se lleva a cabo esta conversión, el texto pertenece lógicamente al IME. Tras el proceso de conversión, el usuario emplea el IME para confirmar los caracteres de doble-byte convertidos en la aplicación. HATS da soporte a la utilización del IME para confirmar los caracteres de doble-byte en campos de HATS.
Si el usuario intenta introducir caracteres en el IME y su número supera la longitud máxima del campo de HATS representado, entonces el comportamiento difiere en función de los valores Eliminar longitud máxima en campos DBCS y Eliminar longitud máxima en campos SBCS. Si desea obtener más información sobre el valor Eliminar longitud máxima en campos DBCS, consulte Eliminar longitud máxima en campos DBCS. Si desea obtener más información sobre el valor Eliminar longitud máxima en campos SBCS, consulte Eliminar longitud máxima de SBCS.
A menudo, las pantallas de sistema principal pueden contener campos DBCS y SBCS. HATS activará automáticamente el IME si el cursor se encuentra en un campo DBCS y lo desactivará si el cursor se encuentra en un campo SBCS.
Para los campos DBCS mixto, DBCS abierto (O), Sólo DBCS (J) y Cualquier DBCS (E), si el valor Mostrar caracteres desprotegidos de fin e inicio de DBCS como espacios en el apartado DBCS de la pestaña Representación está seleccionado, los caracteres SO/SI se visualizan como espacios en la GUI. Si no se selecciona, los caracteres SO/SI no se visualizan en la GUI.
Para configurar esta propiedad para las conexiones utilizadas para los objetos de integración de HATS, utilice el parámetro de sesión de Host On-Demand omitSOSI. Este parámetro puede tener el valor true o false. Si es true, el objeto de integración de HATS omite los caracteres SO/SI para la conexión. Si es false (el valor por omisión), el objeto de integración de HATS sustituye los caracteres SO/SI por un espacio, como sucede normalmente. Si desea obtener información sobre cómo añadir la propiedad omitSOSI a la conexión de objeto de integración, consulte Configurar los valores de conexión opcionales y avanzados.
En este apartado se explican otras consideraciones para entender cuándo se utilizan las funciones generales de HATS para desarrollar aplicaciones que den soporte a DBCS.
Los valores siguientes están disponibles en el editor de valores del proyecto para proyectos DBCS. Consulte el Modificación de un proyecto de HATS para obtener información sobre otros valores del proyecto.
En la pestaña Representación puede configurar las siguientes opciones DBCS para el proyecto si la conexión por omisión especifica una página de códigos DBCS.
Si no está seleccionado este valor, los caracteres que superan la longitud máxima del campo DBCS no se pueden introducir en el IME.
Si está seleccionado, entonces:
Se admite este valor para los tipos de campo siguientes:
En la sección Valores del cliente de la pestaña Otros, considere los valores siguientes para proyectos DBCS.
Para aplicaciones Web de HATS, la característica de avance automático depende del número de caracteres y de la longitud de los campos actuales para decidir el momento del avance. Si el valor Mostrar caracteres desprotegidos de fin e inicio de DBCS como espacios en la sección DBCS de la pestaña Representación no está seleccionado, el número de caracteres nunca alcanza el límite del campo si un carácter DBCS se encuentra en el campo. Por tanto, para aplicaciones Web de HATS, si necesita la función de avance automático en el entorno DBCS, debe seleccionar el valor Mostrar caracteres desprotegidos de fin e inicio de DBCS como espacios.
Cuando se utiliza el IME para introducir datos en un campo, se utilizan dos tablas en el archivo KBS.js para definir las teclas que iniciarán el avance automático. Se proporciona un conjunto de teclas de inicio por omisión. Si es necesario, se pueden editar las tablas en el archivo KBS.js para cambiar los valores por omisión. Para editar el archivo KBS.js, desde la vista Navegador haga clic con el ratón dos veces en el archivo, que está situado en la carpeta nombre_proyecto\Web Content\common. El ejemplo siguiente muestra las teclas por omisión definidas en las dos tablas. Por ejemplo, la combinación de teclas ALT + SBCS/DBCS (código de tecla 25) es una tecla de inicio por omisión. Para añadir una tecla, escriba su código de tecla (su nombre de variable definido en el archivo KBS.js o su valor numérico) y un modificador de tecla (ALT, CTRL, o Mayúsculas) como sea necesario. Para saber cómo determinar el valor del código de tecla para una determinada tecla del teclado, consulte Determinación de los valores del código de tecla.
var IMEkeysForKeyUp = [ //-Keycode----ALT-CTRL-Shift----// [ CODE_ENTER, 0, 0, 0 ], [ CODE_M, 0, 1, 0 ], [ CODE_ENTER, 0, 1, 0 ] ]; var IMEkeysForKeyDown = [ //-Keycode----ALT-CTRL-Shift----// [ 25, 1, 0, 0 ] //Tecla ALT + SBCS/DBCS ];
La característica modalidad de sobrescritura (inicial) no está soportada para la entrada DBCS.
Si se selecciona este valor, cuando un usuario tabula en un campo J 5250, se selecciona todo el texto del campo si el campo recibe el foco. A continuación, si el usuario entra caracteres DBCS y utiliza la función Salida de campo para salir del campo, puede suprimirse el último carácter de la serie.
Para evitar este comportamiento, deseleccione el recuadro Seleccionar todo el texto enfocado y seleccione el recuadro Mostrar caracteres desprotegidos de fin e inicio de DBCS como espacios. En este caso, el cursor se coloca correctamente en la primera posición de entrada del campo. El usuario puede empezar a escribir en esta posición y, a continuación, utilizar la función Salida de campo para salir del campo.
No debe seleccionar criterios de reconocimiento de pantalla que contengan caracteres de doble byte (DBCS) partidos. Cualquier carácter DBCS seleccionado debe incluirse por completo en la región de selección. Consulte Criterios de reconocimiento de pantalla o Pantalla de inicio para obtener más información.
El valor siguiente está disponible para el componente Lista de selección para proyectos DBCS. Consulte Lista de selección para obtener una explicación de los otros valores del componente Lista de selección.
La siguiente es una consideración a tener en cuenta si utiliza el valor Divisiones de columna del componente Subarchivo. Consulte Subarchivo para obtener una explicación de los otros valores del componente Subarchivo.
La siguiente es una consideración a tener en cuenta si utiliza el valor Divisiones de columna del componente Tabla. Consulte Tabla para obtener una explicación de los otros valores del componente Tabla.
Si no está seleccionado este valor, no se pueden introducir en el IME los caracteres que superan la longitud máxima del campo SBCS.
Si está seleccionado, entonces:
Se admite este valor para los aparatos siguientes:
Se admite este valor para los tipos de campo siguientes:
Las siguientes son consideraciones a tener en cuenta si utiliza el soporte de macros en proyectos DBCS.
Cuando graba una macro, puede utilizar Añadir acción extraer para extraer información de la pantalla de sistema principal. Si desea obtener más información sobre Añadir acción extraer, consulte Añadir acción extraer. Tenga en cuenta el caso siguiente al extraer caracteres DBCS.
Cuando extrae una región de la pantalla de sistema principal a una tabla, puede modificar el formato de la tabla. Una de las modificaciones que puede hacer es dividir una columna de la tabla en dos columnas. Cuando pulsa Dividir, HATS divide la columna seleccionada. Si la columna contiene caracteres de doble byte (DBCS), la división puede dividir un carácter DBCS en dos columnas. En este caso, el carácter DBCS no aparecerá en ninguna de las columnas. Si ve que ocurre esto cuando edita una acción de extracción, utilice los botones Derecha e Izquierda para ajustar las columnas. El carácter DBCS dividido volverá a aparecer cuando esté contenido en una sola columna.
Si exporta una macro que contenga caracteres DBCS a una macro de Host Publisher/HOD y, a continuación, la importa en Host On-Demand, es posible que los caracteres DBCS queden ilegibles. Para evitar este problema, puede abrir la macro exportada con un editor que soporte codificación UTF-8, como el Bloc de notas, guardarla utilizando la codificación nativa y después importarla en Host On-Demand.
La siguiente es una consideración a tener en cuenta al crear un objeto de integración en un proyecto DBCS. Si desea obtener más información, consulte Creación de un objeto de integración.
Al nombrar una macro utilizada para crear un objeto de integración, los caracteres de doble-byte (anchura completa) no están permitidos:
En Internet Explorer Mobile, los cambios en los campos de entrada para las características soportadas de DBCS se efectúan cuando el cambio de entrada pierde el foco, es decir, cuando se produce el suceso de atenuación. Es diferente del soporte en navegadores de escritorio donde los cambios se efectúan en tiempo real utilizando el suceso de tecla.
Para la comprobación del tipo de datos, todos los caracteres que empiezan con un primer carácter no permitido se eliminan del campo de entrada cuando éste pierde el foco, es decir, cuando se produce el suceso de atenuación.
Si desea obtener más información, consulte Desarrollo de aplicaciones de HATS para dispositivos móviles.
Para representar correctamente caracteres DBCS en aplicaciones de cliente enriquecido de HATS que se ejecuten en plataformas Windows 2000 Japonés, asegúrese de descargar e instalar los paquetes de idioma de Eclipse 3.2.1 desde la página de descargas de Eclipse en http://download.eclipse.org/eclipse/downloads/. En la sección Language Packs (Paquetes de idioma), pulse 3.2.1_Language_Packs. En la sección SDK Language Packs, pulse, descargue e instale NLPack1 para la plataforma que utilice.
Puede utiliza el soporte de HATS para las tablas personalizadas de Host On-Demand para volver a correlacionar el teclado del usuario y los caracteres de pantalla mediante la personalización de las tablas de conversión de páginas de códigos. Si desea obtener más información, consulte Cómo volver a correlacionar el teclado y los caracteres de pantalla.
Los idiomas DBCS están formados por caracteres ideográficos en lugar de alfabetos fonéticos. En estos idiomas se utilizan miles de caracteres ideográficos y las páginas de códigos o fonts definidos actualmente no siempre cumplen los requisitos para estos caracteres. Los caracteres definidos por el usuario (UDC) se utilizan para dar soporte a los caracteres necesarios que no están definidos en las páginas de códigos o fonts. Mediante el editor de correlaciones UDC, puede asignar un punto de código local del área definida por el usuario (UDA) a un punto de código de sistema principal específico que está reservado para ese carácter.
Las funciones UDC de HATS dan soporte a los tipos de conexiones 3270, 3270E y 5250. El soporte de correlaciones UDC de HATS se utiliza para mostrar los UDC para las conexiones 3270, 3270E y 5250, y el soporte de imágenes de font UDC de HATS se utiliza para imprimir los UDC en modalidad PDF o PDT para conexiones 3270E.
Para habilitar el soporte de pantalla de UDC para las conexiones 3270, 3270E y 5250, siga estos pasos:
| Página de códigos | Ubicación o uso |
|---|---|
| 930 | Japonés (katakana) |
| 930 | Japonés (katakana ampliado) |
| 933 | Corea (ampliado) |
| 937 | Taiwán (chino tradicional ampliado) |
| 939 | Japonés (latín ampliado) |
| 1364 | Corea Euro |
| 1371 | Taiwán (chino tradicional) Euro |
| 1388 | RPC (chino simplificado ampliado; GB18030) |
| 1390 | Japonés (katakana unicode ampliado) |
| 1399 | Japonés (latín unicode ampliado) |
Cuando pulse Finalizar en el asistente UDC, HATS copia los archivos UDC relacionados al proyecto de HATS apropiado y actualiza los valores de conexión avanzados UDC_SETTING y UDC_TABLE_SELECTION en el proyecto.
Para habilitar el soporte de impresión de UDC para conexiones 3270E, siga estos pasos:
| Plataforma | Nombre del archivo de imagen de font |
|---|---|
| Windows Japonés | jpn24.fnt |
| Windows Coreano | kor24.fnt |
| Windows Chino simplificado | chs24.fnt |
| Windows Chino tradicional | cht24.fnt |
Cuando pulsa Finalizar, HATS copia los archivos UDC relacionados al proyecto de HATS apropiado.
Para imprimir los UDC en modalidad PDF de Adobe®, configure estos valores en la pestaña Impresión del editor de valores de conexión:
| Nombre | Valor |
|---|---|
| printDestination | false |
| printMimeType | application/pdf |
| printSaveAsExtension | |
| separateFiles | true |
| useAdobePDF | true |
| usePDT | false |
| useWindowsPrinter | false |
Para imprimir los UDC en modalidad PDT, configure estos valores en la pestaña Impresión del editor de valores de conexión:
| Nombre | Valor |
|---|---|
| PDTFile | La vía de acceso al archivo PDT, por ejemplo, MiPDT/NombreArchivoPDT.hodpdt. Consulte abajo la tabla de los nombre de archivo PDT que hay que utilizar en función de la página de códigos y de las impresoras PDT soportadas. |
| printDestination | false |
| printMimeType | application/octet-stream |
| printSaveAsExtension | .out |
| separateFiles | true |
| useAdobePDF | false |
| usePDT | true |
| useWindowsPrinter | false |
| Página de códigos | Impresora PDT soportada | Nombre de archivo PDT |
|---|---|---|
|
930 Japonés (katakana) 930 Japonés (katakana ampliado) 939 Japonés (latín ampliado) 1390 Japonés (katakana Unicode ampliado) 1399 Japonés (latín Unicode ampliado) |
Modalidad de texto ASCII | /pdfpdt/basic_dbcs.hodpdt |
| Impresoras basadas en ESC/P 24-J84 | /pdfpdt/esc_p.hodpdt | |
| IBM® 5577-B02,F02,G02,H02 | /pdfpdt/ibm5577.hodpdt | |
| Impresora IBM 5585-H01 | /pdfpdt/ibm5585.hodpdt | |
| IBM 5587-G01,H01 (sin función avanzada) | /pdfpdt/ibm5587.hodpdt | |
| Impresora Lips3a4 | /pdfpdt/lips3a4.hodpdt | |
| Impresora Lips3b4 | /pdfpdt/lips3b4.hodpdt | |
|
933 Corea (ampliado) 1364 Corea Euro |
Impresora IBM 5577 para Corea | /pdfpdt/ibm5577k.hodpdt |
| Impresora Ks_jo | /pdfpdt/ks_jo.hodpdt | |
| Impresora Ks_wan | /pdfpdt/ks_wan.hodpdt | |
| Impresora Kssm_jo | /pdfpdt/kssm_jo.hodpdt | |
| Impresora Kssm_wan | /pdfpdt/kssm_wan.hodpdt | |
|
937 Taiwán (chino tradicional ampliado) 1371 Taiwán (chino tradicional) Euro |
Impresora ESC/P (5550) para chino tradicional | /pdfpdt/esc_5550.hodpdt |
| Impresora ESC/P (big-5) para chino tradicional | /pdfpdt/esc_big5.hodpdt | |
| Impresora ESC/P (cns) para chino tradicional | /pdfpdt/esc_cns.hodpdt | |
| Impresora ESC/P (tca) para chino tradicional | /pdfpdt/esc_tca.hodpdt | |
| Impresora IBM 5577 para chino tradicional (sin función avanzada) | /pdfpdt/ibm5577t.hodpdt | |
| Impresora IBM 5585 para chino tradicional | /pdfpdt/ibm5585t.hodpdt | |
| 1388 RPC (chino simplificado ampliado; GB18030) | Impresora ESC/P para chino simplificado | /pdfpdt/esc_pp.hodpdt |
Para imprimir el contenido del archivo en modalidad PDT con una impresora PDT local, siga estos pasos: