Docx Writer

El Docx Writer permite crear archivos de Word (.docx) directamente desde tu dashboard de Nappai. Solo necesitas indicar el nombre del archivo y el contenido que quieres incluir, y el componente generará el documento listo para descargar o usar en otros procesos.

¿Cómo funciona?

El componente recibe el contenido que quieres colocar en el documento (puede ser texto plano, datos estructurados o mensajes de otros componentes). Internamente convierte ese contenido a Markdown, luego lo transforma en un archivo .docx usando la clase MarkdownToDocx. El resultado se devuelve como un objeto Data codificado en base64, con la información necesaria (nombre, tipo MIME, etc.). Todo el proceso se ejecuta localmente en el servidor de Nappai, sin llamadas externas.

Entradas

Campos de Entrada

• File Content: Contenido que se incluirá en el documento. Puede ser texto plano, datos o mensajes de otros componentes.
• File Name: Nombre que tendrá el archivo generado. Si no se especifica, se usará un nombre genérico con un UUID.

Salidas

• File: Un objeto Data que contiene el archivo .docx codificado en base64. Puedes usarlo para descargar el archivo, enviarlo por correo, guardarlo en un sistema de archivos, etc.

Ejemplo de Uso

1. Arrastra el componente Docx Writer al lienzo.
2. Conecta la salida de un componente que genere texto (por ejemplo, un Text Generator) al campo File Content.
3. Escribe el nombre deseado en el campo File Name (ejemplo: InformeSemanal).
4. Ejecuta el flujo.
5. La salida File aparecerá en la pestaña de resultados; haz clic en ella para descargar el documento .docx.

Componentes Relacionados

• Text Writer – Guarda texto plano en archivos .txt.
• PDF Writer – Genera archivos PDF a partir de contenido Markdown o texto.
• Email Sender – Envía correos electrónicos; puedes adjuntar el archivo generado por Docx Writer.

Consejos y Mejores Prácticas

• Usa Markdown: Si tu contenido incluye encabezados, listas o enlaces, escribe en Markdown para que se conviertan correctamente en el documento.
• Controla el tamaño: Los archivos muy grandes pueden tardar en procesarse; considera dividir el contenido en varios archivos si es necesario.
• Verifica el nombre: Evita caracteres especiales en el nombre del archivo para garantizar compatibilidad en todos los sistemas.
• Revisa la codificación: La salida está en base64; si la usas en otro componente, asegúrate de decodificarla correctamente.

Consideraciones de Seguridad

• Almacenamiento temporal: El archivo se crea en el directorio de trabajo del servidor y se elimina automáticamente después de la ejecución. No se guarda permanentemente a menos que lo conectes a un componente de almacenamiento.
• Acceso restringido: Solo los usuarios con permisos de ejecución en el flujo pueden generar y descargar archivos.
• Validación de entrada: Evita inyectar contenido malicioso en el campo File Content; si proviene de usuarios externos, sanitiza el texto antes de enviarlo al componente.