Descripción General #
El comando IBMi Pantalla pertenece a la categoría de automatización para terminales de tipo IBM i / AS/400. Su propósito principal es extraer y capturar la información textual visible en la pantalla de la terminal emulada de IBM i. Permite leer bloques enteros de información de manera consecutiva o la pantalla completa en una sola acción, facilitando la validación de datos en interfaces donde no se conocen las columnas exactas donde se posiciona la información.
Ejemplo de Uso Rápido #
Imagina que el robot acaba de ejecutar una transacción en la terminal y el sistema despliega un bloque de texto con el resumen de la operación, pero el mensaje de confirmación varía de posición según la longitud de los datos. Con IBMi Pantalla puedes indicarle a STELA que lea las primeras líneas de la interfaz y guarde el texto en una variable para verificar posteriormente si la palabra «EXITOSA» o «PROCESADA» está presente.
Parámetros y Opciones #
Para configurar el comando IBMi Pantalla, se utilizan los siguientes parámetros estructurados:
- Inicio (Opcional): Define el número de la primera fila desde la cual se desea iniciar la lectura de la pantalla. Debe ser un número natural. Si se deja vacío, STELA asume la lectura desde el comienzo de la interfaz.
- Fin (Opcional): Define el número de la última fila hasta la cual se extenderá la captura de información. Debe ser un número natural. Si se deja vacío, la lectura continuará hasta el límite inferior de la pantalla.
- Variable (Obligatorio): Nombre de la variable principal donde STELA almacenará todo el bloque de texto consolidado que ha sido leído.
Nota de comportamiento: Además de guardar el bloque completo de texto en la variable principal, STELA genera automáticamente una entrada individual indexada por cada línea leída. Esto es ideal si necesitas realizar validaciones secuenciales fila por fila mediante otros comandos del flujo.
Ejemplos de Uso Avanzado #
- Lectura Completa de Interfaz: Cuando necesitas extraer todo el texto expuesto en la terminal para realizar auditorías o buscar patrones dinámicos sin importar la coordenada, dejas los campos de rango vacíos.
- Extracción de Encabezados de Control: En pantallas de navegación donde los datos de control (como el nombre del menú, usuario logueado o código de sucursal) se ubican estrictamente en la parte superior, puedes acotar la lectura a las primeras 5 filas.
Errores Comunes y Soluciones #
- Error: La variable no captura datos o devuelve información obsoleta.
- Solución: Asegúrate de que la sesión de la terminal se encuentre completamente cargada y en la pantalla correcta antes de ejecutar la lectura. Si el sistema emulado presenta retrasos de red, se recomienda anteponer el comando IBMi Espera para sincronizar el flujo de manera óptima antes de capturar el texto.
- Error: El rango de filas ingresado no devuelve el texto esperado.
- Solución: Verifica los índices de las filas en tu emulador de AS400. La numeración en STELA comienza en 1. Si el parámetro Inicio es mayor que el parámetro Fin, el comando no podrá procesar el segmento de forma lógica.