Macros y terminal de sistema principal

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:

Saltar pantalla
Las macros de saltar pantalla son macros de navegación que mueven al usuario desde una pantalla a otra sin mostrar las pantallas intermedias.
Solicitud
Las macros de solicitud contienen pasos para solicitar datos de entrada a los usuarios durante la sesión de sistema principal. También pueden establecer solicitudes desde una lista de usuarios. Por ejemplo, puede utilizar una macro de solicitud para solicitar al usuario un ID de usuario y una contraseña antes de conectarse a una aplicación de sistema principal.
Nota:
las solicitudes de lista de usuarios sólo se pueden utilizar en las macros de conexión.

Los desarrolladores también pueden utilizar las macros de solicitud para proporcionar los valores constantes o los valores obtenidos de variables globales.

Extracción
Las macros de extracción contienen sucesos para extraer información de la pantalla de sistema principal como una serie, como una lista de series o como una tabla. Por ejemplo, puede utilizar una macro de extracción para conectarse a una aplicación de sistema principal tipo directorio y extraer los resultados de realizar una búsqueda en el directorio.

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.

Nota:
El soporte del Editor de macros y del Editor de macros avanzado están en desuso en HATS V7.5.1. Aunque de momento sigue teniendo soporte, IBM se reserva el derecho a eliminar estas opciones en publicaciones futuras del producto. Este soporte se sustituye por el Editor de macros visual.

Editor de macros

En los siguientes apartados se describen cada una de las pestañas del editor de macros.

Visión general

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.

Figura 63. Grabación de una macro de HATS
Grabación de macro utilizando el terminal de sistema principal

Abrir terminal de sistema principal

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.

Terminal de sistema principal

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.

Nota:
Notas:
  1. HATS precisa que defina los criterios de reconocimiento de pantalla para determinadas pantallas. Estas pantallas son:
  2. Las funciones cortar, copiar y pegar se proporcionan en el terminal de sistema principal mediante el uso de las siguientes combinaciones de teclas:

La Tabla 4 muestra los iconos de macro que aparecen en la barra de herramientas de la pantalla del terminal de sistema principal.

Tabla 4. Iconos de macro
Icono Descripción
abrir macro
Abrir una macro. Utilice la lista desplegable para seleccionar una macro
ejecutar macro
Ejecutar una macro. Utilice la lista desplegable para seleccionar una macro
grabar macro
Empezar a grabar una macro
detener macro
Detener la grabación de la macro
guardar macro
Guardar la macro grabada
recorrer todo
Recorrer todo (F5) el contenido de la macro a efectos de depuración
recorrer principal
Recorrer principal (F6) recorre el texto principal de la macro a efectos de depuración
recorrer hasta retorno
Recorrer hasta retorno (F7) dentro de la macro a efectos de depuración
reanudar
Reanudar (F8) la reproducción de la macro
definir criterio de reconocimiento de pantalla de macro
Definir los criterios de reconocimiento de pantalla para una pantalla de macro
añadir una acción de solicitud
Añadir una acción de solicitud a la macro actual (sólo se habilita cuando se graba una macro)
añadir una acción extraer
Añadir una acción de extracción a la macro actual (sólo se habilita cuando se graba una macro)
grabar una macro de bucle
Grabar un bucle en la macro actual (sólo se habilita cuando se graba una macro)
añadir acciones de solicitud para todos los campos
Añadir acciones de solicitud en la macro actual para todos los campos de la pantalla (sólo se habilita cuando se graba una macro)
añadir acciones de extracción para todos los campos
Añadir acciones de extracción en la macro actual para todos los campos de la pantalla (sólo se habilita cuando se graba una macro)
mostrar/ocultar área de teclado
Mostrar u ocultar el área de teclado de la ventana de terminal de sistema principal
OIA textual
Mostrar u ocultar el Área de información del operador (OIA) textual
Iconos relacionados con las macros

A continuación se incluye una lista de iconos relacionados con las macros en la barra de herramientas del Terminal de sistema principal:

Grabar 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. 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.

Nota:
si va a crear un objeto de integración a partir de una macro, asegúrese de que sigue estos requisitos para el nombre de la macro:
  • El nombre de la macro debe constar sólo de letras, dígitos o caracteres de subrayado.
  • El primer carácter del nombre no puede ser un numeral.
  • No se admiten caracteres de doble byte (anchura completa).
Detener macro
Cuando termine de grabar la macro, pulse el icono Detener macro.
Guardar macro
Después de detener la grabación de la macro, tiene que guardarla pulsando el icono Guardar macro.
Recorrer todo (F5)
Al pulsar el icono Recorrer todo (F5) puede pasar de una pantalla a la primera acción incluida, y de acción en acción. Con la tecla F5 realizará la misma acción. Se utiliza a efectos de depuración.
Recorrer principal (F6)
Al pulsar Recorrer principal (F6) puede ir de pantalla en pantalla (realizando todas las acciones relacionadas). Con la tecla F6 realizará la misma acción. Se utiliza a efectos de depuración.
Recorrer hasta retorno (F7)
Al pulsar Recorrer hasta retorno (F7) puede dejar de ejecutar las acciones de una pantalla e ir a la pantalla siguiente. Con la tecla F7 realizará la misma acción. Se utiliza a efectos de depuración.
Reanudar (F8)
Para reanudar la reproducción de la macro, puede pulsar el icono Reanudar (F8) o pulsar la tecla F8 en el teclado. Esto se puede utilizar para el resto de la macro si actualmente la está depurando.
Definir criterio de reconocimiento de pantalla

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.

Añadir acción de solicitud

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.

Nota:
los valores por omisión que especifique para las solicitudes se almacenan en archivos de macro no cifrados. Los valores por omisión se visualizan sin cifrar al editar solicitudes utilizando el editor de macros. Por tanto, es adecuado utilizar una solicitud para especificar una contraseña, pero no debe especificar un valor por omisión para la contraseña por motivos de seguridad.

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:

Mostrar manejador
Para proyectos Web de HATS, puede seleccionar un archivo .jsp 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 default.jsp. Para encontrar este archivo, pulse la vista Proyectos de HATS de HATS Toolkit, expanda el nombre del proyecto y, a continuación, Contenido Web > Manejadores de sucesos de macro. Si desea crear su propio manejador, asegúrese de devolver el control a la unidad ejecutable de HATS.
Notas:
  1. los objetos de integración ignoran el manejador .jsp seleccionado. En su lugar se crea una página de entrada para el objeto de integración y se coloca una solicitud de valor en esa página de entrada. La página de salida generada copia el valor suministrado por la página de entrada en el objeto de integración, antes de ejecutar el objeto de integración.
  2. La opción Mostrar manejador queda inhabilitada cuando la macro se extrae de un plano distinto del plano de texto.
Nota:

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.

Establecer solicitud como una serie
Si sabe qué valor se debe devolver para una solicitud, puede entrar esa serie en el campo Serie.
Establecer solicitud como una variable global
Si desea que el valor de la solicitud lo proporcione una variable global, entre un nombre para la variable global en el campo Nombre o seleccione una variable existente utilizando el menú desplegable al lado del campo Variable global. Si pulsa el botón Avanzada, puede especificar si la variable es compartida o indexada. Si es una variable indexada, también debe especificar si desea mostrar todos los índices o uno solo. Si desea obtener más información, consulte el Interacción con variables globales.
Nota:

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 .

Establecer solicitud de propiedad de la lista de usuarios
Si desea que la solicitud acceda a una lista de usuarios, seleccione el Perfil de usuario en la lista desplegable. El perfil de usuario es la clave para determinar si desea utilizar el ID de usuario o la contraseña como la Propiedad de la lista de usuarios. Si desea obtener más información, consulte Lista de usuarios.
Nota:
las solicitudes de lista de usuarios sólo se pueden utilizar en las macros de conexión.
Utilizar Inicio de sesión rápido en Web
Si ha configurado la aplicación de HATS para que utilice el inicio de sesión rápido en Web, entre el tipo de solicitud como el ID de usuario o la contraseña en la lista desplegable Tipo de solicitud y entre el ID de aplicación en el campo ID de aplicación.
Nota:
el Tipo de solicitud debe contener previamente el valor correcto.

Pulse Aceptar cuando termine de hacer las selecciones.

Añadir acción extraer

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:

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:

Mostrar manejador
Para aplicaciones Web, puede seleccionar un archivo .jsp para mostrar la información extraída al usuario. Con HATS se suministra un manejador de macros por omisión denominado default.jsp. Puede encontrar este archivo en la vista Proyectos de HATS, expanda el nombre del proyecto y, a continuación, Contenido Web > Manejadores de sucesos de macro. Si desea crear su propio manejador, asegúrese de devolver el control a la unidad ejecutable de HATS.
Nota:
los objetos de integración no utilizan esta opción. En su lugar, la página de salida recuperará los datos extraídos del objeto de integración y los mostrará.

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.

Guardar como variable global
Puede entrar un nombre para la variable global en el campo Nombre o seleccione una variable existente utilizando el menú desplegable. Si selecciona una variable global existente en el campo Nombre, debe especificar cómo desea manejar dicha variable seleccionando uno de los siguientes botones de selección:
  • Grabar encima de un valor existente con este nuevo valor.
  • Grabar encima de un valor existente con este nuevo valor, comenzando en el índice especificado.
  • Añadir este nuevo valor al final del valor existente.
  • Insertar este valor nuevo en el valor existente, en el índice especificado.
También puede especificar si esta variable es compartida seleccionando el recuadro de selección Compartida.
Nota:
si extrae un valor, lo asigna a un conjunto de variables globales mediante una extracción, y piensa utilizar el valor de la variable global en una solicitud, debe establecer promptall en false. Si se establece promptall en true, la acción extraer no se ejecuta antes de recuperar los valores de solicitud. Como consecuencia, la variable global utilizada por la solicitud no contiene un valor.

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.

Grabar un bucle

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.

Nota:
se debe hacer especial énfasis en el criterio de reconocimiento de pantalla para las pantallas inicial y final del bucle. En algunos casos puede que tenga una pantalla inicial que sea casi idéntica a la pantalla final. Preste atención para distinguir estas pantallas.
Añadir acciones de solicitud para todos los campos
Si selecciona este icono, se abre la ventana Insertar todos los campos de variables globales. Seleccione un Nombre de pantalla almacenada en la lista desplegable. También tiene la opción de crear una nueva captura de pantalla si pulsa el recuadro de selección Crear una captura de pantalla. Seleccione el recuadro de selección Compartida para obtener la variable global de la lista compartida.
Notas:
  1. Los valores por omisión que especifique para las solicitudes se almacenan en archivos de macro no cifrados. Los valores por omisión se visualizan sin cifrar al editar solicitudes en el editor de macros del terminal de sistema principal o en el editor de macros avanzado. Por tanto, es adecuado utilizar una solicitud para especificar una contraseña, pero no debe especificar un valor por omisión para la contraseña por motivos de seguridad.
  2. Si utiliza esta opción con objetos de integración, HATS añadirá campos al objeto de integración por cada variable global definida. Debe escribir código para establecer los valores de la variable global y copiarlos al objeto de integración antes de ejecutarlo. Esto se puede realizar en la página .jsp que ejecuta el objeto de integración. Si desea obtener más información, consulte Insertar propiedades de objeto de integración. Recuerde que los objetos de integración sólo pueden acceder a las variables globales compartidas.
Añadir acciones extraer para todos los campos
Si selecciona este icono, se abre la ventana Extraer todos los campos de variables globales. Seleccione un Nombre de pantalla almacenada en la lista desplegable. Este nombre se utilizará como prefijo en las variables globales creadas para todos los campos. Si el texto de los campos protegidos se debe obtener en tiempo de ejecución, seleccione la opción Todos los campos. Si el texto de los campos protegidos es estático en las JSP de transformación, seleccione la opción Campos de entrada. Seleccione el recuadro de selección Compartida para obtener la variable global de la lista compartida.
Nota:
Si utiliza esta opción con objetos de integración, HATS añadirá campos al objeto de integración por cada variable global definida. Debe escribir código para copiar los datos del objeto de integración en las variables globales compartidas después de ejecutar el objeto de integración. Esto se puede realizar en la página .jsp que ejecuta el objeto de integración. Si desea obtener más información, consulte Insertar propiedades de objeto de integración. Recuerde que los objetos de integración sólo pueden acceder a las variables globales compartidas.
Mostrar u ocultar área de teclado

Este icono le permite mostrar u ocultar el área de teclado del terminal.

Mostrar OIA textual

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.

Vista previa de pantalla de sistema principal

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.

Nota:
la pestaña Vista previa de pantalla de sistema principal sólo se ve si el terminal de sistema principal actual está asociado a la conexión por omisión. Si abre un terminal de sistema principal en una conexión de fondo, no verá esta vista previa.

Editor avanzado

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.

Solicitudes y extracciones

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.

Fuente

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.

Trabajo con los errores de macros

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.

Importación de una macro

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.

Nota:
las macros de Host Publisher con bucles de iteración fija reconocen continuamente la misma pantalla y realizan distintas acciones. En HATS, no puede crear una personalización de pantalla para reconocer la misma pantalla una segunda vez y realizar una acción diferente que la primera vez que la reconoció. Si intenta utilizar una macro de Host Publisher con un bucle de iteración fija, el proyecto puede entrar en un bucle infinito. Las macros de Host Publisher con bucles de iteración fija se pueden identificar mirando el código fuente de la macro. La macro contiene códigos customreco con los atributos de ID HPubFixedIterationLoop y códigos custom con los atributos de ID HPubIncrementLoop.

Exportación de una macro

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.

Nota:

Para consideraciones al utilizar el soporte para DBCS, consulte Grabación de una macro.

Sugerencias y consejos sobre las macros

Cómo evitar un bucle infinito

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.

Manejo de pantallas transitorias

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.