SAP — Select tab

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

Cambia de pestaña en una pantalla de SAP que organiza sus campos en pestañas, como las fichas de datos de un maestro o de un documento. Úsala antes de leer o escribir campos que están en una pestaña distinta de la que está abierta.

Cómo funciona

Espera a que SAP termine lo que esté procesando, busca la pestaña por su selector, la selecciona y espera a que SAP cargue su contenido.

Cambiar de pestaña suele implicar un viaje al servidor, así que después lee la barra de estado: si SAP responde con un error (tipo E) o una cancelación (tipo A), la actividad falla con ese mensaje; cualquier otro mensaje queda registrado en el log.

Si la pestaña todavía no está en pantalla, la actividad la espera hasta el plazo configurado (timeout o el elementTimeout del ámbito, 30 segundos por defecto).

Parámetros requeridos

Parámetro	Tipo	Por defecto	Descripción
`selector`	`selector`	—	La pestaña que se quiere abrir. Selector capturado o id de SAP, por ejemplo `wnd[0]/usr/tabsTABSTRIP/tabpTAB02`.

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 la pestaña. 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

SAP — Select tab   selector = "wnd[0]/usr/tabsTABSTRIP/tabpTAB02"
SAP — Get text   selector = "wnd[0]/usr/tabsTABSTRIP/tabpTAB02/ssubSUB:ZPROG:0200/txtCAMPO1"   → output: valor

Actividades relacionadas

SAP — Get text — leer un campo de la pestaña.
SAP — Set text — escribir en un campo de la pestaña.
SAP — Wait for element — esperar a que aparezca un elemento concreto.