Las pantallas de la aplicación host se identifican para el contenedor mediante puntos de referencia definidos en una configuración de contenedor. Los puntos de referencia especifican las acciones que deben tener lugar para las distintas regiones de la pantalla de la aplicación host y los eventos que deben desencadenar las acciones. A través de la configuración y sus puntos de referencia, el contenedor Host On-Demand permite a la aplicación compuesta intercambiar información con una aplicación host.

Configuración de contenedores Host On-Demand con el Editor de aplicaciones compuestas

Puede utilizar el Editor de aplicaciones compuestas para añadir el contenedor Host On-Demand a una aplicación compuesta, definir puntos de referencia y añadir acciones. Para añadir el contenedor, arrástrelo a la aplicación desde la carpeta Contenedores de la paleta de componentes.

Adición de acciones

Una vez que haya añadido el contenedor Host On-Demand a la aplicación y haya especificado la aplicación host a la que desea acceder, puede utilizar la barra de herramientas del Editor de aplicaciones compuestas para definir las acciones de intercambio de datos que deberían desencadenarse cuando se produzcan determinados eventos.

Configuración del contenedor Host On-Demand en los plugins

También puede configurar un plugin de contenedor Host On-Demand editando su archivo "plugin.xml". Este proceso se describe en general en la sección "Application configurations" de Developing Applications for Lotus Expeditor en el Information Center de IBM Lotus Expeditor. Tenga en cuenta estas tareas específicas cuando actualice plugin.xml.

Cree propiedades para cada campo de la aplicación host al que necesite acceder la aplicación compuesta.

Añada un elemento targetBuilder para especificar la configuración de la sesión almacenada en un archivo de propiedades externo, similar al que utiliza el bean de la sesión de Hosted On-Demand. Puede especificar una URL (por ejemplo, 'file://D:/session.properties') o un archivo de un paquete, en cuyo caso se debería asignar al atributo de expresión targetBuilder un valor con el formato 'bundle:/<nombre-simbólico-del-paquete>/<ruta>'; por ejemplo, 'bundle:/test.plugin/configuration/session.properties'. Para obtener una lista completa de las propiedades de sesión soportadas, consulte el Information Center de Host On-Demand (http://publib.boulder.ibm.com/infocenter/hodhelp/v10r0/index.jsp?topic=/com.ibm.hod.doc/doc/beans/com/ibm/eNetwork/beans/HOD/Session.html).

Nota Si utiliza el Editor de aplicaciones compuestas, las propiedades de sesión codificadas en base64 se almacenan en la preferencia del componente 'hod.properties'. El contenedor utiliza las propiedades de sesión definidas en esta preferencia si falta el atributo de expresión targetBuilder o tiene un valor vacío. Este es el mecanismo utilizado por las instancias del contenedor Host On-Demand genérico creado en el Editor de aplicaciones compuestas.

• Cree un elemento identificador de punto de referencia para definir una región de la pantalla que se debe utilizar para comparar con las expresiones de punto de referencia. Si no se define ningún identificador de punto de referencia, las expresiones de punto de referencia se comparan con el contenido completo de la pantalla.
• Cree los elementos de punto de referencia que sean necesarios para los eventos y las acciones requeridos.
• Añada expresiones de punto de referencia a los atributos de expresión de los elementos de punto de referencia. Las expresiones pueden ser valores sencillos, expresiones regulares o descripciones de pantalla más complejas almacenadas externamente. Para especificar una expresión regular, anteponga 'regex:' a la expresión de punto de referencia. Para crear una descripción de pantalla externa, utilice la sintaxis definida en la guía Host On-Demand macro programming guide (http://publib.boulder.ibm.com/infocenter/hodhelp/v10r0/index.jsp?topic=/com.ibm.hod.doc/doc/macro/macro.html), y utilice uno de los mecanismos siguientes para hacer referencia a ella desde la expresión de punto de referencia.
  • Una URL de archivo externo (por ejemplo, 'file://D:/pantalla.xml')
  • Un archivo de un paquete/plugin, cuya expresión tiene el formato 'bundle:/<nombre-simbólico-del-paquete>/<ruta> (por ejemplo, ('bundle:/test.plugin/screens/pantalla2.xml')
  • Una preferencia de componente, que almacene una descripción de pantalla codificada en base64. El nombre de la preferencia debe tener el formato 'hod.screen.<nombre>' y la expresión de punto de referencia debe tener el formato 'screen:<nombre>'. Este es el mecanismo utilizado por la ficha del editor de puntos de referencia del Editor de aplicaciones compuestas.
  Nota Para reemplazar la región especificada por el identificador de punto de referencia, anteponga '$<región>=' a la expresión del punto de referencia, donde <región> especifica la región nueva. El valor que sigue al prefijo puede ser un valor sencillo o una expresión regular.
• Defina los eventos que desencadenan las acciones necesarias para el componente Host On-Demand. El contenedor Host On-Demand soporta los eventos siguientes:
  • contentComplete: Este evento se produce cuando se reconoce una pantalla. Todas las acciones de este evento se ejecutan en serie.
  • dataChange: Este evento tiene lugar cuando entra un cambio de propiedad en el contenedor o cuando cambia una región de la pantalla.
  • viewInit: Este evento tiene lugar cuando se abre inicialmente el componente específico (la parte de vista).
  • viewClose: Este evento tiene lugar cuando se cierra el componente específico (la parte de vista).
• Especifique las acciones (publicar o recibir) que se deben realizar cuando tenga lugar cada evento. Para cada acción, especifique las propiedades a las que se aplica y los campos asociados (regiones de la pantalla).

  Represente las posiciones de pantalla con uno de los formatos siguientes:

  • Posición lineal '<posición lineal>' (por ejemplo, '1')
  • Coordenada de fila, columna: '<fila>,<columna>' (por ejemplo, '5,10')
  Represente las regiones de pantalla con uno de los formatos siguientes:
  • Región lineal: '<posición>:<longitud>' (por ejemplo, '1:20' o '1.1:20')
  • Región rectangular: <posición superior izquierda>-<posición inferior derecha> (por ejemplo, '1-160' o '1,1-2,80')
  Nota Cuando se configura un campo, el valor puede truncarse si sobrepasa el tamaño de la región de pantalla definida por el campo.

Para ampliar la funcionalidad del contenedor Host On-Demand, amplíe su clase de vista, com.ibm.rcp.composite.container.hod.view.HODAppView. Utilice el método getContainer para acceder a la instancia HODAppContainer. Utilice el método getECLPS para acceder al espacio de presentación, y el método getTerminal para acceder al bean del terminal. Si desea información detallada sobre las API de Host On-Demand, consulte el Information Center de Host On-Demand.

Si desea información detallada sobre cómo utilizar este contenedor, consulte la documentación del Editor de aplicaciones compuestas, la de Lotus Expeditor y el Information Center de Host On-Demand (http://publib.boulder.ibm.com/infocenter/hodhelp/v10r0/index.jsp?topic=/com.ibm.hod.doc/doc/beans/com/ibm/eNetwork/beans/HOD/Session.html).

Glosario