SAP — Press toolbar button

Tipo: sap-press-toolbar-button · Paquete: SAP Activities v1.0.5

Pulsa un botón de las barras de herramientas de SAP: la barra estándar (tbar[0]: Guardar, Atrás, Salir, Cancelar…) o la barra de la aplicación (tbar[1]: Ejecutar y los botones propios de cada transacción). Es la actividad típica para ejecutar un reporte desde su pantalla de selección o guardar lo que el flujo acaba de capturar.

Cómo funciona

Espera a que SAP termine de procesar y busca el botón por su selector, esperando a que aparezca hasta timeout.
Lo pulsa y espera a que SAP termine de responder.
Lee la barra de estado: un mensaje de tipo E (error) o A (cancelación) hace fallar la actividad con el texto de SAP; los demás (S, W, I) se registran en el log.

Algunos botones habituales:

Selector	Botón
`wnd[0]/tbar[1]/btn[8]`	Ejecutar (F8), en pantallas de selección
`wnd[0]/tbar[0]/btn[11]`	Guardar
`wnd[0]/tbar[0]/btn[3]`	Atrás
`wnd[0]/tbar[0]/btn[15]`	Salir
`wnd[0]/tbar[0]/btn[12]`	Cancelar

Parámetros requeridos

Parámetro	Tipo	Por defecto	Descripción
`selector`	`selector`	—	Botón a pulsar, de `tbar[0]` o `tbar[1]`. Ej: `"wnd[0]/tbar[1]/btn[8]"`.

Parámetros opcionales

Parámetro	Tipo	Por defecto	Descripción
`session`	`ZoanSapSession`	—	Sesión de SAP. Omítela dentro del `body` de un SAP — Attach o SAP — Log on.
`timeout`	`number`	—	Segundos que se espera a que aparezca el botón. Manda sobre el `elementTimeout` del ámbito. Vacío usa el del ámbito (30 por defecto); `0` falla al primer intento. Admite decimales.

Salida

Esta actividad no devuelve ningún valor.

Errores comunes

Mensaje	Causa y solución
`El componente '…' no existe en la sesión de SAP. Se esperó … s a que apareciera. La pantalla actual es … dynpro … (transacción …). …`	El elemento no apareció en el plazo. El mensaje dice en qué pantalla está la sesión: casi siempre es otra distinta de la esperada (un diálogo delante, un paso que no se dio). Si la pantalla tarda, sube `timeout`.
`SAP respondió [E …]: …`	Tras la acción, SAP mostró un error (E) o una cancelación (A) en la barra de estado. El texto es el de SAP.

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

Ejemplo

Consultar la tabla T000 en la SE16:

SAP Run Transaction   code = "SE16"
SAP Set Text   selector = "wnd[0]/usr/ctxtDATABROWSE-TABLENAME"   value = "T000"
SAP Send Key   key = Enter
SAP Press Toolbar Button   selector = "wnd[0]/tbar[1]/btn[8]"

Actividades relacionadas

SAP — Press button — botones dentro de la pantalla o de un diálogo.
SAP — ALV toolbar — botones de la barra de un ALV.
SAP — Read status bar — revisar el resultado.