SAP — Element exists
SAP — Element exists
Sección titulada «SAP — Element exists»Tipo: sap-element-exists · Paquete: SAP Activities v1.0.5 · Salida: boolean
Comprueba si un elemento existe en la pantalla actual de SAP y devuelve true o false. No falla si el elemento no está: simplemente devuelve false. Es la forma de manejar lo que a veces aparece —un diálogo inesperado, un aviso, un campo que solo sale en ciertos casos— y decidir qué hacer.
Cómo funciona
Sección titulada «Cómo funciona»Primero espera a que SAP termine lo que esté procesando (así no mira la pantalla anterior a la última acción) y luego busca el elemento por su selector una sola vez: no espera a que aparezca ni usa elementTimeout. El resultado suele alimentar un If.
Parámetros requeridos
Sección titulada «Parámetros requeridos»| Parámetro | Tipo | Por defecto | Descripción |
|---|---|---|---|
selector | selector | — | Elemento a buscar. Ej: "wnd[1]" para saber si hay una ventana modal abierta. |
Parámetros opcionales
Sección titulada «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. |
Devuelve un boolean: true si el elemento existe en la pantalla actual, false si no.
Errores comunes
Sección titulada «Errores comunes»No falla porque el elemento no esté: en ese caso devuelve false. Solo falla si el selector llega vacío ('selector' es obligatorio.) o por los errores comunes a todas las actividades, como la falta de sesión.
Ejemplo
Sección titulada «Ejemplo»Leer y cerrar un diálogo solo si aparece:
SAP Element Exists selector = "wnd[1]" → output: hayDialogoIf condition = hayDialogo └─ then: SAP Get Text selector = "wnd[1]/titl" → output: tituloDialogo Log message = "Diálogo: " + tituloDialogo SAP Close ModalActividades relacionadas
Sección titulada «Actividades relacionadas»- SAP — Wait for element — esperar a que un elemento aparezca, y fallar si no lo hace.
- SAP — Close modal — cerrar el diálogo encontrado.
- SAP — Get text — leer el texto del elemento.
- SAP — Read status bar — otra forma de saber qué pasó.