Libreria Java per creare report altamente personalizzati usando REST API
Inizia la prova gratuitaGroupDocs.Assembly Cloud è un servizio completamente gestito, basato su REST, che consente agli sviluppatori Java di creare documenti, report, contratti, fatture e lettere di stampa unione altamente personalizzati direttamente dal cloud. La soluzione supporta un ampio set di formati di input e output, consentendoti di archiviare i file modello in GroupDocs Cloud Storage, collegarli a fonti dati XML o JSON, e ricevere il documento assemblato nel formato che preferisci – DOCX, PDF, HTML, PPTX, XLSX, ecc. Poiché tutto l’elaborazione avviene sul lato server, non è necessario installare alcun software o libreria di terze parti sul dispositivo client; l’unico requisito è un runtime Java e l’Assembly Cloud SDK, che fornisce wrapper leggeri intorno agli endpoint API.
Un tipico flusso di lavoro Java consiste in tre semplici passaggi. Primo, aggiungi la dipendenza Assembly Cloud SDK al tuo progetto Maven o Gradle e inizializza il ApiClient con il tuo App SID e App Key personali. Secondo, carica il file modello su GroupDocs Cloud Storage usando il metodo uploadFile. Terzo, crea un oggetto AssembleOptions, specifica il percorso del modello, il file dati (XML o JSON), il formato di output desiderato e invoca assembleDocument. Il servizio restituisce il documento assemblato come stream, che può essere salvato localmente o ulteriormente elaborato. Il SDK espone anche metodi di supporto per l’anteprima dei modelli, il recupero dei formati supportati e la gestione degli errori. Questo approccio semplice ti permette di integrare la generazione di documenti in applicazioni web, processi batch o micro‑servizi con poco codice.
Tutte le comunicazioni sono criptate con SSL/TLS, e l’accesso è controllato da chiavi personali. La piattaforma scala automaticamente per gestire grandi volumi di richieste e supporta operazioni batch di stampa unione, dove una singola chiamata API può generare migliaia di lettere personalizzate. Inoltre, il SDK supporta l’inserimento di immagini, grafici, codici a barre e l’applicazione di logica condizionale direttamente nel modello usando espressioni in stile LINQ, offrendoti il pieno controllo sul layout finale del documento.
Il frammento qui sotto dimostra come caricare un template, impostare la sorgente dati e generare un report DOCX usando Assembly Cloud API.
Passaggi
AssembleOptions – percorso del template, formato di output e file dei dati.assembleDocument per produrre il risultato.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);