Desarrollo y despliegue de aplicaciones de cliente enriquecido de HATS

HATS ofrece la posibilidad de transformar el acceso a las aplicaciones de sistema principal existentes utilizando aplicaciones GUI de cliente enriquecido que se ejecutan en el entorno de la plataforma de cliente enriquecido de Eclipse (Eclipse RCP) o los entornos de Lotus Notes o de Lotus Expeditor Client.

Eclipse RCP es un subconjunto de plug-ins proporcionado por la plataforma Eclipse, más conocido como plataforma de herramientas de código abierto. La introducción de Eclipse RCP permite utilizar la funcionalidad básica proporcionada por Eclipse para crear aplicaciones cliente nativas destinadas a un escritorio de usuario. Puede encontrar más información sobre Eclipse RCP en http://www.eclipse.org/home/categories/rcp.php.

Lotus Notes es un software potente y con numerosas opciones que le proporciona acceso instantáneo a toda la información importante para usted. Puede utilizar Lotus Notes para enviar y recibir correo electrónico, citas programadas, navegar por Internet, participar en grupos de noticias en Internet y beneficiarse de la página de inicio para realizar un rastreo de toda su información importante. Si desea obtener más información, consulte el centro de información de Lotus Notes en http://publib.boulder.ibm.com/infocenter/domhelp/v8r0/index.jsp.

Lotus Expeditor Client proporciona un entorno de ejecución de cliente enriquecido y componentes de middleware integrados para ampliar las distintas aplicaciones de empresa a sistemas de escritorio y portátiles gestionados por servidor. Para obtener más información acerca de cómo desarrollar y desplegar aplicaciones para Lotus Expeditor Client, consulte el centro de información de Lotus en http://publib.boulder.ibm.com/infocenter/ledoc/v6r2/index.jsp.

Nota:

A menos que se indique lo contrario, las instrucciones incluidas en este documento se aplican al desarrollo y despliegue de aplicaciones de cliente enriquecido en entornos Eclipse RCP V3.4, Lotus Notes V8.5.1 y Lotus Expeditor Client V6.2. Para obtener instrucciones aplicables a las versiones anteriores de Eclipse RCP y Lotus Expeditor Client, consulte las versiones anteriores de los centros de información adecuados.

Un entorno de cliente enriquecido ofrece posibilidades que no están disponibles en un entorno Web tradicional, por ejemplo:

Si desea obtener más información y ayuda para desarrollar aplicaciones de cliente enriquecido, consulte el contenido de la ayuda de Rational SDP. Seleccione Ayuda > Contenido de la ayuda en la barra de menús y busque cliente enriquecido.

Cuando se crean aplicaciones de cliente enriquecido, las diferencias entre entornos Eclipse RCP, Lotus Notes y Lotus Expeditor Client son mínimas. En este capítulo se describen las diferencias.

La principal diferencia de arquitectura entre una aplicación de cliente enriquecido de HATS y una aplicación Web de HATS es dónde se inicia la conexión de socket Telnet. Con una aplicación de cliente enriquecido, la conexión de socket se inicia desde una estación de trabajo del usuario, no desde WebSphere Application Server, como ocurre con una aplicación Web de HATS tradicional. Como las aplicaciones de cliente enriquecido necesitarán un cliente en la estación de trabajo de un usuario, estas aplicaciones están destinadas principalmente a los usuarios internos, que están acostumbrados a utilizar un emulador de terminal de cliente pesado tradicional.

Desarrollo de aplicaciones de cliente enriquecido de HATS

Los pasos para crear y probar una aplicación de cliente enriquecido de HATS son básicamente los mismos que para una aplicación Web de HATS. Utilice HATS Toolkit con las herramientas proporcionadas en la perspectiva de HATS para desarrollar un proyecto de cliente enriquecido de HATS desde el que se genera una aplicación de cliente enriquecido de HATS. Se proporcionan los mismos asistentes, editores y vistas para dar soporte a las distintas actividades necesarias durante el desarrollo. Para crear aplicaciones destinadas a Lotus Notes o Lotus Expeditor Client, Lotus Expeditor Toolkit debe estar instalado y puede utilizarse como ayuda.

Al igual que en HATS para el entorno Web, desarrolle el aspecto y el funcionamiento de la aplicación, incluida la personalización de los valores de representación, la navegación de pantalla (mediante macros de salto de pantalla) y los fonts y colores utilizados para representar pantallas.

La mayoría de características disponibles en una aplicación Web de HATS también están disponibles en una aplicación de cliente enriquecido de HATS. Por ejemplo, entre otras:

Las características disponibles en las aplicaciones Web de HATS que no están disponibles en las aplicaciones de cliente enriquecido de HATS incluyen:

Un proyecto de cliente enriquecido de HATS es un proyecto de plug-in de Eclipse. Como proyecto, existe en un espacio de trabajo y está desarrollado por un desarrollador de aplicaciones de HATS. Una vez desarrollado y probado, el proyecto se exporta como una aplicación de cliente enriquecido de HATS, que es un plug-in de Eclipse que se puede instalar en un entorno Eclipse. Un plug-in de Eclipse es un componente que proporciona un determinado tipo de servicio en el contexto de un entorno Eclipse. En el caso de HATS, el plug-in proporciona el servicio necesario para transformar una aplicación de sistema principal.

Cada plug-in de aplicación de cliente enriquecido de HATS depende de varios plug-ins de tiempo de ejecución. Se hace referencia a las dependencias en el archivo de manifiesto del proyecto de cliente enriquecido, MANIFEST.MF. Asegúrese de que los plug-ins necesarios se incluyan en el entorno de prueba local y en el entorno de producción desplegado para que el plug-in de cliente enriquecido de HATS se ejecute correctamente. Si desea obtener más información, consulte Proyecto de extensión del tiempo de ejecución RCP de HATS, Prueba de aplicaciones de cliente enriquecido de HATS y Despliegue de aplicaciones de cliente enriquecido de HATS.

Especificaciones de la plataforma de destino

Contenido del proyecto

Cuando se crea un proyecto de cliente enriquecido de HATS, debe seleccionar una plataforma de destino. Esta selección indica dónde tiene previsto desplegar la aplicación. Las diferencias entre un proyecto destinado al despliegue en Eclipse RCP y Lotus Notes o Lotus Expeditor Client son mínimas. Las siguientes características son comunes para todo proyecto de cliente enriquecido de HATS:

Adición para los proyectos destinados al despliegue en Eclipse RCP:

Adiciones para los proyectos destinados al despliegue en Lotus Notes y Lotus Expeditor Client:

Establecimiento del nivel de conformidad de compilador

El JRE (Java Runtime Environment) del espacio de trabajo de Rational SDP y el entorno de ejecución que va a utilizar deben ser iguales. Por ejemplo, si desarrolla un plug-in de cliente enriquecido de HATS para que funcione en un entorno Eclipse que ejecuta Java Runtime Environment (JRE) 1.6, debe establecer el nivel de conformidad de compilador del espacio de trabajo en 1.6. Para ello, en la barra de menús de Rational SDP, seleccione Ventana > Preferencias > Java > Compilador y establezca el Nivel de conformidad de compilador en 1.6.

Si tiene otros proyectos de plug-in o Java en el espacio de trabajo que necesitan otros niveles de conformidad, puede establecer el nivel de conformidad de compilador para proyectos de plug-in o Java individuales. Para ello, pulse con el botón derecho del ratón en el proyecto y seleccione Propiedades. En el panel Propiedades, seleccione Compilador Java a la izquierda. A continuación, seleccione el recuadro Habilitar valores específicos de proyecto y establezca el Nivel de conformidad de compilador en el nivel correspondiente.

Nota:
el proyecto de Extensión de HATS RCP Runtime, com.ibm.hats.rcp.runtime.extension, debe tener el mismo nivel de conformidad de compilador que el proyecto de cliente enriquecido de HATS. Consulte la Proyecto de extensión del tiempo de ejecución RCP de HATS.

Proyecto de extensión del tiempo de ejecución RCP de HATS

Cuando se crea un proyecto de cliente enriquecido de HATS, se crea automáticamente un proyecto para el plug-in de Extensión de HATS RCP Runtime (de aquí en adelante denominado plug-in de extensión de tiempo de ejecución), si no existe previamente uno en el espacio de trabajo. El plug-in de extensión de tiempo de ejecución tiene un nombre, el ID de plug-in com.ibm.hats.rcp.runtime.extension y una versión inicial 1.0.0.

El plug-in de extensión de tiempo de ejecución es una extensión del plug-in de HATS RCP Runtime (com.ibm.hats.rcp.runtime). El plug-in HATS RCP Runtime contiene las clases de tiempo de ejecución de HATS y debe estar en el entorno para que funcionen las aplicaciones de cliente enriquecido de HATS. El plug-in de extensión de tiempo de ejecución ofrece la posibilidad de configurar los valores relacionados con el entorno de ejecución.

Este proyecto de plug-in contiene los siguientes artefactos configurables:

Este proyecto es parecido a un proyecto EAR de HATS en el entorno Web, pero sólo hay uno de estos plug-ins por entorno de ejecución. Esto es, sólo hay un plug-in de extensión de tiempo de ejecución ejecutándose en el entorno del usuario. Cada archivo plugin.xml del proyecto de cliente enriquecido de HATS declara una dependencia de este plug-in. El plug-in de extensión de tiempo de ejecución no hace referencia a los plug-ins de aplicación de HATS individuales.

Como sólo se puede ejecutar una copia del plug-in de extensión de tiempo de ejecución en el entorno de ejecución, debe asegurarse de que exista sólo una copia del plug-in en el entorno de un usuario. Si hay más de un plug-in de extensión de tiempo de ejecución en el entorno, el entorno utilizará el plug-in con el número de versión más alto. Esto garantiza siempre la utilización del código más reciente.

El proyecto de extensión de tiempo de ejecución no está visible en la vista Proyectos de HATS, pero sí en la vista Navegador. Se incluye como parte del proyecto de característica generado durante la exportación. Si desea obtener más información, consulte Despliegue de aplicaciones de cliente enriquecido de HATS.

Nota:
este proyecto no se suprime cuando se suprime el último proyecto de cliente enriquecido de HATS. Debe suprimirlo manualmente si desea crear un nuevo proyecto de extensión de tiempo de ejecución.

Trabajo con proyectos de cliente enriquecido de HATS

De la misma manera que con un proyecto Web de HATS, cuando se crea un nuevo proyecto de HATS cliente enriquecido, se crea un conjunto de carpetas para organizar mejor los archivos 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 6. Vista de proyectos de cliente enriquecido de HATS
Vista de proyectos de cliente enriquecido de HATS

Dependiendo de cómo configure el proyecto, 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.

Notas:
  1. Un proyecto de cliente enriquecido muestra una carpeta Contenido de cliente enriquecido, donde un proyecto Web muestra una carpeta Contenido Web.
  2. La carpeta Contenido de cliente enriquecido aparece en el nivel raíz del proyecto de cliente enriquecido. No obstante, no hay ninguna carpeta Contenido de cliente enriquecido real en el proyecto. Sólo se muestra una dinámicamente para mantener la coherencia con la carpeta Contenido Web que aparece para los proyectos Web.
  3. Algunas de las carpetas mostradas en la carpeta Contenido de cliente enriquecido que aparece dinámicamente también se muestran en la carpeta Fuente.
  4. Los decoradores de etiquetas de las carpetas de cliente enriquecido que aparecen de forma dinámica puede que no decoren correctamente, ya que las carpetas no se correlacionan con carpetas físicas en el proyecto.

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.

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.

Copia de recursos entre proyectos Web y proyectos de cliente enriquecido

Puede copiar, pegar, suprimir, mover y renombrar recursos de cliente enriquecido utilizando el menú emergente de la vista Proyectos de HATS. Los siguientes recursos se pueden copiar o mover entre proyectos Web de HATS y proyectos de cliente enriquecido de HATS:

Nota:
no puede copiar transformaciones, fragmentos de transformaciones ni plantillas entre proyectos Web de HATS y proyectos de cliente enriquecido de HATS.

Algunos recursos copiados de proyectos de distintos tipos necesitarán modificaciones. Por ejemplo, una macro copiada de un proyecto Web de HATS en un proyecto de cliente enriquecido de HATS deberá actualizarse para hacer referencia a un manejador de macros Java SWT válido (para los proyectos Web de HATS, las macros hacen referencia a un manejador de macros JSP). Las personalizaciones de pantalla también deberán actualizarse, debido a las referencias a las transformaciones JSP especificadas en la acción aplicar y a los URL especificados en la acción reenviar. Aparecerá un mensaje de aviso en la vista Problemas para ayudarle a encontrar y solucionar estos problemas. Se etiquetarán los siguientes casos de ejemplo:

No existe ninguna función incorporada para migrar una aplicación Web de HATS a una aplicación RCP de HATS. Algunos artefactos como, por ejemplo, las personalizaciones de pantalla, las macros, las conexiones, las capturas de pantalla, las imágenes, los archivos de origen de lógica empresarial y los archivos de origen de componente personalizado se pueden migrar manualmente, con cambios mínimos, de un tipo de proyecto a otro. Otros artefactos como, por ejemplo, las transformaciones, los aparatos personalizados, las plantillas y los manejadores de macro personalizados requieren cambios más amplios para funcionar en un proyecto de otro tipo.

Exportación e importación de proyectos de cliente enriquecido de HATS

Para mover un proyecto de cliente enriquecido de HATS a otro sistema con Rational SDP instalado, o para guardar y restaurar un proyecto por cualquier otro motivo, puede utilizar las funciones de exportación e importación de Rational SDP.

Exportación

Exporte un proyecto y sus proyectos dependientes en un archivo comprimido utilizando la función Intercambio de proyectos de Rational SDP. Esta función tiene varias ventajas. Le permite exportar simultáneamente varios proyectos y el proyecto de extensión de tiempo de ejecución necesario (com.ibm.hats.rcp.runtime.extension). 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 los proyectos desde HATS Toolkit como un archivo de Intercambio de proyectos:

  1. En la barra de menús, pulse Archivo > Exportar para abrir el asistente Exportar.
  2. Seleccione Otro > Intercambio de proyectos y pulse Siguiente.
  3. Seleccione los proyectos que va a exportar.
    Nota:
    un proyecto de cliente enriquecido de HATS requiere el proyecto de extensión de tiempo de ejecución (com.ibm.hats.rcp.runtime.extension) para poder ejecutarse. Por lo tanto, debe exportar el proyecto de extensión de tiempo de ejecución como parte del archivo de Intercambio de proyectos, o crear un nuevo proyecto extensión de tiempo de ejecución en el sistema de destino creando un nuevo proyecto de cliente enriquecido de HATS.
  4. Especifique un nombre de archivo .zip y una ubicación donde desee guardar los proyectos.
  5. Pulse Finalizar.

Importar

Para importar un archivo comprimido de Intercambio de proyectos en HATS Toolkit:

  1. En la barra de menús, pulse Archivo > Importar para abrir el asistente Importar.
  2. Seleccione Otro > Intercambio de proyectos y pulse Siguiente.
  3. Especifique el archivo .zip que desea importar en el campo Del archivo zip.
  4. Especifique el espacio de trabajo en el que desea importar el archivo .zip en el campo Raíz de ubicación de proyecto.
  5. Seleccione los proyectos del archivo de intercambio de proyectos que desea importar en el espacio de trabajo especificado.
    Nota:
    un proyecto de cliente enriquecido de HATS requiere el proyecto de extensión de tiempo de ejecución (com.ibm.hats.rcp.runtime.extension) para poder ejecutarse. Por lo tanto, debe importar el proyecto de extensión de tiempo de ejecución como parte del archivo de Intercambio de proyectos, o crear un nuevo proyecto extensión de tiempo de ejecución creando un nuevo proyecto de cliente enriquecido de HATS.
  6. Pulse Finalizar.

Prueba de aplicaciones de cliente enriquecido de HATS

Configuración de la plataforma de destino

Para probar un plug-in de aplicación de cliente enriquecido de HATS en un entorno de prueba local, inicie el plug-in y los plug-ins de tiempo de ejecución necesarios en una instancia de la plataforma de destino. La plataforma de destino hace referencia al producto Eclipse (por ejemplo, Eclipse RCP, Lotus Notes o Lotus Expeditor Client) con el que se compilará y probará el plug-in que está desarrollando. Para configurar la plataforma de destino, utilice el diálogo Ventana > Preferencias > Desarrollo de conectores > Plataforma de destino de Rational SDP.

Lotus Notes

Para configurar una plataforma de destino Lotus Notes para realizar pruebas, debe tener instalados Lotus Expeditor Toolkit versión 6.2.1, o posterior y Lotus Notes versión 8.5.1, o posterior. Si tiene instalado Lotus Expeditor Toolkit junto con la opción Configuración de entorno de prueba de Lotus Expeditor, se muestra el diálogo de configuración (mostrado a continuación) la primera vez que se abre un espacio de trabajo. Puede configurarlo cuando se muestra mediante las Test Environment Configuration Preferences que se presentan a continuación. La Ubicación de destino está contenida en la ubicación de instalación por omisión de Lotus Notes. Asegúrese de establecer el Nombre de VM y el Nivel de conformidad de compilador como se muestra a continuación. Si selecciona la opción No mostrar nunca, puede restablecer la opción para mostrar este diálogo de configuración utilizando Ventana > Preferencias > Servicios de cliente en la barra de menús de Rational SDP.

Figura 7. Configuración del entorno de prueba de Lotus Notes
Configuración del entorno de prueba de Lotus Notes

Lotus Expeditor

Para configurar una plataforma de destino Lotus Expeditor para realizar pruebas, debe tener instalados Lotus Expeditor Toolkit y Lotus Expeditor Client for Desktop. El Toolkit y el cliente deben tener la misma versión. Si utiliza Lotus Expeditor Client for Desktop versión 6.2.0, o anterior, también debe instalar el entorno de ejecución del dispositivo.

Para Lotus Expeditor Client, se deben añadir las características siguientes a la instalación por omisión:

En Lotus Expeditor Client, seleccione Archivo > Aplicación > Instalar > Buscar características nuevas para instalar > Añadir ubicación de carpeta. Busque la carpeta siguiente en los archivos del producto Lotus Expeditor Client: desktop\updates\platform y seleccione Finalizar. Expanda updates/platform y Desarrollo. Ponga una marca de selección junto a Lotus Expeditor Desktop Development Utilities. Expanda también Runtime Components y ponga una marca de selección junto a Service Data Objects (SDO) Components. Seleccione Siguiente y finalice el asistente.

Para Lotus Expeditor Client versiones 6.2.0 y anteriores, si desea instalar Core JVM Feature - J2SE desde Lotus Expeditor Client, seleccione Archivo > Aplicación > Instalar > Buscar características nuevas para instalar > Añadir ubicación de carpeta. Busque la ubicación del sitio Entorno de ejecución de dispositivos, que es el directorio update.site.dre.client y seleccione Aceptar. Acepte el nombre de sitio por omisión y seleccione Aceptar y Finalizar. Expanda el sitio y Runtime Components. Ponga una marca de selección junto a Core JVM Feature - J2SE. Seleccione Siguiente y finalice el asistente.

Si tiene instalado Lotus Expeditor Toolkit, junto con la opción Configuración de entorno de prueba de Lotus, se muestra el diálogo de configuración (mostrado a continuación) la primera vez que se abre un espacio de trabajo. Puede configurarlo cuando se muestra mediante las Test Environment Configuration Preferences que se presentan a continuación. La Target Location (Ubicación de destino) está contenida en la ubicación de destino por omisión de Lotus Expeditor Client para Escritorio. Asegúrese de establecer el Nombre de VM y el Nivel de conformidad de compilador como se muestra a continuación. Si selecciona la opción No mostrar nunca, puede restablecer la opción para mostrar este diálogo de configuración utilizando Ventana > Preferencias > Servicios de cliente en la barra de menús de Rational SDP.

Nota:
Es posible que el Nombre VM muestre com.ibm.rcp.j2se.win32.x86 la primera vez que se abre este diálogo de configuración.
Figura 8. Configuración del entorno de prueba de Lotus Expeditor
Configuración del entorno de prueba de Lotus Expeditor

Además de las pruebas en el entorno de prueba local, debe exportar el proyecto como una aplicación y desplegarlo en un entorno de ejecución para probar el proceso de despliegue. Si desea obtener más información, consulte Despliegue de aplicaciones de cliente enriquecido de HATS.

Instalación de plug-ins de tiempo de ejecución

Para que un plug-in de aplicación de cliente enriquecido de HATS se ejecute en el entorno de prueba local de la plataforma de destino, deben instalarse los plug-ins de tiempo de ejecución necesarios en la plataforma de destino. Al crear un proyecto nuevo y seleccionar la plataforma de destino, o bien para cambiar posteriormente la plataforma de destino, HATS Toolkit detectará si los plug-ins de tiempo de ejecución necesarios están instalados y tienen el nivel más reciente en la plataforma de destino seleccionada. Si no los tiene, el kit de utilidades solicitará que instale los plug-ins de tiempo de ejecución más recientes. Puede habilitar o inhabilitar esta solicitud utilizando las preferencias de HATS. Consulte Utilización de preferencias de HATS para obtener más información. Los plug-ins de tiempo de ejecución necesarios que se instalan son los siguientes:

Los siguientes plug-ins Eclipse también se instalan para una pataforma de destino Lotus Notes:

Nota:
por omisión, la plataforma de destino es el mismo Rational SDP. Como HATS Toolkit está instalado en Rational SDP, los plug-ins de tiempo de ejecución de HATS ya están instalados, y no aparece ninguna solicitud si se utiliza la plataforma de destino por omisión.

Después de instalar los plug-ins de tiempo de ejecución de HATS más recientes en la plataforma de destino, debe volver a cargar los nuevos plug-ins. Para ello, utilice el diálogo Ventana > Preferencias > Desarrollo de plug-ins > Plataforma de destino de Rational SDP y pulse Recargar.

Establecimiento del JRE por omisión

Además de configurar la plataforma de destino e instalar los plug-ins de tiempo de ejecución, es posible que deba establecer el JRE por omisión del espacio de trabajo en Rational SDP.

Eclipse RCP

Cuando realice pruebas en una plataforma de destino Eclipse RCP, establezca el JRE por omisión en jdk. Para ello, efectúe los pasos siguientes:

  1. En la barra de menús de Rational SDP, seleccione Ventana > Preferencias > Java > JRE instalados.
  2. En la lista de JRE instalados, seleccione el recuadro situado junto a jdk.
  3. Pulse Aceptar.

Asegúrese de que coincida el JRE. Por ejemplo, si realiza pruebas en un entorno Eclipse que ejecutará Java 1.6, debe actualizar el JRE del espacio de trabajo para que coincida con el JRE del entorno de ejecución.

Lotus Notes

Al realizar pruebas en una plataforma de destino Lotus Notes, es posible que ya haya establecido el JRE por omisión para el espacio de trabajo utilizando el diálogo de configuración de Lotus Expeditor Toolkit, consulte Figura 7. Si no es así, siga los pasos siguientes:

Lotus Expeditor Client

Al realizar pruebas en una plataforma de destino Lotus Expeditor, es posible que ya haya establecido el JRE por omisión para el espacio de trabajo utilizando el diálogo de configuración de Lotus Expeditor Toolkit, consulte Figura 8. Si no es así, siga los pasos siguientes:

  1. En la barra de menús de Rational SDP, seleccione Ventana > Preferencias > Java > JRE instalados.
  2. Asegúrese de seleccionar el JRE Java SE 6.0 Win32 x86.
    Nota:
    si el JRE Java SE 6.0 Win32 x86 no aparece, deberá empezar con un espacio de trabajo limpio, esto es, deberá cambiar a un nuevo directorio de espacio de trabajo.
  3. Pulse Aceptar.

Inicio del proyecto

Para iniciar el proyecto es necesaria una configuración de inicio. HATS crea una configuración de inicio por omisión cuando se pulsa Ejecutar o Depurar para el proyecto (consulte las instrucciones en los apartados siguientes). No se crea una configuración de inicio cuando se abre el diálogo Ejecutar o Depurar desde otra vista, por ejemplo, la vista Explorador de paquetes. La configuración de inicio por omisión se basa en la plataforma de destino del proyecto, que se establece en el asistente Nuevo proyecto o en el editor de valores del proyecto. Si modifica la configuración de inicio por omisión hasta el punto de que ésta no pueda ya iniciar el entorno de trabajo de tiempo de ejecución, puede suprimir la configuración de inicio y HATS volverá a crearla cuando se vuelva a pulsar Ejecutar o Depurar. Par iniciar el proyecto, siga las instrucciones de los apartados siguientes para su plataforma de destino.

Eclipse RCP

Para iniciar el proyecto en el entorno de prueba local para Eclipse RCP, siga estos pasos:

  1. En la vista Proyectos de HATS, pulse con el botón derecho del ratón en el proyecto y seleccione Ejecutar o Depurar.
  2. Si ha seleccionado Depurar, responda Sí, No o Cancelar en el diálogo Terminal de pantalla para especificar si desea ver el terminal de pantalla de sistema principal durante la prueba de la aplicación.
  3. En el diálogo de configuración Ejecutar (o Depurar), HATS crea y configura automáticamente una configuración de inicio por omisión denominada hostaccess.
  4. En la pestaña Principal, en la sección Programa a ejecutar, asegúrese de que aparezca com.ibm.hats.rcp.runtime.extension.product en el campo Ejecutar un producto.
  5. Pulse Ejecutar (o Depurar) para iniciar la configuración por omisión.
  6. Se iniciará una nueva instancia del entorno de trabajo de Eclipse.
  7. La perspectiva Host Access se abrirá automáticamente.
  8. La aplicación de HATS aparecerá en la vista Aplicaciones. Para iniciar la aplicación, efectúe una doble pulsación en ella o pulse con el botón derecho y seleccione Abrir.
  9. Se abrirá una nueva instancia de la aplicación seleccionada mostrando su vista Transformación.

Lotus Notes

Lotus Expeditor Toolkit y Lotus Notes deben estar instalados en la misma estación de trabajo de desarrollo que Rational SDP para poder probar localmente un plug-in de HATS destinado para Lotus Notes. Lotus Notes no debe estar ya funcionando cuando intente probar su proyecto porque sólo puede ejecutarse una instancia de Lotus Notes en un momento dado. Consulte la Configuración de la plataforma de destino.

Para iniciar el proyecto en el entorno de prueba local para Lotus Notes, siga estos pasos:

  1. En la vista Proyectos de HATS, pulse con el botón derecho del ratón el proyecto y seleccione Ejecutar o Depurar.
  2. Si ha seleccionado Depurar, responda Sí, No o Cancelar en el diálogo Terminal de pantalla para especificar si desea ver el terminal de pantalla de sistema principal durante la prueba de la aplicación.
  3. En el diálogo de configuración Ejecutar (o Depurar), HATS crea y configura automáticamente una configuración de inicio por omisión denominada hostaccess.
  4. En la pestaña Principal, en la sección Programa a ejecutar, asegúrese de que aparezca com.ibm.notes.branding.notes en el campo Ejecutar un producto.
  5. En la pestaña Principal, en la sección Java Runtime Environment, confirme que Notes 8.5.1 VM aparezca en el campo JRE de tiempo de ejecución. Si desea obtener más información, consulte Lotus Notes.
  6. Pulse Ejecutar (o Depurar) para iniciar la configuración.
  7. Se iniciará una nueva instancia de Lotus Notes.
  8. Pulse Abrir en la barra de herramientas principal y seleccione Host Access.
  9. La aplicación de HATS aparecerá en la vista Aplicaciones. Para iniciar la aplicación, efectúe una doble pulsación en ella o pulse con el botón derecho y seleccione Abrir.
  10. Se abrirá una nueva instancia de la aplicación seleccionada mostrando su vista Transformación.

Lotus Expeditor Client

Lotus Expeditor Toolkit y Lotus Expeditor Client para escritorio deben estar instalados en la misma estación de trabajo de desarrollo que Rational SDP para poder probar localmente un plug-in de HATS destinado para Lotus Expeditor. Consulte la Configuración de la plataforma de destino.

Para iniciar el proyecto en el entorno de prueba local para Lotus Expeditor Client, siga estos pasos:

  1. En la vista Proyectos de HATS, pulse con el botón derecho del ratón en el proyecto y seleccione Ejecutar o Depurar.
  2. Si ha seleccionado Depurar, responda Sí, No o Cancelar en el diálogo Terminal de pantalla para especificar si desea ver el terminal de pantalla de sistema principal durante la prueba de la aplicación.
  3. En el diálogo de configuración Ejecutar (o Depurar), HATS crea y configura automáticamente una configuración de inicio por omisión denominada hostaccess.
  4. En la pestaña Principal, en la sección Programa a ejecutar, asegúrese de que aparezca com.ibm.rcp.platform.personality.branding.DefaultProduct en el campo Ejecutar un producto.
  5. En la pestaña Principal, en la sección Java Runtime Environment, confirme que Java SE 6.0 Win32 x86 aparezca en el campo JRE de tiempo de ejecución. Si desea obtener más información, consulte Lotus Expeditor Client.
  6. Pulse Ejecutar (o Depurar) para iniciar la configuración.
  7. Se iniciará una nueva instancia de Lotus Expeditor Client. Puede que tenga que especificar una nueva contraseña la primera vez que se inicie el cliente.
  8. Pulse Abrir en la barra de herramientas principal y seleccione Host Access.
  9. La aplicación de HATS aparecerá en la vista Aplicaciones. Para iniciar la aplicación, efectúe una doble pulsación en ella o pulse con el botón derecho y seleccione Abrir.
  10. Se abrirá una nueva instancia de la aplicación seleccionada mostrando su vista Transformación.

Despliegue de aplicaciones de cliente enriquecido 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.

En este apartado se describen dos métodos diferentes para desplegar aplicaciones de cliente enriquecido de HATS. El primer método se puede utilizar para empaquetar un entorno de cliente Eclipse completo para la distribución que tenga todo lo necesario para ejecutar la aplicación de cliente enriquecido de HATS. El segundo método se puede utilizar para empaquetar la aplicación de cliente enriquecido de HATS para los clientes que ya tengan un entorno Eclipse instalado.

Empaquetado de un entorno de cliente Eclipse para la distribución

El SDK de Eclipse, en el que se basa Rational SDP, ofrece la posibilidad de generar un cliente Eclipse completo que incluye los plug-ins de la aplicación de HATS y los demás plug-ins necesarios. Este cliente se puede distribuir a sistemas cliente individuales y se puede ejecutar como una aplicación autónoma.

Nota:
antes de seguir estas instrucciones, se supone que se ha creado un proyecto de plug-in de cliente enriquecido de HATS y se ha ejecutado en el entorno de prueba local.

Para crear el paquete de cliente, siga estos pasos:

  1. En la vista Proyectos de HATS, pulse con el botón derecho del ratón en el proyecto de cliente enriquecido de HATS y, en el menú emergente, seleccione Nuevo HATS > Configuración del producto. Esto inicia el asistente Nueva configuración de producto. El asistente también se puede iniciar desde la barra de menús de Rational SDP seleccionando Archivo > Nuevo > Otros > Desarrollo de conectores > Configuración del producto > Siguiente.
  2. Seleccione la carpeta del proyecto de plug-in com.ibm.hats.rcp.runtime.extension como carpeta padre.
  3. Especifique hostaccess.product en el campo Nombre de archivo.
  4. Seleccione el botón de selección Utilizar una configuración de inicio y seleccione hostaccess.
    Nota:
    en este ejemplo, hostaccess es el nombre por omisión utilizado para la configuración de Ejecutar o Depurar que ha utilizado al probar la aplicación en el entorno de prueba local.
  5. Pulse Finalizar.
  6. Cuando se abra el editor de configuración del producto, pulse la pestaña Configuración y elimine los siguientes plug-ins que no son necesarios de la lista de plug-ins:
  7. Guarde el archivo pulsando el icono Guardar en la barra de herramientas de Rational SDP.
  8. Pulse la pestaña Visión general y el enlace Asistente de exportación del producto Eclipse.
  9. En destino, en el campo Directorio, especifique el nombre del directorio al que se exporta el producto Eclipse. Por ejemplo, c:\hostaccess. De manera alternativa, puede seleccionar exportar a un archivo archivador (.zip), lo cual es muy útil para que el paquete del cliente esté disponible como descarga de un archivo.
  10. Pulse Finalizar.

Se crea un entorno de cliente Eclipse completo. Para probar la aplicación, utilice Windows® Explorer para desplazarse al directorio c:\hostaccess. En la carpeta eclipse, efectúe una doble pulsación en eclipse.exe. Este directorio puede estar comprimido y descargado en máquinas de cliente individuales. Todo lo que se necesita en el sistema de cliente es un JRE (Java Runtime Environment) compatible.

Preparación para clientes Eclipse ecistentes(Eclipse RCP, Lotus Notes, o Lotus Expeditor Client)

Para desplegar la aplicación de cliente enriquecido de HATS en un entorno de ejecución de cliente Eclipse existente, debe:

En los siguientes apartados se describe cómo realizar cada una de estas tareas.

Exportación del proyecto como una característica de Eclipse

Para desplegar el plug-in de aplicación de cliente enriquecido de HATS en un entorno de ejecución, debe empaquetarlo primero en una característica de Eclipse. Una característica de Eclipse es un artefacto de despliegue que se utiliza para empaquetar los plug-ins asociados. Para empaquetar los plug-in en una característica de Eclipse, siga estos pasos.

  1. Cree un directorio vacío, por ejemplo, c:\myHATS, en la unidad de disco duro local para almacenar la característica de aplicación de HATS exportada. Este directorio se utilizará también para almacenar las características de tiempo de ejecución de HATS y el archivo site.xml que contiene la definición de un sitio de actualizaciones. Si desea obtener más información, consulte Exportación de características de tiempo de ejecución de HATS y Creación de un sitio de actualizaciones.
  2. En la vista Proyectos de HATS, pulse con el botón derecho del ratón el proyecto de cliente enriquecido y, en el menú emergente, seleccione Exportar > Exportar característica.
    Nota:

    Si no ha especificado los valores de licencia, aparecerá un mensaje indicando que esta aplicación no está habilitada para el tiempo de ejecución y no se puede ejecutar en un entorno de producción. Las aplicaciones de cliente enriquecido de HATS se pueden probar en un entorno de prueba local (Eclipse, Lotus Notes o Lotus Expeditor Client), pero no se pueden ejecutar en un entorno de ejecución (no desarrollo) sin especificar primero los valores de licencia. Esto significa que puede crear y probar completamente una aplicación en el entorno de desarrollo de HATS Toolkit. También puede exportar la aplicación, y un usuario puede instalarla, pero el usuario no podrá conectarse con la aplicación. Es decir, el tiempo de ejecución estará bloqueado y no permitirá que se realicen conexiones. Si desea obtener información sobre la especificación de valores de licencia, consulte Habilitación de Runtime de HATS y los valores de licencia en la publicación Guía de iniciación de HATS. Si se han adquirido licencias, pulse Habilitar Runtime para habilitar la aplicación para el tiempo de ejecución. De lo contrario, pulse Continuar para continuar el proceso de exportación.

  3. Suponiendo que el proyecto no forma parte de una característica, aparecerá un diálogo solicitándole que cree la característica ahora. Pulse Sí para iniciar el asistente Crear un proyecto de característica de HATS.
  4. En el asistente Crear un proyecto de característica de HATS, complete los campos ID de característica, Nombre, Versión y Proveedor.
    Nota:
    el campo Nombre se rellena automáticamente cuando rellena el campo ID de característica. Cuando se rellenan los campos ID de característica y Nombre, se validan. El valor que especifique para ID de característica será también el nombre utilizado para el proyecto de característica que se crea, y todos los valores se almacenarán en el archivo feature.xml del proyecto. HATS proporciona el nombre hostaccess como valor por omisión para los campos ID de característica y Nombre, y la versión 1.0.0 como valor por omisión para el campo Versión.
  5. La lista de plug-ins se rellena a partir de todos los proyectos de plug-in de cliente enriquecido de HATS que hay en el espacio de trabajo. Seleccione los plug-ins que desee incluir en la nueva característica. Estos plug-ins se instalarán en el cliente cuando se instale la característica. Pulse Finalizar.
  6. A continuación, aparece el asistente Exportar de Eclipse. En el panel Características desplegables, seleccione la característica.
  7. En la pestaña Destino, seleccione Directorio y pulse Examinar para localizar y seleccionar el directorio de exportación, por ejemplo, c:\myHATS.
  8. En la pestaña Opciones, seleccione Empaquetar como archivos JAR individuales (necesario para JNLP y los sitios de actualizaciones).
  9. Pulse Finalizar.

La característica de aplicación de cliente enriquecido de HATS exportada incluye automáticamente el plug-in de extensión de tiempo de ejecución y una dependencia de las características de tiempo de ejecución de HATS. El proyecto de característica no aparece en la vista Proyectos de HATS, pero sí en la vista Navegador.

Si desea realizar una configuración más avanzada de la característica de aplicación de cliente enriquecido de HATS, en lugar de utilizar el asistente Crear un proyecto de característica de HATS, puede utilizar el asistente estándar Nueva característica de Eclipse proporcionado por Eclipse. Para iniciar este asistente, en la barra de herramientas de Rational SDP, seleccione Archivo > Nuevo > Otros > Desarrollo de conectores > Proyecto de característica. Este asistente realiza básicamente las mismas funciones que el asistente Crear un proyecto de característica de HATS, excepto que no incluye automáticamente el plug-in de extensión de tiempo de ejecución ni las dependencias necesarias de las características de tiempo de ejecución de HATS.

Exportación de características de tiempo de ejecución de HATS

En un entorno de producción, una característica de aplicación de cliente enriquecido de HATS depende de las características de tiempo de ejecución de HATS que se están instalando en el cliente. Cuando se crea una característica de aplicación de cliente enriquecido de HATS utilizando el asistente Crear un proyecto de característica de HATS, incluirá automáticamente una dependencia de las características de tiempo de ejecución de HATS. Esta dependencia es la que hace que el proceso de instalación y actualización de características despliegue automáticamente las características de tiempo de ejecución de HATS del sitio de actualizaciones cuando se instala o se actualiza una característica de aplicación de cliente enriquecido de HATS. Las características de tiempo de ejecución de HATS incluyen las siguientes características y plug-ins:

La siguiente característica de Eclipse también se incluye cuando se especifica una plataforma de destino de Lotus Notes:

Para exportar las características de tiempo de ejecución de HATS, realice los pasos siguientes:

  1. En la vista Proyectos de HATS, pulse con el botón derecho del ratón en el proyecto de cliente enriquecido de HATS y, en el menú emergente, seleccione Exportar > Exportar características de HATS Runtime. Esto inicia el asistente Exportar características de HATS Runtime. El asistente también se puede iniciar desde la barra de menús de Rational SDP seleccionando Archivo > Exportar > HATS > Características de HATS Runtime.
  2. En el panel Exportar características de HATS Runtime, para Desplegar como, seleccione Directorio y pulse Examinar para localizar y seleccionar el directorio de exportación, por ejemplo, c:\myHATS.
    Nota:
    el asistente Exportar características de HATS Runtime permite especificar un archivo archivador o un directorio en el sistema de archivos local para guardar las características de tiempo de ejecución de HATS. Si elige exportar a un archivo Archivador, todas las características y plug-ins se empaquetan en un solo archivo archivador .zip. La estructura de directorios raíz dentro del archivo archivador .zip empieza con dos subdirectorios, uno denominado features y el otro denominado plugins. Si elige exportar a un Directorio, las características y los plug-ins se exportan al directorio seleccionado. Las características se colocan en un subdirectorio denominado features, y los plug-ins se colocan en un subdirectorio denominado plugins. Seleccione Directorio si tiene previsto cargar los archivos archivadores a un directorio de sitio de actualizaciones en un servidor Web.
  3. Pulse Finalizar.

Creación de un sitio de actualizaciones

Después de exportar la característica de aplicación de HATS y las características de tiempo de ejecución de HATS, debe crear un sitio de actualizaciones que puede utilizar el proceso de instalación y actualización de características para desplegar la aplicación. Para crear un sitio de actualizaciones, siga estos pasos:

  1. En la vista Proyectos de HATS, pulse con el botón derecho del ratón en el proyecto de cliente enriquecido de HATS y, en el menú emergente, seleccione Nuevo HATS > Proyecto de sitio de actualizaciones. Esto inicia el asistente Sitio de actualizaciones nuevo. El asistente también se puede iniciar desde la barra de menús de Rational SDP seleccionando Archivo > Nuevo > Otros > Desarrollo de conectores > Proyecto de sitio de actualizaciones > Siguiente.
  2. En el panel Proyecto de sitio de actualizaciones:
    1. Dé un nombre al proyecto, por ejemplo, myHATSUpdateSite.
    2. Deseleccione el recuadro de selección Utilizar ubicación por omisión y pulse Examinar para localizar y seleccionar el directorio donde ha exportado la característica de aplicación de HATS y las características de tiempo de ejecución de HATS, por ejemplo, c:\myHATS.
    3. Pulse Finalizar.
  3. En la vista del editor de site.xml, en la pestaña Mapa del sitio, pulse Categoría nueva.
  4. En la sección Propiedades de las categorías:
    1. Especifique un nombre, por ejemplo, HATS.
    2. Especifique una etiqueta, por ejemplo, HATS.
    3. De manera opcional, especifique una Descripción.
    4. Pulse el icono Guardar en la barra de herramientas de Rational SDP.
  5. En la vista del editor de site.xml, en la pestaña Mapa del sitio, pulse Añadir característica.
  6. En el panel Selección de característica, desplácese y seleccione la característica de aplicación de HATS, por ejemplo, hostaccess (nnnn), donde nnnn representa el número de versión de la característica, y pulse Aceptar. Si desea obtener más información sobre los números de versión, consulte Actualización de los números de versión de plug-in y características.
    Nota:
    si empieza a escribir el nombre de una característica en el campo Seleccione una característica, los datos que especifique actuarán como comodín y la lista de características del recuadro de lista se reducirá hasta que aparezca la característica deseada.
  7. Pulse Añadir característica para añadir cada una de las características de tiempo de ejecución de HATS:

    Si la plataforma de destino especificada es Lotus Notes, añada también la característica siguiente:

  8. Pulse Construir todo para completar la construcción del archivo site.xml del sitio de actualizaciones.
    Nota:
    Si se muestra un mensaje de error que indica que Se han producido errores de compilación durante la creación. Las anotaciones cronológicas se encuentran en 'logs.zip' en el directorio raíz del proyecto del sitio., compruebe el archivo logs.zip. Si contiene sólo avisos, puede ignorarlos con seguridad y continuar.

Ha creado un sitio de actualizaciones, en este ejemplo, c:\myHATS, incluido el archivo site.xml que indica qué características y qué versiones de las características están disponibles en el sitio para que las descargue un cliente. Ahora puede mover este directorio de sitio de actualizaciones a un servidor Web al que puedan acceder los clientes. Para obtener instrucciones sobre cómo definir un sitio de actualizaciones en el sistema de cliente e instalar las aplicaciones de cliente enriquecido de HATS en un entorno de ejecución, consulte Instalación de la aplicación en un entorno de ejecución.

Nota:
después de instalar una actualización de servicio de HATS, debe volver a exportar y volver a desplegar las características de tiempo de ejecución de HATS para elegir los cambios que desee. Debe modificar el archivo site.xml del sitio de actualizaciones para que refleje los cambios de número de versión. Las versiones aparecen en el primer panel del asistente Exportar características de HATS Runtime. Si desea obtener más información, consulte Actualización de los números de versión de plug-in y características.

Instalación de la aplicación en un entorno de ejecución

Las aplicaciones de cliente enriquecido de HATS se pueden ejecutar en entornos de Eclipse RCP, Lotus Notes y Lotus Expeditor Client. En los siguientes apartados se describe cómo instalar la aplicación de cliente enriquecido de HATS en cada uno de estos entornos.

Eclipse RCP

Para descargar e instalar la aplicación cliente enriquecido de HATS en un entorno de cliente enriquecido de Eclipse, el entorno del cliente debe contener la característica EMF Service Data Objects (SDO) de Eclipse y debe estar configurado para acceder al sitio de actualizaciones que contiene la aplicación. Por omisión, como la instalación y la actualización automáticas están inhabilitadas, el usuario o el administrador debe instalar manualmente las nuevas características o actualizaciones utilizando las funciones estándar de actualización de software de Eclipse. Para ello, siga estos pasos en el sistema cliente.

Nota:
Las instrucciones siguientes son para Eclipse 3.4 y posterior. Si utiliza una versión anterior de Eclipse, siga la documentación correspondiente de Eclipse para utilizar su gestor de actualizaciones para instalar las características.
  1. En la barra de menús del cliente de Eclipse, seleccione Ayuda > Actualizaciones de software. Seleccione la pestaña Software disponible.
    Nota:
    dependiendo de la configuración del cliente de Eclipse, este elemento de menú puede aparecer en otro menú.
  2. Pulse sucesivamente los botones Añadir sitio y Local.
  3. Busque la ubicación del sitio de actualizaciones creado para el proyecto de HATS y pulse Aceptar.
  4. Seleccione el sitio de actualizaciones de HATS y pulse Instalar.
  5. Revise y confirme los elementos que se van a instalar. Pulse Siguiente.
  6. Seleccione Acepto los términos del acuerdo de licencia y pulse Finalizar.
  7. La aplicación de HATS se ha instalado.
  8. Cuando se le solicite si desea reiniciar el entorno de trabajo, pulse Sí.
  9. Puede ejecutar entonces la aplicación abriendo primero la perspectiva Host Access (Ventana->Abrir perspectiva-> Host Access). La aplicación de HATS aparece en la vista Aplicaciones. Para iniciar la aplicación, efectúe una doble pulsación en ella o pulse con el botón derecho y seleccione Abrir.

Si desea obtener más información sobre el entorno RCP de Eclipse, consulte la página http://www.eclipse.org/home/categories/rcp.php.

Lotus Notes

En el entorno de Lotus Notes, se utiliza un aparato para instalar aplicaciones proporcionadas como características y plug-ins. El aparato puede después ser publicado en un catálogo de aparatos para que sea utilizado por otros. Si desea obtener más información sobre widgets, consulte el apartado Widgets and Live Text del centro de información de Lotus Notes en http://publib.boulder.ibm.com/infocenter/domhelp/v8r0/index.jsp?topic=/com.ibm.notes85.help.doc/wid_app_overview_c.html .

Para descargar e instalar la aplicación de cliente enriquecido de HATS en un entorno de Lotus Notes, realice los siguientes pasos en el sistema del cliente:

  1. Inicie el cliente de Lotus Notes y seleccione Archivo > Preferencias > Aparatos.
  2. Seleccione Mostrar barra de herramientas Aparato y el panel de la barra lateral Mis aparatos. Pulse Aceptar.
  3. La barra de herramientas Aparato tiene este aspecto:
    Figura 9. Barra de herramientas Aparato de Lotus Notes
    Barra de herramientas Aparato de Lotus Notes
  4. El panel de la barra lateral Mis aparatos tiene este aspecto:
    Figura 10. Barra lateral Mis aparatos
    Barra lateral Mis aparatos
  5. Seleccione Cómo empezar con aparatos desde la barra de herramientas Aparato.
  6. Seleccione Características y Plugins, y a continuación seleccione Siguiente.
  7. En el campo Escribir el URL, escriba la vía de acceso al archivo site.xml del sitio de actualización utilizando este formato como ejemplo (debe comenzar por file:///): file:///c:\hatsupdatesite\site.xml. Pulse el botón Cargar.
  8. En Características a instalar, seleccione todas las características y seleccione Siguiente.
  9. Opcional: En el campo Nombre de aparato, puede escribir Aparato de provisión de HATS u otro nombre apropiado.
  10. Opcional: Si desea que el widget tenga una imagen asociada a él, copie la imagen deseada a su carpeta del sitio de actualización. A continuación, en el campo URL de imagen, escriba la vía de acceso a la imagen utilizando este formato como ejemplo (debe comenzar con file:///): file:///c:\hatsupdatesite\myhatsimage.png.
  11. Seleccione instalar los plug-ins cuando se le solicite.

    El panel de la barra lateral Mis aparatos tendrá este aspecto:

    Figura 11. Barra lateral Mis aparatos con el ejemplo Aparato de provisión de HATS
    Barra lateral Mis aparatos con el Aparato de provisión de HATS de ejemplo
  12. Reinice Lotus Notes cuando se le pida.

Puede ejecutar su aplicación seleccionando Abrir > Acceso a sistema principal. La aplicación de HATS aparecerá en la vista Aplicaciones. Para iniciar la aplicación, efectúe una doble pulsación en ella o pulse con el botón derecho y seleccione Abrir.

Para desinstalar la aplicación de HATS, pulse con el botón derecho del ratón el aparato Provisión de HATS (o el nombre que usted le haya dado) y seleccione Eliminar. Reinice Lotus Notes cuando se le pida.

Lotus Expeditor Client

En el entorno de Lotus Expeditor Client, la gestión y el despliegue de aplicaciones se puede controlar de varias formas:

Para Lotus Expeditor Client, se deben añadir las características siguientes a la instalación por omisión:

En Lotus Expeditor Client, seleccione Archivo > Aplicación > Instalar > Buscar características nuevas para instalar > Añadir ubicación de carpeta. Busque la carpeta siguiente en los archivos del producto Lotus Expeditor Client: desktop\updates\platform y seleccione Finalizar. Expanda updates/platform y Desarrollo. Ponga una marca de selección junto a Lotus Expeditor Desktop Development Utilities. Expanda también Runtime Components y ponga una marca de selección junto a Service Data Objects (SDO) Components. Seleccione Siguiente y finalice el asistente.

Para Lotus Expeditor Client versiones 6.2.0 y anteriores, si desea instalar Core JVM Feature - J2SE desde Lotus Expeditor Client, seleccione Archivo > Aplicación > Instalar > Buscar características nuevas para instalar > Añadir ubicación de carpeta. Busque la ubicación del sitio Entorno de ejecución de dispositivos, que es el directorio update.site.dre.client y seleccione Aceptar. Acepte el nombre de sitio por omisión y seleccione Aceptar y Finalizar. Expanda el sitio y Runtime Components. Ponga una marca de selección junto a Core JVM Feature - J2SE. Seleccione Siguiente y finalice el asistente.

Si desea obtener más información, consulte el apartado Assembling and Deploying Lotus Expeditor Applications (Ensamblaje y despliegue de Lotus Expeditor Applications) en el centro de información de Lotus Expeditor en http://publib.boulder.ibm.com/infocenter/ledoc/v6r2/index.jsp.

Para descargar e instalar la aplicación de cliente enriquecido de HATS en un entorno de Lotus Expeditor Client, el cliente debe estar configurado para acceder al sitio de actualizaciones que contiene la aplicación. Para ello, siga estos pasos en el sistema cliente.

  1. En el menú principal de Lotus Expeditor Client, seleccione Archivo > Aplicación > Instalar.
  2. En el panel Actualizaciones de características, seleccione Buscar características nuevas para instalar y pulse Siguiente.
  3. En el panel Ubicaciones de aplicaciones, pulse Añadir ubicación remota o Añadir ubicación de carpeta, según corresponda.
  4. En el panel Ubicaciones de aplicaciones, seleccione el sitio de actualizaciones de HATS y pulse Finalizar.
  5. En el panel Resultados de la búsqueda, seleccione las características que desee instalar y pulse Siguiente.
  6. En el panel Licencia de la característica, seleccione Acepto los términos del acuerdo de licencia y pulse Siguiente.
  7. En el panel Instalación, pulse Finalizar.
  8. La aplicación de HATS se ha instalado.
  9. Cuando se le solicite si desea reiniciar el entorno de trabajo, pulse Sí.
  10. Puede ejecutar entonces la aplicación abriendo primero la perspectiva Host Access (Abrir->Host Access). La aplicación de HATS aparece en la vista Aplicaciones. Para iniciar la aplicación, efectúe una doble pulsación en ella o pulse con el botón derecho y seleccione Abrir.
Proceso de actualización automática

El entorno de cliente enriquecido permite la actualización automática de las aplicaciones instaladas. Existen preferencias para controlar la frecuencia con la que se comprueba si hay actualizaciones en el servidor. Una vez subida y actualizada una aplicación, el cliente enriquecido descargará e instalará la actualización. Se realiza la comprobación de versiones para asegurarse de que sólo se descargan y se instalan nuevas actualizaciones. En la mayoría de los casos, el usuario deberá reiniciar el entorno para activar la aplicación actualizada. Para obtener más información, consulte la documentación correspondiente de Eclipse RCP, Lotus Noteso Lotus Expeditor.

Actualización de los números de versión de plug-in y características

Para actualizar un plug-in que ya está instalado, debe actualizar primero la versión del plug-in, ya que Eclipse utiliza la versión para determinar si ha cambiado un plug-in. Por ejemplo, si añade una personalización de pantalla o modifica una macro del proyecto, debe actualizar la versión del plug-in antes de volver a exportarlo.

Para actualizar la versión del plug-in, en el editor de Valores del proyecto, en la pestaña Visión general, pulse el enlace abra el manifiesto de plug-in. En la pestaña Visión general, en Información general, actualice la versión. Una versión de Eclipse tiene el formato major.minor.service. Cuando realice un cambio menor en el proyecto, actualice el segmento service de la versión. Por ejemplo, antes de exportar el plug-in una segunda vez, establezca la versión del plug-in en 1.0.1.

Como el asistente Valores de licencia actualiza el proyecto de extensión de tiempo de ejecución (com.ibm.hats.rcp.runtime.extension), después de ejecutar el asistente, debe actualizar la versión de este plug-in. Para ello, en la vista Navegador, abra el archivo plugin.xml que se encuentra en la raíz del proyecto. En la pestaña Visión general, en Información general, actualice la versión.

Asimismo, como las características están formadas por plug-ins (y las características también tienen versiones), debe actualizar la versión de la característica siempre que actualice la versión de uno de los plug-ins incluidos. Para ello, cambie a la vista Navegador y abra el archivo feature.xml que se encuentra en el proyecto de característica. Por omisión, el nombre del proyecto de característica es hostaccess. En la pestaña Visión general, en Información general, actualice la versión. Asimismo, asegúrese de que la característica incluya correctamente las nuevas versiones de los plug-ins. Para ello, pulse el botón Versiones en la pestaña Conectores y seleccione Copiar versiones de los manifiestos de conectores y fragmentos.

Una vez actualizada la versión de la característica, debe actualizar el archivo site.xml (si es aplicable) para asegurarse de que incluya la nueva versión de la característica.

Nota:
estos pasos no son necesarios cuando se ejecuta o se depura la aplicación en el entorno de prueba local.

Administración de aplicaciones de cliente enriquecido de HATS

Para las aplicaciones de cliente enriquecido de HATS, los valores de tiempo de ejecución como, por ejemplo, los valores de anotaciones cronológicas y de rastreo, se especifican en dos archivos en el plug-in de extensión de tiempo de ejecución (com.ibm.hats.rcp.runtime.extension):

Si desea obtener más información sobre la ejecución en modalidades de prueba distintas, consulte Prueba de las modalidades de los proyectos del cliente enriquecido en la publicación Guía de iniciación de HATS.

En HATS Toolkit, puede editar estos archivos para cambiar los valores, por ejemplo, los valores de rastreo y nivel de rastreo. Los archivos se encuentran en la raíz del proyecto de plug-in de extensión de tiempo de ejecución. Tenga en cuenta que los cambios efectuados en el archivo runtime.properties en HATS Toolkit se retienen y pasan a aplicarse al desplegar la aplicación de HATS en un entorno de ejecución. En el entorno de ejecución, el archivo runtime.properties se encuentra en el directorio del plug-in de extensión de tiempo de ejecución, por ejemplo, <dir_instalación_eclipse>/eclipse/plugins/com.ibm.hats.rcp.runtime.extension_1.0.0. El archivo runtime-debug.properties se ignora en el entorno de ejecución. Para obtener más información sobre los valores de anotaciones cronológicas y de rastreo en estos archivos, consulte el Apéndice A. Archivos de propiedades de unidad ejecutable.

Si desea obtener más información sobre cómo puede configurar el usuario los valores de anotaciones cronológicas y de rastreo, y recopilar datos de determinación de problemas en el entorno de ejecución, consulte Preferencias.

Sólo hay un plug-in de extensión de tiempo de ejecución en el espacio de trabajo, y sólo una versión del plug-in en el entorno de ejecución. Por lo tanto, en un solo entorno de ejecución de cliente enriquecido de HATS, los valores de anotaciones cronológicas y de rastreo son los mismos para todas las aplicaciones de cliente enriquecido de HATS.

Los valores de licencia también se almacenan en el archivo runtime.properties del plug-in de extensión de tiempo de ejecución (com.ibm.hats.rcp.runtime.extension). Por lo tanto, se realiza un seguimiento de las licencias en el nivel del entorno de cliente enriquecido, no en el nivel de una aplicación de cliente enriquecido de HATS individual. Si el usuario revisa el número de licencias adquiridas, aparecerá un mensaje de aviso en las anotaciones cronológicas. Si desea obtener información sobre la especificación de valores de licencia, consulte Habilitación de Runtime de HATS y los valores de licencia en la publicación Guía de iniciación de HATS.

Entorno de ejecución

Vista Aplicaciones

La vista Aplicaciones muestra al usuario todas las aplicaciones de cliente enriquecido de HATS activas instaladas en el entorno de ejecución. La vista se ordena por el nombre de visualización de las aplicaciones. Por omisión, esta vista aparece la primera vez que el usuario abre la perspectiva Host Access. Para iniciar una nueva instancia de una aplicación de HATS, el usuario puede realizar una doble pulsación en la aplicación en la vista Aplicaciones, o pulsar con el botón derecho el nombre de aplicación y seleccionar Abrir.

Después de iniciar una nueva instancia de una aplicación de HATS, aparece su vista Transformación. Consulte Vista Transformación para obtener más información. Por omisión, el nombre de la vista Transformación que se acaba de abrir es el nombre de la aplicación. Si se inicia más de una instancia de la aplicación, el nombre de la vista Transformación será una combinación del nombre de la aplicación más un número que indica la instancia de la sesión. Por ejemplo, el título de la segunda instancia de la aplicación denominada Entrada de pedidos será Entrada de pedidos : 2.

Por omisión, un usuario puede iniciar varias instancias de la misma aplicación. Puede modificar el archivo plugin.xml para no permitir el inicio de varias instancias. Asimismo, puede decidir no mostrar la vista Aplicaciones y, en su lugar, controlar qué vistas están disponibles para el usuario. Esto también puede restringir el número de instancias de una aplicación. Para obtener más información consulte la publicación HATS Rich Client Platform Programmer's Guide.

Si la aplicación se ejecuta en el entorno de prueba local y ha seleccionado ver el terminal de pantalla, aparecerá una ventana de terminal de pantalla cuando se realice una conexión con el sistema. La ventana se cerrará cuando finalice la sesión o cuando se concluya el cliente.

Menú emergente

Se proporciona un menú emergente para habilitar al usuario para realizar acciones en una o varias aplicaciones de la vista. Seleccione uno o varios nombres de aplicación y pulse con el botón derecho del ratón para mostrar el menú. Están disponibles los siguientes elementos de menú:

Abrir
Si se selecciona este elemento de menú, se inicia una nueva instancia de la aplicación seleccionada. Si se seleccionan varias aplicaciones, se inicia una instancia de cada aplicación seleccionada.
Ver trabajos de impresión
Este elemento de menú sólo se habilita cuando se selecciona como mínimo una aplicación habilitada para la impresión. Si selecciona este elemento de menú, se abre la vista Trabajos de impresión (3270) o Trabajos de impresión (5250), que muestra una lista de los trabajos de impresión en cola. Consulte el Habilitación de soporte de impresión para obtener más información.
Propiedades
Este elemento de menú sólo se habilita si hay una aplicación seleccionada. Si selecciona este elemento de menú, un usuario puede ver información sobre la aplicación, así como configurar algunos valores relacionados con la aplicación. En el diálogo Propiedades, se proporcionan las siguientes páginas para una aplicación seleccionada:
Información
La página Información muestra información sobre la aplicación seleccionada, incluido el nombre, el ID, la versión y la ubicación física del plug-in. La página también muestra la versión del plug-in de tiempo de ejecución de HATS que utiliza la aplicación. Esta información es útil cuando un usuario debe comunicar información sobre el entorno a un equipo de soporte. El usuario no puede cambiar ningún valor en esta página. Es sólo informativa.
Parámetros de conexión
Este elemento no aparece en la lista si ha elegido no permitir que el usuario altere parámetros de conexión, que es el valor por omisión. Consulte Alteraciones de parámetros de conexión para obtener más información.

Si permite las alteraciones, esta página permite al usuario alterar parámetros de conexión. Esta función es equivalente a la función de HATS de las aplicaciones Web que permite al usuario alterar parámetros de conexión utilizando el URL cuando se accede por primera vez a la aplicación. Un ejemplo de uso de la alteración de parámetros de conexión puede ser cuando el usuario necesita alterar un ID de estación de trabajo o un nombre de LU.

Para establecer una alteración temporal, el usuario pulsa el botón Añadir, selecciona un parámetro en la lista desplegable del campo Nombre y establece un valor en el campo Valor. No se realiza ninguna validación en el diálogo para alertar al usuario sobre si se puede alterar el nombre del parámetro de conexión proporcionado. Por omisión, el valor de alteración se habilita cuando se añade por primera vez. Se puede inhabilitar deseleccionando el recuadro de selección situado junto al nombre del parámetro.

Cuando el usuario altera un parámetro de conexión, los valores se guardan en el espacio de trabajo local. Los valores de los parámetros alterados se utilizan cuando se inicia una instancia de la sesión.

Si desea obtener más información sobre el inicio mediante programación de una instancia de aplicación de cliente enriquecido utilizando alteraciones de parámetros de conexión, consulte la publicació HATS Rich Client Platform Programmer's Guide.

Variables
Este elemento no aparecerá en la lista si ha elegido no permitir que el usuario altere variables globales, que es el valor por omisión. Consulte Alteraciones de variables globales para obtener más información.

Si permite las alteraciones, esta página permite al usuario alterar variables globales. Esta función es equivalente a la función de HATS de las aplicaciones Web que permite al usuario alterar variables globales y variables globales compartidas utilizando el URL cuando se accede por primera vez a la aplicación.

Esta función permite utilizar datos de variables específicos del usuario en la aplicación. Por ejemplo, puede grabar una macro que solicite el nombre de usuario y la contraseña proporcionados a partir de los valores de las variables globales. El usuario puede proporcionar estos valores en la página de alteración de variables. Estos valores se utilizan posteriormente al ejecutar la macro cuando se reconoce la pantalla de inicio de sesión.

Para establecer una alteración temporal, el usuario pulsa el botón Añadir, selecciona un nombre de variable en la lista desplegable del campo Nombre, establece un valor en el campo Valor y especifica si la variable global es Compartida. No se realiza ninguna validación en el diálogo para alertar al usuario sobre si se puede alterar el nombre de la variable global proporcionado. Por omisión, el valor de alteración se habilita cuando se añade por primera vez. Se puede inhabilitar deseleccionando el recuadro de selección situado junto al nombre de la variable.

Cuando el usuario altera temporalmente una variable global, los valores se almacenan en el directorio de datos del entorno. Los valores de las variables globales alteradas se utilizan cuando se inicia una instancia de la sesión.

Si desea obtener información sobre cómo iniciar mediante programación una instancia de aplicación de cliente enriquecido utilizando alteraciones de variables globales, consulte la publicación HATS Rich Client Platform Programmer's Guide.

Soporte de pantalla de impresión

En el entorno de cliente enriquecido, el usuario puede imprimir la transformación de pantalla actual seleccionando Imprimir en el menú Archivo. Por omisión, Eclipse muestra el diálogo Imprimir, donde el usuario puede seleccionar la impresora, así como configurar otras opciones. Cuando el usuario pulsa Aceptar, el área de transformación de la vista Transformación se envía a la impresora seleccionada.

Nota:
En los sistemas Windows, se imprimirá la transformación completa, incluidas las partes que estén sólo visibles utilizando la barra de desplazamiento. En los sistemas Linux®, se imprimirá sólo la parte visible de la transformación, no las partes ocultas a las que se debe desplazar para verlas.

Vista Transformación

La vista Transformación es el área principal de la transformación en el entorno de cliente enriquecido. Cada proyecto de cliente enriquecido de HATS tiene asociada una vista Transformación. La vista se registra en el archivo plugin.xml del proyecto cuando se crea el proyecto. La vista está formada por cuatro áreas:

Barra de herramientas

La barra de herramientas de la vista Transformación contiene botones para las acciones a nivel de aplicación, así como botones para las acciones aportadas por el aparato Barra de herramientas, durante la representación de pantalla. Por omisión, se muestra la barra de herramientas y los botones aparecen con títulos de sólo texto. Puede cambiar estos valores en los valores del proyecto. Consulte Barra de herramientas  Sólo RCP  para obtener más información.

La barra de herramientas está dividida en dos secciones. La derecha de la barra de herramientas es equivalente al área de teclado de aplicación en una aplicación Web de HATS y contiene botones de área de teclado de aplicación. Consulte Área de teclado de aplicación para obtener información sobre cómo puede configurar qué botones aparecen. A la izquierda aparecen los botones aportados por el aparato Barra de herramientas. Consulte Barra de herramientas  Sólo RCP  para obtener más información.

Hay disponible texto de ayuda contextual que proporciona una descripción de la función del botón en todos los botones del área de teclado de aplicación. Puede establecer texto de ayuda contextual sobre los botones que añada utilizando el aparato Barra de herramientas.

Encima de los botones del área de teclado de aplicación de la barra de herramientas, al lado de los iconos Minimizar y Maximizar, aparece un icono Menú. Si pulsa este icono, aparece un menú con los siguientes elementos de menú:

Conmutar soporte de teclado
Permite al usuario habilitar e inhabilitar el soporte de teclado.
Detalles de conexión
Muestra los detalles de la conexión de sistema principal de esta aplicación.
Propiedades
Muestra las propiedades de esta aplicación.

Área de plantilla y transformación

El área de plantilla y transformación constituye la parte principal de la vista Transformación y es donde aparecen todas las transformaciones de pantalla. También es el área donde aparecen los mensajes de error, los mensajes de desconexión y los paneles de manejador de macros.

Menú emergente
En el área de transformación se proporciona un menú emergente que permite al usuario ver información de la aplicación actual. Está disponible el siguiente elemento de menú:
Propiedades
Si selecciona este elemento, se abre el diálogo de propiedades de la aplicación actual. Consulte Menú emergente para obtener más información.
Paneles de estado de tiempo de ejecución
Al igual que con las aplicaciones Web de HATS, se muestra un panel al usuario si la aplicación de cliente enriquecido de HATS se detiene, se desconecta, tiene un error o está ocupada.

Área de teclado de sistema principal

El área de teclado de sistema principal muestra las teclas de sistema principal que desea mostrar en los valores del proyecto. Consulte Área de teclado de sistema principal para obtener información sobre cómo configurar el área de teclado de sistema principal. Por omisión, no se muestra ninguna área de teclado de sistema principal.

Área de estado de OIA

El área de estado de OIA muestra información sobre el estado de la sesión que configura en los valores del proyecto. Consulte Área de información del operador para obtener información sobre cómo configurar el área de estado de OIA.

Cierre de la vista

La conexión con el sistema principal se cierra cuando se cierra la vista. Esto ocurre si el usuario cierra explícitamente la vista o el entorno de cliente enriquecido. Cuando se cierra, se procesa el conjunto de acciones definidas en los sucesos de desconexión y detención.

Nota:
si el usuario intenta cerrar la vista cuando HATS está procesando una petición, por ejemplo, si el usuario pulsa un botón que empieza a reproducir una macro, aparece un mensaje indicando que la sesión está ocupada. Si el usuario continúa, la sesión terminará y las acciones de los sucesos de desconexión y detención no se ejecutarán.

Solicitud de ID de estación de trabajo

Cuando se crea o se edita una conexión de sistema principal, puede especificar que se solicite un ID de estación de trabajo al usuario para conectarse a un sistema principal 5250. Consulte Creación de una conexión para obtener más información. Si especifica la solicitud del ID de estación de trabajo, se presenta un diálogo de solicitud al usuario la primera vez que se conecta al sistema principal. El usuario puede especificar un ID de estación trabajo en el campo ID de estación de trabajo.

Se proporciona un recuadro de selección que, si se selecciona, hace que el ID de estación de trabajo se guarde para evitar solicitudes futuras. Cuando se selecciona el recuadro de selección, la solicitud se puede restaurar más adelante si se inhabilita la alteración temporal del parámetro de conexión workstationID en las propiedades de la aplicación. Consulte Parámetros de conexión para obtener más información.

Solicitud de nombre de LU

Cuando se crea o se edita una conexión de sistema principal, puede especificar que se solicite un nombre de LU al usuario para conectarse a un sistema principal 3270E. Consulte Creación de una conexión para obtener más información. Si especifica la solicitud del nombre de LU, se presenta un diálogo de solicitud al usuario la primera vez que se conecta al sistema principal. El usuario debe especificar un nombre de LU en el campo Nombre de LU.

Se proporciona un recuadro de selección que, si se selecciona, hace que el nombre de LU se guarde para evitar solicitudes futuras. Cuando se selecciona el recuadro de selección, la solicitud se puede restaurar más adelante si se inhabilita la alteración temporal del parámetro de conexión LUName en las propiedades de la aplicación. Consulte Parámetros de conexión para obtener más información.

Preferencias

Por omisión, los usuarios pueden acceder a las preferencias seleccionando Archivo > Preferencias > Host Access en la barra de menús de la plataforma de tiempo de ejecución. Las páginas que aparecen se registran en el plug-in extensión de tiempo de ejecución. Si no desea proporcionar estas funciones al usuario, puede eliminar las declaraciones aplicables en el archivo plugin.xml del plug-in extensión de tiempo de ejecución. Para obtener más información sobre cómo hacerlo, consulte la descripción del ID de punto de extensión org.eclipse.ui.preferencePages en la sección HATS runtime extension plug-in (Plug-in de extensión de tiempo de ejecución de HATS) de la publicación HATS Rich Client Platform Programmer's Guide. Pueden seleccionarse los siguientes valores de preferencia:

Preferencias de impresión

El usuario puede establecer las siguientes preferencias de impresión para las aplicaciones que dan soporte a la impresión 3270:

Acciones de trabajo de impresión por omisión
Al iniciar
Cuando se inicia un trabajo de impresión, se pueden establecer las siguientes preferencias:
  • Activar vista de trabajos de impresión
  • Mostrar un mensaje

    Se muestra un mensaje indicando al usuario que se ha iniciado un trabajo de impresión.

  • Ninguna
Al finalizar
Cuando finaliza un trabajo de impresión, se pueden establecer las siguientes preferencias:
  • Activar vista de trabajos de impresión
  • Mostrar un mensaje

    Se muestra el mensaje El trabajo de impresión {0} ha finalizado. Donde {0} es el nombre del trabajo de impresión.

  • Abrir
  • Ninguna
En el error
Cuando falla un trabajo de impresión, se pueden establecer las siguientes preferencias:
  • Activar vista de trabajos de impresión
  • Mostrar un mensaje

    Se muestra el mensaje El trabajo de impresión {0} ha encontrado un error. Donde {0} es el nombre del trabajo de impresión.

  • Suprimir
  • Ninguna
Suprimir trabajos de impresión al salir
Si se selecciona, los trabajos de impresión se suprimen automáticamente cuando se cierra el entorno. Esto puede ser muy útil para los usuarios que comparten una estación de trabajo con otros.

Preferencias de resolución de problemas

El usuario puede establecer las siguientes preferencias de resolución de problemas. Si desea obtener más información sobre los valores de anotaciones cronológicas y rastreo, consulte Administración de aplicaciones de cliente enriquecido de HATS.

Valores de rastreo
El usuario puede habilitar los siguientes rastreos de tiempo de ejecución de HATS:
Habilitar rastreo de tiempo de ejecución
Habilita el rastreo de las conexiones en la aplicación.
Habilitar rastreo de aparatos
Habilita el rastreo de los aparatos en la aplicación.
Habilitar rastreo de acciones
Habilita el rastreo de acciones de sucesos en la aplicación.
Habilitar rastreo de HOD
Habilita el rastreo de Host On-Demand en la aplicación.
Habilitar rastreo de componentes
Habilita el rastreo de componentes en la aplicación.
Habilitar rastreo de utilidades
Habilita el rastreo de utilidades de tiempo de ejecución en la aplicación.
Habilitar rastreo de macros
Efectúa el rastreo de la ejecución de las macros. Puesto que afecta al rendimiento del sistema, sólo debe utilizar este rastreo para depurar de macros.
Mostrar terminal de pantalla
Seleccione este recuadro para mostrar una vista de la aplicación de sistema principal en el terminal de pantalla mientras se ejecuta la aplicación de HATS.
Habilitar la grabación de simulación de sistema principal
Seleccione este recuadro para habilitar la grabación de simulación de sistema principal durante la ejecución. La grabación empieza la próxima vez que se inicie la aplicación de cliente enriquecido y finaliza cuando se cierre la sesión de sistema principal, por ejemplo, cuando el usuario pulse el elemento de desconexión en la barra de herramientas de la vista Transformación.

El archivo de rastreo se guarda en la carpeta de simulaciones de sistema principal en el entorno de cliente enriquecido. Por ejemplo, en el entorno Eclipse RCP en Windows en el que se guarda, <Directorio de instalación de Eclipse>\plugins\<versión_NombreAplicación>\profiles\hostsimulations\. En el entorno de Lotus Notes en Windows en el que se guarada, el directorio de instalación de <Lotus Notes>\Data\workspace\applications\eclipse\plugins\<versión_NombreAplicación>\profiles\hostsimulations\. En el entorno de Lotus Expeditor Client en Windows en el que se guarda, <Directorio de instalación de Lotus Expeditor Client>\shared\eclipse\plugins\<versión_NombreAplicación>\profiles\hostsimulations\. En el entorno de Lotus Expeditor Client en Linux en el que se guarda, /opt/IBM/Lotus/Expeditor/shared/eclipse/plugins/<versión_NombreAplicación>/profiles/hostsimulations/.

Los archivos de rastreo se nombran utilizando la siguiente plantilla, NombreAplicación_NombreConexión_Fecha(aaaammdd)_Hora(hhmmss)_Número, por ejemplo, MiAplicación_principal_20060101_134543_1.

Pestaña Salida de rastreo
Nombre de archivo
Nombre utilizado como plantilla para generar conjuntos exclusivos de archivos de rastreo para cada entorno de ejecución. El valor por omisión trace.txt.
Tamaño máximo de archivo
Especifica el tamaño máximo del archivo en KB. El valor por omisión es 10240.
Número máximo de archivos
Especifica el número máximo de archivos de rastreo. El valor por omisión es 5.
Botón Ver
Pulse este botón para que los archivos de rastreo se abran en el editor del sistema por omisión. Todos los archivos de rastreo que coincidan con el nombre de archivo de plantilla especificado se combinarán en un único archivo y se abrirán. Por ejemplo, si trace.txt es el nombre del archivo de plantilla, y trace1.txt, trace2.txt y trace3.txt están presentes, se combinarán en un único archivo, en el orden correcto, y se abrirán. Si no se configura ningún editor por omisión, aparece un mensaje de error.
Botón Borrar
Pulse este botón para que se le solicite si desea borrar el archivo de rastreo actual.
Pestaña Salida de mensajes
Nombre de archivo
Nombre utilizado como plantilla para generar conjuntos exclusivos de archivos de anotaciones cronológicas para cada entorno de ejecución. El valor por omisión messages.txt.
Tamaño máximo de archivo
Especifica el tamaño máximo del archivo en KB. El valor por omisión es 512.
Número máximo de archivos
Especifica el número máximo de archivos de rastreo. El valor por omisión es 2.
Botón Ver
Pulse este botón para que el archivo de anotaciones cronológicas actual se abra en el editor del sistema por omisión. Todos los archivos de anotaciones cronológicas que coincidan con el nombre de archivo de plantilla especificado se combinarán en un único archivo y se abrirán. Por ejemplo, si messages.txt es el nombre del archivo de plantilla, y messages1.txt, messages2.txt y messages3.txt están presentes, se combinarán en un único archivo, en el orden correcto, y se abrirán. Si no se configura ningún editor por omisión, aparece un mensaje de error.
Botón Borrar
Pulse este botón para que se le solicite si desea borrar el archivo de anotaciones cronológicas actual.
Pestaña Salida de simulación
Número máximo de archivos
Cuando el recuadro de selección Habilitar la grabación de simulación de sistema principal está seleccionado, este campo especifica el número máximo de archivos de salida de simulación. El valor por omisión es 10. Si un nuevo archivo de simulación excede el valor máximo, se suprime el archivo de simulación más antiguo.
Botón Recopilar
Pulse este botón para recopilar todos los artefactos que necesita IBM® Support para diagnosticar un problema. En el asistente Recopilar información sobre determinación de problemas, seleccione el recuadro de selección de la aplicación para la que desee recopilar información y especifique el archivo .zip de destino. En el archivo .zip de destino se recopilará la siguiente información:
Botón Restaurar valores por omisión
Si pulsa este botón, todos los valores del panel vuelven a los valores por omisión.
Botón Aplicar
Pulse este botón para guardar los valores en el archivo runtime.properties del plug-in de extensión de tiempo de ejecución.

Consideraciones y limitaciones de clientes enriquecidos de HATS

A continuación, se muestra una lista de consideraciones y limitaciones a tener en cuenta cuando se utilizan aplicaciones de cliente enriquecido de HATS: