XLSExport: Exporta datos desde un origen determinado a un archivo Excel
Permitirá a los usuarios exportar datos desde un archivo Excel / CSV, una base de datos SQL o un objeto de tipo tabla y completar los datos en un archivo Excel de destino.
IMPORTANTE: Al momento de ejecutar la automatización utilizando este comando, el archivo XLS debe estar cerrado en el dispositivo.
El comando cuenta con los siguientes parámetros:
- Archivo: Este campo es obligatorio. Acepta entradas de tipo File, String, Variable, Constant o Extended, debe ser un parámetro relevante y en vista plantilla estar catalogado como objeto.
- Origen: Se debe especificar el tipo de origen de donde extraer los datos a exportar. Este parámetro es requerido y acepta entradas de tipo Enum, Variable o Constant y en vista plantilla debe estar catalogado como descripción. El parámetro Origen aceptará los valores XLS, SQL y TABLA.
- Ubicación: Este parámetro corresponde al objeto o archivo donde extraer los datos. Es un parámetro opcional, acepta entradas de tipo String, File, Object, Variable, Constant o Extended y en vista plantilla debe estar catalogado como entrada.
- Consulta: Corresponde a consultas SQL o rango de datos a exportar del origen. Este parámetro es opcional, acepta entradas de tipo String, Variable, Constant o Extended y en vista plantilla estar catalogado como entrada.
- Consulta 2: Refiere a la hoja origen de donde extraer los datos (en caso de ser un excel). Este parámetro es opcional, acepta entradas de tipo String, Variable, Constant o Extended y en vista estar plantilla catalogada como entrada.
- Hoja: Permite indicar en qué hoja exportar los datos. Es un parámetro opcional, acepta entradas de tipo String, Variable, Constant o Extended, no figura en vista plantilla.
- Celda: Corresponde a la celda inicial donde se van a colocar los datos a exportar. Parámetro opcional, acepta entradas de tipo String, Variable, Constant o Extended, no figura en vista plantilla.
- Impactar: Permite indicar si se quieren impactar los campos en el documento. Es un parámetro opcional, acepta entradas de tipo Enum, Variable, Constant, no figura en vista plantilla. El parámetro Impactar aceptará los valores VERDADERO y FALSO.
Exportar datos desde un archivo Excel/CSV #
Permitirá exportar datos desde otro archivo Excel / CSV, una base de datos SQL o un objeto de tipo tabla y completar los datos en el archivo Excel de destino.
Exportar datos desde una BD SQL #
En caso de seleccionar como origen de los datos una BD SQL se deberá obtener la información desde la Base de Datos SQL y guardarla en el archivo XLS/CSV destino.
En este caso, el parámetro Consulta representará la Consulta SQL que se va a realizar sobre la base de datos configurada en el proyecto. En caso de que este campo no represente una Query SQL, o no se pueda ejecutar la Query contra la BD correctamente, se deberá devolver un mensaje de error en el Log de Evidencia al momento de la ejecución.
El parámetro de ubicación no será utilizado en este caso Al importar los datos al Excel se deberá incluir como primera fila una fila con los nombres de los cabezales en la respuesta SQL
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.
Exportar datos desde un Objeto Tabla #
En caso de seleccionar como origen de los datos un objeto de tipo tabla dentro de la automatización se deberá leer la información desde la tabla indicada y guardarla en el archivo XLS/CSV destino.
En este caso el parámetro Ubicación representará el objeto / nombre del objeto de tipo tabla desde el que se van a leer los datos. En caso de que el objeto no se pueda ubicar en la aplicación se deberá devolver un error indicando que no se pudo encontrar el objeto. Si el objeto no es una tabla u ocurre un error al obtener su contenido, deberá indicar con un mensaje de error que no se pudo realizar el proceso. El proceso obtiene todos los datos de la tabla y exporta estos datos al Excel en el mismo orden que estaban en la tabla al ser leída. No se generará una primera fila con cabezales.
En este caso el campo Consulta no será utilizado.