SAP — Get text

Tipo: sap-get-text · Paquete: SAP Activities v1.0.5 · Salida: string

Lee el texto de un elemento de SAP: el valor de un campo, una etiqueta, el título de una ventana. Es la forma de llevar a tu flujo un dato que SAP muestra en pantalla —un número de documento, un nombre, un estado— para guardarlo, compararlo o enviarlo a otro sistema.

Cómo funciona

Espera a que SAP termine de procesar, busca el elemento por su selector (esperando a que aparezca, hasta timeout) y devuelve su texto tal como lo muestra SAP. Si el elemento no tiene texto, devuelve una cadena vacía.

Si el elemento no aparece en el plazo, falla indicando en qué pantalla está la sesión.

Parámetros requeridos

Parámetro	Tipo	Por defecto	Descripción
`selector`	`selector`	—	Elemento a leer. Ej: `"wnd[0]/usr/txtRSYST-BNAME"` o `"wnd[0]/titl"` (título de la ventana).

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 elemento. Manda sobre el `elementTimeout` del ámbito. Vacío usa el del ámbito (30 por defecto); `0` falla al primer intento. Admite decimales.

Salida

Devuelve un string con el texto del elemento, tal como lo muestra SAP (sin recortar espacios). Si el elemento no tiene texto, o es de un tipo sin propiedad de texto, devuelve "".

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`.

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

Ejemplo

SAP Run Transaction   code = "SE16"
SAP Get Text   selector = "wnd[0]/titl"   → output: titulo
Log   message = "Pantalla actual: " + titulo

Actividades relacionadas

SAP — Read status bar — leer el mensaje de la barra de estado.
SAP — Read table — leer una tabla completa.
SAP — Element exists — comprobar antes si el elemento está.