Utilización de objetos de integración

En este capítulo se describen los objetos de integración, que son beans Java™ que encapsulan interacciones con una aplicación de sistema principal. Los objetos de integración sólo están soportados por aplicaciones Web de HATS, incluidos los portlets de HATS.

Nota:
las variables globales y las plantillas no están soportadas para los objetos de integración utilizados en los portlets estándar de HATS.

Si ha utilizado IBM® WebSphere Host Publisher, ya estará familiarizado con la mayoría de las características de los objetos de integración, aunque necesitará aprender cómo se utilizan los objetos de integración en HATS. No es necesario ser un desarrollador experto de Host Publisher para crear y utilizar objetos de integración en HATS.

Si la aplicación de HATS va a transformar una sola aplicación de sistema principal, sin conexiones secundarias, no es necesario utilizar objetos de integración. Puede que sea necesario utilizar objetos de integración en el caso de que cualquiera de las siguientes sentencias sea verdadera:

Después de crear un objeto de integración, puede utilizarlo de muchas maneras:

Consulte la publicación HATS Web Application Programmer's Guide para obtener información sobre otras tareas avanzadas que se pueden ejecutar con objetos de integración. Algunas de las tareas descritas son:

Creación de un objeto de integración

Un objeto de integración se crea a partir de una macro. Siga los pasos descritos en el Macros y terminal de sistema principal para grabar una macro.

Pulse con el botón derecho del ratón en la macro en la vista Proyectos de HATS y seleccione Crear objeto de integración. El objeto de integración tendrá el mismo nombre que la macro. También puede establecer una preferencia en HATS para generar automáticamente un objeto de integración al grabar una macro. Pulse Ventana > Preferencias, expanda HATS en el árbol de la izquierda y pulse Objeto de integración. Seleccione el recuadro de selección Generar automáticamente un objeto de integración al guardar la macro y pulse Aplicar.

Al nombrar una macro utilizada para crear un objeto de integración, asegúrese de que sigue estos requisitos:

Notas:
  1. Los objetos de integración generados automáticamente siempre serán no encadenados.
  2. Si desea obtener información sobre la creación de objetos de integración al utilizar el soporte para DBCS, consulte Creación de un objeto de integración.

Los objetos de integración no pueden ser creados a partir de macros encadenadas. El encadenamiento de objetos de integración es completamente distinto del encadenamiento de las macros: cada objeto de integración de una cadena se ejecuta para completarse antes de que el siguiente objeto de integración de la cadena tome el control. El encadenamiento de macros, utilizando la acción ejecutar macro de HATS, termina la macro actual (la macro sobre la que se produce la acción ejecutar macro) y comienza a procesar la pantalla de macro especificada de la macro de destino. Si importa una macro de Host On-Demand que contiene el código <playmacro name="chainedMacroName"/>, sólo puede utilizar esta macro con las acciones ejecutar macro y realizar una transacción de macro de HATS. Consulte la publicación HATS Advanced Macro Guide para obtener más información sobre macros encadenadas.

Si se modifica una macro utilizando el editor de macros después de haber creado un objeto de integración a partir de esa macro concreta, hay que volver a generar el objeto de integración para que refleje el cambio con exactitud. Si está seleccionada la preferencia Generar automáticamente un objeto de integración al guardar la macro, el objeto de integración se actualizará automáticamente.

Para ver una lista de los objetos de integración que ha creado, pulse la pestaña Vista del proyecto Proyectos de HATS de HATS Toolkit y expanda el nombre del proyecto y, a continuación, vaya a Fuente > Objeto de integración y efectúe una doble pulsación en la carpeta para ver el contenido.

Nota:
la carpeta IntegrationObject bajo Fuente sólo es visible después de crear el primer objeto de integración.

Encadenamiento de objetos de integración

El encadenamiento de objetos de integración permite crear varios objetos de integración que pueden agruparse en una sola tarea principal dentro de la aplicación de Host Access Transformation Services. Cada objeto de integración ejecuta una subtarea y la tarea principal la lleva a cabo una cadena de objetos de integración. Al ejecutar la aplicación, los objetos de integración se ejecutan uno tras otro utilizando la misma conexión.

Al pulsar con el botón derecho del ratón en la macro para crear el objeto de integración, seleccione Crear objeto de integración encadenado. Luego especifique si el objeto de integración es el primero, el del centro o el último en la cadena. Puede haber más de un objeto de integración que ocupe la posición central en una cadena. Especifique las etiquetas que identifican los estados de inicio y de parada para este objeto de integración. No hay ninguna etiqueta de estado de inicio para un objeto de integración que sea el primero en su cadena y ninguna etiqueta de estado de parada para un objeto de integración que sea el último en su cadena. Las etiquetas de estado son necesarias para garantizar que los objetos de integración de una cadena se procesan en el orden correcto y con los datos correctos pasados.

En este apartado se describe el encadenamiento de los objetos de integración en detalle y muestra cómo utilizarlo en las aplicaciones de HATS.

Cómo se determina cuándo utilizar el encadenamiento de los objetos de integración

Para determinar cuántos objetos de integración son necesarios en la cadena, anote en una lista todas las tareas que sea necesario llevar a cabo. Por ejemplo, imagine una aplicación de sistema principal denominada verarchivos que, cuando se invoca, muestra una lista de archivos. En la lista de archivos, el usuario puede seleccionar cualquier archivo escribiendo 1 junto a su nombre, pulsar Intro y examinar a continuación su contenido. Aquí deben llevarse a cabo dos tareas:

  1. Obtener la lista de archivos que deben mostrarse al usuario.
  2. Recuperar los detalles de un archivo seleccionado.

Se precisan dos macros porque el usuario debe intervenir para poder ejecutar la segunda macro. Para ejecutar la segunda macro es necesaria la intervención del usuario. El primer paso para separar las dos tareas en objetos de integración individuales será definir dónde es necesaria la intervención del usuario.

Si el usuario tiene varias opciones y cada una origina una acción de sistema principal distinta, cada opción debe ser un objeto de integración distinto. Entonces podrá unir dinámicamente los objetos de integración, en función de las opciones seleccionadas. Un ejemplo es un menú de cinco elementos. Si el usuario puede seleccionar cualquiera de las cinco opciones, se debe crear cada selección como un objeto de integración independiente.

Una vez conocida la cantidad de tareas distintas incluidas en la aplicación, podrá decidir cómo el encadenamiento afectará a la aplicación. Si dispone de más de dos tareas, el encadenamiento puede ayudar a mejorar el tiempo de respuesta de la aplicación o a reducir la cantidad de grabación de macro que debe realizarse, reduciendo a la vez la complejidad de los objetos de integración.

Utilización del encadenamiento de los objetos de integración

Un objeto de integración de una cadena deja la conexión en un estado (en una pantalla concreta). Una vez que finaliza la ejecución de un objeto de integración, puede ejecutarse otro objeto de integración que empiece en dicho estado (es decir, en dicha pantalla).

El encadenamiento puede utilizarse para dividir una aplicación compleja en varias tareas y que cada una de ellas esté representada por un objeto de integración. Debe asegurarse de que el orden de los objetos de integración sea correcto.

Por ejemplo, si tiene tres objetos de integración en una cadena (A, B y C), primero debe utilizar A, después B y después C. Si se invoca el objeto de integración C antes de invocar el objeto de integración B, cuando C solicita su conexión, ésta no estará disponible en el estado correcto y el objeto de integración no se ejecutará.

Figura 64. Etapas de la conexión con encadenamiento
etapas de la conexión con encadenamiento

En la Figura 64 se muestra el recorrido de una conexión a través de la ejecución de tres objetos de integración. El objeto de integración A se configura como el primero, el objeto de integración B como el del centro y el objeto de integración C como el último. Los datos del estado de la conexión representan la conexión y la etiqueta de estado del último objeto de integración ejecutado.

  1. Cuando se empieza a ejecutar el objeto de integración A, éste recupera la conexión especificada en la macro. Si está habilitada la pantalla de registro y hay una conexión disponible, la conexión ya estará activa. Si está habilitada la pantalla de registro, pero no hay ninguna conexión disponible, se crea la conexión y se ejecuta la macro de conexión (si se especifica). Si la pantalla de registro está inhabilitada, se crea una conexión y se ejecuta la macro de conexión (si se especifica).
  2. El objeto de integración A ejecuta la macro asociada y, a continuación, guarda la conexión y su estado actual para la siguiente invocación. Este estado se debería haber definido como etiqueta de estado de parada durante el encadenamiento de objetos de integración.
  3. Cuando se empieza a ejecutar el objeto de integración B, éste recupera una conexión y su estado de los datos del estado de la conexión porque es el objeto de integración del centro. Se debe haber definido la etiqueta de estado de inicio del objeto de integración B como etiqueta de estado de parada del objeto de integración A, lo que permite el encadenamiento de estos objetos de integración.
  4. Al finalizar la ejecución del objeto de integración B, la conexión y su estado se guardan en los datos del estado de la conexión.
  5. El objeto de integración C también recupera la conexión de los datos del estado de la conexión. Cuando se empieza a ejecutar el objeto de integración C, éste recupera una conexión y su estado de los datos del estado de la conexión porque es el último objeto de integración. Se debe haber definido la etiqueta de estado de inicio del objeto de integración C como etiqueta de estado de parada del objeto de integración B, lo que permite el encadenamiento de estos objetos de integración. Los objetos de integración que ocupan el último lugar en la cadena no tienen etiquetas de parada porque siempre se devuelve la conexión.
  6. Cuando está habilitada la pantalla de registro, la conexión vuelve a la agrupación; de lo contrario, se ejecuta la macro de desconexión (si se especifica) y la conexión finaliza.
Nota:
se accede a los valores de la pantalla de registro en la pestaña Macro de los valores de conexión. Debe habilitar la agrupación para que esté disponible el valor pantalla de registro. Si desea obtener más información, consulte Editor de conexiones.

Para crear una aplicación mediante el encadenamiento de objetos de integración con HATS, primero debe crear los objetos de integración y luego crear las páginas Web a partir de los objetos de integración.

Para crear la aplicación, efectúe estos pasos:

  1. Grabar macros.
  2. Crear objetos de integración encadenados a partir de cada macro.
  3. Crear páginas Web para cada objeto de integración.
Grabar una macro

Puede grabar macros en HATS Toolkit utilizando el terminal de sistema principal de HATS. En la pantalla del terminal de sistema principal de HATS, pulse el icono Grabar macro. Si desea obtener más información sobre la grabación de macros, consulte Iconos relacionados con las macros.

Repita estos pasos para cada objeto de integración que desee crear.

Crear objetos de integración a partir de cada macro
Después de crear todas las macros, vaya a la pestaña Vista del proyecto de HATS de HATS Toolkit, expanda el nombre del proyecto y abra la carpeta Macros.

Pulse con el botón derecho del ratón en cada una de las macros y seleccione Crear objeto de integración encadenado. Después deberá seleccionar la posición que ocupa en la cadena de objetos. Las opciones son Primero, Centro o Último. Si selecciona Primero, tendrá el estado de parada durante la configuración del encadenamiento de objetos de integración. Si selecciona Centro, tendrá el estado de inicio o el estado de parada. El objeto que ocupa el Último lugar en la cadena de objetos utiliza el estado de inicio.

Es necesario efectuar este proceso para todos los objetos de integración que forman parte de la cadena.

Crear páginas Web a partir de cada objeto de integración
Después de crear los objetos de integración, cree las páginas Web. Si desea obtener más información sobre la creación de páginas Web a partir de objetos de integración, consulte Creación de páginas Web a partir de un objeto de integración.

Depuración de aplicaciones que utilizan el encadenamiento de los objetos de integración

Aunque el encadenamiento de objetos de integración es una herramienta potente para modelar las aplicaciones de sistema principal más complejas, debe tener cuidado cuando ensamble las aplicaciones. Existe el riesgo de crear una aplicación Java EE con objetos de integración que se invoquen fuera de la secuencia; por lo tanto, debe conocer los errores que se reciben en el servidor cuando esto ocurre.

Si los objetos de integración se encadenan incorrectamente, surgirán problemas al ejecutar el objeto de integración. A continuación se muestran los mensajes de error que podrán aparecer en el servidor y cómo depurarlos.

HPS5075 Se ha recibido STATE_PLAY_ERROR mientras se reproducía la macro en el archivo zzz.macro
Este error se produce cuando no se puede ejecutar una macro porque no puede encontrar coincidencia con la pantalla actual. Esto puede suceder si se invoca en el orden correcto un objeto de integración encadenado (se encontró y pudo utilizar una conexión en una cadena específica), pero la macro no puede ejecutarse. Puede ser un problema si las etiquetas de inicio y parada son iguales, o son las mismas para dos objetos de integración, y los objetos de integración se invocan en un orden que no es el lógico.
HPS5035 No hay objeto de fuente de datos {0} en HttpSession. Una causa posible es la utilización de varios navegadores desde una sola máquina con una aplicación encadenada. Consulte la documentación para obtener más información
Este error se produce cuando un objeto de integración con una etiqueta de estado de inicio, como estado de último objeto de integración, no puede recuperar la conexión ni su estado porque su etiqueta de estado de inicio no coincide con la etiqueta de estado de parada del objeto de integración anterior.

Si esto sucede, determine el motivo si el objeto de integración se está invocando en un orden incorrecto.

Creación de páginas Web a partir de un objeto de integración

Puede crear una JSP a partir de cualquier objeto de integración. Hay tres métodos para crear estas páginas, denominados Modelo 1, JSF y Struts. Los apartados siguientes describen estas tres soluciones y cómo crear páginas con ellas.

Creación de páginas Web del modelo 1

El método de HATS tradicional para crear una JSP se denomina Modelo 1.

Nota:
Es el único enfoque soportado para portlets estándar de HATS.

En este modelo, una sola JSP contiene:

En la vista Proyectos de HATS, pulse con el botón derecho del ratón en el nombre de un objeto de integración y seleccione Crear páginas Web del modelo 1. Especifique los nombres de la página de entrada y de salida junto con el destino o acepte los nombres por omisión creados a partir del nombre del objeto de integración. También puede especificar las Opciones de generación de página seleccionando Añadir a archivos existentes o Grabar encima de archivos existentes. Pulse Siguiente al terminar sus selecciones.

Al crear páginas Web del Modelo 1, se definirán dos páginas: una página de entrada, que recopila los datos que necesita el objeto de integración y una página de salida, que presenta los resultados después de ejecutar el objeto de integración.

En la página Definir entradas, se puede definir un control de entrada para cada propiedad de entrada. Para cambiar un control, seleccione una propiedad de entrada y pulse Editar. Puede añadir el texto destacado para el control y, si es necesario, configurar el control deseado. En lugar de utilizar un control de entrada, puede elegir establecer la propiedad de entrada con el valor de una variable global. También tiene la opción de almacenar el valor de la propiedad de entrada como una variable global (las variables globales utilizadas por objetos de integración se comparten). Al ejecutar la página de entrada, ésta no pasa el control directamente a la página de salida, sino que lo devuelve a la aplicación de HATS permitiendo establecer las variables globales y llevar a cabo otras acciones cuando sea necesario.

Nota:
si la macro no tiene solicitudes, no existirá una página de entrada.

En la página Definir salidas, se seleccionan las propiedades de salida del objeto de integración que se desean mostrar. Para cambiar un control, seleccione una propiedad de salida y pulse Editar. Puede añadir el texto inicial para el control. La JSP de salida incluye código para inicializar el objeto de integración, establecer las propiedades del objeto de integración a partir de variables globales, ejecutar el objeto de integración y mostrar la salida del objeto de integración.

Las páginas creadas van en la carpeta Contenido Web/Páginas de Modelo 1 de la vista Proyectos de HATS. Para editar una página Web e invocar el Page Designer, efectúe una doble pulsación en el nombre de la página.Para probar las páginas, pulse con el botón derecho del ratón en la página de entrada (o la página de salida si no hay entradas) y seleccione Depurar en servidor o Ejecutar en servidor.

Nota:
cuando utilice páginas Web del modelo 1 para los objetos de integración en un proyecto de portlet estándar de HATS, tenga en cuenta las consideraciones siguientes:

Creación de páginas Web Struts

Si ha instalado la característica Struts Tools de Rational SDP, HATS permite utilizar Struts para crear páginas Web a partir de objetos de integración.

Nota:
este método no está soportado para los portlets estándar de HATS.

En la vista Proyectos de HATS, pulse con el botón derecho del ratón en el nombre de un objeto de integración y seleccione Crear páginas Web Struts. Especifique los nombres para las páginas de entrada y salida, o acepte los nombres por omisión creados a partir del nombre del objeto de integración. Pulse Finalizar.

Al crear páginas Web Struts, HATS genera cinco archivos nuevos:

Clase Action de Struts
Es la clase principal. Crea una instancia del objeto de integración, establece los objetos de integración con los valores de la clase ActionForm, establece el nombre de la agrupación del objeto de integración y ejecuta el objeto de integración. A continuación se dirige a la JSP de salida o, si existe un error, vuelve a la unidad ejecutable de HATS y deja que ésta maneje el error. El desarrollador no debe modificar esta clase.
Clase ActionForm
Esta clase contiene métodos set y get para cada entrada de la JSP de entrada. Se envía la JSP del servlet Struts, que crea una instancia de la clase ActionForm y establece todas sus propiedades basándose en el formulario JSP de entrada sometido. Esta clase la utiliza la clase Action para establecer todas las propiedades de los objetos de integración. Si añade o elimina propiedades de entrada de la JSP de entrada, debe añadir o eliminar de este archivo los métodos set y get coincidentes.
JSP de entrada
La JSP de entrada contiene un formulario HTML Struts que enviará la petición al controlador Struts, que crea una clase ActionForm y reenvía la petición a la clase Action correspondiente. Si el objeto de integración no necesita ninguna entrada o las entradas proceden de distintas fuentes, como las variables globales, se creará una JSP de entrada vacía que sólo contiene el formulario HTML. Se creará la página de entrada en la carpeta Páginas Struts. Para probar las páginas, abra la carpeta y localice la página creada. Pulse con el botón derecho del ratón en la página y seleccione Ejecutar en servidor.
JSP de salida
La JSP de salida muestra las propiedades de salida del objeto de integración. Esta página es parecida a la JSP de salida del modelo 1.
WebDiagram
Este archivo muestra el flujo y la lógica de las páginas Web basadas en Struts. Consulte la documentación de herramientas de Struts en Rational SDP para obtener más información sobre cómo modificar el archivo WebDiagram.

HATS añade también una correlación de acciones al archivo struts-config.xml para asociar la clase Action con la clase ActionForm.

Struts se desarrolló como parte del proyecto Jakarta de Apache Software Foundation. Si desea obtener información detallada sobre Struts, consulte http://jakarta.apache.org/struts y el contenido de la ayuda de Rational SDP.

Creación de páginas Web JSF

JavaServer Faces (JSF) es una infraestructura de desarrollo de interfaces de usuario (UI) para aplicaciones Web que se ejecuten en un servidor Java. Puede crear rápidamente aplicaciones Web ensamblando componentes de UI reutilizables en una página. Una vez creadas las páginas Web JSF, puede utilizar herramientas como el Page Designer y la paleta para efectuar modificaciones.

Nota:
Este método no está soportado para los portlets estándar de HATS o los portlets de IBM de HATS.

En la vista Proyectos de HATS, pulse con el botón derecho del ratón en el nombre de un objeto de integración y seleccione Crear páginas Web JSF. Especifique los nombres para las páginas de entrada y salida, así como el destino, o acepte los nombres por omisión creados a partir del nombre del objeto de integración. También puede Grabar encima de archivos existentes seleccionado el recuadro. Pulse Siguiente al terminar sus selecciones.

Al crear páginas Web JSF, se definen dos páginas: una página de entrada, que recopila los datos que necesita el objeto de integración y una página de salida, que presenta los resultados después de ejecutar el objeto de integración.

Para la página de entrada, se puede definir un control de entrada para cada propiedad de entrada. Para cambiar un control, seleccione una propiedad de entrada y pulse Editar. Puede añadir el texto destacado para el control y, si es necesario, configurar el control deseado. Pulse Siguiente.

Para la página de salida, se seleccionan las propiedades de salida del objeto de integración que se desean mostrar. Para cambiar un control, seleccione una propiedad de salida y pulse Editar. Puede añadir el texto inicial para el control. Pulse Finalizar.

Las páginas creadas van en la carpeta Contenido Web/Páginas JSF de la vista Proyectos de HATS. Para editar una página Web e invocar el Page Designer, efectúe una doble pulsación en el nombre de la página.Para probar las páginas, pulse con el botón derecho del ratón en la página de entrada (o la página de salida si no hay entradas) y seleccione Depurar en servidor o Ejecutar en servidor.

BasicIOErrorPage.jsp y AdvancedIOErrorPage.jsp

BasicIOErrorPage es la página de error por omisión que utilizan las páginas JSP que controlan los objetos de integración. Si se produce un error, éste devolverá al navegador información básica sobre la naturaleza del error. En este proceso se descarta automáticamente la conexión del programa de fondo.

AdvancedIOErrorPage.jsp deja pasar la conexión al servlet de entrada de HATS para una transformación por omisión si se ha creado la conexión a partir de la definición de conexión por omisión. Este proceso permite interactuar con la conexión del programa de fondo y tal vez determinar la causa del error. La transformación por omisión también proporciona la capacidad de desconectar la conexión. Básicamente, AdvancedIOErrorPage.jsp le ofrece un mayor control sobre el proceso cuando un objeto de integración encuentra un error.

Puede encontrar estas páginas de error en la vista Navegador, en la carpeta Contenido Web del proyecto.

Trabajo con objetos de integración que están en JSP

Estas funciones de herramientas de HATS se aplican a la utilización de objetos de integración en JSP. Para seleccionar los elementos indicados a continuación, utilice el menú Herramientas de HATS en la barra de menús de HATS Toolkit.

Insertar propiedades de objeto de integración

Puede añadir entrada y salida de objeto de integración a su JSP de transformación.

Entrada

Seleccione Insertar propiedades de objeto de integración > Entrada cuando desee añadir alguna entrada de objeto de integración a una JSP. En la página Seleccionar clase de objeto de integració, escriba el nombre de la clase del objeto de integración que desee utilizar y la página de destino que se muestra cuando el usuario envía el formulario de entrada. Pulse Siguiente. En la página Definir entradas, para cambiar un control, seleccione una propiedad de entrada y pulse Editar. Aquí se podrá definir el texto inicial, seleccionar un control de entrada apropiado y configurarlo si es necesario, así como almacenar el valor como una variable global.

Salida

Seleccione Insertar propiedades de objeto de integración > Salida cuando desee añadir alguna salida de objeto de integración a una JSP. En la página Seleccionar clase de objeto de integració, escriba el nombre de la clase del objeto de integración que desee utilizar y pulse el recuadro de selección Insertar métodos de transacción de objeto de integración para incluir métodos de transacción que ejecutan objetos de integración. Pulse Siguiente. En la página Definir salidas, para cambiar un control, seleccione una propiedad de salida y pulse Editar. Aquí se podrá definir el texto inicial, seleccionar un control de salida apropiado.

Una variable global de HATS contiene un valor que puede utilizarse para pasar información de un objeto de HATS a otro. Si desea pasar los datos de salida del objeto de integración a otro objeto de HATS, debe añadir código a la JSP de salida utilizada para manejar el objeto de integración. Debe añadir el código después de ejecutar satisfactoriamente el objeto de integración; por ejemplo:

<%
IOGV.setGlobalVariableString(session, "exampleGV", 
exampleIO.getOutputData());
%>

En este ejemplo, a la variable global compartida de nombre exampleGV se le asigna el valor de la propiedad OutputData del objeto de integración exampleIO.

La variable global utilizada en un entorno de objetos de integración debe definirse como variable global compartida. El código del ejemplo crea la variable global compartida si no existe.

Insertar Reenviar a aplicación HATS

Seleccione Insertar Reenviar a aplicación HATS para añadir un botón a la transformación que reenvíe la información de control de JSP de vuelta a la aplicación de HATS (ya sea una aplicación Web o un portlet estándar) que inició el usuario. Por ejemplo, puede que desee devolver el control a la aplicación de HATS después de que una JSP controle un objeto de integración y ejecute una tarea especificada. Para editar los atributos de este botón en la vista Diseño, pulse con el botón derecho del ratón en el botón y seleccione Atributos.