IBMi Valor

Descripción General #

El comando IBMi Valor pertenece a la categoría de automatización para terminales de tipo  IBM iSeries | AS/400. Su propósito principal es simular la introducción de texto por parte de un operador dentro de una terminal de pantalla verde (5250). Permite interactuar con campos editables de la interfaz, ya sea enviando la información directamente a la posición donde se encuentra ubicado el cursor del sistema en ese momento, o indicando de forma explícita coordenadas exactas (fila y columna) para reubicar el cursor justo antes de plasmar el texto.

Ejemplo de Uso Rápido #

Imagina que el robot ha iniciado sesión en la terminal y se encuentra parado sobre el menú principal, donde debe ingresar el nombre de usuario para avanzar:

• Para escribir directamente donde está parpadeando el cursor, configurarías el comando para enviar el texto MIUSUARIO01.
• Si la pantalla tiene varios campos y necesitas asegurar que el dato se escriba exactamente en el campo de contraseña, puedes indicarle a STELA que se mueva primero a la fila 6, columna 32, y luego escriba CLAVE123.

Parámetros y Opciones #

Para configurar correctamente el comando IBMi Valor, debes completar los siguientes parámetros:

• Valor (Obligatorio): Representa el texto, variable o constante que el robot ingresará en la pantalla de la terminal (por ejemplo, un número de cuenta, un código de comando del sistema o un identificador de cliente).
• Fila (Opcional): Número de línea horizontal dentro de la cuadrícula de la terminal donde se desea ubicar el cursor para escribir. La numeración de las filas comienza estrictamente en 1.
• Columna (Opcional): Número de posición vertical dentro de la fila seleccionada donde se iniciará la inserción del texto. La numeración de las columnas comienza estrictamente en 1.

Ejemplos de Uso Avanzado #

• Navegación Dinámica por Menús Orientada a Posición: Cuando el flujo requiere saltar entre diferentes opciones numéricas de un menú principal del AS/400, puedes indicarle al comando que se dirija de manera directa a la línea de comandos de la terminal (por ejemplo, fila 20, columna 7) e introduzca el número de la opción o el comando de ruta de acceso deseado.
• Carga Masiva de Formularios e Inserción Iterativa: En procesos RPA de actualización de registros donde los campos en pantalla verde ocupan ubicaciones estáticas inalterables, se encadenan múltiples comandos IBMi Valor configurados con las coordenadas exactas de cada campo (por ejemplo, Nombre en 10;15, Teléfono en 11;15), asegurando el llenado perfecto de la pantalla antes de enviar la orden de guardado.

Errores Comunes y Soluciones #

• Error: El texto se escribe en un campo o celda incorrecta de la pantalla.
  • Solución: Valida si omitiste los parámetros de fila y columna. Si la terminal es lenta o el comando anterior desplazó el cursor de forma imprevista, la escritura sin coordenadas explícitas heredará la posición previa. Configura de forma estricta el par fila/columna para mitigar dependencias del foco.
• Error de Datos: El valor ingresado para la fila o la columna no es procesado o genera un fallo de ejecución en el robot.
  • Solución: Comprueba que los datos provistos en los campos de coordenadas correspondan a números enteros válidos mayores o iguales a 1. Las variables utilizadas en estos campos deben almacenar únicamente caracteres numéricos y no texto libre.
• Error: El comando se ejecuta pero la pantalla verde no refleja la escritura del texto.
  • Solución: Asegúrate de que no estás intentando escribir en un área de la pantalla protegida o de solo lectura (como etiquetas de texto o encabezados del sistema). El cursor solo aceptará el texto si la coordenada de destino cae dentro de un campo editable de la sesión IBM i.