SAP — Select menu

Tipo: sap-select-menu · Paquete: SAP Activities v1.0.5

Elige una opción de la barra de menús de la ventana principal de SAP, como haría una persona al abrir un menú y hacer clic en una entrada. Puedes indicar la opción por su id técnico (selector) o por la ruta de textos que se ven en pantalla (path), por ejemplo "System > List > Save".

Cómo funciona

Necesita uno de los dos: selector o path. Si no das ninguno, la actividad falla. Si das los dos, se usa el selector. Un selector vacío (por ejemplo, porque borraste el campo en el Designer) cuenta como no indicado, así que en ese caso se usa path.

Por selector: busca la entrada por su id, por ejemplo wnd[0]/mbar/menu[0]/menu[2], esperando a que aparezca hasta el plazo configurado (timeout o el elementTimeout del ámbito, 30 segundos por defecto).
Por path: parte de la barra de menús de la ventana principal y recorre la ruta nivel por nivel, separando por >. Cada nivel se compara con el texto de la entrada sin distinguir mayúsculas y minúsculas. Si un nivel no existe, el error enumera las entradas que sí hay en ese punto.

Después de seleccionar la entrada, espera a que SAP responda y lee la barra de estado: un error (tipo E) o una cancelación (tipo A) hacen fallar la actividad; cualquier otro mensaje queda registrado en el log.

Parámetros requeridos

Ninguno por separado, pero debes indicar selector o path.

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.
`selector`	`selector`	—	Entrada de menú por id, por ejemplo `wnd[0]/mbar/menu[0]/menu[2]`. Si viene, manda sobre `path`.
`path`	`string`	—	Ruta de textos visibles separada por `>`. Ej: `"System > List > Save"`. Cada nivel debe coincidir con el texto completo de la entrada (sin distinguir mayúsculas). Depende del idioma de la sesión.
`timeout`	`number`	—	Segundos que se espera a que aparezca la entrada cuando se usa `selector`. 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
`Se necesita 'selector' o 'path'.`	No indicaste ninguno de los dos (o los dos están vacíos).
`No hay ninguna entrada '…' en el menú. Disponibles: …. Ojo: los textos están en el idioma del inicio de sesión.`	Un nivel de `path` no existe. El mensaje lista las entradas que sí hay en ese nivel; revisa la ortografía y el idioma de la sesión.
`La pantalla no tiene barra de menús.`	Con `path`, la ventana principal no tiene barra de menús (por ejemplo, hay un diálogo delante).
`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

Guardar la lista que se ve en pantalla usando el menú, en una sesión iniciada en inglés:

SAP — Select menu   path = "System > List > Save > Local File"
SAP — Save file dialog   path = "C:\salidas\"   fileName = "t000.txt"   format = Text with Tabs

La misma opción por id:

SAP — Select menu   selector = "wnd[0]/mbar/menu[3]/menu[1]/menu[1]/menu[2]"

Actividades relacionadas

SAP — Press toolbar button — pulsar un botón de la barra de herramientas.
SAP — Send key — muchas opciones de menú tienen una tecla de función equivalente.
SAP — Save file dialog — completar el diálogo de guardado que abren algunas opciones.