Node.js SDK para ensamblado de documentos y generación de informes
Integra potentes capacidades de ensamblado de documentos en tus aplicaciones Node usando GroupDocs.Assembly Cloud REST API.
Integra potentes capacidades de ensamblado de documentos en tus aplicaciones Node usando GroupDocs.Assembly Cloud REST API.
GroupDocs.Assembly Cloud es un servicio totalmente gestionado, basado en REST, que permite a los desarrolladores crear documentos con formato rico y listos para imprimir a partir de plantillas reutilizables y fuentes de datos externas.
La plataforma admite una amplia variedad de formatos de origen y destino – desde archivos clásicos Microsoft Office (DOCX, XLSX, PPTX) hasta PDF, HTML, OpenDocument y muchos formatos gráficos – lo que te permite generar contratos, facturas, informes, folletos de marketing o cualquier documento personalizado sin instalar software de terceros en tus propios servidores. Todas las tareas intensivas – análisis de plantillas, enlace de datos, renderizado de imágenes, generación de códigos de barras, evaluación de fórmulas y conversión de archivos – se realizan en la nube, lo que garantiza resultados consistentes en todos los sistemas operativos y reduce los costos de infraestructura.
¿Por qué usar el Node.js SDK?
Flujo de trabajo típico en una aplicación Node.js
GroupDocs.AssemblyuploadFile del SDK.AssembleOptions – especifica la ruta de la plantilla, la fuente de datos, el formato de salida deseado (PDF, DOCX, HTML, …) y cualquier configuración adicional (p. ej., generación de códigos de barras, color de fondo).assembleDocument – el SDK envía una única solicitud HTTP que desencadena el proceso de ensamblado en el servidor.El siguiente ejemplo (mostrado en la sección More Feature) demuestra cada uno de estos pasos en un fragmento de código compacto y listo para producción.
Capacidades principales del Assembly Cloud API.
Formatos de documento compatibles con Assembly Cloud API.
Sistemas operativos y entornos de desarrollo compatibles.
El fragmento a continuación muestra un flujo completo: subir una plantilla, leer un archivo de datos JSON, configurar la solicitud de ensamblado y recibir el documento ensamblado.
Pasos
AssembleOptions – elige el formato de salida y enlaza los datos.assembleDocument para generar el informe.// Replace with your App SID and App Key
const { AssemblyApi, AssembleDocumentRequest, AssembleOptions, TemplateFileInfo, model } = require("groupdocs-assembly-cloud");
const fs = require("fs");
const path = require("path");
// Authorization placeholder
const assemblyApi = new AssemblyApi("####-####-####-####-####", "##################");
// 1️⃣ Upload the template file
const templatePath = "Input1.docx";
const uploadRequest = new model.UploadFileRequest({
fileContent: fs.createReadStream(templatePath),
path: templatePath
});
await assemblyApi.uploadFile(uploadRequest);
// 2️⃣ Read the data source (JSON)
const dataPath = "Input2.docx";
const reportData = fs.readFileSync(dataPath, "utf8");
// 3️⃣ Set assembly options
const assembleOptions = new AssembleOptions({
saveFormat: "pdf",
reportData: reportData,
templateFileInfo: new TemplateFileInfo({ filePath: templatePath })
});
// 4️⃣ Create and send the assemble request
const request = new AssembleDocumentRequest({ assembleOptions });
const result = await assemblyApi.assembleDocument(request);
// 5️⃣ Save the resulting document
const outputPath = path.join(__dirname, "GeneratedReport.pdf");
fs.writeFileSync(outputPath, result.body);
console.log("Report generated successfully:", outputPath);