Descripción General #
El comando IBMi Campos pertenece a la categoría de automatización para terminales de tipo IBM iSeries | AS/400. Su propósito principal es realizar un relevamiento exhaustivo de todos los campos editables o detectables que se encuentran presentes en la pantalla activa de la terminal. El comando inspecciona la interfaz emulada, recopila sus propiedades y vuelca este inventario detallado dentro de un contenedor estructurado para que el robot pueda consultar o validar el estado de la pantalla de forma dinámica.
Ejemplo de Uso Rápido #
Imagina que el robot navega hacia una pantalla de inicio de sesión o un menú complejo en el AS/400 cuyo diseño exacto o cantidad de campos disponibles desconoces.
- Configuras el comando especificando un contenedor llamado CamposLogin.
- Al ejecutarse, STELA detectará automáticamente cuántos campos hay, sus posiciones exactas (filas y columnas) y si están habilitados para escribir.
- Con esta información, puedes validar si la pantalla cargó correctamente antes de intentar ingresar las credenciales de acceso.
Parámetros y Opciones #
Para configurar este comando en el flujo de trabajo, se dispone del siguiente parámetro:
- Categoría (opcional): Nombre del contenedor o etiqueta de STELA donde se almacenará el inventario de los campos detectados. Si se omite, el sistema procesará la información internamente utilizando sus estructuras por defecto.
¿Qué información guarda el contenedor resultante? Al ejecutarse con éxito, el contenedor almacena las siguientes propiedades estructuradas por cada campo:
- La cantidad total de campos detectados en la pantalla.
- El identificador técnico de cada elemento.
- El valor o texto visible actualmente en el campo.
- Las coordenadas de ubicación (Fila y Columna).
- El estado operativo del campo: si se encuentra habilitado, en modo de solo lectura o si permanece oculto.
Ejemplos de Uso Avanzado #
- Exploración Dinámica de Pantallas Desconocidas: Cuando das mantenimiento a sistemas legados donde los formularios cambian de posición según el tipo de cuenta, puedes ejecutar IBMi Campos al iniciar la pantalla para mapear las coordenadas en tiempo real y decidir dinámicamente en qué fila y columna realizar las escrituras.
- Auditoría de Seguridad y Solo Lectura: En flujos de consulta financiera en el mainframe donde ciertos datos clave deben estar protegidos, el robot puede levantar el inventario de campos con este comando y verificar mediante condiciones que el campo del saldo esté marcado estrictamente como «Solo lectura», asegurando que el robot no altere información por accidente.
- Validación de Carga Correcta de Formularios: Al interactuar con transacciones pesadas del AS/400 que tardan en renderizarse, puedes usar este comando para contar los campos editables de la pantalla. Si la cantidad total detectada es igual a cero o inferior a la estructura esperada, el robot sabrá que la pantalla está congelada o incompleta.
Errores Comunes y Soluciones #
- Error: El comando se ejecuta pero el contenedor de campos queda completamente vacío.
- Solución: Asegúrate de haber invocado exitosamente el comando IBMi Conectar al inicio del flujo y verifica que la sesión de la terminal permanezca activa. Si la conexión se interrumpió, el robot no tendrá acceso para inspeccionar la pantalla.
- Error: Las coordenadas de fila o columna devueltas en el inventario no coinciden con la acción de escritura posterior.
- Solución: Recuerda que la terminal IBM i es síncrona. Si el sistema emulado estaba procesando datos o cambiando de pantalla mientras se invocó el comando, la información recopilada pertenecerá a la pantalla anterior. Introduce un comando IBMi Espera antes del relevamiento para garantizar que la interfaz esté completamente cargada.