Java‑Bibliothek zum Erstellen hochgradig angepasster Berichte mittels REST‑API
Kostenlos testenGroupDocs.Assembly Cloud ist ein vollständig verwalteter, REST‑basierter Dienst, der Java‑Entwicklern ermöglicht, hochgradig angepasste Dokumente, Berichte, Verträge, Rechnungen und Serienbriefschreiben direkt aus der Cloud zu erstellen. Die Lösung arbeitet mit einer breiten Palette von Eingabe‑ und Ausgabeformaten, sodass Sie Vorlagendateien im GroupDocs Cloud Storage speichern, sie an XML‑ oder JSON‑Datenquellen binden und das zusammengeführte Dokument im gewünschten Format erhalten können – DOCX, PDF, HTML, PPTX, XLSX usw. Da die gesamte Verarbeitung serverseitig erfolgt, ist keine Installation von Drittanbieter‑Software oder Bibliotheken auf dem Client‑Rechner erforderlich; die einzige Voraussetzung ist eine Java‑Laufzeitumgebung und das Assembly Cloud SDK, das schlanke Wrapper um die API‑Endpunkte bereitstellt.
Ein typischer Java‑Arbeitsablauf besteht aus drei einfachen Schritten. Zuerst fügen Sie die Assembly Cloud SDK‑Abhängigkeit zu Ihrem Maven‑ oder Gradle‑Projekt hinzu und initialisieren den ApiClient mit Ihrem persönlichen App SID und App Key. Zweitens laden Sie die Vorlagendatei mithilfe der Methode uploadFile in den GroupDocs Cloud Storage hoch. Drittens erstellen Sie ein AssembleOptions‑Objekt, geben den Pfad der Vorlage, die Datendatei (XML oder JSON), das gewünschte Ausgabeformat an und rufen assembleDocument auf. Der Service gibt das zusammengeführte Dokument als Stream zurück, der lokal gespeichert oder weiterverarbeitet werden kann. Das SDK stellt zudem Hilfsmethoden zum Voransicht von Vorlagen, zum Abrufen unterstützter Formate und zur Fehlerbehandlung bereit. Dieser unkomplizierte Ansatz ermöglicht die Integration der Dokumentenerstellung in Webanwendungen, Batch‑Verarbeitungsjobs oder Micro‑Services mit minimalem Code.
Alle Kommunikation ist mit SSL/TLS verschlüsselt und der Zugriff wird über persönliche Schlüssel gesteuert. Die Plattform skaliert automatisch, um große Mengen von Anfragen zu bewältigen, und unterstützt Batch‑Serienbrief‑Operationen, bei denen ein einzelner API‑Aufruf Tausende personalisierter Briefe erzeugen kann. Außerdem unterstützt das SDK das Einbetten von Bildern, Diagrammen, Barcodes und das Anwenden von bedingter Logik direkt in der Vorlage mittels LINQ‑ähnlicher Ausdrücke, sodass Sie die vollständige Kontrolle über das endgültige Dokumentlayout haben.
Das nachstehende Snippet zeigt, wie Sie eine Vorlage hochladen, die Datenquelle festlegen und einen DOCX‑Bericht mit der Assembly Cloud API erzeugen.
Schritte
AssembleOptions – Vorlagepfad, Ausgabeformat und Datendatei.assembleDocument auf, um das Ergebnis zu erzeugen.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);