SAP — Wait for element

SAP — Wait for element

Tipo: sap-wait-for-element  ·  Paquete: SAP Activities v1.0.5

Espera hasta que un elemento aparezca en la pantalla de SAP: un campo de la pantalla siguiente, una grilla que tarda en cargar, un diálogo emergente. Si el elemento no aparece dentro del plazo, la actividad falla.

Cómo funciona

Comprueba cada 200 milisegundos si el elemento indicado por selector existe en la sesión. En cada comprobación espera antes a que SAP termine lo que esté procesando, para no dar por encontrado un elemento de la pantalla anterior. En cuanto existe, continúa el flujo. Si pasa el tiempo de timeout (en segundos) sin que aparezca, la actividad falla con un error de tiempo agotado.

Solo comprueba que el elemento exista; no lee ni modifica nada.

¿Hace falta esperar?

Las actividades que actúan sobre un elemento (escribir, pulsar, seleccionar…) ya esperan a que su elemento aparezca, hasta el elementTimeout de SAP — Attach o SAP — Log on (30 segundos por defecto) o el timeout de cada actividad. Usa esta actividad cuando quieras dejar explícito en el flujo el punto en que se espera una pantalla, o esperar un elemento con el que no vas a interactuar directamente.

Parámetros requeridos

Parámetro	Tipo	Por defecto	Descripción
selector	selector	—	Elemento a esperar. Selector capturado o id de SAP, por ejemplo wnd[1] para un diálogo emergente.

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 a esperar. Vacío: el elementTimeout del ámbito (30 s si nadie lo cambió). Admite decimales, por ejemplo 2.5; con 0 comprueba una sola vez.

Salida

Esta actividad no devuelve ningún valor.

Errores comunes

Mensaje	Causa y solución
El componente '…' no apareció en … s.	El elemento no apareció dentro del plazo. Sube timeout si la pantalla tarda, o usa SAP — Element exists si el elemento es opcional.
'timeout' debe ser un número de segundos; se recibió '…'.	timeout no es un número o es negativo.
'selector' es obligatorio.	El selector llegó vacío.

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

Ejemplo

Esperar a que aparezca la grilla de resultados de un informe pesado, con más margen del habitual:

SAP — Run transaction   code = "ZREPORTE01"
SAP — Send key   key = F8
SAP — Wait for element   selector = "wnd[0]/usr/cntlGRID1/shellcont/shell"   timeout = 120
SAP — Read table   selector = "wnd[0]/usr/cntlGRID1/shellcont/shell"   → output: filas

De dónde sale el plazo

Si dejas timeout vacío, espera lo mismo que las demás actividades de la sesión: el elementTimeout de SAP — Attach o SAP — Log on; si tampoco lo tienen, el tiempo de espera de la configuración del proyecto, y si no, 30 segundos.

Si el elemento puede no aparecer

Si el elemento es opcional (por ejemplo, un diálogo que a veces sale y a veces no), no uses esta actividad, porque falla al agotarse el plazo. Usa SAP — Element exists en una condición.

Actividades relacionadas

• SAP — Element exists — comprobar si un elemento está, sin esperar ni fallar.
• SAP — Attach — donde se ajusta el elementTimeout general.
• SAP — Close modal — cerrar un diálogo emergente que apareció.