Una macro es un script XML que define un conjunto de pantallas. Cada pantalla incluye una descripción de la pantalla, las acciones que deben llevarse a cabo para dicha pantalla así como la pantalla o las pantallas que pueden presentarse después de realizar las acciones.
HATS da soporte a la personalización basada en macros para agilizar y personalizar el proceso de las aplicaciones de sistema principal. Las macros se pueden utilizar para las funciones siguientes:
Puede utilizar macros para realizar las siguientes funciones:
Los desarrolladores también pueden utilizar las macros de solicitud para proporcionar los valores constantes o los valores obtenidos de variables globales.
Las macros grabadas o importadas en HATS Toolkit se guardan en un archivo de macro de HATS (.hma). Para ver las macros definidas en el proyecto, expanda el nodo Macros en la vista Proyectos de HATS de HATS Toolkit.
HATS proporciona tres editores distintos que puede utilizar para ver y modificar macros de HATS, el Editor de macros, el Editor de macros avanzado y el Editor de macros visual. El Editor de macros visual es el editor por omisión para las macros de HATS. Cuando efectúa una doble pulsación en el nombre de una macro, se abre el Editor de macros visual. Si desea obtener más información sobre el Editor de macros visual, consulte el capítulo Visual Macro Editor, de la publicación HATS Advanced Macro Guide.
Para abrir el Editor de macros, pulse el botón derecho del ratón en el nombre de la macro y seleccione Abrir con > Editor de macros.
El Editor de macros avanzado se abre desde la página Visión general del Editor de macros. Si desea obtener más información sobre el Editor de macros avanzado, consulte el capítulo Advanced Macro Editor, de la publicación HATS Advanced Macro Guide.
En los siguientes apartados se describen cada una de las pestañas del editor de macros.
La pestaña Visión general del editor de macros resume la información general sobre la macro como, por ejemplo, el nombre, la descripción, y la fecha y la hora de la última modificación. Los elementos que se pueden modificar en esta pestaña son la descripción de la macro, el tiempo de pausa, el tiempo de espera y la conexión.
Tiempo de pausa es el número de milisegundos de retardo después de realizar cada acción. Tiempo de espera es el número de milisegundos que debe esperar antes de terminar la macro y Conexión permite seleccionar qué conexión desea utilizar en el menú desplegable.
Los botones Abrir terminal de sistema principal y Editor avanzado se describen en más detalle a continuación.

Pulse Abrir terminal de sistema principal para crear o trabajar con la macro utilizando el terminal de sistema principal. Una vez abierto el terminal, puede utilizar los iconos de la barra de herramientas para grabar y crear la macro.
También puede utilizar el Terminal de sistema principal para editar una macro grabada previamente. Para ello, pulse con el botón derecho del ratón en los nodos del árbol de macros y seleccione Editar. Si selecciona una pantalla para editarla, se iniciará el editor de criterios de reconocimiento de pantalla, desde donde puede modificarla. Si edita alguno de los datos que ha entrado en la pantalla, se abrirá una pantalla donde podrá cambiar o modificar la entrada. Si edita el nodo Pantallas siguientes, aparecerá una lista de las pantallas disponibles para que elija la siguiente. Seleccione en la lista el orden en que desea que aparezcan las pantallas.
Para depurar los errores de reproducción de las macros, hay cuatro iconos en la barra de herramientas del Terminal de sistema principal. Los iconos están diseñados para ayudarle a avanzar paso a paso por una macro, donde un paso se define como la ejecución de una acción o el reconocimiento de una pantalla. Los iconos son Recorrer todo, Recorrer principal, Recorrer hasta retorno y Reanudar.
Cada uno de los iconos tiene teclas de función asociadas. Dependiendo de qué vista esté activa, (el Navegador de macros o el Terminal de sistema principal), las teclas F5, F6, F7 y F8 funcionarán de forma distinta. Por ejemplo, si está activo el Navegador de macros, pulsar F5 ejecutará Recorrer todo, y pulsar F6 ejecutará Recorrer principal. Si está activo el Terminal de sistema principal, pulsar F5 o F6 enviará la tecla AID al sistema principal. Si desea obtener más información sobre estos y otros iconos relacionados con macros, consulte Iconos relacionados con las macros.
La Tabla 4 muestra los iconos de macro que aparecen en la barra de herramientas de la pantalla del terminal de sistema principal.
A continuación se incluye una lista de iconos relacionados con las macros en la barra de herramientas del Terminal de sistema principal:
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. Aparece el asistente Grabar macro, que permite seleccionar el proyecto de destino, dar un nombre y una descripción a la macro, y ver dónde se guarda. La opción, Crear capturas de pantalla automáticamente mientras se graba, permite especificar que se cree automáticamente una captura de pantalla para cada pantalla por la que se navega al grabar la macro. Estas capturas de pantalla se pueden utilizar en el Editor de macros visual si más adelante realiza cambios en la macro. Esta opción está seleccionada por omisión. Pulse Finalizar cuando haya especificado estos elementos.
Aparece la ventana Definir criterio de reconocimiento de pantalla, ya que HATS obliga a la primera pantalla a tener el reconocimiento de pantalla definido de forma explícita. A continuación, puede utilizar la pantalla del terminal de sistema principal de HATS para navegar en la aplicación de sistema principal a la pantalla que desee.
Si ya tiene una macro abierta en el terminal de sistema principal de HATS, al pulsar el icono Grabar macro se le preguntará si desea grabar una macro nueva o añadir contenido a la macro abierta. Si añade contenido a la nueva macro, comenzará la grabación de la macro y las acciones se añadirán a la macro actual. La ubicación de la macro donde comienza la grabación depende de lo seleccionado en el árbol Navegador de macros de la izquierda, y de si la pantalla de terminal actual coincide con los criterios de reconocimiento de pantalla del nodo seleccionado. En concreto:
No cree una macro cuyo único paso sea insertar una extracción o añadir una solicitud. Si lo hace, cuando el usuario suministre un valor, la página no cambiará y no habrá forma de que el usuario pase a otra página. Si una macro no vuelve al sistema principal, esperará hasta que se agote el tiempo de espera.
Puede establecer criterios de reconocimiento de pantalla que HATS utiliza para relacionar pantallas de sistema principal. Las pantallas de sistema principal se pueden reconocer mediante cualquier combinación de criterios, incluidos cuántos campos de entrada o campos totales hay en la pantalla, las coordenadas de la posición del cursor y las series de texto en la pantalla dentro de un rectángulo definido o en cualquier otro punto de la pantalla. Si desea obtener más información, consulte Criterios de reconocimiento de pantalla o Pantalla de inicio.
Si desea que la macro solicite información al usuario, pulse Añadir acción de solicitud para mostrar el asistente Añadir acción de solicitud. Puede dar un nombre y un valor por omisión a la solicitud. Si la información que proporciona el usuario, por ejemplo, una contraseña, no debe aparecer en la pantalla principal, pulse el recuadro de selección Entrada protegida por contraseña.
Los campos Fila y Columna de la sección Posición del asistente definen dónde se coloca la información de solicitud proporcionada por el usuario en la pantalla de sistema principal. Si coloca el cursor en un punto de la pantalla de sistema principal, por ejemplo, en el campo de una contraseña, antes de empezar a grabar la macro, los campos Fila y Columna se rellenan con esos valores. La sección Manejar solicitud de macro del asistente permite determinar cómo se procesa la solicitud. Puede seleccionar uno de los siguientes botones de selección:
Para proyectos de cliente enriquecido de HATS, puede especificar un manejador de macros personalizado o seleccionarlo en la lista de manejadores de macros personalizados definidos en el proyecto de cliente enriquecido para solicitar al usuario la información necesaria, e incluir un botón para que el usuario someta la información. Con HATS se suministra un manejador de macros por omisión denominado DefaultMacroHandler. Para encontrar este archivo en la vista Proyectos de HATS, expanda el nombre del proyecto y, a continuación, Contenido de cliente enriquecido > Manejadores de sucesos de macro. Si desea crear su propio manejador, asegúrese de devolver el control a la unidad ejecutable de HATS llamando a los métodos createButtonArea() y createButtons() en el método render() del manejador de macros personalizados. Se llama a estos métodos en la implementación por omisión del método RcpMacroHandler.render(). Si desea obtener más información sobre RcpMacroHandler, consulte HATS RCP API Reference del centro de información de HATS en http://publib.boulder.ibm.com/infocenter/hatshelp/v75/index.jsp?topic=/com.ibm.hats.doc/doc/rcpjavadoc/index.html.
Si un valor de solicitud se basa en una variable global establecida por una extracción y se establece promptall en true, la acción extraer no se ejecuta antes de recuperar los valores de las solicitudes. Como consecuencia, la variable global utilizada por la solicitud no contiene un valor. Si utiliza variables globales con extracciones y solicitudes, debe establecer promptall en false.
Los objetos de integración no acceden a las variables globales directamente. En su lugar las páginas de entrada y salida del objeto de integración recuperan el valor de la variable global y la establecen en el objeto de integración antes de ejecutarlo. Los objetos de integración sólo pueden acceder a las variables globales compartidas .
Pulse Aceptar cuando termine de hacer las selecciones.
Si desea que la macro extraiga información de la pantalla de sistema principal, seleccione un área en la pantalla de sistema principal y pulse Añadir acción extraer para visualizar el asistente Añadir acción extraer. Puede especificar un nombre para la extracción. Los campos Fila de inicio, Columna de inicio, Fila final y Columna final de la sección Posición del asistente definen desde dónde se extrae la información. Si marca una región de la pantalla de sistema principal con un rectángulo y pulsa Añadir acción extraer, los campos de la sección Posición se rellenan con los valores cuando aparece el asistente Añadir acción extraer.
Puede especificar el Formato de extracción como uno de los siguientes valores:
Especifica que el texto extraído debe guardarse como serie horizontal de caracteres. Esta opción tiene soporte para objetos de integración, variables globales y manejadores de macros.
Especifica que el texto extraído debe guardarse como una lista vertical de series. Esta opción tiene soporte para variables globales y manejadores de macro. En un objeto de integración, una lista de series se trata como una serie continua.
Especifica que el texto extraído debe guardarse como una tabla de series horizontales y verticales, con filas y columnas. Esta opción tiene soporte para objetos de integración y manejadores de macros. En una variable global, las series extraídas como una tabla pasan a ser una serie continua.
Utilice este campo para cambiar la cabecera de la columna seleccionada.
Al expandir una columna se desplazan los caracteres entre las columnas. Cuando resalta una columna, el botón Izquierda mueve el último carácter de cada línea de la columna situada a la izquierda de la columna resaltada para convertirlo en el primer carácter de cada línea de la columna resaltada. El botón Derecha mueve el primer carácter de cada línea de la columna situada a la derecha de la columna resaltada para convertirlo en el último carácter de cada línea de la columna resaltada.
Al reducir una columna se desplazan los caracteres entre las columnas. Cuando resalta una columna, el botón Izquierda mueve el primer carácter de cada línea de la columna resaltada para convertirlo en el último carácter de cada línea de la columna situada a la izquierda de la columna resaltada. El botón Derecha mueve el último carácter de cada línea de la columna resaltada para convertirlo en el primer carácter de cada línea de la columna situada a la derecha de la columna resaltada.
Utilice este botón para fusionar las dos columnas resaltadas en una sola columna. Los caracteres de las columnas resaltadas se unen en una columna.
Utilice este botón para dividir una columna resaltada en dos columnas separadas. los caracteres de la columna resaltada se dividen de forma equitativa entre las dos nuevas columnas. Si hay un número impar de caracteres, la columna izquierda contendrá un carácter más que la columna derecha.
Para consideraciones al utilizar esta función con el soporte para DBCS, consulte Grabación de una macro.
La sección Manejar extracción de macro del asistente permite determinar cómo se procesa la solicitud. Puede seleccionar los siguientes recuadros de selección:
Para proyectos de cliente enriquecido de HATS, puede especificar un manejador de macros personalizado o seleccionarlo en la lista de manejadores de macros personalizados definidos en el proyecto de cliente enriquecido para solicitar al usuario la información necesaria, e incluir un botón para que el usuario someta la información. Con HATS se suministra un manejador de macros por omisión denominado DefaultMacroHandler. Para encontrar este archivo en la vista Proyectos de HATS, expanda el nombre del proyecto y, a continuación, Contenido enriquecido > Manejadores de sucesos de macro. Si desea crear su propio manejador, asegúrese de devolver el control a la unidad ejecutable de HATS llamando a los métodos createButtonArea() y createButtons() en el método render() del manejador de macros personalizados. Se llama a estos métodos en la implementación por omisión del método RcpMacroHandler.render(). Si desea obtener más información sobre RcpMacroHandler, consulte HATS RCP API Reference del centro de información de HATS en http://publib.boulder.ibm.com/infocenter/hatshelp/v75/index.jsp?topic=/com.ibm.hats.doc/doc/rcpjavadoc/index.html.
Los objetos de integración no extraen directamente a las variables globales. En su lugar, la página de salida del objeto de integración recupera los datos del objeto de integración una vez que se ha ejecutado, y los establece en las variables globales. Recuerde que los objetos de integración sólo pueden acceder a las variables globales compartidas.
Pulse Aceptar cuando termine de hacer las selecciones.
Si desea grabar un bucle en la macro, pulse Grabar un bucle y desplácese hasta la pantalla donde empezará el bucle. Pulse Siguiente para definir los criterios de reconocimiento de la primera pantalla. Pulse Siguiente para definir criterios adicionales o Finalizar para volver al terminal principal. En el terminal principal, realice las acciones que se ejecutarán en cada ciclo del bucle y pulse Siguiente. Para determinar cómo finalizará el bucle, seleccione Terminar cuando se reconozca una sola pantalla o Terminar después de un número fijo de iteraciones y entre el número de bucles debajo. Pulse Siguiente y desplácese hasta la última pantalla del bucle y pulse Finalizar para completar el bucle.
Este icono le permite mostrar u ocultar el área de teclado del terminal.
El icono Mostrar OIA textual (OIA: área de información del operador) permite ver la posición exacta de fila y columna del cursor en la pantalla del terminal. También indica si la entrada está inhibida o no.
Para ver el aspecto de la pantalla de sistema principal actual transformada por el servidor, pulse la pestaña Vista previa de pantalla de sistema principal en la parte superior de la venta del terminal de sistema principal. La pantalla de vista previa mostrará la pantalla de sistema principal en la que está como una página Web.
La primera vista previa de la pantalla de sistema principal se aplica a cualquier personalización de pantalla definida para la pantalla actual. Si no hay personalizaciones de pantalla definidas para la pantalla actual, se aplican a la pantalla las normas de la plantilla del nivel de proyecto y las normas de representación por omisión.
La vista previa de la pantalla de sistema principal aplica el orden de personalizaciones de pantalla indicado en la pestaña Sucesos de los Valores del proyecto. Tan pronto como encuentra una coincidencia de reconocimiento de pantalla le muestra la pantalla transformada por la transformación definida en esa personalización de pantalla (si existe). Si no hay coincidencia, se muestra la transformación por omisión.
La vista previa de la pantalla de sistema principal no procesará ninguna personalización de pantalla definida en la lista de pantallas siguiente. Las pantallas siguientes no se procesan en la vista previa de la pantalla de sistema principal. Si desea obtener más información, consulte Pantalla siguiente.
También puede pulsar Editor avanzado en la pestaña Visión general para iniciar las características avanzadas del editor de macros de HATS y modificar los valores de la macro. Se abre una ventana independiente para el editor de macros con las siguientes pestañas:
Si desea obtener más información sobre las características avanzadas del editor de macros, consulte la publicación HATS Advanced Macro Guide.
La pestaña Solicitudes y extracciones del editor de macros muestra una lista de las solicitudes y las extracciones configuradas de la macro, y cómo se manejan cuando se ejecuta la macro. Para editar las propiedades específicas de HATS de una solicitud o extracción, selecciónela en la tabla y pulse Editar.
La pestaña Fuente muestra los códigos que hay en el archivo nombre_macro.hma para todos los atributos y valores de la macro, donde nombre_macro es el nombre que le ha dado a la macro al crearla o importarla. Si realiza cambios en otras pestañas con el editor de proyectos, los códigos y los atributos que aparecen en el archivo fuente cambiarán para reflejar esos cambios. También puede hacer cambios directamente en los códigos y los atributos del archivo fuente, y se reflejarán en las pestañas correspondientes del editor de macros.
Las solicitudes y extracciones aparecen en el archivo fuente de macro en el orden en que las haya grabado. Además, cuando abre la macro en el editor, el cursor aparece en la misma línea en la que estaba cuando guardó la macro por última vez, en lugar de aparecer al principio del archivo de macro.
Los errores de una macro se resumen en la vista Problemas, tanto si está utilizando el editor de macros, el editor de texto o el editor XML. El código fuente de la macro muestra un marcador, un círculo rojo con una X en blanco dentro, que aparece en todas las líneas que contienen un error.
La macro puede guardarse incluso cuando contiene errores, lo que le permite encontrar los errores y arreglarlos posteriormente, si es necesario. No obstante, las macros que contienen errores no se pueden reproducir en tiempo de ejecución o en el terminal de sistema principal.
También puede importar macros grabadas con otros programas como, por ejemplo IBM® WebSphere Host Publisher o IBM Host On-Demand. Para importar estas macros, seleccione Archivo > Importar > HATS > Macro de Host Publisher/HOD y pulse Siguiente para visualizar el diálogo Importar una macro de Host Publisher/HOD. Pulse Añadir y desplácese hasta la ubicación de la macro en el sistema de archivos.
Puede exportar macros de HATS, así como macros de IBM WebSphere Host Publisher o IBM Host On-Demand. Para exportar estas macros, seleccione Archivo > Exportar > HATS > Macro de HATS o Archivo > Exportar > HATS > Macro de Host Publisher/HOD y pulse Siguiente. Las macros de Host Publisher están normalmente en la vía de directorios \hostpub\Studio\IntegrationObjects. Estas macros se exportan como archivos .macro. Esta extensión de archivo funciona para Host Publisher y Host On-Demand, aunque Host On-Demand toma por omisión y busca archivos .mac. Tiene que cambiar el filtro de Host On-Demand para buscar *.macro o *.*.
Seleccione Archivos de macro a exportar junto con el destino. Si desea grabar encima de los recursos actuales, pulse el recuadro de selección Grabar encima de recursos existentes sin avisar.
Pulse Finalizar cuando termine.
Para consideraciones al utilizar el soporte para DBCS, consulte Grabación de una macro.
Ejecutar una macro es una de las acciones que puede especificar que se realicen cuando una pantalla de sistema principal coincide con un criterio de reconocimiento de personalización de pantalla. Cuando grabe la macro, asegúrese de que la pantalla final no es la pantalla reconocida por la personalización de pantalla que tiene la macro definida como una acción. Si la pantalla reconocida es la última pantalla de la macro, se creará un bucle.
Puede definir pantallas transitorias junto con pantallas no transitorias para sus macros. No obstante, en tiempo de ejecución, es posible que vea una de sus pantallas transitorias reconocida de forma inesperada.
Al comparar descriptores de siguiente pantalla con macro, se comparan en primer lugar los descriptores de pantallas no transitorias, y después se comparan los descriptores de pantallas transitorias. Si se actualiza la información de la pantalla actual después de que haya comenzado la comparación de los descriptores de pantallas no transitorias, la información actualizada de la pantalla se utiliza para la comparación de descriptores de pantallas transitorias. Por lo tanto, es posible que si una pantalla queda bloqueada (OIA no permite la entrada) cuando comienza la comparación de pantallas no transitorias, y se desbloquea, sin ningún otro cambio, antes de la comience la comparación de pantallas transitorias, esto puede hacer que no se reconozcan las pantallas no transitorias, pero entonces las pantallas transitorias posteriores podrán ser reconocidas, lo cual no es el comprtamiento esperado.
Para evitar este comportamiento inesperado, puede controlar si se utiliza la misma información de pantalla al comprarar descriptores de pantallas no transitorias y transitorias. Para hacerlo, añada el valor de conexión avanzada, screenRecoUseOIASnapshot, y configure su valor como true. Para saber cómo configurar los valores de conexión avanzada, consulte Configurar los valores de conexión opcionales y avanzados.