Trình tạo báo cáo cho Swift
Thư viện Swift để xây dựng các báo cáo tùy chỉnh cao bằng cách sử dụng REST API
Thư viện Swift để xây dựng các báo cáo tùy chỉnh cao bằng cách sử dụng REST API
GroupDocs.AssemblyCloud là một dịch vụ lắp ráp tài liệu dựa trên REST được quản lý hoàn toàn, cho phép các nhà phát triển tạo báo cáo, hợp đồng, hóa đơn, đề xuất và bất kỳ loại tài liệu nào khác được định dạng phong phú trực tiếp từ các ứng dụng Swift. Dịch vụ này hoạt động trên nền tảng Lưu trữ Đám mây GroupDocs – các mẫu và dữ liệu được tải lên đám mây, công cụ lắp ráp sẽ xử lý chúng và tài liệu hoàn chỉnh được trả về cho máy khách mà không cần cài đặt Office cục bộ. Điều này giúp loại bỏ chi phí duy trì các thư viện của bên thứ ba, giảm tải xử lý phía máy chủ và đảm bảo hỗ trợ định dạng mới nhất (DOCX, PDF, PPTX, XLSX, HTML, v.v.) luôn khả dụng.
Với Swift SDK, toàn bộ quy trình làm việc sẽ tự động phù hợp với chu trình phát triển iOS/macOS điển hình:
Chuẩn bị mẫu – Word, Excel, PowerPoint hoặc bất kỳ định dạng nào được hỗ trợ có chứa các ký tự giữ chỗ (ví dụ: {{Customer.Name}}) và các quy tắc tạo tùy chọn được viết theo cú pháp kiểu LINQ.
Tạo nguồn dữ liệu – một tệp JSON hoặc XML cung cấp các giá trị cho các trình giữ chỗ. Các cấu trúc phức tạp như mảng có thể được sử dụng để tạo bảng, biểu đồ hoặc các phần lặp lại.
Tải mẫu lên GroupDocs Cloud Storage bằng một lệnh gọi API duy nhất (SDK xử lý yêu cầu nhiều phần).
Gọi điểm cuối Assemble – truyền đường dẫn đám mây của mẫu, nội dung nguồn dữ liệu và định dạng đầu ra mong muốn (định dạng đầu ra có thể khác với định dạng mẫu, ví dụ: tạo PDF từ mẫu DOCX).
Nhận tài liệu đã được lắp ráp – dịch vụ sẽ truyền phát kết quả trở lại; SDK có thể lưu trữ cục bộ, gửi qua email hoặc lưu trữ lại trong Cloud Storage.
SDK tóm tắt tất cả các chi tiết HTTP – bạn chỉ cần cung cấp App SID và App Key (mã thông báo truy cập cá nhân). Mọi giao tiếp đều được mã hóa bằng SSL/TLS, xử lý lỗi tuân theo mã trạng thái HTTP tiêu chuẩn và dịch vụ tuân thủ các tiêu chuẩn bảo mật cấp ngành. Vì quá trình xử lý được thực hiện trên đám mây, cùng một mã Swift có thể hoạt động trên iPhone, iPad, Mac hoặc bất kỳ nền tảng nào khác có thể thực thi mã Swift và thực hiện các yêu cầu mạng.
Các tab sau đây cung cấp tổng quan ngắn gọn về các tính năng được AssemblyCloud hỗ trợ cho Swift, danh sách đầy đủ các định dạng tài liệu và các hệ điều hành/công cụ phát triển tương thích với SDK.
Các tính năng cốt lõi của Assembly Cloud API dành cho Swift.
Các định dạng tài liệu được Assembly Cloud API hỗ trợ.
Hệ điều hành và khung phát triển được hỗ trợ.
Đoạn mã dưới đây minh họa cách tạo báo cáo bằng Assembly Cloud SDK cho Swift. SDK này tải lên một mẫu, đọc tệp dữ liệu, cấu hình các tùy chọn assembly và gọi API.
Các bước
AssemblyApi với App SID và App Key của bạn.TemplateFileInfo trỏ đến mẫu đã tải lên.AssembleOptions với mẫu, dữ liệu và định dạng.assembleDocument và lấy tệp đã lắp ráp.import GroupDocsAssemblyCloud
let assemblyApi = AssemblyApi(appSid: "......##", appKey: "......##")
let fileName = "Input1.docx"
let dataFile = "Input2.docx"
// Upload template
let requestFileContent = InputStream(url: URL(string: fileName)!)!
let uploadDocumentRequest = UploadFileRequest(fileContent: requestFileContent, path: fileName)
_ = try assemblyApi.uploadFile(request: uploadDocumentRequest)
// Prepare template info
let templateFileInfo = TemplateFileInfo()
templateFileInfo.setFilePath(filePath: fileName)
// Load data
let reportData = try String(contentsOfFile: dataFile, encoding: .utf8)
// Assemble options
let assembleOptions = AssembleOptions()
assembleOptions.setTemplateFileInfo(templateFileInfo: templateFileInfo)
assembleOptions.setSaveFormat(saveFormat: "docx")
assembleOptions.setReportData(reportData: reportData)
// Execute assembly
let request = AssembleDocumentRequest(assembleOptions: assembleOptions)
let result = try assemblyApi.assembleDocument(request: request)