ibm host access transformation services...exportación de un proyecto web .....35 importación de un...

IBM Host Access Transformation Services

Guía del usuario y del administradorVersión 9.6

*/*SC27-5904-02

IBM

NotaAntes de utilizar esta información y el producto al que da soporte, lea la información general que se encuentra en elAppendix C, “Avisos,” on page 539.

Décima edición (noviembre de 2017)

© Copyright IBM Corporation 2003, 2017.US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contractwith IBM Corp.

Contents

Chapter 1. Utilización de Host AccessTransformation Services (HATS) . . . . 1Descripción de los conceptos clave y los objetos deHATS. . . . . . . . . . . . . . . . . 2Descripción del proceso de las aplicaciones de HATS 9Descripción del desarrollo de las aplicaciones deHATS . . . . . . . . . . . . . . . . 11¿Cómo sé qué versión de HATS tengo? . . . . . 13Recopilación de información sobre determinación deproblemas . . . . . . . . . . . . . . . 14¿Dónde puedo encontrar información sobre HATS? 14

Chapter 2. Migración a HATS V9.6 . . . 17Migración de HATS . . . . . . . . . . . 17

Importación de un proyecto de HATS . . . . 17Utilización del asistente de migración de HATS 18Migración de las transformaciones de HATS . . 19Consideraciones especiales relativas a lamigración . . . . . . . . . . . . . . 19

HATS para usuarios de Host Publisher . . . . . 25Migración de Host Publisher Versión 4 . . . . 26

Migración de J2EE . . . . . . . . . . . . 29

Chapter 3. Desarrollo y despliegue deaplicaciones Web de HATS . . . . . . 31Organización de aplicaciones Web de HATS . . . 33

Traslado de proyectos Web de HATS a unarchivo .ear diferente . . . . . . . . . . 34

Copia de seguridad de proyectos de HATS . . . . 35Exportación e importación de proyectos Web deHATS . . . . . . . . . . . . . . . . 35

Exportación de un proyecto Web . . . . . . 35Importación de un proyecto Web . . . . . . 35

Despliegue de aplicaciones Web de HATS . . . . 36Habilitar el tiempo de ejecución de HATS . . . 36Exportación del proyecto como una aplicaciónJava EE . . . . . . . . . . . . . . . 37Instalación de la aplicación en un entorno deejecución . . . . . . . . . . . . . . 38Cambios necesarios en el entorno de ejecución . 39

Desarrollo de aplicaciones de HATS para el servidorde Apache Geronimo . . . . . . . . . . . 42

Instalación y configuración de servidoresGeronimo . . . . . . . . . . . . . . 42Consideraciones y limitaciones de los servidoresde Geronimo . . . . . . . . . . . . . 43

Desarrollo de aplicaciones de HATS para OracleWebLogic Server. . . . . . . . . . . . . 43

Instalación y configuración de servidoresWebLogic . . . . . . . . . . . . . . 43Consideraciones y limitaciones de los servidoresWebLogic . . . . . . . . . . . . . . 45

Desarrollo de aplicaciones de HATS para IBMBluemix Server . . . . . . . . . . . . . 46

Configuración de Rational SDP para IBMBluemix Server . . . . . . . . . . . . 46Consideraciones y limitaciones de IBM BluemixServer . . . . . . . . . . . . . . . 46

Desarrollo de aplicaciones de HATS para el PerfilLiberty de WebSphere Application Server . . . . 48

Consideraciones y limitaciones del Perfil Libertyde WebSphere Application Server . . . . . . 49

Desarrollo de aplicaciones de HATS paradispositivos móviles . . . . . . . . . . . 49

Consideraciones y limitaciones para dispositivosmóviles . . . . . . . . . . . . . . . 50Consideraciones y limitaciones para dispositivosiPad . . . . . . . . . . . . . . . . 57Consideraciones y limitaciones para dispositivosAndroid . . . . . . . . . . . . . . 57

Chapter 4. Desarrollo y despliegue deaplicaciones de cliente enriquecido deHATS . . . . . . . . . . . . . . . 59Desarrollo de aplicaciones de cliente enriquecido deHATS . . . . . . . . . . . . . . . . 60Especificaciones de la plataforma de destino . . . 61

Contenido del proyecto . . . . . . . . . 61Establecimiento del nivel de conformidad decompilador . . . . . . . . . . . . . 62

proyecto de extensión del tiempo de ejecución RCPde HATS . . . . . . . . . . . . . . . 62Trabajo con proyectos de cliente enriquecido deHATS . . . . . . . . . . . . . . . . 63

Copia de recursos entre proyectos Web yproyectos de cliente enriquecido . . . . . . 65Exportación e importación de proyectos decliente enriquecido de HATS . . . . . . . 66

Prueba de aplicaciones de cliente enriquecido deHATS . . . . . . . . . . . . . . . . 67

Configuración de la plataforma de destino . . . 67Instalación de plug-ins de tiempo de ejecución . 68Establecimiento del JRE por omisión . . . . . 69Inicio del proyecto . . . . . . . . . . . 70

Despliegue de aplicaciones de cliente enriquecido deHATS . . . . . . . . . . . . . . . . 72

Empaquetado de un entorno de cliente Eclipsepara la distribución. . . . . . . . . . . 72Preparación para clientes Eclipseecistentes(Eclipse RCP, Lotus Notes, o LotusExpeditor Client) . . . . . . . . . . . 73Actualización de los números de versión deplug-in y características . . . . . . . . . 83

Administración de aplicaciones de clienteenriquecido de HATS . . . . . . . . . . . 84Entorno de ejecución . . . . . . . . . . . 85

Vista Aplicaciones . . . . . . . . . . . 85Vista Transformación . . . . . . . . . . 87Solicitud de ID de estación de trabajo . . . . 89

© Copyright IBM Corp. 2003, 2017 iii

||

|||

||||||||||||

Solicitud de nombre de LU . . . . . . . . 89Preferencias . . . . . . . . . . . . . 89

Consideraciones y limitaciones de clientesenriquecidos de HATS. . . . . . . . . . . 93

Chapter 5. Modificación de un proyectode HATS . . . . . . . . . . . . . . 95Visión general . . . . . . . . . . . . . 95Conexiones . . . . . . . . . . . . . . 97Plantilla . . . . . . . . . . . . . . . 98Representación . . . . . . . . . . . . . 98

Representación por omisión . . . . . . . . 98Normas globales . . . . . . . . . . . 103Sustitución de texto . . . . . . . . . . 107Componentes y aparatos . . . . . . . . 107Barra de herramientas �Sólo RCP� . . . . . 108Área de teclado de aplicación . . . . . . . 108Área de teclado de sistema principal . . . . 108Área de información del operador . . . . . 109DBCS . . . . . . . . . . . . . . . 110

Sucesos . . . . . . . . . . . . . . . 110Prioridad de suceso de pantalla . . . . . . 111Sucesos de aplicación . . . . . . . . . . 112

Otros . . . . . . . . . . . . . . . . 115Soporte de teclado. . . . . . . . . . . 116Entorno local del cliente . . . . . . . . . 116Alteraciones de parámetros de conexión . . . 117Actualización asíncrona �Sólo RCP� . . . . . 120Desconexión y renovación automática�Sólo Web� . . . . . . . . . . . . . 120Alteraciones de variables globales . . . . . 127Valores de cliente . . . . . . . . . . . 128Asistencia de contenido de macro . . . . . 133Valores del portlet . . . . . . . . . . . 133

Fuente. . . . . . . . . . . . . . . . 135Utilización de preferencias de HATS. . . . . . 135Utilización de otras preferencias de Rational SDP 140

Chapter 6. Gestión de conexiones . . 141Creación de una conexión . . . . . . . . . 141Editor de conexiones . . . . . . . . . . . 142

Visión general . . . . . . . . . . . . 142Básica . . . . . . . . . . . . . . . 142Avanzadas . . . . . . . . . . . . . 143Impresión . . . . . . . . . . . . . 146Gestión de pantalla . . . . . . . . . . 148Seguridad . . . . . . . . . . . . . 150Agrupación . . . . . . . . . . . . . 152Macros . . . . . . . . . . . . . . 153Lista de usuarios . . . . . . . . . . . 154Fuente. . . . . . . . . . . . . . . 156

Chapter 7. Trabajo con sucesos depantalla . . . . . . . . . . . . . . 157Asistente Crear una personalización de pantalla 157Asistente Crear una combinación de pantallas . . 158Edición de sucesos de pantalla . . . . . . . 159

Visión general . . . . . . . . . . . . 159Criterios de reconocimiento de pantalla oPantalla de inicio . . . . . . . . . . . 159

Representación (sólo combinación de pantallas) 164Navegación (sólo combinación de pantallas) . . 164Pantalla de inicio (sólo combinación depantallas). . . . . . . . . . . . . . 165Acciones . . . . . . . . . . . . . . 165Normas globales . . . . . . . . . . . 178Sustitución de texto . . . . . . . . . . 178Pantalla siguiente . . . . . . . . . . . 180Fuente. . . . . . . . . . . . . . . 181

Pantallas inhibidas . . . . . . . . . . . 181Criterios de reconocimiento . . . . . . . 181Gestión automática de las pantallas inhibidas 182Gestión de varias pantalla inhibidas . . . . . 182

Importar conjuntos de correlaciones BMS . . . . 183

Chapter 8. Trabajar contransformaciones. . . . . . . . . . 185Asistente Crear una transformación . . . . . . 185Edición de transformaciones . . . . . . . . 187

Edición de transformaciones para proyectosWeb . . . . . . . . . . . . . . . 187Edición de transformaciones para proyectos decliente enriquecido . . . . . . . . . . 190

Asistentes de transformación . . . . . . . . 190Insertar componente de sistema principal . . . 190Editar componente de sistemaprincipal�Sólo Web� . . . . . . . . . . 192Transformación para edición Dojo �Sólo Web� 193Insertar representación por omisión . . . . . 193Editar representación por omisión�Sólo Web� 193Insertar carpeta con pestañas�Sólo Web� . . . 194Insertar tecla de macro . . . . . . . . . 195Insertar variable global . . . . . . . . . 195Insertar área de información del operador�Sólo Web� . . . . . . . . . . . . . 196Insertar área de teclado de sistema principal . . 196Insertar área de teclado de aplicación . . . . 197Insertar todos los componentes de sistemaprincipal�Sólo Web� . . . . . . . . . . 197Insertar pantalla almacenada�Sólo Web� . . . 198

Vista previa de transformaciones . . . . . . . 198Área de teclado de sistema principal . . . . . 198

Chapter 9. Valores y descripciones decomponentes y aparatos . . . . . . 201Valores de componentes y aparatos . . . . . . 201Valores de componentes de sistema principal . . . 201

Línea de mandatos . . . . . . . . . . 202Diálogo . . . . . . . . . . . . . . 202ENPTUI . . . . . . . . . . . . . . 205Campo . . . . . . . . . . . . . . 207Tecla de función . . . . . . . . . . . 208Palabra clave HTML DDS�Sólo Web� . . . . 210Campo de entrada. . . . . . . . . . . 211Campo de entrada con consejos . . . . . . 213Selección de elementos . . . . . . . . . 215Lápiz fotosensible (atención) . . . . . . . 216Lápiz fotosensible (selección) . . . . . . . 217Lista de selección . . . . . . . . . . . 218Subarchivo . . . . . . . . . . . . . 221

iv IBM Host Access Transformation Services: Guía del usuario y del administrador

Tabla . . . . . . . . . . . . . . . 228Tabla (campo) . . . . . . . . . . . . 230Tabla (visual) . . . . . . . . . . . . 231Texto . . . . . . . . . . . . . . . 233URL . . . . . . . . . . . . . . . 233

Valores de aparatos . . . . . . . . . . . 234Botón . . . . . . . . . . . . . . . 234Tabla de botones . . . . . . . . . . . 236Calendario�Sólo Web� . . . . . . . . . 238Recuadro de selección . . . . . . . . . 245Recuadro combinado �Sólo RCP� . . . . . . 247Diálogo . . . . . . . . . . . . . . 249Desplegable (entrada de datos) . . . . . . 251Desplegable (selección) . . . . . . . . . 254Campo . . . . . . . . . . . . . . 256Gráfico (barra horizontal, línea, barra vertical) 262Etiqueta . . . . . . . . . . . . . . 266Enlace . . . . . . . . . . . . . . . 267Enlace (selección de elemento). . . . . . . 269Lista . . . . . . . . . . . . . . . 271Emergente . . . . . . . . . . . . . 274Botón de selección (entrada de datos) . . . . 279Botón de selección (selección de elemento) . . 281Botón de selección (selección) . . . . . . . 283Barra de desplazamiento (ENPTUI) . . . . . 286Subarchivo (recuadro de selección) . . . . . 287Subarchivo (desplegable) . . . . . . . . 294Subarchivo (emergente) . . . . . . . . . 301Tabla . . . . . . . . . . . . . . . 308Entrada de texto . . . . . . . . . . . 314Barra de herramientas �Sólo RCP� . . . . . 318

Configuración de aparato (Dojo) . . . . . . . 322Consideraciones y limitaciones de aparato Dojode HATS . . . . . . . . . . . . . . 322Recuadro combinado (Dojo) �Sólo Web� . . . 323Recuadro de texto de fecha (Dojo) �Sólo Web� 325Cuadrícula ampliada (Dojo) �Sólo Web� . . . 328Selección de filtrado (Dojo) �Sólo Web� . . . . 329Recuadro de texto (Dojo) �Sólo Web� . . . . 332Recuadro de texto de validación (Dojo)�Sólo Web� . . . . . . . . . . . . . 332

Correlación entre componentes y aparatos . . . . 334

Chapter 10. Utilización de plantillas 337Ejemplos de plantillas . . . . . . . . . . 337Asistente Crear una plantilla . . . . . . . . 341Edición de plantillas . . . . . . . . . . . 342

Edición de plantillas para proyectos Web . . . 342Edición de plantillas para proyectos de clienteenriquecido . . . . . . . . . . . . . 347

Área de teclado de aplicación . . . . . . . . 347

Chapter 11. Macros y terminal desistema principal . . . . . . . . . . 349Editor de macros . . . . . . . . . . . . 350

Visión general . . . . . . . . . . . . 350Solicitudes y extracciones . . . . . . . . 362Fuente. . . . . . . . . . . . . . . 362

Trabajo con los errores de macros . . . . . . 362Importación de una macro . . . . . . . . . 363

Exportación de una macro . . . . . . . . . 363Sugerencias y consejos sobre las macros . . . . 364

Cómo evitar un bucle infinito . . . . . . . 364Manejo de pantallas transitorias . . . . . . 364

Chapter 12. Interacción con variablesglobales . . . . . . . . . . . . . 365Renombrar variables globales . . . . . . . . 367Diferencias entre variables globales y variables demacro . . . . . . . . . . . . . . . . 367

Variables globales . . . . . . . . . . . 367Variables de macro . . . . . . . . . . 368

Chapter 13. Utilización de objetos deintegración . . . . . . . . . . . . 369Creación de un objeto de integración . . . . . 369Encadenamiento de objetos de integración. . . . 371

Cómo se determina cuándo utilizar elencadenamiento de los objetos de integración . 371Utilización del encadenamiento de los objetosde integración . . . . . . . . . . . . 372Depuración de aplicaciones que utilizan elencadenamiento de los objetos de integración . 374

Creación de páginas Web a partir de un objeto deintegración . . . . . . . . . . . . . . 374

Creación de páginas Web del modelo 1. . . . 375Creación de páginas Web Struts . . . . . . 376Creación de páginas Web JSF . . . . . . . 377

BasicIOErrorPage.jsp y AdvancedIOErrorPage.jsp 378Trabajo con objetos de integración que están en JSP 378

Insertar propiedades de objeto de integración 378Insertar Reenviar a aplicación HATS. . . . . 379

Chapter 14. Combinación de pantallas 381Combinación de datos de salida contiguos . . . 381Combinación de datos de salida no contiguos . . 381Combinación de la salida de varias aplicaciones 382Combinación de la entrada de varias pantallas . . 382

Chapter 15. Habilitación de soporte deimpresión . . . . . . . . . . . . . 383Configuración de la sesión de impresión de sistemaprincipal en sistemas principales 3270 . . . . . 383Definición del soporte de impresión para elproyecto . . . . . . . . . . . . . . . 383

Para las conexiones 3270E . . . . . . . . 383Para las conexiones 5250 . . . . . . . . 386

Suministro de documentación para los usuarios 387

Chapter 16. Habilitación de soporte deteclado . . . . . . . . . . . . . . 389Definición del soporte de teclado . . . . . . . 389Cambio del aspecto de las áreas de teclado . . . 389Suministro de documentación para los usuarios 390

Soporte especial de teclas de campos 5250 . . . 392Cómo volver a correlacionar el teclado en unaaplicación de HATS . . . . . . . . . . . 393

Conceptos que deben entenderse antes devolver a correlacionar las teclas de HATS . . . 393

Contents v

Volver a correlacionar aplicaciones Web deHATS . . . . . . . . . . . . . . . 396Volver a correlacionar aplicaciones de clienteenriquecido de HATS. . . . . . . . . . 399Adición de botones adicionales de área deteclado a una transformación . . . . . . . 401

Chapter 17. Utilización de lasimulación de sistema principal . . . 403Asistente de simulación de sistema principal . . . 403Editor de simulación de sistema principal . . . . 404

Pestaña Visión general . . . . . . . . . 404Pestaña Fuente . . . . . . . . . . . . 405

Grabación en el entorno de ejecución . . . . . 405Opciones de reproducción . . . . . . . . . 405Importación y exportación de archivos de rastreo 406

Chapter 18. Utilización de la consolaadministrativa de HATS . . . . . . . 409Consola administrativa de HATS y seguridad deWebSphere . . . . . . . . . . . . . . 409Roles de la consola administrativa de HATS . . . 411Inicio de la consola administrativa de HATS . . . 412

Inicio de la consola administrativa en HATSToolkit. . . . . . . . . . . . . . . 413

Utilización de las funciones en la consolaadministrativa de HATS . . . . . . . . . . 413

Selección del ámbito de gestión . . . . . . 414Gestión de licencias . . . . . . . . . . 414Supervisión de conexiones . . . . . . . . 415Supervisión de agrupaciones de conexiones . . 415Supervisión de definiciones de agrupaciones 415Supervisión de listas de usuarios y miembros delistas de usuarios . . . . . . . . . . . 416Administración de componentes de ladeterminación de problemas . . . . . . . 416

Funciones de terminal de pantalla . . . . . . 420Utilización del terminal de pantalla para pruebay depuración . . . . . . . . . . . . 420

Chapter 19. WebSphere Portal y HATS 423Creación de portlets de HATS . . . . . . . . 423

Creación de un nuevo proyecto de portlet deHATS . . . . . . . . . . . . . . . 424Generación de portlets a partir de proyectosWeb de HATS . . . . . . . . . . . . 424

Trabajo con portlets de HATS . . . . . . . . 426Alteraciones de parámetros de conexión y devariables globales . . . . . . . . . . . 426Comunicación de portlets . . . . . . . . 427PDT personalizados y tablas personalizadas . . 430Web Services for Remote Portlets (WSRP) . . . 431

Prueba de portlets de HATS . . . . . . . . 431Exportación de portlets de HATS . . . . . . . 431Administración de portlets de HATS . . . . . 432

Utilización de una aplicación administrativa deHATS autónoma . . . . . . . . . . . 432

Consideraciones y limitaciones de portlets deHATS . . . . . . . . . . . . . . . . 433

Consideraciones y limitaciones comunes . . . 433

Chapter 20. WebFacing y HATS . . . 437Interacción de HATS con WebFacing . . . . . 437

Conexión de HATS a un servidor WebFacing 437Interoperatividad de HATS con aplicaciones deWebFacing . . . . . . . . . . . . . 438

Chapter 21. Seguridad e Inicio desesión Express en Web . . . . . . . 441Habilitación de la seguridad SSL . . . . . . . 441Habilitación de la seguridad SSH. . . . . . . 444Utilización del inicio de sesión Express en WEb(WEL) . . . . . . . . . . . . . . . . 444

Visión general . . . . . . . . . . . . 444Arquitectura. . . . . . . . . . . . . 445Planificación de la implementación . . . . . 446Implementación . . . . . . . . . . . 447Cómo crear una macro de inicio de sesión WEL 447Plug-in de seguridad de red . . . . . . . 448Plug-ins de Credential Mapper . . . . . . 448Parámetros de inicialización . . . . . . . 450Creación de archivo de almacén de claves SSL(sólo DCAS) . . . . . . . . . . . . . 457

Utilización de los tickets de servicios Kerberos . . 459Seguridad de Java 2 . . . . . . . . . . . 459

Archivo de políticas . . . . . . . . . . 460Utilización de la gestión de certificados de IBMpara aplicaciones de HATS . . . . . . . . . 460

Creación de un archivo de base de datos declaves . . . . . . . . . . . . . . . 461Solicitud y almacenamiento de certificados deentidades emisoras de certificados . . . . . 462Utilización de un certificado autofirmado . . . 464Intercambio de certificados . . . . . . . . 465Consideraciones sobre la herramienta Gestiónde certificados . . . . . . . . . . . . 465

Chapter 22. Soporte de idiomas . . . 467Códigos de idioma . . . . . . . . . . . 467Páginas de códigos . . . . . . . . . . . 468Valores de codificación . . . . . . . . . . 470Soporte Unicode para sistemas principales 5250 471Utilización de caracteres acentuados con la páginade códigos 937 . . . . . . . . . . . . . 471Utilización de la página de códigos 1388 (GB18030) 471Correlación de códigos de sistema principal parapáginas de códigos 1390 y 1399 . . . . . . . 472

Soporte de JIS2004. . . . . . . . . . . 473Cómo volver a correlacionar el teclado y loscaracteres de pantalla. . . . . . . . . . . 475

Prioridad de sustitución de caracteres . . . . 476

Chapter 23. Soporte de aplicacionesbidireccionales. . . . . . . . . . . 477Entorno de software . . . . . . . . . . . 478Trabajo con el terminal de sistema principal . . . 478

Limitaciones del terminal de sistema principal 480Captura de pantallas . . . . . . . . . . 480

Reconocimiento de componentes de sistemaprincipal bidireccionales . . . . . . . . . . 480Control de la orientación de aparatos . . . . . 481

vi IBM Host Access Transformation Services: Guía del usuario y del administrador

Control de la alineación de aparatos . . . . . . 482Componentes personalizados y soportebidireccional de aparatos . . . . . . . . . 483Variables globales . . . . . . . . . . . . 483Sustitución de texto . . . . . . . . . . . 483Normas globales . . . . . . . . . . . . 484Permitir al usuario que invierta la dirección de lapantalla . . . . . . . . . . . . . . . 485Opciones de pantalla bidireccional VT . . . . . 485Opciones bidireccionales de solicitud y extracto demacro . . . . . . . . . . . . . . . . 486Opciones bidireccionales de macro para consultaSQL . . . . . . . . . . . . . . . . 486Soporte de impresión de derecha a izquierda . . . 487Soporte de correlaciones BMS . . . . . . . . 488Soporte de objetos de integración. . . . . . . 488Soporte de servicios Web de abajo a arriba . . . 489Soporte de servicios Web RESTful . . . . . . 490Soporte de portlet . . . . . . . . . . . . 490Información para usuarios . . . . . . . . . 491

Inversión de campo automática . . . . . . 492Inversión de campo . . . . . . . . . . 492Funciones del portapapeles . . . . . . . . 492Área de información del operador (OIA) . . . 493Conmutación automática de la capa de teclado 493

Soporte Unicode para sistemas principales 5250IBM i . . . . . . . . . . . . . . . . 493Funciones para las páginas de códigos en árabe 493

Orientación de pantalla de HATS Toolkit . . . 493Personalización de la dirección de páginas JSP 494Dirección de forma . . . . . . . . . . 494Forma selectiva del árabe . . . . . . . . 495Intercambio simétrico y numérico . . . . . 495Inhabilitar entrada de dígitosárabes-occidentales . . . . . . . . . . 495Conmutación automática de la capa de teclado 495Limitaciones del terminal de sistema principal 496Capturas de pantalla . . . . . . . . . . 496Configuración de las sesiones de impresión enárabe en Web Access para System i . . . . . 496Otras consideraciones . . . . . . . . . 497

Adiciones a los archivos de HATS . . . . . . 497

Chapter 24. Soporte para el juego decaracteres de doble-byte . . . . . . 499Soporte de campos DBCS y SBCS . . . . . . 499Comprobación del tipo de datos . . . . . . . 500Comprobación de la longitud de los campos . . . 500Prevención de copiar-y-pegar . . . . . . . . 500Editor de método de entrada (IME) . . . . . . 500Conmutación AutoIME . . . . . . . . . . 501Consideraciones sobre caracteres de fin e inicio deDBCS . . . . . . . . . . . . . . . . 501Otras consideraciones . . . . . . . . . . 501

Valores de tema del proyecto . . . . . . . 502Editor de valores del proyecto . . . . . . . 502Editor de sucesos de pantalla . . . . . . . 504Componentes de sistema principal . . . . . 504Aparatos . . . . . . . . . . . . . . 505Soporte de macros. . . . . . . . . . . 506Creación de un objeto de integración . . . . 506Trabajo con aplicaciones de dispositivos móviles 506Cómo volver a correlacionar el teclado y loscaracteres de pantalla. . . . . . . . . . 507Trabajo con caracteres definidos por el usuario 507

Appendix A. Archivos de propiedadesde unidad ejecutable . . . . . . . . 513Opciones de rastreo . . . . . . . . . . . 517Rastreo Host On-Demand . . . . . . . . . 518Rastreo de simulación de sistema principal . . . 521

Appendix B. Material de consulta paraestabilización de pantalla en HATS . . 523Visión general de la estabilización de pantalla . . 523Procedimiento de estabilización de pantalla . . . 523Análisis de datos de salida . . . . . . . . . 524Espera de distintivos OIA . . . . . . . . . 527Cambio de los valores de personalización . . . . 528Determinar la estrategia de HATS . . . . . . 529Resolución de conflictos (sólo TN3270E) . . . . 529

Resolución de conflictos utilizando z/OSCommunications Server . . . . . . . . . 530Resolución de conflictos utilizando otrosCommunications Servers . . . . . . . . 530Impacto en el rendimiento del uso de laresolución de conflictos . . . . . . . . . 531Determinación del estado de la resolución deconflictos . . . . . . . . . . . . . . 531

Renovación automática . . . . . . . . . . 532Gestión de pantallas transitorias . . . . . . . 532Valores de gestión de pantalla en blanco inicial . . 534Valores de HATS relacionados . . . . . . . . 535Ajuste de la estabilización de pantalla de HATS 536Referencias . . . . . . . . . . . . . . 538

Información sobre resolución de conflictos. . . 538Advanced Macro Guide . . . . . . . . . 538

Appendix C. Avisos . . . . . . . . . 539Programación de información de interfaz . . . . 541Marcas registradas. . . . . . . . . . . . 541

Glosario . . . . . . . . . . . . . 543

Index . . . . . . . . . . . . . . . 549

Contents vii

viii IBM Host Access Transformation Services: Guía del usuario y del administrador

Chapter 1. Utilización de Host Access TransformationServices (HATS)

Cpn IBM® Host Access Transformation Services (HATS), puede crear aplicacionesWeb y aplicaciones de cliente enriquecido que proporcionan una interfaz gráfica deusuario (GUI) fácil de utilizar para las aplicaciones 3270 que se ejecutan enplataformas IBM z Systems y para las aplicaciones 5250 que se ejecutan enplataformas del sistema operativo IBM i. Las aplicaciones HATS pueden acceder alas de 5250 y no requieren la capacidad de proceso de transacciones en línea(OLTP). En esta publicación, las aplicaciones 3270 y 5250 basadas en caracteres seconocen como aplicaciones de sistema principal. También puede crear crear activosde SOA (service Oriented oriented) utilizando servicios Web que proporcioneninterfaces de programación estándar para lógica empresarial y transaccionesincluidas en aplicaciones de sistema principal. Asimismo se puede acceder a datosde las pantallas de emulación de terminal de vídeo (VT).

Se puede dar un aspecto moderno a las aplicaciones de HATS. Las aplicacionesWeb de HATS se pueden desarrollar con una interfaz que coincida con las páginasde portal o de Web de la empresa, a las que los usuarios podrán tener accesomediante navegadores Web. También pueden desarrollarse aplicaciones Web deHATS para proporcionar acceso a las aplicaciones de sistema principal desdedispositivos móviles, como teléfonos móviles, terminales de recopilación de datos yasistentes digitales personales (PDA).

Las aplicaciones de cliente enriquecido de HATS pueden desarrollarse para que seejecuten en una implementación de la plataforma de cliente enriquecido (RCP) deEclipse, en Lotus Notes® o en Lotus® Expeditor Client a fin de proporcionaraplicaciones cliente nativas dirigidas al escritorio de un usuario. Si desea obtenermás información sobre el entorno RCP de Eclipse, consulte http://www.eclipse.org/home/categories/rcp.php. Para obtener más información acercade Lotus Notes consulte Lotus Notes Knowledge Center en http://www-01.ibm.com/support/knowledgecenter/SSKTMJ_8.5.3/welcome_Domino_8_5_3.html. Para obtener más información acerca de LotusExpeditor Client, consulte Lotus Expeditor Knowledge Center enhttp://www-01.ibm.com/support/knowledgecenter/SSVHEW_6.2.0/welcome.html.

Si desea obtener más información sobre las novedades de HATS V9.6, consulte lapublicación HATS Getting Started.

Note: A lo largo de este documento, los valores de configuración que se aplicansolo a aplicaciones Web de HATS y aplicaciones EJB, se marcan con�Sólo Web�, a menos que se indique lo contrario. Los valores deconfiguración que se aplican solo a las aplicaciones de la plataforma decliente enriquecido de HATS se marcan con �Sólo RCP�.

HATS tiene dos componentes:v HATS Toolkit es un conjunto de plug-ins para IBM Rational® Software Delivery

Platform (Rational SDP) basada en Eclipse. Si desea obtener más informaciónsobre qué versiones de Rational SDP están soportadas, consulte la sección,Requisitos previos, en HATS Getting Started.

© Copyright IBM Corp. 2003, 2017 1

||||||||||||

|||||||

|

|||||

http://www.eclipse.org/home/categories/rcp.phphttp://www.eclipse.org/home/categories/rcp.phphttp://www.ibm.com/support/knowledgecenter/SSKTMJhttp://www.ibm.com/support/knowledgecenter/SSKTMJhttp://www.ibm.com/support/knowledgecenter/SSKTMJhttp://www.ibm.com/support/knowledgecenter/SSVHEWhttp://www.ibm.com/support/knowledgecenter/SSVHEWgsintro.htm#whatsnewgsinstal.htm#prereqs

HATS Toolkit permite desarrollar aplicaciones nuevas, paso a paso, guardando ymostrando una vista previa de cada cambio efectuado. Con el tiempo, o tanpronto como desee, podrá optimizar las aplicaciones de HATS, para que seanmás fáciles de utilizar que las aplicaciones de sistema principal cuyos datospresentan y trasladar las funciones de las aplicaciones de sistema principal a lasaplicaciones de HATS. El proceso de desarrollo para crear aplicaciones Web y decliente enriquecido de HATS es parecido. Si desea obtener más información,consulte “Descripción del desarrollo de las aplicaciones de HATS” on page 11.Después de desarrollar una aplicación de HATS, debe desplegarse en un entornode ejecución de producción.

v El código de tiempo de ejecución de HATS se ejecuta como parte de unaaplicación HATS desplegada en el entorno de ejecución de producción,WebSphere® Application Server, WebSphere Portal, el servidor de aplicacionesweb Apache Geronimo con el contenedor web Tomcat, Oracle WebLogic Server ola plataforma cliente enriquecido. Los usuarios interacción con la aplicación deHATS a través de la interfaz gráfica de usuario (GUI) de HATS y los datos seenvían entre el usuario y la aplicación de sistema principal en ambos sentidos.

Si desea obtener más información, consulte el Chapter 3, “Desarrollo y desplieguede aplicaciones Web de HATS,” on page 31 y el Chapter 4, “Desarrollo ydespliegue de aplicaciones de cliente enriquecido de HATS,” on page 59.

Descripción de los conceptos clave y los objetos de HATSEn este apartado se analizan los conceptos clave y los objetos de HATS, algunos delos cuales se describen en “Descripción del proceso de las aplicaciones de HATS”on page 9. Muchos de los objetos de HATS se crean utilizando un asistente, pero sevisualizan o se modifican después utilizando un editor.

ProyectoUna colección de recursos de HATS (también llamados artefactos) que secrean utilizando asistentes de HATS Toolkit y se personalizan utilizandoeditores de HATS Toolkit. Estos recursos se exportan como una aplicación deHATS. Hay cinco tipos de projects HATS: Web, EJB, de cliente enriquecido y,para administrar aplicaciones Web de HATS (incluido EJB), proyectos deconsola de administración de HATS. Si desea obtener más información,consulte el Chapter 3, “Desarrollo y despliegue de aplicaciones Web deHATS,” on page 31.

SucesoRecurso de HATS que realiza un conjunto de acciones basadas en un estadodeterminado que se alcanza. Hay dos tipos de sucesos de HATS, sucesos deaplicación y sucesos de pantalla.

Suceso de aplicaciónUn suceso de HATS que se desencadena por cambios de estado en el ciclo devida de la aplicación. Ejemplos de sucesos de aplicación son: el acceso de unusuario a una aplicación de HATS por primera vez (suceso de inicio), o unaaplicación que encuentra una pantalla no reconocida (suceso de pantalla sincoincidencia). Si desea obtener más información, consulte “Sucesos deaplicación” on page 112.

Suceso de pantallaUn suceso de HATS que se desencadena cuando se reconoce una pantalla desistema principal al coincidir criterios determinados de reconocimiento depantalla. Hay dos tipos de sucesos de pantalla, personalizaciones de pantallay combinaciones de pantallas.

2 IBM Host Access Transformation Services: Guía del usuario y del administrador

|

||||||||

Personalización de pantallaUn suceso de pantalla de HATS diseñado para realizar un conjunto deacciones cuando se reconoce una pantalla de sistema principal. Ejemplos depersonalizaciones de pantalla son: el reconocimiento de una pantalla y sutransformación en una GUI para el usuario o la ejecución de una macro paraomitir la pantalla. La definición de personalización de pantalla incluye unconjunto de criterios de reconocimiento de pantalla y una lista de accionesque se deben llevar a cabo cuando una pantalla de sistema principal coincidecon los criterios de reconocimiento de pantalla. Se incluyen también normasglobales a nivel de pantalla y valores de sustitución de texto. Si desea obtenermás información, consulte el Chapter 7, “Trabajo con sucesos de pantalla,” onpage 157.

Combinación de pantallasUn suceso de pantalla de HATS diseñado para recopilar datos de salida depantallas de sistema principal consecutivas y similares, para luegocombinarlos y visualizarlos en una única página de salida. Un ejemplo deuna combinación de pantallas puede ser el reconocimiento de una pantallaque solo contenga datos parciales y la navegación a través de todas laspantallas posteriores para recopilar todos los datos restantes para que losvisualice el usuario. La definición de combinación de pantallas incluye unconjunto de criterios de reconocimiento de pantallas para las pantallas deinicio y final que desee combinar, cómo navegar de pantalla a pantalla, asícomo el componente y el aparato que desee utilizar para reconocer yrepresentar los datos recopilados de cada pantalla. Además, incluye una listade acciones que deben efectuarse una o más veces, normas globales a nivelde pantalla y valores de sustitución de texto. Si desea obtener másinformación, consulte el Chapter 7, “Trabajo con sucesos de pantalla,” onpage 157.

Criterios de reconocimiento de pantallaCuando se crea un suceso de pantalla, se establecen criterios dereconocimiento de pantalla que HATS utiliza para relacionar una o máspantallas. Las pantallas de sistema principal se pueden reconocer mediantecualquier combinación de criterios, incluidos cuántos campos o campos deentrada hay en la pantalla, las coordenadas de la posición del cursor y lasseries de texto en la pantalla dentro de un rectángulo definido o en cualquierotro punto de la pantalla. También puede utilizar variables globales, colores,comparaciones de región con valor y región con región como criterios dereconocimiento de pantalla.

Cuando un sistema principal muestra una pantalla, HATS determina si lapantalla de sistema principal actual coincide con alguno de los criterios dereconocimiento de pantalla establecidos en algún suceso de pantalla delproyecto. Si HATS encuentra una coincidencia, se realizan las accionesdefinidas para el suceso de pantalla.

Si desea obtener más información sobre el establecimiento de criterios dereconocimiento de pantalla, consulte “Criterios de reconocimiento de pantallao Pantalla de inicio” on page 159.

AcciónEl paso que se da cuando se produce un suceso, por ejemplo, cuando seencuentra una pantalla de sistema principal que coincide con los criterios dereconocimiento de pantalla especificados para un suceso de pantalla. Unalista de acciones forma parte de la definición de cada suceso de aplicación ysuceso de pantalla.

Chapter 1. Utilización de Host Access Transformation Services (HATS) 3

TransformaciónUn archivo JSP (JavaServer Pages) (para proyectos Web) o un compuestoSWT (Standard Widgets Toolkit) (para proyectos de cliente enriquecido) quedefine cómo se deben extraer y mostrar los componentes de sistema principalutilizando aparatos en una GUI. Aplicar una transformación es una de lasacciones posibles de un suceso de pantalla. Puede editar las transformacionesen modalidad WYSIWYG, arrastrando componentes de HATS desde la paletay modificando valores desde la vista Propiedades de HATS. No puede editartransformaciones de cliente enriquecido en modalidad WYSIWYG porqueJava Visual Editor ya no está disponible en Rational SDP V9.6. Para obtenermás información sobre las funciones eliminadas y en desuso en RationalApplication Developer, consulte http://www.ibm.com/support/docview.wss?uid=swg27038549.

Si desea obtener más información sobre la creación de transformaciones,consulte el Chapter 8, “Trabajar con transformaciones,” on page 185.

Componentes de sistema principalLos Componentes de sistema principal son objetos de HATSresponsables del reconocimiento de los elementos de la pantalla desistema principal (por ejemplo, líneas de mandatos, teclas de función,etc.) que presenta al usuario de la aplicación de HATS. Puede utilizarel conjunto de componentes de sistema principal que suministraHATS, o puede crear uno propio.

Si desea obtener más información sobre la selección de loscomponentes de sistema principal que desea utilizar con el proyectode HATS, consulte “Insertar componente de sistema principal” onpage 190.

Si desea obtener más información sobre el uso del asistente paracrear componentes y aparatos personalizados, consulte la publicaciónHATS Web Application Programmer's Guide o la publicación HATS RichClient Platform Programmer's Guide, en función de su entorno deaplicación.

AparatosLos aparatos son objetos de HATS responsables de la creación de lasalida GUI para los componentes de sistema principal en lapresentación de HATS. Por ejemplo, puede convertir los componentesde sistema principal de tecla de función en aparatos de botónpermitiendo que el usuario vea las teclas de función como pulsadoresen la aplicación de HATS. Puede utilizar los aparatos que sesuministran con HATS o puede crear los suyos propios.

Si desea obtener más información sobre la selección de los aparatosque desea utilizar con el proyecto de HATS, consulte “Insertarcomponente de sistema principal” on page 190.

Si desea obtener más información sobre el uso del asistente paracrear componentes y aparatos personalizados, consulte la publicaciónHATS Web Application Programmer's Guide o la publicación HATS RichClient Platform Programmer's Guide, en función de su entorno deaplicación.

ConexiónUn conjunto de parámetros que utiliza HATS para conectarse a lasaplicaciones de sistema principal. Hay dos tipos de conexiones en HATS: poromisión (también llamada de transformación) y de fondo. Cada aplicación deHATS tiene una conexión por omisión para la aplicación de sistema principal


||||||||||||

http://www.ibm.com/support/docview.wss?uid=swg27038549http://www.ibm.com/support/docview.wss?uid=swg27038549pgcmpwgt.htmrcppgd10.htm#pgcmpwgtrcppgd10.htm#pgcmpwgtpgcmpwgt.htmrcppgd10.htm#pgcmpwgtrcppgd10.htm#pgcmpwgt

cuyas pantallas transformará HATS. Las conexiones de fondo son lasconexiones de una aplicación de HATS que no son la conexión por omisión.HATS no transforma pantallas desde las conexiones de fondo. No obstante,es posible elegir dinámicamente qué conexión se tratará como la conexiónpor omisión. Si desea obtener más información, consulte Chapter 6, “Gestiónde conexiones,” on page 141.

Normas globalesLas normas que especifican la sustitución a nivel de pantalla o a nivel deproyecto de un tipo determinado de campo de entrada de sistema principalpor un aparato particular utilizando fragmentos de transformación. Elfragmento de transformación incluye el contenido que desea utilizar parasustituir todas las apariciones de un patrón determinado en unatransformación.

Note: las normas globales se pueden desactivar para un uso específico deuna transformación, editando la acción de transformación de un sucesode pantalla.

Si desea obtener más información, consulte “Representación” on page 98.

Representación por omisiónMétodo utilizado por HATS para representar una pantalla de sistemaprincipal para la que no existe un suceso de pantalla específico. Larepresentación por omisión también puede utilizarse en una transformaciónespecífica que se aplique a un área definida de una pantalla de sistemaprincipal. Si desea obtener más información, consulte “Representación” onpage 98.

Sustitución de textoLa sustitución de texto se utiliza a nivel de proyecto o a nivel de pantallapara transformar el texto de las pantallas de sistema principal en imágenes,HTML �Sólo Web� u otro tipo de texto en la transformación de GUI. Si deseaobtener más información, consulte “Sustitución de texto” on page 107.

PlantillaUn archivo JSP (para proyectos Web) o una clase de compuesto SWT Java™

(para proyectos de cliente enriquecido) que permite mejorar la apariencia delproyecto. Cuando se crea un objeto de HATS, se selecciona una plantilla parautilizarla como plantilla por omisión del proyecto. La plantilla puedecontener logotipos de empresa, información y enlaces con otras páginas.Puede seleccionar su plantilla por omisión entre las plantillas de ejemplo quese proporcionan con HATS, o puede diseñar plantillas personalizadas paralos proyectos utilizando los asistentes y editores de HATS Toolkit. Tambiénpuede crear una plantilla predefinida a partir de un archivo existente o, paraproyectos Web, predefinida a partir de un URL.

En la GUI, la plantilla rodea el área donde aparece la transformación. Puedeaplicar una plantilla distinta a la plantilla por omisión como resultado de unsuceso de pantalla. Si desea obtener más información sobre la asociación deuna plantilla con una transformación, consulte el Chapter 10, “Utilización deplantillas,” on page 337.

Lógica empresarialTodo código Java que se invoca como acción en un suceso, por ejemplo, unapersonalización de pantalla. La lógica empresarial es específica de laaplicación.


Si desea obtener más información sobre la lógica empresarial, consulte lapublicación HATS Web Application Programmer's Guide o la publicación HATSRich Client Platform Programmer's Guide, en función de su entorno deaplicación.

Variable globalUna variable utilizada para almacenar un valor que se puede utilizar durantetoda la vida de una instancia de aplicación de HATS. El valor de unavariable global se puede extraer de una pantalla de sistema principal o puedeser definido por el desarrollador. Las variables globales se pueden utilizar enplantillas, transformaciones, acciones de suceso de pantalla o criterios dereconocimiento. También se pueden compartir entre las aplicaciones Web enun archivo Enterprise Archive (.ear) o entre las aplicaciones de clienteenriquecido que se ejecutan en el mismo entorno de cliente enriquecido. Lasvariables globales se pueden indexar, y también se pueden utilizar en macros,lógica empresarial y objetos de integración.

Si desea obtener más información sobre variables globales, consulte elChapter 12, “Interacción con variables globales,” on page 365.

MacroUn script XML que define un conjunto de pantallas y determinadas accionesque se deben realizar en esas pantallas. Utilice las macros para automatizarlas interacciones del usuario con el sistema principal. Puede registrar yejecutar macros para saltar pantallas, hacer bucles, solicitar la entrada dedatos a los usuarios (o insertarlos usted mismo o con variables globales), yextraer información de las pantallas de sistema principal.

Las macros se pueden utilizar de distintas formas en una aplicación deHATS:v Se puede ejecutar una macro en la conexión por omisión como parte de

una acción Ejecutar macro de un suceso de HATS. Debe ser la últimaacción definida para un suceso de pantalla.

v Se puede ejecutar una macro en una conexión de fondo como parte de unaacción Realizar transacción de macro de un suceso de HATS.

v Se puede ejecutar una macro añadiendo botones de macro a unatransformación. Esto permite a un usuario controlar si se ejecuta la macroo no.

v Se puede ejecutar una macro mediante un objeto de integración.v Se puede utilizar una macro de conexión para iniciar una conexión.v Se puede utilizar una macro de desconexión terminar una conexión.Si desea obtener más información sobre la incorporación de macros en elentorno de HATS, consulte el Chapter 11, “Macros y terminal de sistemaprincipal,” on page 349.

Objetos de integraciónLos objetos Java creados desde una macro que se pueden utilizar comobloques de construcción para las aplicaciones WebSphere. Los objetos deintegración son beans de Java que encapsulan interacciones con los orígenesde datos de sistema principal. Estos orígenes de datos incluyen aplicacionesorientadas al terminal que utilizan datos 3270, 5250 y de terminal de vídeo(VT).

Los objetos de integración que comparten la misma conexión se puedenagrupar para formar una sola tarea principal en la aplicación de HATS. Esto


pgblogic.htmrcppgd09.htm#pgblogicrcppgd09.htm#pgblogic

se conoce como encadenamiento de objetos de integración. Si desea obtenermás información, consulte el Chapter 13, “Utilización de objetos deintegración,” on page 369.

Terminal de sistema principalUna conexión en HATS Toolkit con un sistema principal activado. Utilizandoel terminal de sistema principal, puede capturar pantallas, crear sucesos depantalla y transformaciones, así como registrar y editar macros. Tambiénpuede ejecutar macros importadas o registradas previamente. El terminal desistema principal también le permite ver una vista previa de la pantalla cómoGUI.

Terminal de pantallaUna ventana de terminal que muestra pantallas de sistema principal quepuede utilizar mientras prueba y depura para observar las interacciones entreuna aplicación de HATS y una aplicación de sistema principal en tiempo deejecución. También puede interactuar con la aplicación de sistema principalmediante pantallas de sistema principal en la ventana de terminal. Si deseaobtener más información sobre el terminal de pantalla, consulte “Utilizacióndel terminal de pantalla para prueba y depuración” on page 420.

Captura de pantallaUna representación XML de una pantalla de sistema principal, almacenada enun archivo .hsc, que se utiliza para crear o personalizar una personalizaciónde pantalla, una combinación de pantallas, una transformación, una normaglobal o una macro. Las capturas de pantalla son útiles porque permitenpersonalizar un proyecto de HATS aunque no esté conectado al sistemaprincipal. Resultan también de utilidad para crear macros que son el núcleodel soporte de objetos de integración de HATS y servicios Web.

Al configurar la agrupación, se pueden utilizar las capturas de pantalla de laspantallas de sistema principal de terminal de vídeo (VT) para crear opersonalizar una macro mediante el Editor de macros visual y como lapantalla de comprobación. No se pueden utilizar para crear personalizacionesde pantalla, combinaciones de pantallas, transformaciones, representación poromisión o normas globales.

Ejecutar en servidor�Sólo Web�Una función de Rational SDP que permite probar los proyectos Web de HATSen un servidor de WebSphere Application Server o en una instancia deWebSphere Portal, según sea adecuado. En esta modalidad puede modificar yprobar los valores de tiempo de ejecución, definidos en el archivoruntime.properties, que se despliegan en el entorno de ejecución. Tenga encuenta que cualquier cambio efectuado en los valores del tiempo de ejecuciónmientras se efectúan pruebas en esta modalidad se retienen y pasan aaplicarse al desplegar la aplicación de HATS en un entorno de ejecución. Sidesea obtener más información sobre el cambio de valores del tiempo deejecución, consulte “Administración de componentes de la determinación deproblemas” on page 416.

Depurar en servidor �Sólo Web�Igual que Ejecutar en servidor y además permite:v Utilizar el terminal de pantalla para ver las pantallas de sistema principal a

medida que navega a través de ellas al probar el proyecto.v Ver los mensajes del depurador en la consola de Rational SDP.v Ver los cambios efectuados en el proyecto, por ejemplo, cambiar la plantilla

o una transformación, sin tener que reiniciar la aplicación en el servidor depruebas.


|||||||||||

v Modificar y probar valores de tiempo de ejecución, definidos en el archivoruntime-debug.properties, sin modificar los valores, definidos en el archivoruntime.properties, que se despliegan en el entorno de ejecución.

v Recorrer el código Java, como la lógica empresarial de HATS.Crear perfiles en servidor �Sólo Web�

Igual que Ejecutar en servidor y además permite localizar las operacionesque requieren más tiempo e identificar las acciones están repetidas paraeliminar redundancias. Puede utilizar esta función para el análisis derendimiento, lo que permite conocer mejor la aplicación.

Ejecutar �Sólo RCP�Una función de Rational SDP que permite probar proyectos de clienteenriquecido de HATS en una instancia de Eclipse, de Lotus Notes o de LotusExpeditor Client. En esta modalidad puede modificar y probar los valores detiempo de ejecución, definidos en el archivo runtime.properties, que sedespliegan en el entorno de ejecución. Tenga en cuenta que cualquier cambioefectuado en los valores del tiempo de ejecución mientras se efectúanpruebas en esta modalidad se retienen y pasan a aplicarse al desplegar laaplicación de HATS en un entorno de ejecución. Si desea obtener másinformación sobre el cambio de valores del tiempo de ejecución, consulte“Administración de aplicaciones de cliente enriquecido de HATS” on page84.

Depurar �Sólo RCP�Igual que Ejecutar y además permite:v Utilizar el terminal de pantalla para ver las pantallas de sistema principal a

medida que navega a través de ellas al probar el proyecto.v Ver los mensajes del depurador en la consola de Rational SDP.v Ver los cambios efectuados en el proyecto, por ejemplo, cambiar la plantilla

o una transformación, sin tener que reiniciar la aplicación.v Modificar y probar valores de tiempo de ejecución, definidos en el archivo

runtime-debug.properties, sin cambiar los valores de tiempo de ejecución,definidos en el archivo runtime.properties, que se despliegan en el entornode ejecución.

v Recorrer el código Java, como la lógica empresarial de HATS.Crear perfiles �Sólo RCP�

Igual que Ejecutar y además permite localizar las operaciones que requierenmás tiempo e identificar las acciones están repetidas para eliminarredundancias. Puede utilizar esta función para el análisis de rendimiento, loque permite conocer mejor la aplicación.

Soporte de impresiónEl desarrollador puede especificar una sesión de impresora para que se asociecon una sesión de sistema principal y habilitar al usuario para ver lostrabajos de impresión de la aplicación de sistema principal, enviarlos a unaimpresora o guardarlos en disco. El soporte de impresión sólo está disponiblepara la conexión por omisión.

Si desea obtener más información sobre el soporte de impresión, consulte elChapter 15, “Habilitación de soporte de impresión,” on page 383.

Soporte de tecladoEl desarrollador puede habilitar al usuario para que utilice un teclado físicopara interactuar con el sistema principal cuando la aplicación se ejecute enuna GUI. El desarrollador también decide si desea incluir un área de tecladode sistema principal, un área de teclado de aplicación, o ambas, en un


proyecto. Si se incluyen las áreas de teclado, el desarrollador decide quéteclas se incluyen y cómo aparecen esas teclas y el área de teclado en la GUI.

Si desea obtener más información sobre el soporte de teclado, consulte elChapter 16, “Habilitación de soporte de teclado,” on page 389.

Soporte de área de tecladoEl área de teclado de sistema principal es una tabla de botones o enlaces quepermiten a los usuarios interactuar con el sistema principal como si pulsaranlas teclas físicas en un teclado. No obstante, los usuarios pueden continuarutilizando las teclas físicas del teclado en lugar de los botones o enlaces delárea de teclado de sistema principal. Si desea obtener más información sobreel área de teclado de sistema principal, consulte “Área de teclado de sistemaprincipal” on page 198.

El área de teclado de aplicación es una tabla de botones o enlaces quepermiten a los usuarios realizar tareas relacionadas con la aplicación deHATS como, por ejemplo, visualizar los trabajos de impresión o renovar lapantalla. Si desea obtener más información sobre el área de teclado deaplicación, consulte “Área de teclado de aplicación” on page 347.

Descripción del proceso de las aplicaciones de HATSAntes de crear un proyecto de HATS, debe entender cómo procesa HATS lasaplicaciones de sistema principal. A medida que los usuarios acceden a cada unade las pantallas de una aplicación, HATS procesa la aplicación tal como se describeen los pasos siguientes. La Figure 1 on page 11 muestra el flujo de estos pasos. Losconceptos clave se describen en “Descripción de los conceptos clave y los objetosde HATS” on page 2.1. Cuando el sistema principal muestra una pantalla, HATS compara la pantalla

de sistema principal con el conjunto de criterios de reconocimiento de pantalladefinidos en cada una de los sucesos de pantalla habilitados del proyecto, en elorden definido por la prioridad del suceso, hasta que encuentra unacoincidencia.

2. Cuando se encuentra una coincidencia, HATS realiza las acciones definidaspara el suceso de pantalla. Tanto los sucesos de personalización de pantallacomo los de combinación de pantallas pueden incluirse en las acciones que selistan a continuación. Además, en el caso de un suceso de combinación depantallas, HATS navega a través de varias pantallas recopilando datos de cadapantalla para mostrarlos al usuario.v Aplicar una transformación utilizando la plantilla asociada. HATS muestra

los componentes de sistema principal (definidos en la transformación) comoaparatos de GUI

v Ejecutar lógica empresarialv Extraer variable globalv Insertar datosv Establecer variable globalv Eliminar variable globalv Enviar variable global (sólo proyectos de portlet estándar de HATS)v Mostrar URL o compuesto SWT �Sólo RCP�v Mostrar URL �Sólo Web�v Reenviar a URL �Sólo Web�v Ejecutar macrov Realizar una transacción de macro


v Enviar una teclav Desconectarv PausaSi desea obtener más información, consulte “Acciones” on page 165.

Notes:

1. Cuando se encuentra una coincidencia de pantalla, al menos tiene que efectuarse unaacción, pero no es necesario mostrar una transformación de la pantalla al usuario. Enotras palabras, la acción aplicar una transformación no es necesaria.

2. Puede realizar acciones sobre los datos de la pantalla de sistema principal antes ydespués de que el usuario interactúe con ella. Por ejemplo, puede extraer algunos datoscomo una variable global, sustituir cierta información por datos nuevos y seguidamenteaplicar la transformación antes de mostrar la transformación al usuario. Después deque el usuario realice una acción que devuelva los datos de la pantalla, puede efectuarextracciones e inserciones adicionales antes de devolver los datos definitivamente alsistema principal.

3. Si ninguno de los criterios de reconocimiento de pantalla coincide con lapantalla de sistema principal, HATS procesa el suceso de aplicación de pantallasin coincidencia. La acción por omisión de este suceso es mostrar la pantalla desistema principal utilizando la transformación por omisión y aplicar la plantillapor omisión. La transformación por omisión utiliza los valores derepresentación definidos en los valores del proyecto.

4. A medida que el sistema principal presenta cada una de las nuevas pantallasde una aplicación, HATS vuelve a empezar por el paso 1 y continúa con elresto. La Figure 1 on page 11 muestra cómo HATS procesa las pantallas.

Note: Si se utiliza una macro para el proceso de saltar pantallas, dichaspantallas no estarán sujetas a este proceso.


Los Sucesos de pantalla constituyen un concepto importante en el desarrollo de unproyecto de HATS. Si no hay criterios de reconocimiento de pantalla definidos enun suceso de pantalla, HATS no sabe qué acciones debe realizar cuando se recibela pantalla de sistema principal.

Debe familiarizarse con los principios básicos de los sucesos de pantalla antes deempezar el proceso de desarrollo. Los elementos básicos de los criterios dereconocimiento de pantalla se analizan en el Chapter 7, “Trabajo con sucesos depantalla,” on page 157.

Descripción del desarrollo de las aplicaciones de HATSHATS permite utilizar un enfoque iterativo en el desarrollo de aplicaciones. Puedeempezar con una configuración sencilla y añadir mejoras cuando esté preparado.Puede probar cada cambio mientras lo realiza mediante el entorno de prueba deRational SDP. La mayoría de los cambios se pueden ver con una simple renovaciónde la transformación de HATS. Si es necesario, puede efectuar modificaciones yguardar el trabajo antes de pasar al siguiente cambio. En este apartado se describe

Recibida pantallade sistema principal

Comprobar el primersuceso de pantalla (SP)

¿Coincidentodos loscriterios

necesarios?

¿Coincidealgúncriterio

opcional?

¿HayotroSP?

Realizar las accionesdefinidas para el suceso

de pantalla no coincidente

Opcionalmenteenviar la

pantalla al usuario

Realizar las accionesdefinidas para estesuceso de pantalla

Comprobar siguientesuceso de pantalla

No

No

Sí

Sí

Sí

No

Figure 1. Proceso de pantallas de HATS


una posible secuencia de pasos que puede utilizar para diseñar y desarrollar laaplicación de HATS. Puede seguir adelante hasta donde desee o detenerse encualquier punto del camino.1. Empiece creando una aplicación de HATS que utilice todos los valores por

omisión y vea instantáneamente todas las pantallas de sistema principalrepresentadas en una GUI. La representación por omisión puede representar laspantallas de sistema principal de forma que se converse el diseño original de lapantalla y se añadan automáticamente controles de GUI, como enlaces, botonesy tablas, para mejorar la productividad del usuario.

2. Cree una plantilla que coincida con las páginas Web de la empresa, o bien conotras aplicaciones de la empresa, y vea todas las pantallas de sistema principalrepresentadas con el aspecto de la empresa. Puede empezar con una de lasplantillas proporcionadas con HATS y luego modificarla, o en el caso deaplicaciones Web de HATS, puede importar el sitio Web de la empresa comoplantilla. Consulte el Chapter 10, “Utilización de plantillas,” on page 337 paraobtener más información. Ahora la aplicación de HATS coincide con el estilo ycolores de las páginas Web u otras aplicaciones de la empresa.

3. Configure valores a nivel de proyecto (de forma global en la aplicación) ycompruebe el grado de manejo de la aplicación de sistema principal sinconfigurar pantallas específicas. Puede cambiar características a nivel deproyecto en las distintas pestañas del Editor de valores del proyecto. Consulteel Chapter 5, “Modificación de un proyecto de HATS,” on page 95 para obtenermás información. Por ejemplo, intente realizar algunos cambios como, porejemplo:v Cambie la representación por omisión para que represente una lista de

selección como una lista desplegable. Esto cambiará todas las listas deselección por listas desplegables.

v Cree una o más normas globales para configurar la forma en que HATStransforma los campos de entrada de las pantallas de sistema principal. Porejemplo, cambie los campos de fecha por aparatos de calendario, o loscampos de ubicación por listas desplegables.

v Utilice la sustitución de texto para cambiar una o más series que aparezcanen las pantallas de sistema principal. Por ejemplo, puede cambiar laspalabras abrir sesión por iniciar sesión.

v Observe cómo se transforman las pantallas de sistema principal. ¿Hayelementos que aparezcan en la mayoría de las ventanas que deseetransformar de forma diferente? Esos pueden ser los candidatos paramodificar los valores de algunos componentes (cambiar cómo se reconocenlos componentes de sistema principal) o aparatos (cambiar cómo serepresentan los controles de GUI en la transformación). Puede cambiar estosvalores a nivel de proyecto estableciendo los valores por omisión que se vana utilizar en las pantallas de sistema principal. También puede cambiar losvalores de las instancias individuales de los componentes y aparatos cuandolos añada a las transformaciones. Si desea obtener más información, consulte“Representación” on page 98.

4. Cree sucesos a nivel de pantalla para reconocer pantallas de sistema principalespecíficas y desencadenar la ejecución de un conjunto de acciones.v Si utiliza correlaciones BMS, puede empezar importando sus conjuntos de

correlaciones BMS para crear capturas de pantalla para las pantallas desistema principal. De lo contrario, utilice la función de terminal del sistemaprincipal de HATS para conectarse a la aplicación de sistema principal ycrear capturas de pantalla para las pantallas específicas que desea reconocery con las que desea actuar. A continuación, a partir de cada captura depantalla, cree un suceso de pantalla.


v Utilice el asistente Crear una personalización de pantalla para personalizaralgunas de las pantallas de sistema principal para simplificarlas, eliminarelementos no utilizados, y extraer y rellenar automáticamente datos parasimplificar la entrada del usuario. Proporcione controles de GUI específicosde la pantalla para aumentar el grado de productividad del usuario. Si deseaobtener más información, consulte el Chapter 7, “Trabajo con sucesos depantalla,” on page 157.

v Es un requisito común poder recopilar datos a partir de varias pantallas desistema principal y presentarlos en una sencilla página de salida, o bienfacilitar una única página de entrada que luego proporcione varias pantallasde sistema principal con datos. HATS ofrece varios métodos para realizarestas operaciones. Estos métodos son: la utilización de combinaciones depantallas, personalizaciones de pantalla, transformaciones, macros, variablesglobales y objetos de integración. La utilización de un método concretodepende de la operación que se va a efectuar y de la ubicación de los datos.Para empezar, intente utilizar el asistente Crear una combinación de pantallaspara combinar datos que no quepan en su totalidad en una única pantalla desistema principal y visualizarlos en una única página de salida. Si deseaobtener más información, consulte el Chapter 14, “Combinación depantallas,” on page 381 y el Chapter 7, “Trabajo con sucesos de pantalla,” onpage 157.

5. Cree macros sencillas para ayudar al usuario en la navegación por la aplicaciónde sistema principal. Las macros pueden utilizarse para efectuar funciones desaltar pantalla, solicitar datos de entrada a los usuarios o para extraer datos deuna o varias pantallas de sistema principal. Si desea obtener más información,consulte el Chapter 11, “Macros y terminal de sistema principal,” on page 349.

6. Para aplicaciones Web, cree objetos de integración, que se construyen a partirde macros y son beans Java que encapsulan interacciones con una aplicación desistema principal. A continuación, utilice los objetos de integración para crearpáginas Web del modelo 1, Struts o JSF (JavaServer Faces) para dirigir lasinteracciones con la aplicación de sistema principal. También puede ejecutarobjetos de integración desde su propia lógica empresarial Java o ampliarlospara proporcionar interfaces de Enterprise JavaBeans (EJB) o de servicios Web ala aplicación de sistema principal. Si desea obtener más información, consulte elChapter 13, “Utilización de objetos de integración,” on page 369.

¿Cómo sé qué versión de HATS tengo?Puede determinar la versión de HATS Toolkit y de cada uno de los proyectos deHATS.

Para determinar qué versión de HATS Toolkit utiliza, compruebe los paquetesinstalados de IBM Installation Manager:1. En el menú Inicio, seleccione Todos los programas > IBM Installation

Manager > Ver paquetes instalados.2. La página IBM Installation Manager - Installed Offerings muestra todos los

paquetes instalados (incluidos los niveles de versión y compilación) y lascaracterísticas.

Puede determinar la versión (incluido el nivel de mantenimiento) de cada proyectode HATS. Esta información de versión se mantiene en cada proyecto en un archivodenominado .serviceHistory.xml. Este archivo se puede visualizar desde la vistaNavegador de la perspectiva de HATS en la carpeta ContenidoWeb\WEB-INF\profiles (para proyectos Web), en la carpeta profiles (paraproyectos de cliente enriquecido) y en la carpeta ejbModule (para proyectos EJB).


|

La información de versión para proyectos .ear de HATS y para el proyecto deextensión del tiempo de ejecución RCP de HATS se mantiene en el archivoproduct.xml. Este archivo se puede visualizar desde la vista Navegador en lacarpeta raíz del proyecto.

Recopilación de información sobre determinación de problemasAlgunas veces quizá necesite ayuda para determinar problemas relacionados conHATS. Si desea obtener instrucciones sobre cómo recopilar información dedeterminación de problemas para el personal de soporte de HATS, consulte elapartado Gathering problem determination information de la publicación HATSTroubleshooting.

¿Dónde puedo encontrar información sobre HATS?La siguiente información sobre HATS está disponible antes de instalar HATS:v La documentación de HATS está disponible en el CD de instalación de CD.

Desde el launchpad de instalación, seleccione enlaces a los documentossiguientes:– Notas de release– Guía de iniciación (pdf)

v El Knowledge Center de HATS en http://www.ibm.com/support/knowledgecenter/SSXKAY_9.6.0 incluye información de las Notas de release, laspreguntas más frecuentes (FAQs), información de referencia de la API, guías deaprendizaje, información sobre WebFacing y versiones en HTML y PDF de losdocumentos siguientes. También se incluyen las versiones traducidas disponiblesen formato PDF.– HATS Getting Started– Guía del usuario y del administrador de HATS– HATS Web Application Programmer's Guide– HATS Rich Client Platform Programmer's Guide– HATS Advanced Macro Guide– HATS Messages– HATS Troubleshooting– Desarrollo de aplicaciones WebFacing

v El sitio Web del producto HATS en http://www.ibm.com/software/products/es/es/rhats incluye información adicional del producto, como la visión generaldel producto, descargas de prueba, requisitos del sistema, etc.

v La zona interactiva de HATS en la dirección https://www.ibm.com/developerworks/mydeveloperworks/groups/service/html/communityview?communityUuid=2ce1fd8d-d706-4afd-b9ef-9000ad21218dincluye una biblioteca de recursos, foros de discusión, blogs, etc.

v El sitio Web de IBM Education Assistant en http://publib.boulder.ibm.com/infocenter/ieduasst/rtnv1r0/index.jsp integra presentaciones narradas,demostraciones, guías de aprendizaje y enlaces a recursos para ayudarle autilizar los productos de IBM satisfactoriamente. Busque Host AccessTransformation Services en Contents.

Además de la información disponible antes de instalar HATS, la informaciónsiguiente está disponible en el sistema después de instalar HATS:v Puede encontrar enlaces al sitio Web de HATS, al Knowledge Center y a las

Notas de release en el menú Inicio de Windows.


||

contacting_support.htm#gatheringhttp://www.ibm.com/support/knowledgecenter/SSXKAY_9.6.0http://www.ibm.com/support/knowledgecenter/SSXKAY_9.6.0http://www.ibm.com/software/products/us/en/rhatshttp://www.ibm.com/software/products/us/en/rhatshttps://www.ibm.com/developerworks/mydeveloperworks/groups/service/html/communityview?communityUuid=2ce1fd8d-d706-4afd-b9ef-9000ad21218dhttps://www.ibm.com/developerworks/mydeveloperworks/groups/service/html/communityview?communityUuid=2ce1fd8d-d706-4afd-b9ef-9000ad21218dhttps://www.ibm.com/developerworks/mydeveloperworks/groups/service/html/communityview?communityUuid=2ce1fd8d-d706-4afd-b9ef-9000ad21218dhttp://publib.boulder.ibm.com/infocenter/ieduasst/rtnv1r0/index.jsphttp://publib.boulder.ibm.com/infocenter/ieduasst/rtnv1r0/index.jspreadme.htm

v La documentación de HATS, incluida la de WebFacing, está disponible en elmenú Ayuda de la barra de menús de Rational SDP. Seleccione Ayuda >Contenido de la ayuda y, en el panel Contenido, seleccione Desarrollo deaplicaciones de HATS.

v La guía de aprendizaje de la página de bienvenida de HATS le guía en todo elproceso de desarrollo de una aplicación de HATS y, si se ha instalado en elproducto IBM Rational Developer para Power Systems Software™, introduce lacaracterística IBM WebFacing Tool para IBM i de HATS Toolkit.

v Si está instalado WebFacing Tool, la guía de aprendizaje de la página debienvenida de WebFacing proporciona información similar a la que figura en laguía de aprendizaje de la página de bienvenida de HATS.

v Todos los campos de los asistentes y editores de HATS disponen de ayuda segúnel contexto. Pulse la tecla F1 para ver la ayuda de HATS Toolkit.

v Se proporcionan sugerencias en puntos clave del proceso de desarrollo de unproyecto de HATS. Puede controlar si desea ver las sugerencias modificando laspreferencias de HATS.


Chapter 2. Migración a HATS V9.6

Si es usuario de Host Publisher V4, HATS V5, V6, V7.0, V7.1, V7.5, V8.0, V8.5 oV9.0 , puede migrar sus proyectos a HATS V9.6.

Los proyectos de HATS V4 LE, HATS V5 LE y HATS V4 no se pueden migrardirectamente a HATS V8.0, V8.5, V9.0 o V9.6. Para migrar estos proyectos, primerodebe migrarlos a un release provisional de HATS, por ejemplo, V5, V6, V7, V7.1 oV7.5 y, a continuación, migrarlos desde el release provisional a HATS V8.0, V8.5,V9.0 o V9.6. Consulte la documentación correspondiente a su release anterior deHATS para obtener información sobre la migración de proyectos HATS.

Si está utilizando una versión de Host Publisher anterior a la V4.0, primero tieneque seguir las instrucciones de migración de las aplicaciones de Host Publisher aHost Publisher V4.0. Vaya a http://www.ibm.com/support/entry/portal/overview/software/rational/rational_host_access_transformation_services y entrela serie de búsqueda "How to migrate Host Publisher" (Cómo migrar HostPublisher). Si desea obtener más información, consulte “HATS para usuarios deHost Publisher” on page 25.

Migración de HATSLa migración de un proyecto de HATS desde un release anterior de HATS es unproceso de dos pasos.1. Importe el proyecto al espacio de trabajo HATS V9.6 mediante uno de los

métodos siguientes:v Importe un proyecto existente seleccionando su directorio raíz o un archivo

de archivado.v Desproteja el proyecto de un repositorio de códigos (como CVS o IBM

Rational ClearCase®).v Abra un espacio de trabajo de Rational SDP V7.0, o posterior, que contenga

el proyecto en Rational SDP V9.6.2. Migrar el proyecto utilizando el asistente de migración de HATS.

Importación de un proyecto de HATSSi tiene instalado un release de HATS V5 o posterior, puede exportar el proyecto aun archivo zip o a un archivo de intercambio de proyectos y, a continuación,importarlo y migrarlo a HATS V9.6. Consulte la documentación del release anteriorde HATS para obtener información sobre la exportación de proyectos de HATS.Para obtener más información sobre la importación de proyectos Web y de clienteenriquecido de HATS en HATS V9.6, consulte “Exportación e importación deproyectos Web de HATS” on page 35 y “Exportación e importación de proyectosde cliente enriquecido de HATS” on page 66.

Si ha almacenado los proyectos de HATS en Rational ClearCase, debe crear unavista instantánea que contenga estos proyectos y, a continuación, importarlos en elespacio de trabajo de HATS V9.6 mediante Archivo > Importar > General >Proyectos existentes en el espacio de trabajo. Durante la importación, noseleccione la opción Copiar proyectos en el espacio de trabajo. Después deimportar los proyectos en el espacio de trabajo de HATS V9.6, dispondrá de la

© Copyright IBM Corp. 2003, 2017 17

|

|

||

||||||

|

||

|

|

|

|

http://www.ibm.com/support/entry/portal/overview/software/rational/rational_host_access_transformation_serviceshttp://www.ibm.com/support/entry/portal/overview/software/rational/rational_host_access_transformation_services

opción de migrarlos a HATS V9.6. Durante la migración, los archivos que debenactualizarse se desprotegen automáticamente de Rational ClearCase.

Migración del espacio de trabajo de Rational SDPSe muestra el asistente de migración de espacios de trabajo de Rational SDP si seimporta un proyecto en el espacio de trabajo y necesita algún nivel de migraciónde Rational SDP. Este asistente realiza alguna migración básica del proyecto deRational SDP y si el proyecto tiene como destino una unidad ejecutable noadmitida, fuerza que se elija una unidad ejecutable de destino admitida. Comopreparativo para ejecutar el asistente de migración de HATS, debe ejecutar primeroel asistente de migración de espacios de trabajo de Rational SDP.

Note: La migración del espacio de trabajo Rational SDP V9.6 sólo soportaproyectos creados a partir de Rational SDP V7.0 o posterior. Al importar unproyecto pre-HATS V7.0, la migración de la estación de trabajo de RationalSDP no funciona y aparece un mensaje de error. La migración de HATSseguirá pudiendo migrar el proyecto a HATS V9.6.

Utilización del asistente de migración de HATSCuando conmuta a la perspectiva de HATS, si tiene un proyecto creado con unrelease anterior de HATS en el espacio de trabajo de HATS V9.6, recibirá unmensaje en el que se indica que el espacio de trabajo contiene un proyecto deHATS que tiene que migrarse.

Debe utilizar el asistente de migración de HATS para migrar este proyecto a HATSV9.6 antes de investigar los errores mostrados en la vista Problemas, ya que lamigración puede eliminar algunos o todos estos errores.

Para utilizar el asistente de migración de HATS siga estos pasos:1. En la vista Proyectos de HATS, pulse con el botón derecho del ratón en el

proyecto y seleccione Migrar proyecto.2. Si tiene otros proyectos de un release anterior de HATS que están asociados con

el proyecto de HATS que ha seleccionado para migrarlo, esos proyectostambién se migrarán, así como todos los proyectos .ear de HATS asociados.

3. Pulse Aceptar para empezar la migración.4. Si el proyecto no tiene un proyecto .ear asociado, deberá asociar el proyecto

.war después de realizar la migración. Para asociar el proyecto .war con unproyecto .ear, consulte “Traslado de proyectos Web de HATS a un archivo .eardiferente” on page 34.

Notes:

1. Después de la migración, compruebe los detalles en el Informe de migración.2. Si un proyecto Web de HATS que se va a migrar tiene una unidad ejecutable

de destino no admitida (si no se ha ejecutado el asistente de migración deespacios de trabajo de Rational SDP) o facetas de WebSphere no admitidas, elasistente de migración de HATS establece la unidad ejecutable de destino y lasfacetas en el nivel inferior admitido de WebSphere Application Server paraproyectos Web . Se muestra un mensaje y se anota, que indica el hecho de quese ha realizado el cambio.

3. Si, después de la migración, recibe un error indicando que el entorno deejecución de destino no está definido, edite las propiedades para el proyecto yseleccione el entorno de ejecución de destino adecuado. Para ello, pulse con elbotón derecho del ratón en el proyecto y seleccione Propiedades. En la ventana


|

|

|

||

|||||||

Propiedades, seleccione Entornos de ejecución de destino. En la lista Entornosde ejecución, seleccione el entorno de ejecución adecuado.

4. La migración del proyecto desde un release anterior de HATS a HATS V9.6 nose puede deshacer.

Migración de las transformaciones de HATSAl migrar proyectos de HATS de un release anterior de HATS a HATS V9.6, lastransformaciones de los proyectos también se migran. Los cambios efectuados enlas transformaciones dependen del release de HATS desde el que se efectúa lamigración. Todas las transformaciones se guardan en la carpeta MigrationBackupantes de migrarse.

Consideraciones especiales relativas a la migración

Avance automáticoSi en versiones anteriores de HATS ha habilitado la función de avance automáticoañadiendo la línea turnAutoTabOn(); al archivo lxgwfunctions.js, ahora debeutilizar el valor Habilitar avance automático de campo en la sección Valores delcliente de la pestaña Otros del editor Valores del proyecto. Si desea obtener másinformación, consulte “Valores de cliente” on page 128.

Archivos de copia de seguridadLa migración de HATS crea una carpeta de copia de seguridad en el directorio deproyectos denominada MigrationBackup. Esta carpeta contiene copias de losarchivos del proyecto anteriores al proceso de migración, durante el que sesobrescribieron. Estos archivos se guardan para permitir compararlos y fusionarloscon los nuevos archivos de HATS V9.6. No se preocupe si surgen problemas; laaplicación ya no utiliza estos archivos. Una vez se hayan comparado o fusionadotodos los archivos guardados, puede suprimir la carpeta MigrationBackup.

Note: Antes de suprimir la carpeta MigrationBackup, puede publicar un proyectomigrado en WebSphere Application Server para probar cómo se comporta.No obstante, los errores de la lista de tareas provocados por la carpetaMigrationBackup pueden crear problemas al publicar en WebSphereApplication Server. Para evitar esto, puede eliminar la carpetaMigrationBackup del proyecto o Permitir publicar en un servidor lasaplicaciones que contienen errores. Para permitir que las aplicaciones quecontienen errores se publiquen en un servidor, seleccione Ventana >Preferencias > Servidor > WebSphere Application Server en la barra demenús de Rational SDP y seleccione Permitir publicar en un servidor lasaplicaciones que contienen errores.

Aparato de botónSi migra un proyecto creado antes de HATS V7.0.0.2 y elige implementar la opciónHabilitar colores de primer plano, si utiliza una plantilla que usa la hoja de estilosblacktheme.css, debe actualizar la hoja de estilos blacktheme.css manualmente deuna de las formas siguientes:1. Elimine la línea siguiente de la declaración input.HATSBUTTON:

color: lime;

Esto permite que los colores de primer plano se representen en teclas defunción; sin embargo, hace que otros botones generados por un aparato deHATS se representen en un color por omisión.

Chapter 2. Migración a HATS V9.6 19

|

|

|

2. Combine las declaraciones de CSS relacionadas con el color para cada color. Porejemplo, cambie:.HBLUE {

color: #3c9dff;}input.HBLUE {

white-space: normal;letter-spacing: normal;

}

a.HBLUE, input.HBLUE {

color: #3c9dff;white-space: normal;letter-spacing: normal;

}

Repita este cambio para cada color.

Una alternativa a la edición manual de la hoja de estilos blacktheme.css es crear unnuevo proyecto ficticio y copiar los archivos CSS de tema de este proyecto en suproyecto. Asegúrese de que cualquier cambio que efectúe a los archivos CSS sesobrescribe.

Beans de acceso EJBSi tiene proyectos de HATS V5 que contengan beans de acceso EJB, es posible quetenga problemas de compilación o de tiempo de ejecución que empiecen con "Nose pudo resolver HPubReqCompleteEvent." Para corregirlos, vuelva a generar losbeans de acceso EJB.

Note: El soporte de aplicación EJB de HATS está en desuso en HATS V9.6.Aunque de momento el soporte para las aplicaciones EJB de HATS continua,IBM se reserva el derecho a eliminar esta capacidad en un release posteriordel producto. Las alternativas son:v Utilizar servicios Web para acceder a objetos de integración. Para obtener

más información, consulte Desarrollo de servicios Web de la publicaciónHATS Web Application Programmer's Guide.

v Crear beans EJB para acceder a los objetos de integración. Para obtenermás información, consulte Utilización de un objeto de integración en uncontenedor EJB (del EJB) en la publicación HATS Web ApplicationProgrammer's Guide.

Aparato CampoSi desea utilizar el valor Representar utilizando font monoespacio para el aparatoCampo, y se ha creado su proyecto inicialmente en un release anterior a HATSV7.0,deberá actualizar los archivos CSS de la manera siguiente:1. Añada la clase siguiente a los archivos whitetheme.css, graytheme.css,

monochrometheme.css, tantheme.css y blacktheme.css:.HF {font-family: courier new, monospace;}

2. Elimine font-family: monospace de todas las clases H-color (color de HATS) detodos los archivos CSS.

Normas globalesSe ha añadido un valor nuevo, enforceImmediacy, a cualquier norma globalimportada en HATS V9.6 desde HATS V5. Cuando este valor es true, la norma


|

|

pgwebsv.htmpgcusio.htm#writingpgcusio.htm#writing

global se comporta como lo hacía en HATS V5 al seleccionar Sólo el campo deentrada más cercano para la opción Transformar del patrón Buscar campos deentrada por texto adyacente. Cuando este valor es false (valor por omisión), lanorma global se comporta como lo hace en HATS V9.6.

Para que las normas globales que se acaban de definir se comporten como lohacían las normas globales de HATS V5, debe añadir el valor enforceImmediacy yestablecerlo en true. Para ello, en la pestaña Fuente del editor de Valores delproyecto, añada el valor siguiente al código componentSettings de las normasglobales:

Variables globalesAntes de HATS V7, el valor de una variable global, especificado en una solicitudinsertada en una transformación mediante la opción Solicitar la variable globalcon recuadro de entrada, podría haberse truncado debido a algunos caracteres noespecificados correctamente.

En esta versión de HATS, los valores de variable global solicitados por unatransformación se especifican correctamente para evitar recortes. Las variablesglobales insertadas en una transformación mediante la opción Mostrar la variableglobal como texto estático no se ven afectadas por este cambio. Las solicitudes devariables globales insertadas en una transformación en una versión de HATSanterior a HATS V7 no se actualizan automáticamente durante la migración, por loque no se ven afectadas por este cambio.

Compresión HTTPSi desea utilizar el soporte de HATS para la compresión HTTP en proyectosmigrados de HATS V5.0.x, V6.0 y V6.0.1, debe añadir manualmente el filtro decompresión al archivo del descriptor de despliegue Web (web.xml). Para añadir elfiltro de compresión al archivo web.xml:1. En HATS Toolkit, cambie a la vista Navegador de la perspectiva de HATS.2. Abra el archivo web.xml que se encuentra en la carpeta Contenido

Web\WEB-INF del proyecto.3. Pulse la pestaña Fuente para ver el fuente de este archivo.4. Copie las sentencias siguientes después de la última correlación de servlets

definida (busque la última aparición de ).

Proporciona compresión para la salida del servlet deentrada de HATS

CompressionFilterCompressionFiltercom.ibm.hats.runtime.filters.CompressionFilter

5. Copie las sentencias siguientes después de la última correlación de filtrosdefinida (busque la última aparición de ).

CompressionFilterEntryServletERRORFORWARDINCLUDEREQUEST

CompressionFilter/

Chapter 2. Migración a HATS V9.6 21

|

CompressionFilter/index.jsp

6. Guarde el archivo.

Note: si ha ejecutado este proyecto en el servidor, deberá volver a publicar laaplicación para que WebSphere Application Server aplique el cambio en elarchivo web.xml.

Herramientas de gestión de licencias de IBMLas aplicaciones HATS, WebFacing y enlazadas HATS/WebFacing que se migran aHATS V9.6 deben volver a desplegarse en el entorno de producción para que seaplique el soporte del nuevo archivo de signatura de HATS V9.6 mediante lasherramientas de gestión de licencias de IBM, por ejemplo, IBM License Metric Toole IBM Tivoli® Asset Discovery for Distributed.

Aplicaciones Web de WebFacing: Las herramientas de gestión de licencias deIBM detectan las aplicaciones Web desplegadas como Enterprise Archives (EAR) enlos servidores WebSphere Application Servers soportados. Ya que los proyectosWeb de WebFacing se crean de forma independiente de los EAR asociados, elarchivo de signatura de HATS V9.6 debe incluirse manualmente. Siga los pasossiguiente para habilitar que detecte correctamente las aplicaciones Web deWebFacing.1. Cree una carpeta llamada itlm directamente bajo el EAR asociado del proyecto

de WebFacing.2. Localice el archivo de signatura denominado

Host_Access_Transformation_Services-9.0.0.swidtag en el directorio delplug-in de HATS\plugins\com.ibm.hats_nnn\

donde directorio_instalación_compartido es el directorio de recursos compartidosdonde se ha instalado la oferta de HATS mediante IBM Installation Manager ynnn es la versión y el nivel de build de HATS.

3. Copie el archivo de signatura desde el plug-in a la carpeta itlm que creóanteriormente.

4. Exporte el proyecto como un EAR y vuelva a desplegarlo.5. Las herramientas de gestión de licencias de IBM podrán ahora detectar la

aplicación.

ibm host access transformation services...exportación de un proyecto web .....35 importación de un...

Documents