Descripción General #
El comando XlsExport pertenece a la categoría de comandos RPA. Permite exportar datos desde una fuente específica a un archivo de Excel. Con esta función, los usuarios pueden transferir información desde un archivo de Excel/CSV, una base de datos SQL o un objeto tipo tabla para completar los datos en un archivo de destino en formato Excel.
Importante: Al momento de ejecutar la automatización con este comando, el archivo de Excel de destino debe estar cerrado en el dispositivo.
Ejemplo de Uso Rápido #
Imagina que tienes una lista de clientes en un archivo Excel y quieres copiar esa lista a un nuevo archivo para enviársela a tu equipo de ventas. Con XlsExport, puedes decirle a STELA: «Toma los datos de este archivo Excel y ponlos en este otro archivo Excel».
Parámetros y Opciones #
- Archivo (Obligatorio): Este es el archivo Excel de destino donde se guardarán los datos exportados. Es obligatorio y puedes usar un archivo existente o crear uno nuevo. Acepta entradas de tipo File, String, Variable, Constante o Editor Extendido.
- Origen (Obligatorio): Aquí le dices a STELA de dónde sacar los datos. Puedes elegir entre:
- XLS: Para exportar desde otro archivo Excel o CSV. Ejemplo de uso
- SQL: Para exportar desde una base de datos SQL. Ejemplo de uso
- TABLA: Para exportar desde un objeto de tipo tabla dentro de tu automatización. Ejemplo de uso
- Ubicación (Opcional): Si eliges exportar desde un objeto tabla, aquí indicas el nombre de ese objeto. Si exportas desde un archivo, aquí indicas la ruta del archivo. Es opcional segun el origen seleccionado.
- Consulta (Opcional): Si exportas desde una base de datos SQL, aquí escribes la consulta SQL para obtener los datos que quieres. Si exportas desde un Excel, aquí puedes indicar un rango de celdas. Es opcional segun el origen seleccionado.
- Consulta 2 (Opcional): Si exportas desde un archivo Excel, aquí puedes especificar la hoja desde donde extraer los datos. Es opcional segun el origen seleccionado.
- Hoja (Opcional): Aquí indicas en qué hoja del archivo Excel de destino quieres guardar los datos.
- Celda (Opcional): Aquí especificas la celda donde quieres que empiecen a colocarse los datos en el archivo Excel de destino.
- Impactar (Opcional): Define el guardado físico inmediato sobre el disco al terminar la inyección de los datos, liberando la memoria
- Contraseña (Opcional): Contraseña de apertura del archivo Excel de destino, en caso de estar protegido.
- Contraseñaorigen (Opcional): Contraseña del archivo Excel origen, si corresponde a una planilla protegida.
- Encoding (csv) (Opcional): Define la codificación de caracteres (ej.
UTF-8) cuando el archivo destino o el origen es un archivo CSV.
Ejemplos de Uso Avanzado #
- Generar Informes de Ventas: Imagina que tienes datos de ventas en una base de datos SQL. Puedes usar XlsExport para extraer esos datos y generar automáticamente un informe de ventas en Excel cada semana.
- Consolidar Datos de Múltiples Hojas de Cálculo: Si tienes datos de diferentes departamentos en varias hojas de cálculo, puedes usar XlsExport para juntar toda esa información en una sola hoja de cálculo para tener una visión general.
- Extraer Datos de una Tabla Web: Si tu automatización interactúa con una página web que muestra datos en una tabla, puedes usar XlsExport para extraer esos datos y guardarlos en un archivo Excel.
Errores Comunes y Soluciones #
- Error: No permite escribir en el archivo Excel de destino.
- Solución: Asegúrate de que el archivo Excel de destino esté cerrado antes de ejecutar la automatización. XlsExport no puede escribir en un archivo que está abierto.
- Error: No se pudo ejecutar la Query contra la BD correctamente.
- Solución: Revisa la sintaxis de tu consulta SQL en el parámetro «Consulta». Asegúrate de que la consulta sea válida y que la base de datos esté accesible.
- Error: No se pudo encontrar el objeto.
- Solución: Verifica que el nombre del objeto tabla en el parámetro «Ubicación» sea correcto y que el objeto exista en la aplicación.
- Error: No se pudo realizar el proceso.
- Solución: Asegúrate de que el objeto especificado en «Ubicación» sea realmente una tabla y que no haya errores al acceder a su contenido.
Casos de Uso #
- Automatización de tareas repetitivas: Si necesitas generar informes o consolidar datos regularmente, XlsExport puede automatizar este proceso, ahorrándote tiempo y esfuerzo.
- Captura de datos visuales: Si necesitas extraer datos de tablas en aplicaciones o páginas web, XlsExport te permite hacerlo de manera eficiente.
- Integración de datos: Puedes usar XlsExport para mover datos entre diferentes sistemas, como bases de datos y hojas de cálculo.
IMPORTANTE: STELA codifica archivos .CSV que vienen con codificación UTF-8 a encoding ANSI/Cp1252, así evitamos que existan errores en guardar la información del archivo, por lo que se sugiere que los archivos .CSV utilicen codificación distinta a UTF-8 ejemplo.
