Biblioteca Java para crear informes altamente personalizados mediante API REST
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 una amplia gama de formatos de entrada y salida, lo que permite almacenar archivos de plantilla en GroupDocs Cloud Storage, vincularlos a fuentes de datos XML o JSON y recibir el documento ensamblado en el formato que prefiera: DOCX, PDF, HTML, PPTX, XLSX, etc. Dado que todo el procesamiento se realiza en el servidor, no es necesario instalar software ni bibliotecas de terceros en el equipo cliente; el único requisito es un entorno de ejecución de Java y el SDK de Assembly Cloud, que proporciona envoltorios ligeros alrededor de los puntos finales de la API.
El flujo de trabajo típico de Java consta de tres sencillos pasos. Primero, agregue la dependencia del SDK de Assembly Cloud a su proyecto Maven o Gradle e inicialice ApiClient con su AppSID y AppKey personales. En segundo lugar, suba el archivo de plantilla a GroupDocs Cloud Storage mediante el método uploadFile. En tercer lugar, cree un objeto AssembleOptions, especifique la ruta de la plantilla, el archivo de datos (XML o JSON), el formato de salida deseado e invoque assembleDocument. El servicio devuelve el documento ensamblado como un flujo que puede guardarse localmente o procesarse posteriormente. El SDK también incluye métodos auxiliares para previsualizar plantillas, recuperar formatos compatibles y gestionar errores. Este sencillo enfoque permite integrar la generación de documentos en aplicaciones web, trabajos de procesamiento por lotes o microservicios 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 se escala automáticamente para gestionar grandes volúmenes de solicitudes y admite operaciones de combinación de correspondencia por lotes, donde una sola llamada a la API puede generar miles de cartas personalizadas. Además, el SDK permite incrustar imágenes, gráficos y códigos de barras, y aplicar lógica condicional directamente en la plantilla mediante expresiones de estilo LINQ, lo que le proporciona un control total sobre el diseño final del documento.
El siguiente fragmento muestra cómo cargar una plantilla, configurar la fuente de datos y generar un informe DOCX con la API de Assembly Cloud. Pasos
AssembleOptions: ruta de la plantilla, formato de salida y archivo de datos.assembleDocument para generar 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);