SAP — Set text

SAP — Set text

Tipo: sap-set-text  ·  Paquete: SAP Activities v1.0.5

Escribe un valor en un campo de SAP: el nombre de una tabla, un número de pedido, una fecha, un mandante. Es la actividad que más vas a usar para llenar pantallas de selección y formularios. Sirve para campos de texto normales, campos con ayuda de búsqueda (los que tienen el botón de F4) y campos de contraseña.

Cómo funciona

Espera a que SAP termine lo que esté procesando, busca el campo por su selector y reemplaza su contenido por value. No agrega texto al final: lo que hubiera en el campo se sustituye.

Si el campo todavía no está en pantalla, la actividad lo espera hasta el plazo configurado (timeout de la actividad o, si no lo pones, el elementTimeout de SAP — Attach o SAP — Log on, 30 segundos por defecto). Si se agota el plazo, el error indica en qué programa, pantalla (dynpro) y transacción está la sesión, para que veas rápido si SAP llegó a otra pantalla distinta de la esperada.

El selector puede ser un selector capturado con el Designer o directamente el id de SAP como texto, por ejemplo wnd[0]/usr/ctxtDATABROWSE-TABLENAME.

Parámetros requeridos

Parámetro	Tipo	Por defecto	Descripción
selector	selector	—	Campo que se va a llenar: de texto (txt), con ayuda de búsqueda (ctxt) o de contraseña (pwd).
value	string	—	Texto a escribir. Si es más largo que el campo, SAP lo recorta a la longitud del campo. Vacío deja el campo en blanco.

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 campo. 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.
Error de SAP GUI al asignar el texto	El elemento no es un campo editable (por ejemplo, una etiqueta o un campo de solo lectura en esa pantalla). Revisa el selector o el modo de la transacción.

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

Ejemplo

Consultar la tabla T000 en la transacción SE16:

SAP — Attach   system = "A4H"   client = "001"
 └─ body:
      SAP — Run transaction   code = "SE16"
      SAP — Set text   selector = "wnd[0]/usr/ctxtDATABROWSE-TABLENAME"   value = "T000"
      SAP — Send key   key = Enter

Escribir no dispara nada

Llenar un campo no equivale a pulsar Enter: SAP no valida ni procesa el valor hasta que envías una tecla o pulsas un botón. Después de llenar los campos, sigue con un SAP — Send key (Enter o F8) o un SAP — Press button.

Contraseñas

Si escribes en un campo de contraseña, toma el valor de una credencial guardada y no lo pongas como texto fijo en el playbook.

Actividades relacionadas

• SAP — Get text — leer el contenido de un campo o etiqueta.
• SAP — Send key — confirmar con Enter o ejecutar con F8.
• SAP — Select from dropdown — para campos que son listas desplegables.
• SAP — Set checkbox — para casillas de verificación.