SAP — Send key

SAP — Send key

Tipo: sap-send-key  ·  Paquete: SAP Activities v1.0.5

Envía una tecla de función a la ventana de SAP: Enter para confirmar, F8 para ejecutar, F3 para volver, F11 para grabar… En SAP casi todo se dispara con una de estas teclas, así que es una de las actividades más usadas.

SAP no recibe pulsaciones de teclado sino códigos de función (las vkeys): cada tecla o combinación que SAP entiende tiene un número fijo, y es ese número el que se envía a la ventana. Por eso la lista de teclas es cerrada: solo existen las combinaciones de la tabla de SAP.

Cómo funciona

Espera a que SAP termine lo que esté procesando, envía la tecla a la ventana indicada en window (por defecto la principal, wnd[0]) y vuelve a esperar a que SAP responda.

Después lee la barra de estado:

• Si SAP muestra un mensaje de error (tipo E) o de cancelación (tipo A), la actividad falla con ese mensaje.
• Cualquier otro mensaje se registra en el log (los avisos, tipo W, como advertencia). Esto importa porque SAP comunica cosas relevantes con mensajes de tipo S (éxito), como “No table entries found for specified key”: no detienen el flujo, pero quedan en el log.

La tecla se envía a la ventana, no a un campo concreto: no hace falta seleccionar nada antes. La ventana sí debe existir; si no, la actividad falla de inmediato (no espera a que aparezca).

Parámetros requeridos

Parámetro	Tipo	Por defecto	Descripción
key	string	—	Tecla a enviar (ver Teclas disponibles). Con Expresión puedes pasar el nombre de la tecla armado en tiempo de ejecución o directamente el número de vkey de SAP (0–99). Si llega vacía, se envía Enter.

Teclas disponibles

Tecla	vkey	Uso habitual
Enter	0	Confirmar, pasar a la siguiente pantalla
F1 … F12	1–12	F1 ayuda · F3 volver · F4 ayuda de valores · F8 ejecutar · F11 grabar · F12 cancelar
Shift+F1 … Shift+F12	13–24	Shift+F3 finalizar (salir)
Ctrl+F1 … Ctrl+F12	25–36	Según la pantalla
Ctrl+Shift+F1 … Ctrl+Shift+F12	37–48	Según la pantalla
Ctrl+E · Ctrl+F · Ctrl+/ · Ctrl+\ · Ctrl+N · Ctrl+O	70–75	Ctrl+F buscar
Ctrl+X · Ctrl+C · Ctrl+V · Ctrl+Z	76–79	Según la pantalla
Ctrl+PageUp · PageUp · PageDown · Ctrl+PageDown	80–83	Primera página · página anterior · página siguiente · última página
Ctrl+G · Ctrl+R · Ctrl+P	84–86	Ctrl+G seguir buscando · Ctrl+P imprimir
Ctrl+S	11	Igual que F11 (grabar)

Qué hace cada tecla depende de la pantalla: SAP solo ejecuta la función si esa pantalla la tiene asignada. Los valores F11-Save, F12-Cancel y F15-Exit de playbooks guardados con versiones anteriores siguen funcionando (equivalen a F11, F12 y Shift+F3).

El nombre se compara sin distinguir mayúsculas ni espacios, así que en una expresión valen "ctrl + f5", "CTRL+F5" o "Shift+Ctrl+F1". También se aceptan F13–F24 como otro nombre de Shift+F1–Shift+F12, y PgUp/PgDn. Si el valor no es un nombre conocido ni un número entre 0 y 99, la actividad falla indicando las teclas válidas.

Parámetros opcionales

Parámetro	Tipo	Por defecto	Descripción
session	ZoanSapSession	—	Sesión de SAP. Omítela dentro del cuerpo de un SAP — Attach o un SAP — Log on.
window	string	"wnd[0]"	Ventana que recibe la tecla. Usa wnd[1] para una ventana modal (un diálogo emergente).

Salida

Esta actividad no devuelve ningún valor. Para saber qué respondió SAP, léelo después con SAP — Read status bar.

Errores comunes

Mensaje	Causa y solución
Tecla desconocida '…'. Válidas: Enter, F1-F12, Shift+F1-F12, …	El valor no es un nombre de la tabla ni un número entre 0 y 99. Elige una tecla de la lista.
La ventana '…' no existe.	La ventana de window no está abierta (por ejemplo, wnd[1] cuando el diálogo ya se cerró). Compruébalo antes con SAP — Element exists.
SAP respondió [E …]: …	Tras la tecla, SAP mostró un error o una cancelación en la barra de estado.

Además, los errores comunes a todas las actividades.

Ejemplo

Abrir la tabla T000 en SE16 y ejecutar la consulta:

SAP — Run transaction   code = "SE16"
SAP — Set text   selector = "wnd[0]/usr/ctxtDATABROWSE-TABLENAME"   value = "T000"
SAP — Send key   key = Enter                        // pasa a la pantalla de selección
SAP — Send key   key = F8                           // ejecuta
SAP — Read status bar   → output: estado
Log   message = "SAP respondió: " + str(estado["text"])

Buscar en la pantalla actual con Ctrl+F:

SAP — Send key   key = Ctrl+F

Enviar una vkey por su número, desde una variable:

SAP — Send key   key = teclaSap                   // por ejemplo 8, que es F8

Confirmar un diálogo emergente:

SAP — Send key   key = Enter   window = "wnd[1]"

Leer el resultado

Si necesitas decidir qué hacer según lo que respondió SAP (por ejemplo, “no hay datos”), sigue con un SAP — Read status bar y usa su salida en una condición.

Lo que graba el grabador

Al grabar en SAP GUI con el botón Grabar del Designer, las teclas de función se convierten en pasos de SAP — Send key con estos mismos nombres: Enter, F1–F12 solas o con Shift/Ctrl (por ejemplo Shift+F3 o Ctrl+F5) y los atajos Ctrl+E, Ctrl+F, Ctrl+G, Ctrl+N, Ctrl+O, Ctrl+P, Ctrl+R y Ctrl+S. Cortar, copiar, pegar y deshacer (Ctrl+X/C/V/Z) no se graban, porque dentro de un campo son acciones propias de SAP GUI.

Actividades relacionadas

• SAP — Read status bar — leer el mensaje que dejó SAP.
• SAP — Press button — pulsar un botón concreto de la pantalla.
• SAP — Press toolbar button — pulsar un botón de la barra de herramientas.
• SAP — Close modal — cerrar un diálogo emergente.