Descripción General #
El comando IBMi Info pertenece a la categoría de comandos para sistemas de terminales IBM i | AS/400. Su propósito principal es extraer y consultar una propiedad técnica específica de un campo que ya ha sido previamente identificado y estructurado dentro del mapa de objetos del proyecto. Este comando trabaja de manera directa sobre la definición del objeto, facilitando auditorías visuales y validaciones dinámicas en el flujo de automatización.
Ejemplo de Uso Rápido #
Imagina que estás interactuando con una pantalla de facturación y necesitas asegurarte de que el campo de ingreso de texto correspondiente al «Código de Cliente» se encuentra habilitado para escritura antes de intentar mandarle datos.
En lugar de leer la pantalla completa o intentar escribir a ciegas, utilizas el comando {info IBMi} apuntando al objeto CampoUsuarioIBMi y seleccionando la propiedad Habilitado. El robot guardará un valor booleano en la variable seleccionada, permitiéndote tomar una decisión lógica en el lienzo según el estado real del elemento.
Parámetros y Opciones #
Para configurar el comportamiento de {info IBMi}, debes completar los siguientes parámetros obligatorios:
- Campo (obligatorio; tipo: object): es el objeto específico perteneciente al mapa de la terminal sobre el cual deseas realizar la consulta técnica.
- Propiedad (obligatorio; tipo: enum): especifica la característica o el atributo técnico que deseas recuperar del campo seleccionado. Los valores configurables en STELA son:
- ID: Recupera el identificador técnico interno del campo.
- Valor: Extrae el contenido de texto visible que se encuentra actualmente escrito en el campo.
- Habilitado: Devuelve un estado indicando si el campo acepta entradas e interacción en ese momento.
- Solo lectura: Informa si el campo está bloqueado para modificaciones externas.
- Oculto: Indica si el campo cuenta con propiedades de protección de visibilidad (como los campos de contraseñas).
- Fila: Devuelve la coordenada numérica de la fila donde se origina el campo dentro de la pantalla.
- Columna: Devuelve la coordenada numérica de la columna inicial del campo dentro de la pantalla.
- Variable (obligatorio; tipo: variable): nombre de la variable de STELA donde se almacenará el valor de la propiedad recuperada para su uso posterior.
Ejemplos de Uso Avanzado #
- Validación de contenido en un campo mapeado: Consulta directa del texto ingresado en un campo de entrada para verificar que la información coincide con los datos cargados por el robot. {info IBMi} ; CampoUsuarioIBMi ; Valor ; usuario_leido
- Auditoría de coordenadas de interfaz: Extracción de la fila exacta de un campo dinámico para registrar su ubicación en los reportes de ejecución o utilizarla como referencia. {info IBMi} ; CampoUsuarioIBMi ; Fila ; fila_usuario
Errores Comunes y Soluciones #
- Error: El robot se detiene e indica que el objeto o campo no fue encontrado en la pantalla actual.
- Solución: A diferencia de los comandos de lectura por coordenadas, {info IBMi} requiere obligatoriamente que el objeto esté bien definido en el mapa y que sea visible en la interfaz activa de la terminal. Si la pantalla cambió o el campo se desplaza debido a un subarchivo dinámico, asegúrate de refrescar el mapeo o utilizar comandos de sincronización como {espera IBMi} antes de ejecutar la consulta.
- Error: El valor guardado en la variable no coincide con lo esperado o devuelve datos inconsistentes al evaluar Fila o Columna.
- Solución: En sistemas heredados con subarchivos dinámicos, las propiedades de ubicación física del campo pueden variar de acuerdo con el renderizado de la sesión. Realiza una prueba controlada en tu entorno real para confirmar cómo responde la estructura de la terminal antes de basar lógicas críticas de navegación en las propiedades de coordenadas numéricas.