Biblioteca Java para crear informes altamente personalizados usando REST API
Empiza la prueba gratuitaGroupDocs.Assembly Cloud es un servicio totalmente gestionado, basado en REST, que permite a los desarrolladores Java crear documentos, informes, contratos, facturas y cartas de combinación de correspondencia altamente personalizados directamente desde la nube. La solución funciona con un amplio conjunto de formatos de entrada y salida, lo que te permite almacenar archivos de plantilla en GroupDocs Cloud Storage, enlazarlos a fuentes de datos XML o JSON, y recibir el documento ensamblado en el formato que elijas – DOCX, PDF, HTML, PPTX, XLSX, etc. Como todo el procesamiento se realiza en el lado del servidor, no es necesario instalar ningún software o biblioteca de terceros en el equipo cliente; el único requisito es un tiempo de ejecución Java y Assembly Cloud SDK, que proporciona envoltorios ligeros alrededor de los puntos finales API.
Un flujo de trabajo típico de Java consta de tres pasos simples. Primero, agrega la dependencia Assembly Cloud SDK a tu proyecto Maven o Gradle e inicializa el ApiClient con tu SID de aplicación y tu clave de aplicación personal. Segundo, sube el archivo de plantilla a GroupDocs Cloud Storage usando el método uploadFile. Tercero, crea un objeto AssembleOptions, especifica la ruta de la plantilla, el archivo de datos (XML o JSON), el formato de salida deseado e invoca assembleDocument. El servicio devuelve el documento ensamblado como un flujo que puedes guardar localmente o procesar más adelante. El SDK también expone métodos auxiliares para previsualizar plantillas, obtener los formatos compatibles y manejar errores. Este enfoque sencillo te permite integrar la generación de documentos en aplicaciones web, trabajos de procesamiento por lotes o micro‑servicios con un código mínimo.
Todas las comunicaciones están cifradas con SSL/TLS, y el acceso se controla mediante claves personales. La plataforma escala automáticamente para manejar grandes volúmenes de solicitudes y admite operaciones de combinación de correspondencia por lotes donde una única llamada API puede generar miles de cartas personalizadas. Además, el SDK permite incrustar imágenes, gráficos, códigos de barras y aplicar lógica condicional directamente dentro de la plantilla usando expresiones al estilo LINQ, dándote control total sobre el diseño final del documento.
El fragmento a continuación muestra cómo subir una plantilla, establecer la fuente de datos y generar un informe DOCX usando Assembly Cloud API.
Pasos
AssembleOptions – ruta de la plantilla, formato de salida y archivo de datos.assembleDocument para obtener el resultado.import com.groupdocs.assembly.*;
AssemblyApi assemblyApi = new AssemblyApi(new ApiClient());
ApiClient client = assemblyApi.getApiClient();
client.setAppKey("####################").setAppSid("####-####-####-####-####");
String fileName = "Input1.docx";
String dataFile = "Input2.docx";
File requestFileContent = new File(fileName);
UploadFileRequest uploadDocumentRequest =
new UploadFileRequest(requestFileContent, fileName, null);
assemblyApi.uploadFile(uploadDocumentRequest);
AssembleOptions assembleOptions = new AssembleOptions();
assembleOptions.setTemplateFileInfo(new TemplateFileInfo().filePath(fileName));
assembleOptions.setSaveFormat("docx");
assembleOptions.setReportData(Paths.get(dataFile).toString());
AssembleDocumentRequest request = new AssembleDocumentRequest(assembleOptions);
assemblyApi.assembleDocument(request);