XLS Writer

El XLS Writer te permite crear archivos de Excel (.xls) directamente desde tu dashboard de Nappai. Solo necesitas indicar el nombre del archivo y el contenido que quieres que aparezca en él, y el componente se encargará de generar el archivo y devolverte una referencia que puedes usar en el resto de tu flujo de trabajo.

¿Cómo funciona?

El componente recibe los datos que quieres escribir en el archivo y los convierte en una tabla de Excel. Internamente:

1. Revisa el tipo de datos que le envías. Puede ser una lista, un objeto Data o un Message.
2. Crea un libro de Excel con una sola hoja llamada Sheet1.
3. Escribe cada fila en la hoja. Si el dato es un diccionario, se toma cada valor como una celda.
4. Guarda el archivo en un directorio temporal, lo lee y lo convierte a una cadena base64.
5. Devuelve un objeto Data que contiene el nombre del archivo, el contenido codificado y metadatos útiles (tipo MIME, codificación, etc.).

Todo esto se hace localmente, sin necesidad de conectarse a servicios externos.

Entradas

File Content

Contenido del archivo a crear.

• Tipo: DataInput
• Requerido: Sí
• Descripción: Puedes pasar una lista de filas, un objeto Data o un Message. El componente se encargará de convertirlo en una tabla de Excel.

File Name

Nombre del archivo que se generará.

• Tipo: MessageTextInput
• Requerido: Sí
• Descripción: Escribe el nombre que quieres que tenga el archivo (sin la extensión .xls, ya que el componente la añade automáticamente).

Salidas

File

• Tipo: Data
• Método: create_file
• Descripción: Devuelve un objeto que contiene:
  • file_name: nombre del archivo (file.xlsx).
  • text: contenido del archivo codificado en base64.
  • metadata: información adicional como tipo MIME y codificación.

Puedes usar esta salida para descargar el archivo, enviarlo por correo, guardarlo en un almacenamiento externo, etc.

Ejemplo de Uso

1. Añade el componente XLS Writer al flujo.
2. Conecta la entrada File Content con la salida de otro componente que genere los datos (por ejemplo, un CSV Reader o un Data Table).
3. Escribe el nombre del archivo en el campo File Name (ejemplo: ReporteMensual).
4. Ejecuta el flujo.
5. Obtén la salida File y, por ejemplo, usa un componente Download para que el usuario pueda descargar el archivo.

Tip: Si tu flujo genera datos en formato JSON, simplemente pásalos a File Content y el componente los convertirá automáticamente en filas de Excel.

Componentes Relacionados

• CSV Writer – Similar al XLS Writer pero genera archivos CSV.
• PDF Generator – Convierte datos en documentos PDF.
• Data Table – Muestra datos en una tabla dentro del dashboard.

Consejos y Mejores Prácticas

• Mantén los datos limpios: Asegúrate de que los valores que envías no contengan caracteres que puedan romper la estructura de Excel (por ejemplo, saltos de línea no deseados).
• Usa nombres descriptivos: El nombre del archivo debe reflejar su contenido para que sea fácil de identificar.
• Revisa el tamaño: Si los datos son muy grandes, considera dividirlos en varios archivos para evitar problemas de rendimiento.
• Prueba con datos de muestra antes de usarlo en producción para asegurarte de que la tabla se genera como esperas.

Consideraciones de Seguridad

• El archivo se crea en un directorio temporal que se elimina automáticamente después de la operación, lo que evita dejar archivos residuales en el servidor.
• El contenido se devuelve codificado en base64, lo que protege la integridad de los datos durante la transmisión.
• No se exponen rutas de archivos locales al usuario final, lo que reduce el riesgo de exposición de información sensible.

Con estos cuidados, el XLS Writer es una herramienta segura y sencilla para generar informes y exportar datos en formato Excel dentro de Nappai.