Descripción General #
El comando IBMi Cursor pertenece a la categoría de comandos para entornos de emulación de terminales IBM i / AS/400. Su propósito principal es reposicionar el cursor de forma explícita en una fila y columna determinadas de la pantalla verde antes de realizar una acción de escritura o confirmación.
Este comando es transversal y está disponible para flujos que utilicen los canales WEB, ANDROID, IOS, SWING, MICROSOFT, WINDOWS y SAP. Su uso es fundamental para asegurar que el robot interactúe con los campos correctos en pantallas donde el foco automático del emulador no se posiciona de forma predecible.
Ejemplo de Uso Rápido #
Imagina que te encuentras en el menú principal de un sistema de gestión en AS/400 y necesitas seleccionar la opción de «Facturación». Con el comando IBMi Cursor, puedes indicarle al robot que mueva el cursor directamente hacia el campo de selección de opción, situado en la parte inferior de la pantalla, para posteriormente teclear el número correspondiente.
- Escenario común: Mover el cursor a la fila 20, columna 7 para dejar la terminal lista antes de ingresar una opción del menú.
Parámetros y Opciones #
Para configurar el posicionamiento del cursor, debes indicar las siguientes coordenadas:
- Fila (obligatorio): Número entero que representa la línea vertical de la pantalla de la terminal a la cual se moverá el cursor. La numeración comienza en 1.
- Columna (obligatorio): Número entero que representa la posición horizontal dentro de la fila seleccionada. La numeración comienza en 1.
Ejemplos de Uso Avanzado #
- Preparación para Entrada de Datos en Formularios: En pantallas densas con múltiples campos editables (como el alta de un cliente), puedes utilizar IBMi Cursor para saltar directamente a un campo específico (ej: Fila 12, Columna 40) reduciendo el tiempo de ejecución y la fragilidad del robot.
- Navegación Dinámica basada en Variables: Si la posición del campo varía según el tipo de pantalla o la resolución de la terminal, puedes calcular las coordenadas previamente con comandos utilitarios y pasar las variables resultantes (ej: fila_destino y columna_destino) directamente al comando para lograr un posicionamiento adaptativo.
Errores Comunes y Soluciones #
- Error: El cursor se posiciona en una zona protegida de la pantalla y el comando posterior de escritura falla.
- Solución: Verifica en la terminal física que las coordenadas de fila y columna ingresadas correspondan a un campo editable y no a una etiqueta de texto plano o zona restringida del sistema.
- Error: Las coordenadas ingresadas exceden el tamaño de la pantalla emulada (ej: Fila 25 en una configuración estándar de 24×80).
- Solución: Comprueba la configuración de dimensiones de tu terminal AS/400 y asegúrate de que los valores de los parámetros no superen los límites máximos permitidos por el emulador del proyecto.