SAP — Export list

SAP — Export list

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

Guarda en un archivo la lista que muestra SAP, en un solo paso: es lo mismo que hace una persona con Lista → Guardar → Archivo local, pero sin diálogos que atender. Es la mejor forma de sacar muchos datos de un reporte clásico: con el formato “Text with Tabs” obtienes un archivo tabulado, listo para leer con las actividades de CSV o de Excel.

Cómo funciona

1. Escribe %pc en el campo de comandos y pulsa Enter, que es el atajo de SAP para guardar la lista en un archivo local. Si no aparece el diálogo de exportación, falla: la pantalla actual no es una lista clásica (si es un ALV, usa SAP — Export ALV grid). También falla si hay una ventana modal delante que tape el campo de comandos.
2. Elige el formato (format) en el diálogo de formato.
3. Llena la carpeta, el nombre del archivo y, si lo indicas, la codificación en el diálogo “Save File”. Si la carpeta no termina en \, se la añade.
4. Confirma con Reemplazar (si overwrite está activado, por defecto) o con Generar (si no; SAP se niega si el archivo ya existe).
5. Revisa el resultado: si SAP responde con un error, la actividad falla; si no hay error pero el archivo no está en la ruta indicada, también falla. Si todo va bien, devuelve la ruta completa del archivo.

Mientras SAP escribe el archivo, la actividad vigila el diálogo de seguridad de SAP GUI que pide permiso para escribir en disco. Si aparece dentro de la ventana de SAP, lo acepta (Allow) y lo deja anotado en el log. Lo reconoce por su forma y no por sus textos, así que funciona con SAP GUI en cualquier idioma.

Parámetros requeridos

Parámetro	Tipo	Por defecto	Descripción
path	string	—	Carpeta de destino, que debe existir. Ej: "C:\salidas\". Si falta la barra final, se agrega.
fileName	string	—	Nombre del archivo, con extensión. Ej: "listado.txt".

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.
format	string	"Text with Tabs"	Formato de exportación: Unconverted, Text with Tabs, Spreadsheet, Rich Text o HTML. “Text with Tabs” es el que un flujo puede procesar después. El formato Clipboard no se ofrece porque no genera archivo; un playbook anterior que lo tenga falla antes de abrir el diálogo, con un mensaje que lo explica.
encoding	string	—	Página de códigos de SAP (por ejemplo "4110" para UTF-8). Vacío usa la del sistema.
overwrite	bool	true	Sobrescribir si el archivo ya existe. Con false, SAP se niega si el archivo existe y la actividad falla. También acepta una expresión que devuelva true o false.

Salida

Devuelve un string con la ruta del archivo generado (carpeta + nombre), una vez comprobado que existe.

Errores comunes

Mensaje	Causa y solución
%pc no abrió el diálogo de exportación. La pantalla actual no es una lista clásica: si es un ALV usa sap-grid-export.	La pantalla no es una lista clásica. Para un ALV usa SAP — Export ALV grid.
No hay campo de comandos. ¿Hay una ventana modal abierta delante?	Un diálogo tapa la ventana principal. Ciérralo con SAP — Close modal.
El formato Clipboard no está soportado: SAP copia la lista al portapapeles y nunca abre el diálogo de guardar, así que no hay archivo que escribir. …	Un playbook anterior trae format = Clipboard. Elige otro formato.
Formato desconocido '…'. Válidos: Unconverted, Text with Tabs, Spreadsheet, Rich Text, HTML.	format no es uno de la lista (se compara sin distinguir mayúsculas).
No hay diálogo de guardar en wnd[1]. Esta actividad va DESPUÉS de la que lo abre (sap-export-list, sap-grid-export o el botón propio de la transacción).	El campo de carpeta (ctxtDY_PATH) no está en la ventana del diálogo. La actividad no espera a que aparezca.
El diálogo no tiene el botón btn[11]. (o btn[0])	El diálogo que hay delante no es el “Save File” estándar de SAP. Condúcelo a mano con SAP — Press button.
SAP rechazó la descarga [E …]: …	SAP respondió con un error, por ejemplo una carpeta que no existe o, con overwrite = false, un archivo que ya existe.
SAP no dejó ningún error pero el archivo no se escribió. …	El diálogo se cerró pero el archivo no está en la ruta. Si el mensaje añade Si el equipo pide permiso de escritura y nadie responde, la descarga nunca ocurre, revisa el diálogo de seguridad de SAP GUI (Options → Security).

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

Ejemplo

Consultar la tabla T000 en la SE16 y guardarla como texto tabulado:

SAP Run Transaction   code = "SE16"
SAP Set Text   selector = "wnd[0]/usr/ctxtDATABROWSE-TABLENAME"   value = "T000"
SAP Send Key   key = Enter
SAP Press Toolbar Button   selector = "wnd[0]/tbar[1]/btn[8]"
SAP Export List   path = "C:\salidas\"   fileName = "t000.txt"   format = Text with Tabs   → output: archivo
Log   message = "Exportado: " + archivo

Evitar el aviso de seguridad

Lo más limpio es que SAP GUI no pregunte: en SAP GUI Options → Security, configura la acción por defecto como Allow, o marca “Remember My Decision” la primera vez. La vigilancia automática es una red de seguridad para equipos que no controlas.

La carpeta debe existir

Asegúrate de que la carpeta de destino exista en el equipo del robot antes de exportar; puedes crearla con las actividades de archivos.

Actividades relacionadas

• SAP — Export ALV grid — el equivalente para rejillas ALV.
• SAP — Save file dialog — completar un diálogo “Save File” abierto por otro camino.
• SAP — Read classic list — leer la lista sin pasar por un archivo.