Módulo XLSX
Definición
El módulo de herramientas “XLSX”, módulo estándar de Skyone Studio para uso en cualquier flujo, fue creado para convertir datos entre los formatos JSON y XLSX (Excel), utilizando archivos en formato Base64.
El módulo “XLSX” está compuesto por dos operaciones:
Convertir JSON a XLSX
Convertir XLSX a JSON
Configuración del módulo XLSX
El módulo “XLSX” aparece en la opción Herramientas de la edición de un flujo. Al ser agregado a un flujo, ofrece dos operaciones:
Convertir JSON a XLSX: convierte un contenido en JSON a un archivo XLSX, retornando el resultado en Base64.
Convertir XLSX a JSON: convierte un archivo XLSX en Base64 al formato JSON.
Operación Convertir JSON a XLSX
Esta operación le permite convertir un contenido en JSON (como respuestas de APIs, listas de productos, clientes, etc.) al formato XLSX, permitiendo la generación de hojas de cálculo de Excel a partir de datos estructurados.
Cómo utilizar
Ingrese a su flujo de integración.
Seleccione la operación “Convertir JSON a XLSX”.
Haga clic en Guardar.
Al editar el módulo, se mostrará el área de configuración de las variables.
Campos de configuración
Nombre de la hoja de cálculo
Informe el nombre que se le asignará a la hoja XLSX generada.
JSON
Informe el contenido en formato JSON que debe ser convertido.
Si lo prefiere, haga clic en el signo de más ( + ) para configurar una SMOP o utilizar datos provenientes de otro módulo del flujo (ej: respuesta de API).
XLSX convertido (Base64)
Después de hacer clic en el botón Validar, se mostrará el archivo XLSX generado en formato Base64.
El módulo no ofrece la descarga directa del archivo XLSX. El resultado siempre se genera en Base64.
Uso del Base64 generado
El Base64 retornado puede ser:
Guardado para uso posterior;
Utilizado directamente en el retorno de la aplicación;
Convertido en un archivo físico utilizando:
JSONata
Transformaciones en el módulo Transformación de Datos
Implementaciones externas que consuman Base64
Ejemplo de uso en el retorno del flujo:
Arrastre el parámetro generado por el módulo XLSX al módulo de Retorno.
Defina un nombre para el campo.
El Base64 estará disponible como salida de la API.
Operación Convertir XLSX para JSON
Esta operación permite la conversión de un archivo XLSX en Base64 al formato JSON, lo que permite la lectura y manipulación de los datos de las hojas de cálculo dentro del flujo.
Cómo utilizar
Seleccione la operación “Convertir XLSX a JSON”.
Haga clic en Guardar.
Al editar el módulo, se mostrará el área de configuración de las variables.
Campos de configuración
Nombre de la hoja de cálculo: Informe el nombre de la hoja que se utilizará en la lectura del archivo XLSX.
XLSX (Base64): Informe el contenido del archivo XLSX codificado en Base64. Este campo acepta únicamente Base64, incluyendo archivos generados por el propio módulo XLSX.
XLSX convertido a JSON: Después de hacer clic en Validar, el contenido de la hoja de cálculo se mostrará en formato JSON.
Parámetros
Cada operación del módulo XLSX posee un parámetro correspondiente al resultado de la conversión:
Convertir JSON para XLSX → retorna un Base64 XLSX
Convertir XLSX para JSON → retorna un JSON
Estos parámetros:
Están disponibles en el lado izquierdo del modal de configuración;
Pueden ser utilizados en módulos posteriores del flujo;
Pueden ser manipulados por el módulo Transformación de Datos o por SMOPs.
Consideraciones finales
El módulo XLSX fue desarrollado para facilitar la conversión entre JSON y Excel, siguiendo el estándar de uso de Base64 adoptado por Skyone Studio. Actualmente:
JSON → XLSX
XLSX → JSON
Para finalizar la configuración del módulo, haga clic en Guardar.
Última actualización
¿Te fue útil?