Desarrollo y despliegue de aplicaciones Web de HATS
Hay cinco tipos de aplicaciones de HATS: Web, portlet, EJB, cliente enriquecido y consola administrativa. En este capítulo se incluye información sobre aplicaciones Web de HATS. Si desea obtener información sobre los otros tipos de aplicaciones, consulte los capítulos siguientes:
Además, una aplicación Web de HATS puede enlazarse con una aplicación WebFacing y empaquetarse juntos para interaccionar entre sí en una única Enterprise Application. Si desea obtener más información, consulte el WebFacing y HATS.
Las aplicaciones de HATS se crean a partir de proyectos de HATS mediante HATS Toolkit. Cuando se crea un nuevo proyecto de HATS, se crea un conjunto de carpetas para organizar mejor los archivos de aplicación de HATS.
A continuación, se muestra un ejemplo de un proyecto por omisión. La carpeta de máximo nivel tiene el mismo
nombre que el proyecto en el momento de crearlo. En esa carpeta se encuentran las
demás carpetas de alto nivel que contienen objetos definidos en el proyecto de
HATS. Algunas carpetas no aparecen hasta que se crean ciertos objetos.
Figura 2. Vista de proyectos Web de HATS
Dependiendo de cómo configure el proyecto de HATS, algunas o todas estas carpetas
aparecen en la vista Proyectos de HATS. También puede especificar qué carpetas aparecen en la vista Proyectos de HATS así como ocultar extensiones de archivos. Si desea obtener más
información, consulte Utilización de preferencias de HATS.
Nota:
aparecen carpetas diferentes para tipos diferentes de proyectos de HATS. Por ejemplo, el árbol de
directorios de un proyecto EJB de HATS no tendrá carpetas
Personalizaciones de pantalla, Capturas
de pantalla ni Contenido Web.
Puede crear subcarpetas dentro de estas carpetas de alto nivel para organizar
mejor el proyecto. Por ejemplo, cuando se crean capturas de pantalla para el
proyecto, se pueden crear carpetas en la carpeta Capturas
de pantalla y organizar y agrupar las pantallas capturadas. Para crear una
carpeta, pulse con el botón derecho del ratón en una de las carpetas de alto nivel en
el árbol y pulse Nuevo HATS > Carpeta. Para mover un
archivo a otra carpeta, pulse con el botón derecho del ratón en el archivo y
seleccione Mover, o también puede utilizar el método
de arrastrar y soltar.
Nota:
existe una limitación para las
subcarpetas. Los archivos de transformación y de plantilla deben estar en
subcarpetas del mismo nivel. Para poder utilizar una transformación que resida
en un determinado nivel de subcarpetas como, por ejemplo,
\transformations\Callup\, la plantilla que se empareje con
esta transformación deberán estar en el mismo nivel de subcarpetas, por ejemplo,
\templates\Callup\.
Los proyectos de HATS se pueden compartir en un entorno de equipo
accediendo a la vista Navegador de la
perspectiva de HATS. Pulse con el botón derecho del ratón en el proyecto y seleccione
Equipo > Compartir proyecto. Seleccione el tipo de
depósito de la lista y pulse Siguiente. Rational SDP da soporte a varios depósitos.
Si desea obtener más información, consulte la documentación de Rational SDP y
busque la palabra clave depósito.
Los proyectos Web de HATS, creados en HATS Toolkit,
son ampliaciones de los proyectos Web en el entorno de trabajo de Rational SDP. Para obtener
más información, pulse Ayuda > Contenido de la ayuda en la barra
de menús de Rational SDP, expanda Desarrollo y
seleccione Desarrollo de aplicaciones Web.
Organización de aplicaciones Web de HATS
Por omisión, todas las aplicaciones Web de HATS se almacenan en un
archivo Enterprise Archive (.ear), como HATS_EAR7. Cuando se exportan las aplicaciones y
se implementan en WebSphere Application Server, el archivo HATS.ear
contiene un archivo archivador Web (.war) con los recursos para ejecutar cada
aplicación, así como una copia del código ejecutable de la unidad ejecutable de
HATS. Si lo prefiere, puede
organizar las aplicaciones de forma diferente, cada una en su propio archivo .ear, o
en otro tipo de combinación.
Tenga en cuenta las siguientes consideraciones en el servidor
cuando decida cómo desea organizar las aplicaciones Web:
- Espacio de disco
- Si crea cada aplicación en su propio archivo .ear, tendrá su propia copia del
código de la unidad ejecutable de HATS. El código de la unidad ejecutable tiene aproximadamente 25 MB; multiplique este valor por el número de aplicaciones que
tiene para ver cuánto espacio de disco se consume en el sistema de la unidad ejecutable para todas las aplicaciones.
- Despliegue
- Si vuelve a desplegar un archivo .ear de HATS, se vuelven a desplegar todas las aplicaciones que haya en el archivo .ear, aunque algunas no hayan cambiado.
- Registro cronológico y rastreo
-
El registro cronológico y el rastreo están controlados a nivel del archivo
.ear, no a nivel de las aplicaciones de HATS individuales. Si cada aplicación de HATS está en su propio archivo .ear, puede controlar sus valores de registro cronológico y rastreo de manera independiente de las demás aplicaciones. Si tiene varias aplicaciones de HATS en un archivo .ear, los valores de registro cronológico y rastreo se aplicarán a todas las aplicaciones de HATS que haya en el archivo .ear. Los mensajes de todas las aplicaciones de HATS en el archivo .ear se insertan en el mismo archivo de anotaciones cronológicas, y la información de rastreo de todas las aplicaciones de HATS se inserta en el mismo archivo de rastreo.
Puede
añadir una palabra clave opcional adicional, traceLogDirectory, al archivo
runtime.properties. Esto le permite especificar un directorio concreto para los
archivos de salida. El archivo se halla en el directorio dir_was/installedApps/nombre_ear correspondiente a una aplicación de empresa de HATS.
- Seguimiento de licencias
- El seguimiento de licencias está controlado a nivel del archivo .ear, no a
nivel de las aplicaciones de HATS individuales. Si cada aplicación de HATS está
en su propio archivo .ear, el seguimiento de licencias se realiza de manera
independiente de las demás aplicaciones. Si tiene varias aplicaciones de HATS en
un archivo .ear, el seguimiento de licencias se realizará en todas las aplicaciones
de HATS que haya en el archivo .ear. En el archivo .ear se mantiene información
sobre el uso de licencias para todas las aplicaciones de HATS, y se inserta en el
mismo archivo de uso de licencia.
Traslado de proyectos Web de HATS a un archivo .ear diferente
El archivo .ear donde van los archivos del proyecto se determina cuando se
crea el proyecto. Después de crear el proyecto, puede trasladarlo de un archivo .ear a otro siguiendo los pasos siguientes:
Para añadir el proyecto a un archivo .ear:
- Pulse la pestaña Navegador de HATS Toolkit para
mostrar los archivos .ear.
- Expanda el archivo .ear al que desee añadir un proyecto. Expanda la carpeta
META-INF y busque el archivo application.xml.
- Inicie el editor de application.xml de Rational SDP efectuando una doble pulsación en el archivo application.xml.
- En la vista Diseño del editor application.xml, en el grupo
Visión general, seleccione Aplicación y pulse Añadir.
- En el diálogo Añadir elemento, seleccione Módulo y
pulse Aceptar.
- Seleccione el proyecto que desee añadir al archivo .ear y pulse Finalizar.
- Cierre el editor application.xml de Rational SDP.
Para eliminar el proyecto de un archivo .ear:
- Pulse la pestaña Navegador de HATS Toolkit para
mostrar los archivos .ear.
- Expanda el archivo .ear del que desee eliminar un proyecto. Expanda la carpeta
META-INF y busque el archivo application.xml.
- Inicie el editor de application.xml de Rational SDP efectuando una doble pulsación en el archivo application.xml.
- En la vista Diseño del editor application.xml, en el grupo
Visión general, seleccione el proyecto que desee eliminar del archivo .ear y pulse Eliminar.
- Cierre el editor application.xml de Rational SDP.
Copia de seguridad de proyectos de HATS
Como con cualquier actividad de desarrollo de software, es una buena costumbre efectuar copias de seguridad de los proyectos de HATS para evitar que los datos se pierdan o se vean dañados. Además de crear copias de seguridad durante su propio ciclo de desarrollo, también debe crear copias de seguridad antes de instalar el mantenimiento de HATS. Esto permite, si es necesario, revertir los proyectos al nivel de mantenimiento instalado anteriormente. Para crear una copia de seguridad del proyecto de HATS, utilice la función Exportar intercambio de proyectos de Rational SDP. Si desea obtener más información, consulte Exportación de un proyecto Web.
Para restaurar un proyecto de HATS a partir de una copia de seguridad,
utilice la función Importar intercambio de proyectos. Si desea obtener más información, consulte Importación de un proyecto Web.
Exportación e importación de proyectos Web de HATS
Exportación de un proyecto Web
Puede exportar los proyectos Web de HATS para guardarlos y utilizarlos como copias de seguridad o para trasladarlos a otro sistema HATS Toolkit. Para efectuar la exportación, siga el método siguiente:
Archivo de intercambio de proyectos
Esta función tiene varias ventajas. Le permite exportar simultáneamente varios proyectos y el archivo .ear
asociado. Además, no tiene que crear un proyecto en el HATS Toolkit de destino antes de importar el archivo de intercambio de proyectos. Para exportar el proyecto como archivo de intercambio de proyectos, realice los pasos siguientes:
- En la barra de menús, seleccione Archivo > Exportar para abrir el asistente Exportar.
- Seleccione Otro > Intercambio de proyectos y pulse Siguiente.
- Seleccione el proyecto y su proyecto EAR asociado.
- Especifique un nombre de archivo .zip y una ubicación para el archivo .zip
en el que guardar el proyecto.
- Pulse Finalizar.
Importación de un proyecto Web
Para importar un proyecto en un archivo de intercambio de proyectos en HATS Toolkit:
- En la barra de menús, pulse Archivo > Importar para abrir el asistente Importar.
- Seleccione Otro > Intercambio de proyectos y pulse Siguiente.
- Especifique el archivo .zip que desea importar en el campo Del archivo zip.
- Especifique el espacio de trabajo en el que desea importar el archivo en el campo Raíz de ubicación de proyecto.
- Seleccione los proyectos del archivo de intercambio de proyectos que desea importar en el espacio de trabajo especificado.
- Pulse Finalizar.
Si desea obtener información sobre cómo
migrar un proyecto de HATS desde un release anterior de HATS, consulte
Migración de HATS.
Despliegue de aplicaciones Web de HATS
Los términos aplicación Web de HATS, aplicación WebSphere y aplicación Java™ EE pueden utilizarse indistintamente para hacer referencia a una aplicación Web creada a partir de un proyecto de HATS. Es una aplicación Web de HATS porque se ha desarrollado en HATS Toolkit. Es una aplicación de WebSphere porque se instalará y ejecutará en WebSphere Application Server. Se trata de una aplicación Java
EE porque cumple con los estándares de Java
EE.
Para desplegar la aplicación Web de HATS en un entorno de ejecución debe:
- Habilitar el tiempo de ejecución de HATS.
- Exportar el proyecto como una aplicación Java EE.
- Instalar la aplicación en un entorno de ejecución.
- Realizar los cambios necesarios en el entorno de ejecución.
En los siguientes apartados se describe cómo realizar cada una de estas
tareas.
Habilitar el tiempo de ejecución de HATS
Independientemente de dónde obtenga el paquete HATS (HATS
CD, Web, o contenido en otro producto), se instala misma versión del HATS Toolkit. Es una versión con uso limitado que puede utilizar para evaluar HATS. Para habilitar completamente los tiempos de ejecución para producción según su prueba de licencia de propiedad, debe especificar los valores
de licencia mediante el asistente Valores de licencia que se incluye en HATS Toolkit. Si desea más información, consulte las secciones, Evaluación de HATS y Habilitación de tiempo de ejecución de HATS y valores de licencia,
en Guía de iniciación de HATS.
Exportación del proyecto como una aplicación Java EE
Para desplegar la aplicación Web de HATS en un entorno de ejecución de WebSphere Application Server, primero debe empaquetarla en una aplicación Java EE. Para ello, exporte el proyecto como archivo EAR.
Para exportar el proyecto, siga estos pasos:
- Resalte (con una pulsación) el nombre del proyecto en la vista Proyectos de HATS.
- Pulse el icono Exportar proyecto de HATS en la barra de herramientas principal o pulse con el botón derecho del ratón en el nombre del proyecto y seleccione Exportar proyecto.
- En la ventana Exportar, elija un proyecto de Enterprise Application en la lista desplegable o escriba el nombre de un proyecto de Enterprise Application en el campo Proyecto EAR.
- Especifique una ubicación de destino en el campo Destino o pulse el botón Examinar para seleccionar el destino del archivo .ear exportado.
- Si desea exportar los archivos fuente del proyecto junto con los archivos ejecutables, seleccione el recuadro Exportar archivos fuente. Si incluye los archivos fuente, otro desarrollador puede extraerlos del archivo .ear. Esto puede facilitar la colaboración o el servicio, pero debe decidir si puede crear un riesgo de seguridad.
- Si ha exportado este proyecto a esta ubicación anteriormente, el proceso de exportación solicita si desea sobrescribir los archivos existentes. Así se pretende proteger la sobrescritura de archivos que podría querer conservar, o quizás archivar una versión anterior del proyecto. Si desea sobrescribir archivos anteriores sin que se le solicite confirmación, seleccione el recuadro Grabar encima de archivos existentes.
- Pulse Finalizar. El proyecto se exporta como una aplicación Java EE, representada por un archivo Enterprise Archive con la extensión .ear, con el directorio y nombre de archivo especificados.
Instalación de la aplicación en un entorno de ejecución
Después de exportar el proyecto de HATS como una aplicación Java
EE y transferir el archivo .ear de la aplicación al sistema
de producción, instálelo, para ello inicie la consola administrativa de WebSphere y busque la ubicación del archivo .ear. Si desea obtener más información sobre la instalación de aplicaciones en WebSphere Application Server, consulte la biblioteca de WebSphere Application Server en http://www.ibm.com/software/webservers/appserv/was/library/ y seleccione el enlace al centro de información correspondiente a su versión de WebSphere Application Server. En el contenido existente bajo el producto WebSphere Application Server, consulte el capítulo referente al despliegue de aplicaciones.
Después de instalar la aplicación, pruébela accediendo al URL en un navegador Web de otro sistema. A continuación, puede publicar el URL para los usuarios. Por ejemplo, el URL podría parecerse a http://nombresisprinc//nombreaplhats/ donde nombresisprinc es el nombre de sistema principal IP en el que está instalado WebSphere Application Server y nombreaplhats es el nombre de la aplicación de HATS.
Notas:
- Si desea obtener más información sobre la instalación de aplicaciones de HATS en plataformas específicas, consulte el centro de información de HATS en http://publib.boulder.ibm.com/infocenter/hatshelp/v75/index.jsp.
- Si las aplicaciones de HATS se despliegan en WebSphere Application
Server con la seguridad de Java 2 habilitada, pero no se inician, consulte Seguridad de Java 2 para obtener más información.
- HATS da soporte a varias instancias de navegador de la misma estación de trabajo que acceden a la misma aplicación de HATS. Sin embargo, estas diversas instancias de navegador no deben compartir el mismo ID de sesión HTTP.
Se asigna un ID de sesión HTTP a la sesión que hay entre el navegador que accede a
la aplicación HATS y el servidor de la aplicación de WebSphere. El ID de sesión HTTP permite
que peticiones posteriores desde el mismo navegador vuelvan a la misma aplicación HATS. Las peticiones posteriores utilizan la misma sesión Telnet (3270 o 5250)
que existe entre la aplicación HATS en el servidor y el sistema principal.
Los navegadores distintos realizan el ID de sesión HTTP
de modo distinto. Microsoft® Internet
Explorer espera que todas sesiones del mismo proceso compartan el mismo ID de sesión HTTP. Cuando se inicia una ventan de navegador nueva utilizando
el mismo atajo, se inicia una sesión nueva de navegador y comparte el mismo proceso y el mismo ID de sesión HTTP.
Un modo de abrir un proceso nuevo de Internet Explorer con un ID de
sesión HTTP exclusivo, por ejemplo en Windows® XP,
si Internet Explorer está en su lista de inicio, es seleccione Inicio > Internet Explorer. Seleccionar Inicio > Todos los programas > Internet Explorer también
inicia un proceso nuevo de Internet Explorer con un ID de sesión HTTP exclusivo.
Notas:
- La función Ctrl-N de Internet Explorer no inicia un proceso nuevo porque
abre una ventana nueva que tiene el mismo ID de proceso y el mismo ID de sesión
HTTP que la ventana desde la que se originó.
- Para Internet Explorer 8, puede utilizar Archivo > Sesión nueva para abrir un navegador nuevo
con un ID de sesión exclusivo.
Nota:
En
Internet Explorer, puede encontrar el ID de sesióne HTTP para una ventana de navegador
seleccionando Ver > Código fuente en la barra de menús,
o pulsando con el botón derecho del ratón en la ventana del navegador Internet Explorer
y seleccionando Ver código fuente para ver el código fuente de la página. Avance hasta el código de formulario de HATS en la ventana fuente, que es similar a esto:
<FORM NAME="HATSform" dir="" METHOD="POST"
ACTION="/YourHATSAppName/entry">.
Dentro de ese código de formulario, encuentre el parámetro SESSIONID, que es similar a esto:
<INPUT TYPE="HIDDEN" NAME="SESSIONID"
VALUE="PIOncS1GehNWxWo_49VCBzC" />
Nota:
Cuando accede a una aplicación HATS que sólo muestra una
transformación por omisión de la pantalla y no ejecuta macros cuando
se inicia, el SESSIONID tiene un valor de "INVALID." El valor de SESSIONID
se asigna cuando envía algo al sistema principal, por ejemplo pulsar la tecla
Intro, y obtiene una respuesta.
Puede verificar
si un proceso nuevo se está iniciando utilizando el Gestor de tareas en Windows. Inicie el Gestor de tareas
y pulse la cabecera de la columna 'Nombre de imagen' de la pestaña Procesos para ordenar la información por nombre de imagen. Avance hacia abajo para ver cuántos procesos 'iexplore.exe' hay en la lista. Intente iniciar algunas ventanas nuevas de Internet Explorer
utilizando el atajo Inicio > Internet Explorer.
Si se inicia un proceso nuevo, se añade un proceso iexplore.exe nuevo a la visualización. De lo contrario, un proceso existente controla la ventana de navegador nueva.
- HATS requiere que display-name de la aplicación, como está
definido en el archivo web.xml de la aplicación, coincida con la
vía de acceso de contexto de la aplicación Web utilizada en el URL del navegador. Si cambia el valor de display-name de modo que es distinto de la vía de acceso de contexto
de la aplicación, quizá se encuentre con un error java.lang.nullPointerException
o un error javax.servlet.ServletException al ejecutar la aplicación de HATS.
Por ejemplo, un proyecto de HATS denominado MyHatsProject toma por omisión un display-name
de MyHatsProject. Se debe acceder a este proyecto, cuando se despliega como una aplicación Web,
con un URL similar a http://myServer/MyHatsProject/ para que opere correctamente.
Si se cambia el display-name por algún otro nombre distinto de MyHatsProject la
aplicación se vuelve inoperable.
Cambios necesarios en el entorno de ejecución
Configuración de la política de cargador de clases
Si despliega las aplicaciones Web de HATS, o bien si ejecuta las aplicaciones
en el entorno de prueba local, deberá configurar la política de cargador de clases WAR
para cada aplicación Java EE para una de las situaciones siguientes:
- La aplicación incluye la lógica empresarial. La lógica empresarial podría provocar una excepción ClassNotFoundException.
- La aplicación incluye componentes personalizados o aparatos personalizados. Los componentes o aparatos podrían provocar una excepción ClassNotFoundException.
HATS configura automáticamente la política de cargador de clases para estas aplicaciones.
Configuración de aplicaciones de HATS en un entorno en clúster
Si despliega aplicaciones Web de HATS en un entorno en clúster vertical,
cada instancia de servidor de aplicaciones creará sus propios archivos para el
registro cronológico, el rastreo y el seguimiento de licencias.
Esto se consigue complementando los nombres de los archivos de salida con el nombre
plenamente cualificado de la instancia del servidor de
aplicaciones. Por ejemplo, el patrón por omisión del
archivo de anotaciones cronológicas es messages.txt, pero el nombre de archivo real
será parecido al siguiente:
messages_miCélula_miNodo_miInstanciaServidorAplicaciones_1.txt.
Por omisión, todas las instancias de servidor leen el mismo archivo
runtime.properties para sus valores. Para controlar correctamente
los valores de tiempo de ejecución debe configurar cada una de las instancias
para que tengan su propio archivo de propiedades de tiempo de ejecución. De esta forma puede controlar el rastreo de cada instancia de manera independiente,
y se evita que los valores de la unidad ejecutable cambien espontáneamente.
Siga estos pasos para configurar cada una de las instancias de aplicación de HATS en
clúster vertical para que tenga su propio archivo runtime.properties:
- Haga una copia del archivo runtime.properties de cada instancia de servidor de
aplicaciones en el clúster vertical.
- Busque el archivo runtime.properties de la aplicación de HATS. Este archivo
reside en el directorio installedApps\nombre_aplic.ear, en
el directorio donde haya instalado WebSphere Application Server.
- Para cada una de las instancias, haga una copia del archivo runtime.properties, con un
nombre exclusivo, en el mismo directorio. Por ejemplo, podría llamar a los archivos
Clone1runtime.properties, Clone2runtime.properties, etc. Puede utilizar cualquier
nombre de archivo válido, pero el nombre debe servir de ayuda al administrador para
identificar la instancia del servidor de aplicaciones con la que se asocia este
archivo.
- En este punto, para n instancias de servidor, tiene n archivos de propiedades
de unidad ejecutable exclusivos.
- Si tiene más de un archivo .ear de HATS en el entorno en clúster vertical,
repita este paso en cada directorio de archivos .ear.
- Añada un nuevo valor de configuración para identificar el archivo runtime.properties que
utiliza cada una de las instancias. Por ejemplo, para WebSphere
Application Server V6.x:
- Seleccione Servidores de aplicaciones en el elemento Servidores del
panel de navegación izquierdo de la consola administrativa de WebSphere Application Server.
- Seleccione la instancia de servidor en la lista de servidores de aplicaciones.
- Seleccione Java y gestión de procesos en la pestaña Configuración del servidor.
- Seleccione Definición de proceso > Máquina virtual Java > Propiedades personalizadas.
- En el diálogo Propiedades personalizadas, pulse Nueva.
- En el campo Nombre, entre hats.runtime.properties.
- En el campo Valor, entre el
nombre del archivo de propiedades que ha creado para este servidor, por ejemplo,
Clone2runtime.properties.
No especifique nombres de directorio ni barras invertidas
en este valor.
- El campo Descripción no es
obligatorio.
- Pulse Aplicar.
- Repita este procedimiento para cada instancia de servidor.
Después de añadir la nueva propiedad personalizada y comprobar que cada instancia de servidor tiene su propia copia del archivo runtime.properties, con un nombre exclusivo, debe reiniciar cada aplicación para empezar a utilizar los archivos nuevos.
La consola administrativa de HATS puede controlar los valores de los miembros del
clúster. Utilice la carpeta Guía de iniciación en el
panel de navegación de la página Web de administración para seleccionar el
Ámbito de gestión. Después de seleccionar el clúster,
si elige ver los Valores de rastreo, deberá indicar
el miembro concreto del clúster que desea controlar.
Nota:
existen consideraciones especiales para el uso de clústeres y listas de usuarios. Si desea obtener más información, consulte
Clústeres y listas de usuarios.
Desarrollo de aplicaciones de HATS para dispositivos móviles
Puede desarrollar aplicaciones Web de HATS a las que pueda accederse mediante dispositivos móviles,
como teléfonos móviles, terminales de recopilación de datos y asistentes digitales personales
(PDA). El proceso es el mismo que para desarrollar cualquier aplicación Web de HATS con
algunas salvedades debido a las capacidades del dispositivo móvil y su navegador Web, por
ejemplo limitaciones del tamaño de pantalla y de interacción.
Para crear un proyecto para la aplicación para dispositivos móviles, inicie el
asistente Crear un proyecto mediante una de las acciones siguientes:
- Seleccione HATS > Nuevo > Proyecto en la barra de menús.
- Seleccione Archivo > Nuevo > Proyecto de HATS en la barra de menús.
- Pulse el icono Crear proyecto de HATS en la barra de herramientas.
En el asistente Crear un proyecto, en el panel Proyecto de HATS:
- Escriba el nombre del proyecto de dispositivo móvil.
- De manera opcional, especifique una descripción.
- Acepte la ubicación por omisión.
- Seleccione Web para indicar que es un proyecto Web.
Nota:
si la opción Despliegue Web está inhabilitada, esto indica que
no se han definido Runtimes de servidor. Para definir Runtimes de servidor, vaya a Ventana > Preferencias > Servidor > Runtimes instalados y añada
al menos una definición de Runtime.
- Para el campo Servidor de destino, seleccione uno de los servidores WebSphere Application
Servers soportados.
- En el campo Proyecto de Enterprise Application, escriba el nombre del proyecto EAR
que se utilizará para probarlo en el entorno de prueba local.
- Seleccione Optimizar opciones para dispositivos móviles.
- Pulse Siguiente y continúe con la creación del proyecto de la forma habitual.
Consideraciones y limitaciones para dispositivos móviles
Cuando crea un proyecto de HATS y selecciona Optimizar
opciones para dispositivos móviles, HATS inicializa el proyecto con las opciones que
se adaptan mejor a los dispositivos móviles. Algunas opciones, por ejemplo, impresión,
teclado, actualización asíncrona, entre otras, no están soportadas y por lo tanto están
inhabilitadas.
Tenga en cuenta las siguientes consideraciones y limitaciones cuando desarrolle la
aplicación para dispositivos móviles.
- No hay una opción automatizada que le permita convertir un proyecto de HATS
que no esté optimizado para dispositivos móviles a uno que sí lo esté, o viceversa.
- La opción para especificar un tema de proyecto no se proporciona. En su lugar, las opciones
se inicializan automáticamente para funcionar mejor con los dispositivos móviles.
- Sólo se proporcionan las plantillas que están optimizadas para los dispositivos
móviles para utilizarlas en el proyecto.
Nota:
Si no desea tener desplazamiento horizontal con la plantilla Modern,
añada el estilo overflow: auto; a .roundedcornermodule en
el archivo de plantilla Modern.jsp. Por ejemplo, cambie .roundedcornermodule
{margin: 0px;} por .roundedcornermodule { margin: 0px; overflow:
auto; }. Esto fuerza que la página conserve su tamaño original y se mantenga
dentro de la pantalla visual en el dispositivo. Recuerde que en algunos casos, esto
podría producir que se truncaran los datos y, por lo tanto, en el diseño de páginas
personalizadas y en las opciones de aparato se debería tener en cuenta el tamaño de pantalla.
- En el proyecto, se crea un segundo conjunto de representación, denominado
compact. Este conjunto de representación está especificado
como el conjunto de representación por omisión. También tiene seleccionada la opción
Usar representación compacta que reduce la cantidad de
HTML y el espacio en blanco en la representación por omisión, lo que a la vez puede mostrar una
estructura diferente de la pantalla de sistema principal original.
- La preferencia de HATS, Incluir una tabla de diseño
libre, que tiene efecto cuando se crea una transformación en blanco, tiene un
modificador adicional, Excepto cuando el proyecto está
optimizado para dispositivos móviles. Este modificador está seleccionado por
omisión. Por tanto, las transformaciones en blanco que añada al proyecto móvil, por
omisión, no incluirán una tabla de diseño libre.
- Salida de campo, Campo+ y Campo- pueden utilizarse mediante la opción
Habilitar el posicionamiento del cursor en los campos de
entrada en combinación con los botones Área de teclado de sistema principal o
Tecla de sistema principal.
- El aparato Campo proporciona una opción de diseño Separado para representar la salida utilizando códigos
"inline span", en lugar de utilizar una tabla, para diferenciar los campos.
El objetivo de utilizar esta opción es reducir la cantidad de HTML y de espacio en blanco.
Este es el valor por omisión para los proyectos móviles.
- HATS proporciona soporte para Ubicación de las columnas
para los aparatos de subarchivo y de tabla. Esto es útil cuando se muestran datos de tabla en
un dispositivo móvil ya que permite la organización y exclusión de las columnas
en la pantalla, además de permitir utilizar secciones de detalles ampliables
para que la tabla pueda ajustarse en un espacio más pequeño.
La sección de detalles,
cuando se amplía, se muestra directamente por debajo de la fila que contiene las columnas
principales de datos.
Una vez que el usuario identifica una fila particular interesante, los detalles de esa fila,
cuando se amplía, se muestran en un formato que va hacia abajo de la pantalla
en lugar de hacia la derecha. Esto permite ver en pantallas pequeñas los detalles
necesarios de un número arbitrario de columnas, sin recurrir al desplazamiento horizontal.
Las figuras siguientes muestran un subarchivo tal como aparece en una pantalla
de sistema principal, seguido por la vista principal del subarchivo y una vista de detalles de éste
utilizando el soporte por omisión para Ubicación de columnas.
Figura 3. Subarchivo en una pantalla de sistema principal
Figura 4. Vista principal del subarchivo utilizando el soporte por omisión para Ubicación de columnas
Figura 5. Vista de detalles de una fila del subarchivo utilizando el soporte por omisión para Ubicación de columnas
Además de conservar el estado real de la pantalla, puede configurar el aparato
para mantener las columnas de detalle en el servidor hasta que se soliciten, en lugar de
enviarlas mediante HTTP al navegador de usuario. Esto permite una reducción, en algunos
casos, de la cantidad de datos transferidos porque los datos de detalle no deseados no se
envían nunca a través de HTTP al dispositivo final. Sólo los detalles que solicita específicamente el usuario se recuperan
bajo demanda y se envían al navegador.
Nota:
los subarchivos configurados
para utilizar el componente de campo para reconocer la parte de datos del subarchivo
no pueden utilizar de forma efectiva la capacidad de columnas principales y de detalle
debido a que esos subarchivos no pueden distinguir columnas, sólo filas.
Además de los valores Ubicación de las columnas
del aparato de subarchivo y de tabla descritos en Valores de aparatos, se pueden
utilizar los valores siguientes para personalizar más el aspecto de los controles
utilizados para esta opción. Estos valores no aparecen en la GUI de HATS Toolkit. En su lugar,
debe añadir estos valores al fuente del aparato. El fuente que aparece abajo muestra
ejemplos de estos valores utilizando el aparato Subarchivo como ejemplo.
<class name="com.ibm.hats.transform.widgets.SubfileWidgetV6">
<setting name="normalColumnLayout" value="1,2"/>
<setting name="extendedColumnLayout" value="3*"/>
<setting name="keepExpansionOnServer" value="true"/>
<setting name="expandHeaderValue" value="juan"/>
<setting name="expandRepresentation" value="button"/>
<setting name="expandValue" value="pulse aquí"/>
<setting name="collapseRepresentation" value="image"/>
<setting name="collapseValue" value="/common/images/twisty1.gif"/>
<setting name="collapseAltValue" value="ocultar"/>
</class>
- expandRepresentation
- Determina la representación gráfica utilizada para el control que muestra
los detalles. Especifique button, link o image. El valor por omisión es link.
- expandValue
- Si expandRepresentation es button o
link, este valor se utiliza como el texto que aparece en
el botón o en el enlace. Si no se suministra ningún valor, por omisión, se utiliza un
signo más (+). No se acepta un valor de serie vacía
"" y se toma por defecto un signo más (+).
Si expandRepresentation es image, este valor es la vía de
acceso y el nombre del archivo de imagen que debe utilizarse. La vía de acceso se busca partiendo del directorio Contenido Web
del proyecto. Por ejemplo, si desea especificar twisty1.gif
en el directorio Contenido Web/common/images, establezca expandValue como se indica abajo:
<setting name="expandValue" value="/common/images/twisty1.gif "/>
- expandAltValue
- Este valor proporciona texto alternativo para la imagen. Sólo se utiliza cuando
expandRepresentation se establece en
image y el navegador no puede mostrar la imagen especificada,
por ejemplo, la opción Menú > Ver > Mostrar imágenes de
Internet Explorer Mobile no está seleccionada.
- collapseRepresentation
- Determina la representación gráfica utilizada para el control que oculta
los detalles. Especifique button, link o image. El valor por omisión es link.
- collapseValue
- Si collapseRepresentation es button o
link, este valor se utiliza como el texto que aparece en
el botón o en el enlace. Si no se suministra ningún valor, por omisión, se utiliza un
signo menos (-). No se acepta un valor de serie
vacía "" y se toma por defecto un signo menos
(-).
Si collapseRepresentation es image, este valor es la vía de
acceso y el nombre del archivo de imagen que debe utilizarse. La vía de acceso se busca partiendo del directorio Contenido Web
del proyecto. Por ejemplo, si desea especificar twisty1.gif en el directorio Contenido
Web/common/images, establezca collapseValue como se indica abajo:
<setting name="collapseValue" value="/common/images/twisty1.gif "/>
- collapseAltValue
- Este valor proporciona texto alternativo para la imagen. Sólo se utiliza cuando
collapseRepresentation se establece en
image y el navegador no puede mostrar la imagen especificada,
por ejemplo, la opción Menú > Ver > Mostrar imágenes de
Internet Explorer Mobile no está seleccionada.
- expandHeaderValue
- Este valor proporciona el texto de cabecera de la columna para los controles de
detalle. Un valor especificado como "" crea una cabecera sin texto.
- expandStyle, expandClass, expandHeaderStyle, expandHeaderClass,
expandAreaStyle, expandAreaClass, expandRowStyle, expandRowClass, collapseStyle,
collapseClass, collapseAreaStyle, collapseAreaClass
- Se trata de alteraciones de clases y estilos para los controles de esta opción.
Si no se especifican, se aplican los valores estándar para los aparatos. Se pueden
utilizar los estilos HTML estándar y las clases se aplican en orden.
- El valor Habilitar el posicionamiento del cursor en los
campos de entrada, disponible para los aparatos utilizados para representar los
campos de entrada, proporciona a los usuarios un método para conmutar de la modalidad
de entrada de datos a la modalidad de posicionamiento del cursor para los campos de
entrada. Cuando se está en la modalidad de entrada de datos, el usuario pueden escribir
datos en el campo de entrada. Cuando se está en la modalidad de posicionamiento del
cursor, el usuario puede desplazarse con el tabulador o situar el cursor sobre cualquier
carácter del campo de entrada. Este valor es útil para los dispositivos que no tienen
otras capacidades de posicionamiento del cursor.
Además de los valores del aparato
Habilitar el posicionamiento del cursor en los
campos de entrada descritos en Valores de aparatos, se pueden utilizar los
valores siguientes para personalizar más el aspecto de los controles
utilizados para esta opción. Estos valores no aparecen en la GUI de HATS Toolkit. En su lugar,
debe añadir estos valores al fuente del aparato. El fuente que aparece abajo muestra
ejemplos de estos valores utilizando el aparato Campo como ejemplo.
<class name="com.ibm.hats.transform.widgets.FieldWidget">
<setting name="dataModeCEPRepresentation" value="button"/
<setting name="dataModeCEPValue" value="atrás"/>
<setting name="dataModeCEPAltValue" value="entrada de datos"/>
<setting name="cursorModeCEPRepresentation" value="image"/>
<setting name="cursorModeCEPValue" value="cursorOn.gif"/>
<setting name="cursorModeCEPAltValue" value="entrada del cursor"/>
<setting name="cursorCEPRepresentationStyle"
value="text-underline:true"/>
<setting name="useCursorExactPositioningOption" value="true"/>
</class>
- dataModeCEPRepresentation
- Determina la representación gráfica utilizada para el control mostrado junto al
campo de entrada cuando se está en modalidad de datos. Especifique button, link o image. El valor por omisión es link.
- dataModeCEPValue
- Si dataModeCEPRepresentation es button o
link, este valor se utiliza como el texto que aparece en
el botón o en el enlace. Si no se suministra ningún valor, por omisión, se utiliza un
carácter asterisco (*). No se acepta un valor de serie vacía ""
y se toma por defecto un carácter asterisco (*).
Si dataModeCEPRepresentation es image, este valor es la vía de
acceso y el nombre del archivo de imagen que debe utilizarse. La vía de acceso se busca partiendo del directorio Contenido Web
del proyecto. Por ejemplo, si desea especificar sbarleftblk.gif en el directorio
Contenido Web/common/images, establezca dataModeCEPValue como se indica abajo:
<setting name="dataModeCEPValue"
value="common/images/sbarleftblk.gif"/>
- dataModeCEPAltValue
- Este valor proporciona texto alternativo para la imagen. Sólo se utiliza cuando
dataModeCEPRepresentation se establece en image
y el navegador no puede mostrar la imagen especificada,
por ejemplo, la opción Menú > Ver > Mostrar imágenes de
Internet Explorer Mobile no está seleccionada.
- dataModeIconClass, dataModeIconStyle
- Se trata de alteraciones de clases y estilos para el icono de representación de la
modalidad de datos. Si no se especifican, se aplican los valores estándar para los aparatos. Se pueden
utilizar los estilos HTML estándar y las clases se aplican en orden.
- cursorModeCEPRepresentation
- Determina la representación gráfica utilizada para el control mostrado junto al
campo de entrada cuando se está en modalidad de cursor. Especifique button, link o image. El valor por omisión es link.
- cursorModeCEPValue
- Si cursorModeCEPRepresentation es button o
link, este valor se utiliza como el texto que aparece en
el botón o en el enlace. Si no se suministra ningún valor, por omisión, se utiliza un
carácter asterisco (*). No se acepta un valor de serie vacía ""
y se toma por defecto un carácter asterisco (*).
Si cursorModeCEPRepresentation es image, este valor es la vía de
acceso y el nombre del archivo de imagen que debe utilizarse. La vía de acceso se busca partiendo del directorio Contenido Web
del proyecto. Por ejemplo, si desea especificar sbarrightblk.gif en el directorio Contenido
Web/common/images, establezca cursorModeCEPValue como se indica abajo:
<setting name="cursorModeCEPValue"
value="common/images/sbarrightblk.gif "/>
- cursorModeCEPAltValue
- Este valor proporciona texto alternativo para la imagen. Sólo se utiliza cuando
cursorModeCEPRepresentation se establece en
image y el navegador no puede mostrar la imagen especificada,
por ejemplo, la opción Menú > Ver > Mostrar imágenes de
Internet Explorer Mobile no está seleccionada.
- cursorCEPRepresentationStyle
- Este estilo se utiliza para resaltar la posición del cursor seleccionada actualmente.
El valor por omisión es border-bottom: 1px solid green;,
pero es válida una serie vacía "".
- cursorModeCEPStyle
- Es el estilo utilizado alrededor del campo de entrada mientras se está en modalidad
de cursor.
El estilo por omisión es border: 1px solid #999999;
height: 1.75em;. No se recomienda cambiarlo salvo que sea necesario.
- cursorCEPRepresentationClass, cursorModeIconClass, cursorModeIconStyle,
cursorModeCEPClass, cursorModeCEPTextStyle, cursorModeCEPTextClass
- Se trata de alteraciones de clases y estilos para decorar los elementos en el área
de modalidad del cursor. Si no se especifican, se aplican los valores estándar para los aparatos. Se pueden
utilizar los estilos HTML estándar y las clases se aplican en orden.
- dataModeIconClass, dataModeIconStyle
- Se trata de alteraciones de clases y estilos para decorar los elementos en el área
de modalidad de datos. Si no se especifican, se aplican los valores estándar para los aparatos. Se pueden
utilizar los estilos HTML estándar y las clases se aplican en orden.
- Hay algunas instancias durante una conexión inalámbrica donde la conexión
al direccionador o servidor HTTP se pierde. Si sucede esto, puede que la página Web
se bloquee y que HATS no pueda reenviar ninguna información Están disponibles
los valores siguientes para resolver este problema. Los valores están disponibles
en la clase RuntimeSettings de la vista fuente Valores del proyecto (el archivo application.hap).
- usePageUID
- Especifica si se habilita la colocación de un pageUID en la pantalla. Esto
permite al ejecutable realizar un seguimiento de la página para ver si ya se
ha enviado. Si este valor es false, no se lee el valor de pageSubmitTimeout. El valor
por omisión es false.
- pageSubmitTimeout
- Especifica cuánto tiempo se debe esperar, en milisegundos, antes de desbloquear
la página Web para que la utilice el usuario. Un valor de -1, o vacío, da como resultado que esta función
esté inactiva. El valor por omisión es -1.
- incorrectPageUIDEvent
- Especifica lo que se debe hacer cuando el
PageUID en la solicitud HTTP de la página Web del usuario no coincida con el
PageUID almacenado en la unidad ejecutable para ese sessionid e instancia de aplicación. Tiene
2 opciones: REFRESHCOMMAND o ERROREVENT. El valor por omisión es REFRESHCOMMAND.
En el código fuente siguiente se muestran ejemplos de estos valores.
<class name="com.ibm.hats.common.RuntimeSettings">
<setting name="autoEraseFields" value="true"/>
<setting name="enableAutoAdvance" value="false"/>
<setting name="enableAutoTabOn" value="false"/>
<setting name="enableBusyPage" value="false"/>
<setting name="enableCompression" value="false"/>
<setting name="enableOverwriteMode" value="false"/>
<setting name="incorrectPageUIDEvent" value="REFRESHCOMMAND"/>
<setting name="pageSubmitTimeout" value="1000"/>
<setting name="selectAllOnFocus" value="false"/>
<setting name="suppressUnchangedData" value="false"/>
<setting name="usePageUID" value="true"/>
</class>
- El sondeo de AJAX desde un navegador que se ejecuta en un dispositivo iPhone o iPod touch
se detiene cuando cambia del navegador a otra aplicación.
A raíz de esto, cuando cambia de un navegador que accede a HATS a otra
aplicación en el dispositivo, HATS desconecta la sesión de navegador después de
que ha pasado el intervalo de Tiempo de espera para desconectar (segundos).
Quizá desee aumentar este intervalo o inhabilitar la función
desconexión automática de las aplicaciones HATS a las que se accede desde
los dispositivos iPhone o iPod touch. Si desea obtener más información, consulte Utilización del método 'Client pull' (AJAX).
- Para consideraciones sobre DBCS, consulte Trabajo con aplicaciones de dispositivos móviles.
Además de las opciones que HATS inhabilita automáticamente, las funciones siguientes
no están soportadas y no deberían implementarse en las aplicaciones de HATS
para dispositivos móviles:
- Los proyectos Web de HATS no se pueden migrar o convertirse automáticamente
en proyectos Web de HATS para los dispositivos móviles.
- Aplicaciones de Cliente enriquecido.
- Aplicaciones de portal (Estándar o IBM®).
- Interoperatividad con WebFacing.
- Soporte de idioma bidireccional.
- Características de accesibilidad.
- Cualquier dispositivo con tamaños de pantalla inferiores a 320x240.
- Soporte de teclado para teclas de sistema principal.
Como resultado, si se utiliza un
teclado, éste funciona como un teclado Web normal, las teclas de sistema principal no se
envían, en lugar de esto la tecla F1 muestra la ayuda del navegador y la tecla Intro no
está correlacionada con la tecla Intro de sistema principal.
Además, si el soporte de teclado,
HATS JavaScript™ no puede determinar si el usuario ha introducido datos en la página Web de HATS. Como resultado, el soporte de renovación automática
sobrescribe cualquier dato que el usuario haya introducido en la vista GUI de la aplicación de HATS si se recibe una pantalla de sistema principal
nuevo de forma asíncrona desde la aplicación del sistema principal.
- Ayuda específica de campo, justificación derecha, capitalizaciones u otros atributos.
- Cualquier otra limitación de entrada de datos inherente al hardware o el software del dispositivo.
- Acceso a la página de la consola administrativa de HATS mediante un dispositivo móvil.
- El parámetro de conexión disconnectOnClose.
- Combinaciones de pantallas.
- Soporte de carpeta con pestañas.
- Soporte de hoja de cálculo.