Thư viện Java để xây dựng các báo cáo tùy chỉnh cao bằng cách sử dụng REST API
Bắt đầu dùng thử miễn phíGroupDocs.Assembly Cloud là một dịch vụ được quản lý hoàn toàn, dựa trên REST, cho phép nhà phát triển Java tạo các tài liệu, báo cáo, hợp đồng, hóa đơn và thư ghép có độ tùy chỉnh cao trực tiếp từ đám mây. Giải pháp hỗ trợ đa dạng các định dạng đầu vào và đầu ra, cho phép bạn lưu các tệp mẫu trong GroupDocs Cloud Storage, liên kết chúng với nguồn dữ liệu XML hoặc JSON, và nhận tài liệu đã được ghép ở định dạng bạn chọn – DOCX, PDF, HTML, PPTX, XLSX, v.v. Vì mọi xử lý diễn ra phía máy chủ, bạn không cần cài đặt bất kỳ phần mềm hoặc thư viện bên thứ ba nào trên máy khách; yêu cầu duy nhất là môi trường chạy Java và Assembly Cloud SDK, cung cấp các wrapper nhẹ quanh các endpoint API.
Quy trình làm việc điển hình của Java bao gồm ba bước đơn giản. Đầu tiên, thêm phụ thuộc Assembly Cloud SDK vào dự án Maven hoặc Gradle của bạn và khởi tạo ApiClient bằng App SID và App Key cá nhân. Thứ hai, tải tệp mẫu lên GroupDocs Cloud Storage bằng phương thức uploadFile. Thứ ba, tạo một đối tượng AssembleOptions, chỉ định đường dẫn tới mẫu, tệp dữ liệu (XML hoặc JSON), định dạng đầu ra mong muốn, và gọi assembleDocument. Dịch vụ trả về tài liệu đã được ghép dưới dạng luồng, có thể lưu cục bộ hoặc xử lý tiếp. SDK cũng cung cấp các phương thức trợ giúp để xem trước mẫu, lấy danh sách định dạng hỗ trợ và xử lý lỗi. Cách tiếp cận đơn giản này cho phép bạn tích hợp việc tạo tài liệu vào các ứng dụng web, công việc xử lý batch, hoặc micro‑service với ít mã nhất.
Tất cả giao tiếp được mã hoá bằng SSL/TLS, và quyền truy cập được kiểm soát bằng các khóa cá nhân. Nền tảng tự động mở rộng để xử lý khối lượng lớn yêu cầu và hỗ trợ ghép thư hàng loạt, trong đó một lời gọi API duy nhất có thể tạo hàng ngàn thư cá nhân hoá. Ngoài ra, SDK hỗ trợ nhúng hình ảnh, biểu đồ, mã vạch và áp dụng logic điều kiện trực tiếp trong mẫu bằng các biểu thức kiểu LINQ, cho phép bạn kiểm soát toàn bộ bố cục tài liệu cuối cùng.
Đoạn mã dưới đây minh họa cách tải lên một mẫu, thiết lập nguồn dữ liệu và tạo báo cáo DOCX bằng Assembly Cloud API. Các bước
AssembleOptions – đường dẫn mẫu, định dạng đầu ra và tệp dữ liệu.assembleDocument để tạo kết quả.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);