SAP — Screenshot

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

Guarda una imagen de la ventana de SAP en un archivo. Sirve como evidencia de lo que el robot tenía delante: el resultado de una transacción, un mensaje de error, el estado de un documento antes de grabarlo. Devuelve la ruta completa del archivo generado.

Cómo funciona

Crea la carpeta de destino si no existe, espera a que SAP termine lo que esté procesando y le pide a SAP GUI que capture la ventana indicada en window (por defecto la principal, wnd[0]) en el archivo filePath.

Al terminar, comprueba que el archivo realmente exista; si SAP no lo escribió, la actividad falla.

Como la captura escribe en disco, SAP GUI puede mostrar su diálogo de seguridad pidiendo permiso para escribir el archivo. Mientras dura la captura, la actividad vigila ese diálogo dentro de la ventana de SAP y lo acepta, dejando un aviso en el log. No toca ventanas de otras aplicaciones.

La ventana debe existir en el momento de la captura; si no, la actividad falla de inmediato (no espera a que aparezca).

Parámetros requeridos

Parámetro	Tipo	Por defecto	Descripción
`filePath`	`string`	—	Archivo `.png` de destino. Ej: `"C:\evidencias\paso1.png"`. Usa una ruta absoluta: una relativa se resuelve contra la carpeta de trabajo del robot.

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.
`window`	`string`	`"wnd[0]"`	Ventana a capturar. Usa `wnd[1]` para capturar un diálogo emergente.

Salida

Devuelve un string con la ruta completa (absoluta) del archivo de imagen.

Errores comunes

Mensaje	Causa y solución
`La ventana '…' no existe.`	La ventana de `window` no está abierta en ese momento. La actividad no espera a que aparezca.
`SAP no escribió el archivo de la captura.`	SAP GUI no generó el archivo: revisa permisos de escritura en la carpeta y que nadie haya rechazado el diálogo de seguridad de SAP GUI.
`'filePath' es obligatorio.`	Falta `filePath`.

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

Ejemplo

Dejar evidencia si falla la ejecución de un informe:

Try / Catch   errorVariable = error
 ├─ try:
 │    SAP — Run transaction   code = "SE16"
 │    SAP — Set text   selector = "wnd[0]/usr/ctxtDATABROWSE-TABLENAME"   value = "T000"
 │    SAP — Send key   key = Enter
 └─ catch:
      SAP — Screenshot   filePath = "C:\evidencias\se16_" + now().ToString("yyyyMMdd_HHmmss") + ".png"   → output: captura
      Log   level = error   message = "Falló la consulta. Evidencia: " + captura

Actividades relacionadas

SAP — Read status bar — registrar también el mensaje de SAP.
SAP — Maximize — agrandar la ventana antes de capturarla.
SAP — Save file dialog — guardar datos (no imágenes) en un archivo.