ibm host access transformation services: guía del …€¦ · corr elación entr e componentes y...

IBM Host Access Transformation Services

Gua del usuario y del administradorVersin 9.5

SC11-8420-01

IBM

NotaAntes de utilizar esta informacin y el producto al que da soporte, lea la informacin general que se encuentra en elApndice C, Avisos, en la pgina 545.

Dcima edicin (noviembre de 2015)

Copyright IBM Corporation 2003, 2015.

Contenido

Captulo 1. Utilizacin de Host AccessTransformation Services (HATS) . . .. 1Descripcin de los conceptos clave y los objetos deHATS. . . . . . . . . . . . . . . .. 2Descripcin del proceso de las aplicaciones de HATS 9Descripcin del desarrollo de las aplicaciones deHATS . . . . . . . . . . . . . . .. 11Cmo s qu versin de HATS tengo? . . . .. 13Recopilacin de informacin sobre determinacin deproblemas . . . . . . . . . . . . . .. 14Dnde puedo encontrar informacin sobre HATS? 14

Captulo 2. Migracin a HATS V9.5 . .. 17Migracin de HATS . . . . . . . . . .. 17

Importacin de un proyecto de HATS . . .. 17Utilizacin del asistente de migracin de HATS 18Migracin de las transformaciones de HATS .. 19Consideraciones especiales relativas a lamigracin . . . . . . . . . . . . .. 19

HATS para usuarios de Host Publisher . . . .. 25Migracin de Host Publisher Versin 4 . . .. 26

Migracin de J2EE . . . . . . . . . . .. 29

Captulo 3. Desarrollo y despliegue deaplicaciones Web de HATS . . . . .. 31Organizacin de aplicaciones Web de HATS . .. 33

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

Copia de seguridad de proyectos de HATS . . .. 35Exportacin e importacin de proyectos Web deHATS . . . . . . . . . . . . . . .. 35

Exportacin de un proyecto Web . . . . .. 35Importacin de un proyecto Web . . . . .. 35

Despliegue de aplicaciones Web de HATS . . .. 36Habilitar el tiempo de ejecucin de HATS . .. 36Exportacin del proyecto como una aplicacinJava EE . . . . . . . . . . . . . .. 37Instalacin de la aplicacin en un entorno deejecucin . . . . . . . . . . . . .. 38Cambios necesarios en el entorno de ejecucin . 39

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

Instalacin y configuracin de servidoresGeronimo . . . . . . . . . . . . .. 42Consideraciones y limitaciones de los servidoresde Geronimo . . . . . . . . . . . .. 43

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

Instalacin y configuracin de servidoresWebLogic . . . . . . . . . . . . .. 43Consideraciones y limitaciones de los servidoresWebLogic . . . . . . . . . . . . .. 45

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

Configuracin 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 mviles . . . . . . . . . .. 49

Consideraciones y limitaciones para dispositivosmviles . . . . . . . . . . . . . .. 50Consideraciones y limitaciones para dispositivosiPad . . . . . . . . . . . . . . .. 57Consideraciones y limitaciones para dispositivosAndroid . . . . . . . . . . . . .. 57

Captulo 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 extensin del tiempo de ejecucin RCPde HATS . . . . . . . . . . . . . .. 62Trabajo con proyectos de cliente enriquecido deHATS . . . . . . . . . . . . . . .. 63

Copia de recursos entre proyectos Web yproyectos de cliente enriquecido . . . . .. 65Exportacin e importacin de proyectos decliente enriquecido de HATS . . . . . .. 66

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

Configuracin de la plataforma de destino . .. 67Instalacin de plug-ins de tiempo de ejecucin . 68Establecimiento del JRE por omisin . . . .. 69Inicio del proyecto . . . . . . . . . .. 70

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

Empaquetado de un entorno de cliente Eclipsepara la distribucin. . . . . . . . . .. 72Preparacin para clientes Eclipseecistentes(Eclipse RCP, Lotus Notes, o LotusExpeditor Client) . . . . . . . . . .. 73Actualizacin de los nmeros de versin deplug-in y caractersticas . . . . . . . .. 83

Administracin de aplicaciones de clienteenriquecido de HATS . . . . . . . . . .. 84Entorno de ejecucin . . . . . . . . . .. 85

Vista Aplicaciones . . . . . . . . . .. 85Vista Transformacin . . . . . . . . .. 87Solicitud de ID de estacin de trabajo . . .. 89

Copyright IBM Corp. 2003, 2015 iii

||

|||

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

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

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

Captulo 5. Modificacin de unproyecto de HATS . . . . . . . . .. 97Visin general . . . . . . . . . . . .. 97Conexiones . . . . . . . . . . . . .. 99Plantilla . . . . . . . . . . . . . .. 100Representacin . . . . . . . . . . . .. 100

Representacin por omisin . . . . . .. 100Normas globales . . . . . . . . . .. 105Sustitucin de texto . . . . . . . . .. 109Componentes y aparatos . . . . . . .. 109Barra de herramientas Slo RCP . . . .. 110rea de teclado de aplicacin . . . . . .. 110rea de teclado de sistema principal . . .. 110rea de informacin del operador . . . .. 111DBCS . . . . . . . . . . . . . .. 112

Sucesos . . . . . . . . . . . . . .. 112Prioridad de suceso de pantalla . . . . .. 113Sucesos de aplicacin . . . . . . . . .. 114

Otros . . . . . . . . . . . . . . .. 117Soporte de teclado. . . . . . . . . .. 118Entorno local del cliente . . . . . . . .. 118Alteraciones de parmetros de conexin . .. 119Actualizacin asncrona Slo RCP . . . .. 122Desconexin y renovacin automticaSlo Web . . . . . . . . . . . .. 122Alteraciones de variables globales . . . .. 129Valores de cliente . . . . . . . . . .. 130Asistencia de contenido de macro . . . .. 135Valores del portlet . . . . . . . . . .. 135

Fuente. . . . . . . . . . . . . . .. 137Utilizacin de preferencias de HATS. . . . .. 137Utilizacin de otras preferencias de Rational SDP 142

Captulo 6. Gestin de conexiones 143Creacin de una conexin . . . . . . . .. 143Editor de conexiones . . . . . . . . . .. 144

Visin general . . . . . . . . . . .. 144Bsica . . . . . . . . . . . . . .. 144Avanzadas . . . . . . . . . . . .. 145Impresin . . . . . . . . . . . .. 148Gestin de pantalla . . . . . . . . .. 150Seguridad . . . . . . . . . . . .. 152Agrupacin . . . . . . . . . . . .. 154Macros . . . . . . . . . . . . .. 155Lista de usuarios . . . . . . . . . .. 156Fuente. . . . . . . . . . . . . .. 158

Captulo 7. Trabajo con sucesos depantalla . . . . . . . . . . . . .. 159Asistente Crear una personalizacin de pantalla 159Asistente Crear una combinacin de pantallas .. 160Edicin de sucesos de pantalla . . . . . .. 161

Visin general . . . . . . . . . . .. 161Criterios de reconocimiento de pantalla oPantalla de inicio . . . . . . . . . .. 161

Representacin (slo combinacin de pantallas) 166Navegacin (slo combinacin de pantallas) .. 166Pantalla de inicio (slo combinacin depantallas). . . . . . . . . . . . .. 167Acciones . . . . . . . . . . . . .. 167Normas globales . . . . . . . . . .. 180Sustitucin de texto . . . . . . . . .. 180Pantalla siguiente . . . . . . . . . .. 182Fuente. . . . . . . . . . . . . .. 183

Pantallas inhibidas . . . . . . . . . .. 183Criterios de reconocimiento . . . . . .. 183Gestin automtica de las pantallas inhibidas 184Gestin de varias pantalla inhibidas . . . .. 184

Importar conjuntos de correlaciones BMS . . .. 185

Captulo 8. Trabajar contransformaciones. . . . . . . . .. 187Asistente Crear una transformacin . . . . .. 187Edicin de transformaciones . . . . . . .. 189

Edicin de transformaciones para proyectosWeb . . . . . . . . . . . . . .. 189Edicin de transformaciones para proyectos decliente enriquecido . . . . . . . . .. 193Resumen de las diferencias entre la edicin detransformaciones Web y de cliente enriquecido . 195

Asistentes de transformacin . . . . . . .. 196Insertar componente de sistema principal . .. 196Editar componente de sistemaprincipalSlo Web . . . . . . . . .. 198Transformacin para edicin Dojo Slo Web 198Insertar representacin por omisin . . . .. 198Editar representacin por omisinSlo Web 198Insertar carpeta con pestaasSlo Web . .. 199Insertar tecla de macro . . . . . . . .. 200Insertar variable global . . . . . . . .. 201Insertar rea de informacin del operadorSlo Web . . . . . . . . . . . .. 201Insertar rea de teclado de sistema principal .. 201Insertar rea de teclado de aplicacin . . .. 202Insertar todos los componentes de sistemaprincipalSlo Web . . . . . . . . .. 203Insertar pantalla almacenadaSlo Web . .. 203

Vista previa de transformaciones . . . . . .. 203rea de teclado de sistema principal . . . .. 204

Captulo 9. Valores y descripciones decomponentes y aparatos . . . . .. 205Valores de componentes y aparatos . . . . .. 205Valores de componentes de sistema principal . .. 205

Lnea de mandatos . . . . . . . . .. 206Dilogo . . . . . . . . . . . . .. 206ENPTUI . . . . . . . . . . . . .. 210Campo . . . . . . . . . . . . .. 212Tecla de funcin . . . . . . . . . .. 213Palabra clave HTML DDSSlo Web . . .. 215Campo de entrada. . . . . . . . . .. 216Campo de entrada con consejos . . . . .. 217Seleccin de elementos . . . . . . . .. 220Lpiz fotosensible (atencin) . . . . . .. 221Lpiz fotosensible (seleccin) . . . . . .. 222

iv IBM Host Access Transformation Services: Gua del usuario y del administrador

Lista de seleccin . . . . . . . . . .. 223Subarchivo . . . . . . . . . . . .. 226Tabla . . . . . . . . . . . . . .. 233Tabla (campo) . . . . . . . . . . .. 235Tabla (visual) . . . . . . . . . . .. 236Texto . . . . . . . . . . . . . .. 238URL . . . . . . . . . . . . . .. 238

Valores de aparatos . . . . . . . . . .. 239Botn . . . . . . . . . . . . . .. 239Tabla de botones . . . . . . . . . .. 241CalendarioSlo Web . . . . . . . .. 243Recuadro de seleccin . . . . . . . .. 250Recuadro combinado Slo RCP . . . . .. 252Dilogo . . . . . . . . . . . . .. 254Desplegable (entrada de datos) . . . . .. 256Desplegable (seleccin) . . . . . . . .. 259Campo . . . . . . . . . . . . .. 261Grfico (barra horizontal, lnea, barra vertical) 267Etiqueta . . . . . . . . . . . . .. 271Enlace . . . . . . . . . . . . . .. 272Enlace (seleccin de elemento). . . . . .. 274Lista . . . . . . . . . . . . . .. 276Emergente . . . . . . . . . . . .. 279Botn de seleccin (entrada de datos) . . .. 284Botn de seleccin (seleccin de elemento) .. 286Botn de seleccin (seleccin) . . . . . .. 288Barra de desplazamiento (ENPTUI) . . . .. 291Subarchivo (recuadro de seleccin) . . . .. 292Subarchivo (desplegable) . . . . . . .. 299Subarchivo (emergente) . . . . . . . .. 306Tabla . . . . . . . . . . . . . .. 313Entrada de texto . . . . . . . . . .. 319Barra de herramientas Slo RCP . . . .. 323

Configuracin de aparato (Dojo) . . . . . .. 326Consideraciones y limitaciones de aparato Dojode HATS . . . . . . . . . . . . .. 326Recuadro combinado (Dojo) Slo Web . .. 327Recuadro de texto de fecha (Dojo) Slo Web 329Cuadrcula ampliada (Dojo) Slo Web . .. 332Seleccin de filtrado (Dojo) Slo Web . . .. 333Recuadro de texto (Dojo) Slo Web . . .. 336Recuadro de texto de validacin (Dojo)Slo Web . . . . . . . . . . . .. 336

Correlacin entre componentes y aparatos . . .. 338

Captulo 10. Utilizacin de plantillas 341Ejemplos de plantillas . . . . . . . . .. 341Asistente Crear una plantilla . . . . . . .. 345Edicin de plantillas . . . . . . . . . .. 346

Edicin de plantillas para proyectos Web . .. 346Edicin de plantillas para proyectos de clienteenriquecido . . . . . . . . . . . .. 351

rea de teclado de aplicacin . . . . . . .. 352

Captulo 11. Macros y terminal desistema principal . . . . . . . . .. 355Editor de macros . . . . . . . . . . .. 356

Visin general . . . . . . . . . . .. 356Solicitudes y extracciones . . . . . . .. 368Fuente. . . . . . . . . . . . . .. 368

Trabajo con los errores de macros . . . . .. 368Importacin de una macro . . . . . . . .. 369Exportacin de una macro . . . . . . . .. 369Sugerencias y consejos sobre las macros . . .. 370

Cmo evitar un bucle infinito . . . . . .. 370Manejo de pantallas transitorias . . . . .. 370

Captulo 12. Interaccin con variablesglobales . . . . . . . . . . . .. 371Renombrar variables globales . . . . . . .. 373Diferencias entre variables globales y variables demacro . . . . . . . . . . . . . . .. 373

Variables globales . . . . . . . . . .. 373Variables de macro . . . . . . . . .. 374

Captulo 13. Utilizacin de objetos deintegracin . . . . . . . . . . .. 375Creacin de un objeto de integracin . . . .. 375Encadenamiento de objetos de integracin. . .. 377

Cmo se determina cundo utilizar elencadenamiento de los objetos de integracin . 377Utilizacin del encadenamiento de los objetosde integracin . . . . . . . . . . .. 378Depuracin de aplicaciones que utilizan elencadenamiento de los objetos de integracin . 380

Creacin de pginas Web a partir de un objeto deintegracin . . . . . . . . . . . . .. 380

Creacin de pginas Web del modelo 1 . . .. 381Creacin de pginas Web Struts . . . . .. 382Creacin de pginas Web JSF . . . . . .. 383

BasicIOErrorPage.jsp y AdvancedIOErrorPage.jsp 384Trabajo con objetos de integracin que estn en JSP 384

Insertar propiedades de objeto de integracin 384Insertar Reenviar a aplicacin HATS. . . .. 385

Captulo 14. Combinacin de pantallas 387Combinacin de datos de salida contiguos . .. 387Combinacin de datos de salida no contiguos .. 387Combinacin de la salida de varias aplicaciones 388Combinacin de la entrada de varias pantallas .. 388

Captulo 15. Habilitacin de soportede impresin . . . . . . . . . .. 389Configuracin de la sesin de impresin de sistemaprincipal en sistemas principales 3270 . . . .. 389Definicin del soporte de impresin para elproyecto . . . . . . . . . . . . . .. 389

Para las conexiones 3270E . . . . . . .. 389Para las conexiones 5250 . . . . . . .. 392

Suministro de documentacin para los usuarios 393

Captulo 16. Habilitacin de soportede teclado . . . . . . . . . . . .. 395Definicin del soporte de teclado . . . . . .. 395Cambio del aspecto de las reas de teclado . .. 395Suministro de documentacin para los usuarios 396

Soporte especial de teclas de campos 5250 . .. 398Cmo volver a correlacionar el teclado en unaaplicacin de HATS . . . . . . . . . .. 399

Contenido v

Conceptos que deben entenderse antes devolver a correlacionar las teclas de HATS . .. 399Volver a correlacionar aplicaciones Web deHATS . . . . . . . . . . . . . .. 402Volver a correlacionar aplicaciones de clienteenriquecido de HATS. . . . . . . . .. 405Adicin de botones adicionales de rea deteclado a una transformacin . . . . . .. 407

Captulo 17. Utilizacin de lasimulacin de sistema principal . .. 409Asistente de simulacin de sistema principal . .. 409Editor de simulacin de sistema principal . . .. 410

Pestaa Visin general . . . . . . . .. 410Pestaa Fuente . . . . . . . . . . .. 411

Grabacin en el entorno de ejecucin . . . .. 411Opciones de reproduccin . . . . . . . .. 411Importacin y exportacin de archivos de rastreo 412

Captulo 18. Utilizacin de la consolaadministrativa de HATS . . . . . .. 415Consola administrativa de HATS y seguridad deWebSphere . . . . . . . . . . . . .. 415Roles de la consola administrativa de HATS . .. 417Inicio de la consola administrativa de HATS . .. 418

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

Utilizacin de las funciones en la consolaadministrativa de HATS . . . . . . . . .. 419

Seleccin del mbito de gestin . . . . .. 420Gestin de licencias . . . . . . . . .. 420Supervisin de conexiones . . . . . . .. 421Supervisin de agrupaciones de conexiones .. 421Supervisin de definiciones de agrupaciones 421Supervisin de listas de usuarios y miembros delistas de usuarios . . . . . . . . . .. 422Administracin de componentes de ladeterminacin de problemas . . . . . .. 422

Funciones de terminal de pantalla . . . . .. 426Utilizacin del terminal de pantalla para pruebay depuracin . . . . . . . . . . .. 426

Captulo 19. WebSphere Portal yHATS . . . . . . . . . . . . . .. 429Creacin de portlets de HATS . . . . . . .. 429

Creacin de un nuevo proyecto de portlet deHATS . . . . . . . . . . . . . .. 430Generacin de portlets a partir de proyectosWeb de HATS . . . . . . . . . . .. 430

Trabajo con portlets de HATS . . . . . . .. 432Alteraciones de parmetros de conexin y devariables globales . . . . . . . . . .. 432Comunicacin de portlets . . . . . . .. 433PDT personalizados y tablas personalizadas .. 436Web Services for Remote Portlets (WSRP) . .. 437

Prueba de portlets de HATS . . . . . . .. 437Exportacin de portlets de HATS . . . . . .. 437Administracin de portlets de HATS . . . .. 438

Utilizacin de una aplicacin administrativa deHATS autnoma . . . . . . . . . .. 438

Consideraciones y limitaciones de portlets deHATS . . . . . . . . . . . . . . .. 439

Consideraciones y limitaciones comunes . .. 439

Captulo 20. WebFacing y HATS . .. 443Interaccin de HATS con WebFacing . . . .. 443

Conexin de HATS a un servidor WebFacing 443Interoperatividad de HATS con aplicaciones deWebFacing . . . . . . . . . . . .. 444

Captulo 21. Seguridad e Inicio desesin Express en Web . . . . . .. 447Habilitacin de la seguridad SSL . . . . . .. 447Habilitacin de la seguridad SSH. . . . . .. 450Utilizacin del inicio de sesin Express en WEb(WEL) . . . . . . . . . . . . . . .. 450

Visin general . . . . . . . . . . .. 450Arquitectura. . . . . . . . . . . .. 451Planificacin de la implementacin . . . .. 452Implementacin . . . . . . . . . .. 453Cmo crear una macro de inicio de sesin WEL 453Plug-in de seguridad de red . . . . . .. 454Plug-ins de Credential Mapper . . . . .. 454Parmetros de inicializacin . . . . . .. 456Creacin de archivo de almacn de claves SSL(slo DCAS) . . . . . . . . . . . .. 463

Utilizacin de los tickets de servicios Kerberos .. 465Seguridad de Java 2 . . . . . . . . . .. 465

Archivo de polticas . . . . . . . . .. 466Utilizacin de la gestin de certificados de IBMpara aplicaciones de HATS . . . . . . . .. 466

Creacin de un archivo de base de datos declaves . . . . . . . . . . . . . .. 467Solicitud y almacenamiento de certificados deentidades emisoras de certificados . . . .. 468Utilizacin de un certificado autofirmado . .. 470Intercambio de certificados . . . . . . .. 471Consideraciones sobre la herramienta Gestinde certificados . . . . . . . . . . .. 471

Captulo 22. Soporte de idiomas . .. 473Cdigos de idioma . . . . . . . . . .. 473Pginas de cdigos . . . . . . . . . .. 474Valores de codificacin . . . . . . . . .. 476Soporte Unicode para sistemas principales 5250 477Utilizacin de caracteres acentuados con la pginade cdigos 937 . . . . . . . . . . . .. 477Utilizacin de la pgina de cdigos 1388 (GB18030) 477Correlacin de cdigos de sistema principal parapginas de cdigos 1390 y 1399 . . . . . .. 478

Soporte de JIS2004. . . . . . . . . .. 478Cmo volver a correlacionar el teclado y loscaracteres de pantalla. . . . . . . . . .. 481

Prioridad de sustitucin de caracteres . . .. 482

Captulo 23. Soporte de aplicacionesbidireccionales. . . . . . . . . .. 483Entorno de software . . . . . . . . . .. 484Trabajo con el terminal de sistema principal . .. 484

Limitaciones del terminal de sistema principal 486

vi IBM Host Access Transformation Services: Gua del usuario y del administrador

Captura de pantallas . . . . . . . . .. 486Reconocimiento de componentes de sistemaprincipal bidireccionales . . . . . . . . .. 486Control de la orientacin de aparatos . . . .. 487Control de la alineacin de aparatos . . . . .. 488Componentes personalizados y soportebidireccional de aparatos . . . . . . . .. 489Variables globales . . . . . . . . . . .. 489Sustitucin de texto . . . . . . . . . .. 489Normas globales . . . . . . . . . . .. 490Permitir al usuario que invierta la direccin de lapantalla . . . . . . . . . . . . . .. 491Opciones de pantalla bidireccional VT . . . .. 491Opciones bidireccionales de solicitud y extracto demacro . . . . . . . . . . . . . . .. 492Opciones bidireccionales de macro para consultaSQL . . . . . . . . . . . . . . .. 492Soporte de impresin de derecha a izquierda . .. 493Soporte de correlaciones BMS . . . . . . .. 494Soporte de objetos de integracin. . . . . .. 494Soporte de servicios Web de abajo a arriba . .. 495Soporte de servicios Web RESTful . . . . .. 496Soporte de portlet . . . . . . . . . . .. 496Informacin para usuarios . . . . . . . .. 497

Inversin de campo automtica . . . . .. 498Inversin de campo . . . . . . . . .. 498Funciones del portapapeles . . . . . . .. 498rea de informacin del operador (OIA) . .. 499Conmutacin automtica de la capa de teclado 499

Soporte Unicode para sistemas principales 5250IBM i . . . . . . . . . . . . . . .. 499Funciones para las pginas de cdigos en rabe 499

Orientacin de pantalla de HATS Toolkit . .. 499Personalizacin de la direccin de pginas JSP 500Direccin de forma . . . . . . . . .. 500Forma selectiva del rabe . . . . . . .. 501Intercambio simtrico y numrico . . . .. 501Inhabilitar entrada de dgitosrabes-occidentales . . . . . . . . .. 501Conmutacin automtica de la capa de teclado 501Limitaciones del terminal de sistema principal 502Capturas de pantalla . . . . . . . . .. 502Configuracin de las sesiones de impresin enrabe en Web Access para System i . . . .. 502Otras consideraciones . . . . . . . .. 503

Adiciones a los archivos de HATS . . . . .. 503

Captulo 24. Soporte para el juego decaracteres de doble-byte . . . . .. 505Soporte de campos DBCS y SBCS . . . . .. 505Comprobacin del tipo de datos . . . . . .. 506Comprobacin de la longitud de los campos . .. 506Prevencin de copiar-y-pegar . . . . . . .. 506Editor de mtodo de entrada (IME) . . . . .. 506Conmutacin AutoIME . . . . . . . . .. 507Consideraciones sobre caracteres de fin e inicio deDBCS . . . . . . . . . . . . . . .. 507

Otras consideraciones . . . . . . . . .. 507Valores de tema del proyecto . . . . . .. 508Editor de valores del proyecto . . . . . .. 508Editor de sucesos de pantalla . . . . . .. 510Componentes de sistema principal . . . .. 510Aparatos . . . . . . . . . . . . .. 511Soporte de macros. . . . . . . . . .. 512Creacin de un objeto de integracin . . .. 512Trabajo con aplicaciones de dispositivos mviles 512Cmo volver a correlacionar el teclado y loscaracteres de pantalla. . . . . . . . .. 513Trabajo con caracteres definidos por el usuario 513

Apndice A. Archivos de propiedadesde unidad ejecutable . . . . . . .. 519Opciones de rastreo . . . . . . . . . .. 523Rastreo Host On-Demand . . . . . . . .. 524Rastreo de simulacin de sistema principal . .. 527

Apndice B. Material de consulta paraestabilizacin de pantalla en HATS .. 529Visin general de la estabilizacin de pantalla .. 529Procedimiento de estabilizacin de pantalla . .. 529Anlisis de datos de salida . . . . . . . .. 530Espera de distintivos OIA . . . . . . . .. 533Cambio de los valores de personalizacin . . .. 534Determinar la estrategia de HATS . . . . .. 535Resolucin de conflictos (slo TN3270E) . . .. 535

Resolucin de conflictos utilizando z/OSCommunications Server . . . . . . . .. 536Resolucin de conflictos utilizando otrosCommunications Servers . . . . . . .. 536Impacto en el rendimiento del uso de laresolucin de conflictos . . . . . . . .. 537Determinacin del estado de la resolucin deconflictos . . . . . . . . . . . . .. 537

Renovacin automtica . . . . . . . . .. 538Gestin de pantallas transitorias . . . . . .. 538Valores de gestin de pantalla en blanco inicial .. 540Valores de HATS relacionados . . . . . . .. 541Ajuste de la estabilizacin de pantalla de HATS 542Referencias . . . . . . . . . . . . .. 544

Informacin sobre resolucin de conflictos. .. 544Advanced Macro Guide . . . . . . . .. 544

Apndice C. Avisos . . . . . . . .. 545Programacin de informacin de interfaz . . .. 547Marcas registradas. . . . . . . . . . .. 547

Glosario . . . . . . . . . . . .. 549

ndice. . . . . . . . . . . . . .. 555

Contenido vii

viii IBM Host Access Transformation Services: Gua del usuario y del administrador

Captulo 1. Utilizacin de Host Access TransformationServices (HATS)

Cpn IBM Host Access Transformation Services (HATS), puede crear aplicacionesWeb y aplicaciones de cliente enriquecido que proporcionan una interfaz grfica deusuario (GUI) fcil 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 lnea(OLTP). En esta publicacin, las aplicaciones 3270 y 5250 basadas en caracteres seconocen como aplicaciones de sistema principal. Tambin puede crear crear activosde SOA (service Oriented oriented) utilizando servicios Web que proporcioneninterfaces de programacin estndar para lgica empresarial y transaccionesincluidas en aplicaciones de sistema principal. Asimismo se puede acceder a datosde las pantallas de emulacin de terminal de vdeo (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 pginasde portal o de Web de la empresa, a las que los usuarios podrn tener accesomediante navegadores Web. Tambin pueden desarrollarse aplicaciones Web deHATS para proporcionar acceso a las aplicaciones de sistema principal desdedispositivos mviles, como telfonos mviles, terminales de recopilacin de datos yasistentes digitales personales (PDA).

Las aplicaciones de cliente enriquecido de HATS pueden desarrollarse para que seejecuten en una implementacin 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 obtenerms informacin sobre el entorno RCP de Eclipse, consulte http://www.eclipse.org/home/categories/rcp.php. Para obtener ms informacin 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 ms informacin 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 ms informacin sobre las novedades de HATS V9.5, consulte lapublicacin HATS Getting Started.

Nota: a lo largo de este documento, los valores de configuracin que se aplicansolo a aplicaciones Web de HATS y aplicaciones EJB, se marcan conSlo Web, a menos que se indique lo contrario. Los valores deconfiguracin que se aplican solo a las aplicaciones de la plataforma decliente enriquecido de HATS se marcan con Slo 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 ms informacinsobre qu versiones de Rational SDP estn soportadas, consulte la seccin,Requisitos previos, en HATS Getting Started.

Copyright IBM Corp. 2003, 2015 1

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

|||||||

|

|||||
http://www.eclipse.org/home/categories/rcp.phphttp://www.eclipse.org/home/categories/rcp.phphttp://www-01.ibm.com/support/knowledgecenter/SSKTMJ_8.5.3/welcome_Domino_8_5_3.htmlhttp://www-01.ibm.com/support/knowledgecenter/SSKTMJ_8.5.3/welcome_Domino_8_5_3.htmlhttp://www-01.ibm.com/support/knowledgecenter/SSKTMJ_8.5.3/welcome_Domino_8_5_3.htmlhttp://publib.boulder.ibm.com/infocenter/ledoc/v6r2/index.jsphttp://publib.boulder.ibm.com/infocenter/ledoc/v6r2/index.jspgsintro.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 seanms fciles 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 ms informacin,consulte Descripcin del desarrollo de las aplicaciones de HATS en la pgina11.Despus de desarrollar una aplicacin de HATS, debe desplegarse en un entornode ejecucin de produccin.

v El cdigo de tiempo de ejecucin de HATS se ejecuta como parte de unaaplicacin HATS desplegada en el entorno de ejecucin de produccin,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 interaccin con la aplicacin deHATS a travs de la interfaz grfica de usuario (GUI) de HATS y los datos seenvan entre el usuario y la aplicacin de sistema principal en ambos sentidos.

Si desea obtener ms informacin, consulte el Captulo 3, Desarrollo y desplieguede aplicaciones Web de HATS, en la pgina 31 y el Captulo 4, Desarrollo ydespliegue de aplicaciones de cliente enriquecido de HATS, en la pgina 59.

Descripcin 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 Descripcin del proceso de las aplicaciones de HATSen la pgina 9. Muchos de los objetos de HATS se crean utilizando un asistente,pero se visualizan o se modifican despus utilizando un editor.

ProyectoUna coleccin de recursos de HATS (tambin llamados artefactos) que secrean utilizando asistentes de HATS Toolkit y se personalizan utilizandoeditores de HATS Toolkit. Estos recursos se exportan como una aplicacin deHATS. Hay cinco tipos de projects HATS: Web, EJB, de cliente enriquecido y,para administrar aplicaciones Web de HATS (incluido EJB), proyectos deconsola de administracin de HATS. Si desea obtener ms informacin,consulte el Captulo 3, Desarrollo y despliegue de aplicaciones Web deHATS, en la pgina 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 deaplicacin y sucesos de pantalla.

Suceso de aplicacinUn suceso de HATS que se desencadena por cambios de estado en el ciclo devida de la aplicacin. Ejemplos de sucesos de aplicacin son: el acceso de unusuario a una aplicacin de HATS por primera vez (suceso de inicio), o unaaplicacin que encuentra una pantalla no reconocida (suceso de pantalla sincoincidencia). Si desea obtener ms informacin, consulte Sucesos deaplicacin en la pgina 114.

Suceso de pantallaUn suceso de HATS que se desencadena cuando se reconoce una pantalla de

2 IBM Host Access Transformation Services: Gua del usuario y del administrador

|

||||||||

sistema principal al coincidir criterios determinados de reconocimiento depantalla. Hay dos tipos de sucesos de pantalla, personalizaciones de pantallay combinaciones de pantallas.

Personalizacin de pantallaUn suceso de pantalla de HATS diseado para realizar un conjunto deacciones cuando se reconoce una pantalla de sistema principal. Ejemplos depersonalizaciones de pantalla son: el reconocimiento de una pantalla y sutransformacin en una GUI para el usuario o la ejecucin de una macro paraomitir la pantalla. La definicin de personalizacin 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 tambin normasglobales a nivel de pantalla y valores de sustitucin de texto. Si desea obtenerms informacin, consulte el Captulo 7, Trabajo con sucesos de pantalla,en la pgina 159.

Combinacin de pantallasUn suceso de pantalla de HATS diseado para recopilar datos de salida depantallas de sistema principal consecutivas y similares, para luegocombinarlos y visualizarlos en una nica pgina de salida. Un ejemplo deuna combinacin de pantallas puede ser el reconocimiento de una pantallaque solo contenga datos parciales y la navegacin a travs de todas laspantallas posteriores para recopilar todos los datos restantes para que losvisualice el usuario. La definicin de combinacin de pantallas incluye unconjunto de criterios de reconocimiento de pantallas para las pantallas deinicio y final que desee combinar, cmo navegar de pantalla a pantalla, ascomo el componente y el aparato que desee utilizar para reconocer yrepresentar los datos recopilados de cada pantalla. Adems, incluye una listade acciones que deben efectuarse una o ms veces, normas globales a nivelde pantalla y valores de sustitucin de texto. Si desea obtener msinformacin, consulte el Captulo 7, Trabajo con sucesos de pantalla, en lapgina 159.

Criterios de reconocimiento de pantallaCuando se crea un suceso de pantalla, se establecen criterios dereconocimiento de pantalla que HATS utiliza para relacionar una o mspantallas. Las pantallas de sistema principal se pueden reconocer mediantecualquier combinacin de criterios, incluidos cuntos campos o campos deentrada hay en la pantalla, las coordenadas de la posicin del cursor y lasseries de texto en la pantalla dentro de un rectngulo definido o en cualquierotro punto de la pantalla. Tambin puede utilizar variables globales, colores,comparaciones de regin con valor y regin con regin 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 algn suceso de pantalla delproyecto. Si HATS encuentra una coincidencia, se realizan las accionesdefinidas para el suceso de pantalla.

Si desea obtener ms informacin sobre el establecimiento de criterios dereconocimiento de pantalla, consulte Criterios de reconocimiento de pantallao Pantalla de inicio en la pgina 161.

AccinEl paso que se da cuando se produce un suceso, por ejemplo, cuando seencuentra una pantalla de sistema principal que coincide con los criterios de

Captulo 1. Utilizacin de Host Access Transformation Services (HATS) 3

reconocimiento de pantalla especificados para un suceso de pantalla. Unalista de acciones forma parte de la definicin de cada suceso de aplicacin ysuceso de pantalla.

TransformacinUn archivo JSP (JavaServer Pages) (para proyectos Web) o un compuestoSWT (Standard Widgets Toolkit) (para proyectos de cliente enriquecido) quedefine cmo se deben extraer y mostrar los componentes de sistema principalutilizando aparatos en una GUI. Aplicar una transformacin 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 debido aque el Java visual editor ya no est disponible en Rational SDP V9.5. Paraobtener ms informacin sobre las funciones eliminadas y en desuso enRational Application Developer, consulte http://www.ibm.com/support/docview.wss?uid=swg27038549.

Si desea obtener ms informacin sobre la creacin de transformaciones,consulte el Captulo 8, Trabajar con transformaciones, en la pgina 187.

Componentes de sistema principalLos Componentes de sistema principal son objetos de HATSresponsables del reconocimiento de los elementos de la pantalla desistema principal (por ejemplo, lneas de mandatos, teclas de funcin,etc.) que presenta al usuario de la aplicacin de HATS. Puede utilizarel conjunto de componentes de sistema principal que suministraHATS, o puede crear uno propio.

Si desea obtener ms informacin sobre la seleccin de loscomponentes de sistema principal que desea utilizar con el proyectode HATS, consulte Insertar componente de sistema principal en lapgina 196.

Si desea obtener ms informacin sobre el uso del asistente paracrear componentes y aparatos personalizados, consulte la publicacinHATS Web Application Programmer's Guide o la publicacin HATS RichClient Platform Programmer's Guide, en funcin de su entorno deaplicacin.

AparatosLos aparatos son objetos de HATS responsables de la creacin de lasalida GUI para los componentes de sistema principal en lapresentacin de HATS. Por ejemplo, puede convertir los componentesde sistema principal de tecla de funcin en aparatos de botnpermitiendo que el usuario vea las teclas de funcin como pulsadoresen la aplicacin de HATS. Puede utilizar los aparatos que sesuministran con HATS o puede crear los suyos propios.

Si desea obtener ms informacin sobre la seleccin de los aparatosque desea utilizar con el proyecto de HATS, consulte Insertarcomponente de sistema principal en la pgina 196.

Si desea obtener ms informacin sobre el uso del asistente paracrear componentes y aparatos personalizados, consulte la publicacinHATS Web Application Programmer's Guide o la publicacin HATS RichClient Platform Programmer's Guide, en funcin de su entorno deaplicacin.


||||||
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

ConexinUn conjunto de parmetros que utiliza HATS para conectarse a lasaplicaciones de sistema principal. Hay dos tipos de conexiones en HATS: poromisin (tambin llamada de transformacin) y de fondo. Cada aplicacin deHATS tiene una conexin por omisin para la aplicacin de sistema principalcuyas pantallas transformar HATS. Las conexiones de fondo son lasconexiones de una aplicacin de HATS que no son la conexin por omisin.HATS no transforma pantallas desde las conexiones de fondo. No obstante,es posible elegir dinmicamente qu conexin se tratar como la conexinpor omisin. Si desea obtener ms informacin, consulte Captulo 6, Gestinde conexiones, en la pgina 143.

Normas globalesLas normas que especifican la sustitucin 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 transformacin. Elfragmento de transformacin incluye el contenido que desea utilizar parasustituir todas las apariciones de un patrn determinado en unatransformacin.

Nota: las normas globales se pueden desactivar para un uso especfico deuna transformacin, editando la accin de transformacin de un sucesode pantalla.

Si desea obtener ms informacin, consulte Representacin en la pgina100.

Representacin por omisinMtodo utilizado por HATS para representar una pantalla de sistemaprincipal para la que no existe un suceso de pantalla especfico. Larepresentacin por omisin tambin puede utilizarse en una transformacinespecfica que se aplique a un rea definida de una pantalla de sistemaprincipal. Si desea obtener ms informacin, consulte Representacin en lapgina 100.

Sustitucin de textoLa sustitucin de texto se utiliza a nivel de proyecto o a nivel de pantallapara transformar el texto de las pantallas de sistema principal en imgenes,HTML Slo Web u otro tipo de texto en la transformacin de GUI. Si deseaobtener ms informacin, consulte Sustitucin de texto en la pgina 109.

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 omisin del proyecto. La plantilla puedecontener logotipos de empresa, informacin y enlaces con otras pginas.Puede seleccionar su plantilla por omisin entre las plantillas de ejemplo quese proporcionan con HATS, o puede disear plantillas personalizadas paralos proyectos utilizando los asistentes y editores de HATS Toolkit. Tambinpuede 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 transformacin. Puedeaplicar una plantilla distinta a la plantilla por omisin como resultado de unsuceso de pantalla. Si desea obtener ms informacin sobre la asociacin deuna plantilla con una transformacin, consulte el Captulo 10, Utilizacin deplantillas, en la pgina 341.


Lgica empresarialTodo cdigo Java que se invoca como accin en un suceso, por ejemplo, unapersonalizacin de pantalla. La lgica empresarial es especfica de laaplicacin.

Si desea obtener ms informacin sobre la lgica empresarial, consulte lapublicacin HATS Web Application Programmer's Guide o la publicacin HATSRich Client Platform Programmer's Guide, en funcin de su entorno deaplicacin.

Variable globalUna variable utilizada para almacenar un valor que se puede utilizar durantetoda la vida de una instancia de aplicacin 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. Tambin 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 tambin se pueden utilizar en macros,lgica empresarial y objetos de integracin.

Si desea obtener ms informacin sobre variables globales, consulte elCaptulo 12, Interaccin con variables globales, en la pgina 371.

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 informacin de las pantallas de sistema principal.

Las macros se pueden utilizar de distintas formas en una aplicacin deHATS:v Se puede ejecutar una macro en la conexin por omisin como parte de

una accin Ejecutar macro de un suceso de HATS. Debe ser la ltimaaccin definida para un suceso de pantalla.

v Se puede ejecutar una macro en una conexin de fondo como parte de unaaccin Realizar transaccin de macro de un suceso de HATS.

v Se puede ejecutar una macro aadiendo botones de macro a unatransformacin. Esto permite a un usuario controlar si se ejecuta la macroo no.

v Se puede ejecutar una macro mediante un objeto de integracin.v Se puede utilizar una macro de conexin para iniciar una conexin.v Se puede utilizar una macro de desconexin terminar una conexin.

Si desea obtener ms informacin sobre la incorporacin de macros en elentorno de HATS, consulte el Captulo 11, Macros y terminal de sistemaprincipal, en la pgina 355.

Objetos de integracinLos objetos Java creados desde una macro que se pueden utilizar comobloques de construccin para las aplicaciones WebSphere. Los objetos deintegracin son beans de Java que encapsulan interacciones con los orgenesde datos de sistema principal. Estos orgenes de datos incluyen aplicacionesorientadas al terminal que utilizan datos 3270, 5250 y de terminal de vdeo(VT).

pgblogic.htmrcppgd09.htm#pgblogicrcppgd09.htm#pgblogic

Los objetos de integracin que comparten la misma conexin se puedenagrupar para formar una sola tarea principal en la aplicacin de HATS. Estose conoce como encadenamiento de objetos de integracin. Si desea obtenerms informacin, consulte el Captulo 13, Utilizacin de objetos deintegracin, en la pgina 375.

Terminal de sistema principalUna conexin 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. Tambinpuede ejecutar macros importadas o registradas previamente. El terminal desistema principal tambin le permite ver una vista previa de la pantalla cmoGUI.

Terminal de pantallaUna ventana de terminal que muestra pantallas de sistema principal quepuede utilizar mientras prueba y depura para observar las interacciones entreuna aplicacin de HATS y una aplicacin de sistema principal en tiempo deejecucin. Tambin puede interactuar con la aplicacin de sistema principalmediante pantallas de sistema principal en la ventana de terminal. Si deseaobtener ms informacin sobre el terminal de pantalla, consulte Utilizacindel terminal de pantalla para prueba y depuracin en la pgina 426.

Captura de pantallaUna representacin XML de una pantalla de sistema principal, almacenada enun archivo .hsc, que se utiliza para crear o personalizar una personalizacinde pantalla, una combinacin de pantallas, una transformacin, una normaglobal o una macro. Las capturas de pantalla son tiles porque permitenpersonalizar un proyecto de HATS aunque no est conectado al sistemaprincipal. Resultan tambin de utilidad para crear macros que son el ncleodel soporte de objetos de integracin de HATS y servicios Web.

Al configurar la agrupacin, se pueden utilizar las capturas de pantalla de laspantallas de sistema principal de terminal de vdeo (VT) para crear opersonalizar una macro mediante el Editor de macros visual y como lapantalla de comprobacin. No se pueden utilizar para crear personalizacionesde pantalla, combinaciones de pantallas, transformaciones, representacin poromisin o normas globales.

Ejecutar en servidorSlo WebUna funcin de Rational SDP que permite probar los proyectos Web de HATSen un servidor de WebSphere Application Server o en una instancia deWebSphere Portal, segn sea adecuado. En esta modalidad puede modificar yprobar los valores de tiempo de ejecucin, definidos en el archivoruntime.properties, que se despliegan en el entorno de ejecucin. Tenga encuenta que cualquier cambio efectuado en los valores del tiempo de ejecucinmientras se efectan pruebas en esta modalidad se retienen y pasan aaplicarse al desplegar la aplicacin de HATS en un entorno de ejecucin. Sidesea obtener ms informacin sobre el cambio de valores del tiempo deejecucin, consulte Administracin de componentes de la determinacin deproblemas en la pgina 422.

Depurar en servidor Slo WebIgual que Ejecutar en servidor y adems permite:v Utilizar el terminal de pantalla para ver las pantallas de sistema principal a

medida que navega a travs 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 plantillao una transformacin, sin tener que reiniciar la aplicacin en el servidor depruebas.

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

v Recorrer el cdigo Java, como la lgica empresarial de HATS.

Crear perfiles en servidor Slo WebIgual que Ejecutar en servidor y adems permite localizar las operacionesque requieren ms tiempo e identificar las acciones estn repetidas paraeliminar redundancias. Puede utilizar esta funcin para el anlisis derendimiento, lo que permite conocer mejor la aplicacin.

Ejecutar Slo RCPUna funcin 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 ejecucin, definidos en el archivo runtime.properties, que sedespliegan en el entorno de ejecucin. Tenga en cuenta que cualquier cambioefectuado en los valores del tiempo de ejecucin mientras se efectanpruebas en esta modalidad se retienen y pasan a aplicarse al desplegar laaplicacin de HATS en un entorno de ejecucin. Si desea obtener msinformacin sobre el cambio de valores del tiempo de ejecucin, consulteAdministracin de aplicaciones de cliente enriquecido de HATS en lapgina 84.

Depurar Slo RCPIgual que Ejecutar y adems permite:v Utilizar el terminal de pantalla para ver las pantallas de sistema principal a

medida que navega a travs 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 transformacin, sin tener que reiniciar la aplicacin.v Modificar y probar valores de tiempo de ejecucin, definidos en el archivo

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

v Recorrer el cdigo Java, como la lgica empresarial de HATS.

Crear perfiles Slo RCPIgual que Ejecutar y adems permite localizar las operaciones que requierenms tiempo e identificar las acciones estn repetidas para eliminarredundancias. Puede utilizar esta funcin para el anlisis de rendimiento, loque permite conocer mejor la aplicacin.

Soporte de impresinEl desarrollador puede especificar una sesin de impresora para que se asociecon una sesin de sistema principal y habilitar al usuario para ver lostrabajos de impresin de la aplicacin de sistema principal, enviarlos a unaimpresora o guardarlos en disco. El soporte de impresin slo est disponiblepara la conexin por omisin.

Si desea obtener ms informacin sobre el soporte de impresin, consulte elCaptulo 15, Habilitacin de soporte de impresin, en la pgina 389.

Soporte de tecladoEl desarrollador puede habilitar al usuario para que utilice un teclado fsico


para interactuar con el sistema principal cuando la aplicacin se ejecute enuna GUI. El desarrollador tambin decide si desea incluir un rea de tecladode sistema principal, un rea de teclado de aplicacin, o ambas, en unproyecto. Si se incluyen las reas de teclado, el desarrollador decide quteclas se incluyen y cmo aparecen esas teclas y el rea de teclado en la GUI.

Si desea obtener ms informacin sobre el soporte de teclado, consulte elCaptulo 16, Habilitacin de soporte de teclado, en la pgina 395.

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 fsicas en un teclado. No obstante, los usuarios pueden continuarutilizando las teclas fsicas del teclado en lugar de los botones o enlaces delrea de teclado de sistema principal. Si desea obtener ms informacin sobreel rea de teclado de sistema principal, consulte rea de teclado de sistemaprincipal en la pgina 204.

El rea de teclado de aplicacin es una tabla de botones o enlaces quepermiten a los usuarios realizar tareas relacionadas con la aplicacin deHATS como, por ejemplo, visualizar los trabajos de impresin o renovar lapantalla. Si desea obtener ms informacin sobre el rea de teclado deaplicacin, consulte rea de teclado de aplicacin en la pgina 352.

Descripcin del proceso de las aplicaciones de HATSAntes de crear un proyecto de HATS, debe entender cmo procesa HATS lasaplicaciones de sistema principal. A medida que los usuarios acceden a cada unade las pantallas de una aplicacin, HATS procesa la aplicacin tal como se describeen los pasos siguientes. La Figura 1 en la pgina 11 muestra el flujo de estos pasos.Los conceptos clave se describen en Descripcin de los conceptos clave y losobjetos de HATS en la pgina 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 personalizacin de pantallacomo los de combinacin de pantallas pueden incluirse en las acciones que selistan a continuacin. Adems, en el caso de un suceso de combinacin depantallas, HATS navega a travs de varias pantallas recopilando datos de cadapantalla para mostrarlos al usuario.v Aplicar una transformacin utilizando la plantilla asociada. HATS muestra

los componentes de sistema principal (definidos en la transformacin) comoaparatos de GUI

v Ejecutar lgica empresarialv Extraer variable globalv Insertar datosv Establecer variable globalv Eliminar variable globalv Enviar variable global (slo proyectos de portlet estndar de HATS)v Mostrar URL o compuesto SWT Slo RCPv Mostrar URL Slo Web


v Reenviar a URL Slo Webv Ejecutar macrov Realizar una transaccin de macrov Enviar una teclav Desconectarv Pausa

Si desea obtener ms informacin, consulte Acciones en la pgina 167.

Notas:

1. Cuando se encuentra una coincidencia de pantalla, al menos tiene que efectuarse unaaccin, pero no es necesario mostrar una transformacin de la pantalla al usuario. Enotras palabras, la accin aplicar una transformacin no es necesaria.

2. Puede realizar acciones sobre los datos de la pantalla de sistema principal antes ydespus de que el usuario interacte con ella. Por ejemplo, puede extraer algunos datoscomo una variable global, sustituir cierta informacin por datos nuevos y seguidamenteaplicar la transformacin antes de mostrar la transformacin al usuario. Despus deque el usuario realice una accin 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 aplicacin de pantallasin coincidencia. La accin por omisin de este suceso es mostrar la pantalla desistema principal utilizando la transformacin por omisin y aplicar la plantillapor omisin. La transformacin por omisin utiliza los valores derepresentacin definidos en los valores del proyecto.

4. A medida que el sistema principal presenta cada una de las nuevas pantallasde una aplicacin, HATS vuelve a empezar por el paso 1 y contina con elresto. La Figura 1 en la pgina 11 muestra cmo HATS procesa las pantallas.

Nota: Si se utiliza una macro para el proceso de saltar pantallas, dichaspantallas no estarn 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 bsicos de los sucesos de pantalla antes deempezar el proceso de desarrollo. Los elementos bsicos de los criterios dereconocimiento de pantalla se analizan en el Captulo 7, Trabajo con sucesos depantalla, en la pgina 159.

Descripcin del desarrollo de las aplicaciones de HATSHATS permite utilizar un enfoque iterativo en el desarrollo de aplicaciones. Puedeempezar con una configuracin sencilla y aadir mejoras cuando est preparado.Puede probar cada cambio mientras lo realiza mediante el entorno de prueba deRational SDP. La mayora de los cambios se pueden ver con una simple renovacinde la transformacin 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?

Coincidealgncriterio

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

Figura 1. Proceso de pantallas de HATS


una posible secuencia de pasos que puede utilizar para disear y desarrollar laaplicacin de HATS. Puede seguir adelante hasta donde desee o detenerse encualquier punto del camino.1. Empiece creando una aplicacin de HATS que utilice todos los valores por

omisin y vea instantneamente todas las pantallas de sistema principalrepresentadas en una GUI. La representacin por omisin puede representar laspantallas de sistema principal de forma que se converse el diseo original de lapantalla y se aadan automticamente controles de GUI, como enlaces, botonesy tablas, para mejorar la productividad del usuario.

2. Cree una plantilla que coincida con las pginas 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 Captulo 10, Utilizacin de plantillas, en la pgina 341para obtener ms informacin. Ahora la aplicacin de HATS coincide con elestilo y colores de las pginas Web u otras aplicaciones de la empresa.

3. Configure valores a nivel de proyecto (de forma global en la aplicacin) ycompruebe el grado de manejo de la aplicacin de sistema principal sinconfigurar pantallas especficas. Puede cambiar caractersticas a nivel deproyecto en las distintas pestaas del Editor de valores del proyecto. Consulteel Captulo 5, Modificacin de un proyecto de HATS, en la pgina 97 paraobtener ms informacin. Por ejemplo, intente realizar algunos cambios como,por ejemplo:v Cambie la representacin por omisin para que represente una lista de

seleccin como una lista desplegable. Esto cambiar todas las listas deseleccin por listas desplegables.

v Cree una o ms 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 ubicacin por listas desplegables.

v Utilice la sustitucin de texto para cambiar una o ms series que aparezcanen las pantallas de sistema principal. Por ejemplo, puede cambiar laspalabras abrir sesin por iniciar sesin.

v Observe cmo se transforman las pantallas de sistema principal. Hayelementos que aparezcan en la mayora de las ventanas que deseetransformar de forma diferente? Esos pueden ser los candidatos paramodificar los valores de algunos componentes (cambiar cmo se reconocenlos componentes de sistema principal) o aparatos (cambiar cmo serepresentan los controles de GUI en la transformacin). Puede cambiar estosvalores a nivel de proyecto estableciendo los valores por omisin que se vana utilizar en las pantallas de sistema principal. Tambin puede cambiar losvalores de las instancias individuales de los componentes y aparatos cuandolos aada a las transformaciones. Si desea obtener ms informacin, consulteRepresentacin en la pgina 100.

4. Cree sucesos a nivel de pantalla para reconocer pantallas de sistema principalespecficas y desencadenar la ejecucin 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 funcin de terminal del sistemaprincipal de HATS para conectarse a la aplicacin de sistema principal ycrear capturas de pantalla para las pantallas especficas que desea reconocery con las que desea actuar. A continuacin, a partir de cada captura depantalla, cree un suceso de pantalla.


v Utilice el asistente Crear una personalizacin de pantalla para personalizaralgunas de las pantallas de sistema principal para simplificarlas, eliminarelementos no utilizados, y extraer y rellenar automticamente datos parasimplificar la entrada del usuario. Proporcione controles de GUI especficosde la pantalla para aumentar el grado de productividad del usuario. Si deseaobtener ms informacin, consulte el Captulo 7, Trabajo con sucesos depantalla, en la pgina 159.

v Es un requisito comn poder recopilar datos a partir de varias pantallas desistema principal y presentarlos en una sencilla pgina de salida, o bienfacilitar una nica pgina de entrada que luego proporcione varias pantallasde sistema principal con datos. HATS ofrece varios mtodos para realizarestas operaciones. Estos mtodos son: la utilizacin de combinaciones depantallas, personalizaciones de pantalla, transformaciones, macros, variablesglobales y objetos de integracin. La utilizacin de un mtodo concretodepende de la operacin que se va a efectuar y de la ubicacin de los datos.Para empezar, intente utilizar el asistente Crear una combinacin de pantallaspara combinar datos que no quepan en su totalidad en una nica pantalla desistema principal y visualizarlos en una nica pgina de salida. Si deseaobtener ms informacin, consulte el Captulo 14, Combinacin depantallas, en la pgina 387 y el Captulo 7, Trabajo con sucesos depantalla, en la pgina 159.

5. Cree macros sencillas para ayudar al usuario en la navegacin por la aplicacinde 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 ms informacin,consulte el Captulo 11, Macros y terminal de sistema principal, en la pgina355.

6. Para aplicaciones Web, cree objetos de integracin, que se construyen a partirde macros y son beans Java que encapsulan interacciones con una aplicacin desistema principal. A continuacin, utilice los objetos de integracin para crearpginas Web del modelo 1, Struts o JSF (JavaServer Faces) para dirigir lasinteracciones con la aplicacin de sistema principal. Tambin puede ejecutarobjetos de integracin desde su propia lgica empresarial Java o ampliarlospara proporcionar interfaces de Enterprise JavaBeans (EJB) o de servicios Web ala aplicacin de sistema principal. Si desea obtener ms informacin, consulte elCaptulo 13, Utilizacin de objetos de integracin, en la pgina 375.

Cmo s qu versin de HATS tengo?Puede determinar la versin de HATS Toolkit y de cada uno de los proyectos deHATS.

Para determinar qu versin 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 pgina IBM Installation Manager - Installed Offerings muestra todos los

paquetes instalados (incluidos los niveles de versin y compilacin) y lascaractersticas.

Puede determinar la versin (incluido el nivel de mantenimiento) de cada proyectode HATS. Esta informacin de versin 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 Contenido


|

Web\WEB-INF\profiles (para proyectos Web), en la carpeta profiles (paraproyectos de cliente enriquecido) y en la carpeta ejbModule (para proyectos EJB).

La informacin de versin para proyectos .ear de HATS y para el proyecto deextensin del tiempo de ejecucin RCP de HATS se mantiene en el archivoproduct.xml. Este archivo se puede visualizar desde la vista Navegador en lacarpeta raz del proyecto.

Recopilacin de informacin sobre determinacin de problemasAlgunas veces quiz necesite ayuda para determinar problemas relacionados conHATS. Si desea obtener instrucciones sobre cmo recopilar informacin dedeterminacin de problemas para el personal de soporte de HATS, consulte elapartado Gathering problem determination information de la publicacin HATSTroubleshooting.

Dnde puedo encontrar informacin sobre HATS?La siguiente informacin sobre HATS est disponible antes de instalar HATS:v La documentacin de HATS est disponible en el CD de instalacin de CD.

Desde el launchpad de instalacin, seleccione enlaces a los documentossiguientes: Notas de release Gua de iniciacin (pdf)

v El Knowledge Center de HATS en http://www.ibm.com/support/knowledgecenter/SSXKAY_9.5.0 incluye informacin de las Notas de release, laspreguntas ms frecuentes (FAQs), informacin de referencia de la API, guas deaprendizaje, informacin sobre WebFacing y versiones en HTML y PDF de losdocumentos siguientes. Tambin se incluyen las versiones traducidas disponiblesen formato PDF. HATS Getting Started Gua 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 informacin adicional del producto, como la visin generaldel producto, descargas de prueba, requisitos del sistema, etc.

v La zona interactiva de HATS en la direccin https://www.ibm.com/developerworks/mydeveloperworks/groups/service/html/communityview?communityUuid=2ce1fd8d-d706-4afd-b9ef-9000ad21218dincluye una biblioteca de recursos, foros de discusin, 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, guas de aprendizaje y enlaces a recursos para ayudarle autilizar los productos de IBM satisfactoriamente. Busque Host AccessTransformation Services en Contents.

contacting_support.htm#gatheringhttp://www.ibm.com/support/knowledgecenter/SSXKAY_9.5.0http://www.ibm.com/support/knowledgecenter/SSXKAY_9.5.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.jsp

Adems de la informacin disponible antes de instalar HATS, la informacinsiguiente est disponible en el sistema despus 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.v La documentacin de HATS, incluida la de WebFacing, est disponible en el

men Ayuda de la barra de mens de Rational SDP. Seleccione Ayuda >Contenido de la ayuda y, en el panel Contenido, seleccione Desarrollo deaplicaciones de HATS.

v La gua de aprendizaje de la pgina de bienvenida de HATS le gua en todo elproceso de desarrollo de una aplicacin de HATS y, si se ha instalado en elproducto IBM Rational Developer para Power Systems Software, introduce lacaracterstica IBM WebFacing Tool para IBM i de HATS Toolkit.

v Si est instalado WebFacing Tool, la gua de aprendizaje de la pgina debienvenida de WebFacing proporciona informacin similar a la que figura en lagua de aprendizaje de la pgina de bienvenida de HATS.

v Todos los campos de los asistentes y editores de HATS disponen de ayuda segnel 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.


||
readme.htm

Captulo 2. Migracin a HATS V9.5

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.5.

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.5. Para migrar estos proyectos, primerodebe migrarlos a un release provisional de HATS, por ejemplo, V5, V6, V7, V7.1 oV7.5 y, a continuacin, migrarlos desde el release provisional a HATS V8.0, V8.5,V9.0 o V9.5. Consulte la documentacin correspondiente a su release anterior deHATS para obtener informacin sobre la migracin de proyectos HATS.

Si est utilizando una versin de Host Publisher anterior a la V4.0, primero tieneque seguir las instrucciones de migracin 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 bsqueda "How to migrate Host Publisher" (Cmo migrar HostPublisher). Si desea obtener ms informacin, consulte HATS para usuarios deHost Publisher en la pgina 25.

Migracin de HATSLa migracin 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.5 mediante uno de los

mtodos siguientes:v Importe un proyecto existente seleccionando su directorio raz o un archivo

de archivado.v Desproteja el proyecto de un repositorio de cdigos (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.5.2. Migrar el proyecto utilizando el asistente de migracin de HATS.

Importacin 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 continuacin,importarlo y migrarlo a HATS V9.5. Consulte la documentacin del release anteriorde HATS para obtener informacin sobre la exportacin de proyectos de HATS.Para obtener ms informacin sobre la importacin de proyectos Web y de clienteenriquecido de HATS en HATS V9.5, consulte Exportacin e importacin deproyectos Web de HATS en la pgina 35 y Exportacin e importacin deproyectos de cliente enriquecido de HATS en la pgina 66.

Si ha almacenado los proyectos de HATS en Rational ClearCase, debe crear unavista instantnea que contenga estos proyectos y, a continuacin, importarlos en elespacio de trabajo de HATS V9.5 mediante Archivo > Importar > General >Proyectos existentes en el espacio de trabajo. Durante la importacin, noseleccione la opcin Copiar proyectos en el espacio de trabajo. Despus deimportar los proyectos en el espacio de trabajo de HATS V9.5, dispondr de la

Copyright IBM Corp. 2003, 2015 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

opcin de migrarlos a HATS V9.5. Durante la migracin, los archivos que debenactualizarse se desprotegen automticamente de Rational ClearCase.

Migracin del espacio de trabajo de Rational SDPSe muestra el asistente de migracin de espacios de trabajo de Rational SDP si seimporta un proyecto en el espacio de trabajo y necesita algn nivel de migracinde Rational SDP. Este asistente realiza alguna migracin bsica 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 migracin de HATS, debe ejecutar primeroel asistente de migracin de espacios de trabajo de Rational SDP.

Nota: La migracin del espacio de trabajo Rational SDP V9.5 slo soportaproyectos creados a partir de Rational SDP V7.0 o posterior. Al importar unproyecto pre-HATS V7.0, la migracin de la estacin de trabajo de RationalSDP no funciona y aparece un mensaje de error. La migracin de HATSseguir pudiendo migrar el proyecto a HATS V9.5.

Utilizacin del asistente de migracin 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.5, 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 migracin de HATS para migrar este proyecto a HATSV9.5 antes de investigar los errores mostrados en la vista Problemas, ya que lamigracin puede eliminar algunos o todos estos errores.

Para utilizar el asistente de migracin de HATS siga estos pasos:1. En la vista Proyectos de HATS, pulse con el botn derecho del ratn en el

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

el proyecto de HATS que ha seleccionado para migrarlo, esos proyectostambin se migrarn, as como todos los proyectos .ear de HATS asociados.

3. Pulse Aceptar para empezar la migracin.4. Si el proyecto no tiene un proyecto .ear asociado, deber asociar el proyecto

.war despus de realizar la migracin. Para asociar el proyecto .war con unproyecto .ear, consulte Traslado de proyectos Web de HATS a un archivo .eardiferente en la pgina 34.

Notas:

1. Despus de la migracin, compruebe los detalles en el Informe de migracin.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 migracin deespacios de trabajo de Rational SDP) o facetas de WebSphere no admitidas, elasistente de migracin 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, despus de la migracin, recibe un error indicando que el entorno deejecucin de destino no est definido, edite las propiedades para el proyecto yseleccione el entorno de ejecucin de destino adecuado. Para ello, pulse con elbotn derecho del ratn en el proyecto y seleccione Propiedades. En la ventana


|

|

|

||

|||||||

Propiedades, seleccione Entornos de ejecucin de destino. En la lista Entornosde ejecucin, seleccione el entorno de ejecucin adecuado.

4. La migracin del proyecto desde un release anterior de HATS a HATS V9.5 nose puede deshacer.

Migracin de las transformaciones de HATSAl migrar proyectos de HATS de un release anterior de HATS a HATS V9.5, lastransformaciones de los proyectos tambin se migran. Los cambios efectuados enlas transformaciones dependen del release de HATS desde el que se efecta lamigracin. Todas las transformaciones se guardan en la carpeta MigrationBackupantes de migrarse.

Consideraciones especiales relativas a la migracin

Avance automticoSi en versiones anteriores de HATS ha habilitado la funcin de avance automticoaadiendo la lnea turnAutoTabOn(); al archivo lxgwfunctions.js, ahora debeutilizar el valor Habilitar avance automtico de campo en la seccin Valores delcliente de la pestaa Otros del editor Valores del proyecto. Si desea obtener msinformacin, consulte Valores de cliente en la pgina 130.

Archivos de copia de seguridadLa migracin 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 migracin, durante el que sesobrescribieron. Estos archivos se guardan para permitir compararlos y fusionarloscon los nuevos archivos de HATS V9.5. No se preocupe si surgen problemas; laaplicacin ya no utiliza estos archivos. Una vez se hayan comparado o fusionadotodos los archivos guardados, puede suprimir la carpeta MigrationBackup.

Nota: Antes de suprimir la carpeta MigrationBackup, puede publicar un proyectomigrado en WebSphere Application Server para probar cmo 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 demens de Rational SDP y seleccione Permitir publicar en un servidor lasaplicaciones que contienen errores.

Aparato de botnSi migra un proyecto creado antes de HATS V7.0.0.2 y elige implementar la opcinHabilitar 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 lnea siguiente de la declaracin input.HATSBUTTON:

color: lime;

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

Captulo 2. Migracin a HATS V9.5 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 edicin 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. Asegrese de que cualquier cambio que efecte 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 compilacin o de tiempo de ejecucin que empiecen con "Nose pudo resolver HPubReqCompleteEvent." Para corregirlos, vuelva a generar losbeans de acceso EJB.

Nota: El soporte de aplicacin EJB de HATS est en desuso en HATS V9.5.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 integracin. Para obtener

ms informacin, consulte Desarrollo de servicios Web de la publicacinHATS Web Application Programmer's Guide.

v Crear beans EJB para acceder a los objetos de integracin. Para obtenerms informacin, consulte Utilizacin de un objeto de integracin en uncontenedor EJB (del EJB) en la publicacin 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. Aada 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 aadido un valor nuevo, enforceImmediacy, a cualquier norma globalimportada en HATS V9.5 desde HATS V5. Cuando este valor es true, la norma


|

|
pgwebsv.htmpgcusio.htm#writingpgcusio.htm#writing

global se comporta como lo haca en HATS V5 al seleccionar Slo el campo deentrada ms cercano para la opcin Transformar del patrn Buscar campos deentrada por texto adyacente. Cuando este valor es false (valor por omisin), lanorma global se comporta como lo hace en HATS V9.5.

Para que las normas globales que se acaban de definir se comporten como lohacan las normas globales de HATS V5, debe aadir el valor enforceImmediacy yestablecerlo en true. Para ello, en la pestaa Fuente del editor de Valores delproyecto, aada el valor siguiente al cdigo componentSettings de las normasglobales:

Variables globalesAntes de HATS V7, el valor de una variable global, especificado en una solicitudinsertada en una transformacin mediante la opcin Solicitar la variable globalcon recuadro de entrada, podra haberse truncado debido a algunos caracteres noespecificados correctamente.

En esta versin de HATS, los valores de variable global solicitados por unatransformacin se especifican correctamente para evitar recortes. Las variablesglobales insertadas en una transformacin mediante la opcin Mostrar la variableglobal como texto esttico no se ven afectadas por este cambio. Las solicitudes devariables globales insertadas en una transformacin en una versin de HATSanterior a HATS V7 no se actualizan automticamente durante la migracin, por loque no se ven afectadas por este cambio.

Compresin HTTPSi desea utilizar el soporte de HATS para la compresin HTTP en proyectosmigrados de HATS V5.0.x, V6.0 y V6.0.1, debe aadir manualmente el filtro decompresin al archivo del descriptor de despliegue Web (web.xml). Para aadir elfiltro de compresin 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 pestaa Fuente para ver el fuente de este archivo.4. Copie las sentencias siguientes despus de la ltima correlacin de servlets

definida (busque la ltima aparicin de ).

Proporciona compresin para la salida del servlet deentrada de HATS

CompressionFilterCompressionFiltercom.ibm.hats.runtime.filters.CompressionFilter

5. Copie las sentencias siguientes despus de la ltima correlacin de filtrosdefinida (busque la ltima aparicin de ).

CompressionFilterEntryServletERRORFORWARDINCLUDEREQUEST

CompressionFilter/

Captulo 2. Migracin a HATS V9.5 21

|

CompressionFilter/index.jsp

6. Guarde el archivo.

Nota: si ha ejecutado este proyecto en el servidor, deber volver a publicar laaplicacin para que WebSphere Application Server aplique el cambio en elarchivo web.xml.

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

Aplicaciones Web de WebFacing: Las herramientas de gestin 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.5 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_instalacin_compartido es el directorio de recursos compartidosdonde se ha instalado la oferta de HATS mediante IBM Installation Manager ynnn es la versin y el nivel de build de HATS.

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

4. Exporte el proyecto como un EAR y vuelva a desplegarlo.5. Las herramientas de gestin de licencias de IBM podrn ahora detectar la

aplicacin.

Si habilit la deteccin para un proyecto de WebFacing antiguo y migr elproyecto a V9.5, debe eliminar el archivo de signatura existente (por ejemplo,WDHT0700.sys2 si el proyecto de WebFacing antiguo es de V7.0) del EAR asociadoal proyecto y aadir el archivo de signatura de V9.5(Host_Access_Transformation_Services-9.0.0.swidtag) antes de volver a llevar acabo el despliegue.

Seguridad de Java 2Durante la migracin a HATS V9.5, se sobrescribe el archivo was.policy deseguridad de WebSphere Application Server Java 2. Si ha personalizado el archivowas.policy en un proyecto anterior a HATS V9.5, entonces debe volver apersonalizar el archivo despus de la migracin.


||

|

|

||||

|

|

Correlaciones del tecladoEn versiones anteriores del terminal de sistema principal de HATS, la tecla Pausaestaba correlacionada con la accin [clear] del sistema principal. En HATS V7 yposterior, terminal del sistema principal, la tecla Esc est correlacionada con laaccin [clear] del sistema principal.

En versiones anteriores de HATS anteriores a HATS V6, se utilizaba Control+R ensesiones bidireccionales para invertir la direccin de la pantalla. En HATS V6 yposteriores, la combinacin Control+R est correlacionada con una accin RESETpara sesiones bidireccionales y no bidireccionales, y Alt+Intro est correlacionadacon la accin de invertir la direccin de la pantalla en sesiones bidireccionales.

Aplicaciones de Cliente enriquecido

Enlaces del teclado de Lotus Notes:

Si migra a HATS V9.5 un proyecto de cliente enriquecido anterior a HATS V7.5.1diseado para Lotus Expeditor, las correlaciones de teclas para Lotus Notes seaaden al proyecto.

Iniciar configuraciones:

Despus de migrar un proyecto de cliente enriquecido, si no puede iniciarlo en elentorno de prueba, cree una configuracin de inicio nueva para utilizar en elentorno de prueba. Para hacerlo, en la vista de proyectos de HATS, pulse con elbotn derecho del ratn en el proyecto y seleccione Ejecutar o DepurarAparecerla ventana de configuracin de Ejecutar (o Depurar). Si el proyecto est diseadopara Eclipse RCP, pulse con el botn derecho del ratn en Aplicacin Eclipse yseleccione Nuevo. Si el proyecto est diseado para Lotus Notes o Lotus Expeditor,pulse con el botn derecho del ratn en Servicios de cliente y seleccione Nuevo.Modifique el nombre de configuracin de inicio y la ubicacin si lo desea. Tambinpuede eliminar configuraciones de inicio anteriores desde esta ventana. PulseEjecutar (o Depurar) para iniciar el proyecto en el entorno de prueba.

Temas:

Las aplicaciones de cliente enriquecido de HATS V7.0 que utilizan el temaEmulador de terminal clsico tendrn habilitado el valor Navegacin con teclasde flecha despus de la migracin.

Series de caracteres en un idioma distinto del ingls (Estados Unidos) enplantillas y transformaciones:

Las series de caracteres en un idioma distinto del ingls (Estados Unidos) incluidasen plantillas y transformaciones de un proyecto de cliente enriquecido de HATScreado con HATS V7.0 o V7.0.0.1 no se compilan correctamente cuando el proyectose exporta como una caracterstica. Para resolver este problema, despus de migrarel proyecto a HATS V9.5, edite

ibm host access transformation services: guía del …€¦ · corr elación entr e componentes y...

Documents