Descripción General #
El comando IBMi Teclear pertenece a la categoría de comandos para sistemas de terminales IBM i | AS/400. Su función principal es simular la pulsación de teclas especiales y de función del emulador, tales como la confirmación de formularios, la navegación de menús o la interacción con el sistema. A diferencia de los comandos de ingreso de texto plano, este comando se utiliza exclusivamente para transmitir señales de control técnicas que controlan el flujo y comportamiento de la terminal de texto.
Ejemplo de Uso Rápido #
Imagina que te encuentras en un menú interactivo del sistema AS/400 y necesitas acceder a la pantalla de gestión de usuarios o confirmar los datos de un lote recién cargado.
- Después de escribir información en la pantalla, utilizas el comando {teclear IBMi} configurado con la acción [ENTER] para procesar los datos ingresados.
- Si necesitas cancelar la operación actual o regresar a la pantalla anterior sin guardar, puedes emplear el mismo comando configurado con la tecla de función [pf3].
Parámetros y Opciones #
Para configurar el comportamiento de IBMi Teclear, debes completar el siguiente parámetro:
- Tecla (obligatorio): Especifica la tecla especial o la acción de control que se enviará directamente al emulador de la terminal. Los valores aceptados corresponden a la nomenclatura nativa de los emuladores IBM i, entre los cuales se encuentran:
Teclas de Navegación y Control Básic
- [ENTER]: Procesa, confirma o envía los datos cargados en la pantalla actual hacia el servidor.
- [TAB]: Avanza el cursor de manera secuencial hacia el siguiente campo editable.
- [BACKTAB]: Retrocede el cursor hacia el campo editable anterior.
- [ARRIBA], [ABAJO], [IZQUIERDA], [DERECHA]: Mueven el cursor una posición en la dirección indicada a través de la matriz de la pantalla.
- [SUPRIMIR]: Borra el carácter situado en la posición actual del cursor.
- [BACK_SPACE]: Borra el carácter situado inmediatamente antes de la posición del cursor (retroceso).
- [INSERTAR]: Alterna el modo de escritura de la terminal entre insertar texto o sobrescribir los caracteres existentes.
- [INICIO]: Lleva el cursor directamente al primer campo editable de la pantalla actual.
Teclas de Función (F1 a F12)
- [F1] a [F12]: Ejecutan comandos específicos del sistema operativo o del software empresarial de la terminal. Sus acciones son dinámicas y dependen enteramente del menú o la pantalla en la que se encuentre parado el robot (por ejemplo, habitualmente [F3] se usa para salir o regresar).
Funciones Avanzadas de Campos
- [FIN_DE_CAMPO]: Desplaza el cursor de forma automática al final del texto contenido en el campo actual.
- [BORRAR_HASTA_FIN_DE_CAMPO]: Elimina de inmediato todo el contenido que se encuentre desde la posición actual del cursor hasta el límite final de ese campo específico.
- [APAGAR_CAMPO]: Cambia el estado visual del campo actual (ocultando temporalmente el contenido o deshabilitando su entrada según la lógica del emulador).
- [SALIR_DE_CAMPO]: Fuerza al cursor a abandonar el campo de texto actual, validando los datos introducidos y saltando al siguiente control.
Teclas Especiales del Teclado Numérico (Keypad)
Estas funciones simulan de forma explícita las pulsaciones en el bloque numérico lateral del teclado, garantizando que el sistema operativo de la terminal reciba los códigos de carácter correctos para la carga de datos contables o financieros:
- [NUMÉRICO_0] a [NUMÉRICO_9]: Escriben el dígito correspondiente procesado de forma nativa como entrada del teclado numérico.
- [PUNTO_NUMÉRICO]: Inserta el carácter de punto (.) del bloque numérico.
- [COMA_NUMÉRICO]: Inserta el carácter de coma (,) del bloque numérico.
- [MENOS_NUMÉRICO]: Inserta el símbolo de resta o guion (-) perteneciente al teclado numérico.
Ejemplos de Uso Avanzado #
- Navegación y salida de submenús: Uso secuencial de las teclas de función para retroceder en la estructura de menús de la terminal AS/400 hasta regresar a la interfaz principal del sistema. Ej.: {teclear IBMi} ; [pf3]
- Paginación en listas de registros extensas: Envío del comando de avance de página para desplazarse dentro de un subarchivo de facturas pendientes, permitiendo descubrir la información que no ingresa en la pantalla inicial. Ej.:{teclear IBMi} ; [AVANZAR_PÁGINA]
- Desbloqueo de terminal ante ingresos inválidos: Envío del comando de restauración para reactivar la terminal y el ingreso de datos luego de que el sistema arrojara un error de formato de campo. Ej.: {teclear IBMi} ; [RESET]
Errores Comunes y Soluciones #
- Error: El comando se ejecuta, pero no ocurre ninguna acción en la pantalla o se escribe el texto de manera explícita (ej: se escribe «[ENTER]» en un campo).
- Solución: Recuerda que {teclear IBMi} no está diseñado para ingresar texto libre. Si necesitas rellenar un campo con letras, números o palabras, debes utilizar el comando {valor IBMi}. Asegúrate de usar {teclear IBMi} únicamente cuando necesites ejecutar acciones de control.
- Error: El robot se detiene e indica que la pantalla está bloqueada o no responde a los comandos [ENTER] o teclas [F].
- Solución: Cuando se ingresa un dato incorrecto o fuera de zona, el emulador AS/400 bloquea la entrada de datos por seguridad. Ante este escenario, inserta un paso previo en tu automatización que ejecute el valor [RESET] utilizando el comando {teclear IBMi} para liberar el teclado antes de continuar con la navegación habitual.
- Error: La navegación falla porque la tecla de función enviada (ej: [pf12]) no realiza la acción esperada.
- Solución: Verifica la documentación o el diseño visual de la pantalla de tu sistema IBM i. Las acciones de las teclas de función (F1 a F24) cambian dinámicamente según la pantalla en la que te encuentres. Asegúrate de enviar la tecla exacta que el sistema solicita en el menú actual.
