Trình tạo báo cáo cho Swift

Thư viện Swift để xây dựng báo cáo tùy chỉnh cao bằng cách sử dụng REST API

  • GroupDocs.Assembly Cloud cho cURL
  • GroupDocs.Assembly Cloud SDK cho .NET
  • GroupDocs.Assembly Cloud SDK cho Java
  • GroupDocs.Assembly Cloud SDK cho C++
  • GroupDocs.Assembly Cloud SDK cho Go
  • GroupDocs.Assembly Cloud SDK cho Node.js
  • GroupDocs.Assembly Cloud SDK cho PHP
  • GroupDocs.Assembly Cloud SDK cho Python
  • GroupDocs.Assembly Cloud SDK cho Ruby
  • GroupDocs.Assembly Cloud SDK cho Swift
Bắt đầu dùng thử miễn phí

GroupDocs.Assembly Cloud là 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 các báo cáo, hợp đồng, hoá đơn, đề xuất và bất kỳ loại tài liệu nào khác với định dạng phong phú trực tiếp từ các ứng dụng Swift. Dịch vụ hoạt động trên nền tảng GroupDocs Cloud Storage – các mẫu và dữ liệu được tải lên đám mây, engine lắp ráp xử lý chúng, và tài liệu hoàn thiện được trả về cho khách hàng mà không cần cài đặt Office cục bộ. Điều này loại bỏ gánh nặng duy trì thư viện bên thứ ba, giảm tải xử lý phía máy chủ và đảm bảo hỗ trợ các định dạng mới nhất (DOCX, PDF, PPTX, XLSX, HTML, v.v.) luôn sẵn sàng.

Với Swift SDK, toàn bộ quy trình tự nhiên khớp với vòng đời phát triển iOS/macOS điển hình:

  1. Chuẩn bị mẫu – một Word, Excel, PowerPoint hoặc bất kỳ định dạng nào được hỗ trợ có chứa các placeholder (ví dụ: {{Customer.Name}}) và các quy tắc sinh tùy chọn được viết bằng cú pháp kiểu LINQ.
  2. 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 placeholder. Các cấu trúc phức tạp như mảng có thể được dùng để sinh bảng, biểu đồ hoặc các phần lặp lại.
  3. Tải mẫu lên lên GroupDocs Cloud Storage bằng một lời gọi API duy nhất (SDK xử lý yêu cầu multipart).
  4. Gọi endpoint 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ụ: sinh một PDF từ mẫu DOCX).
  5. Nhận tài liệu đã lắp ráp – dịch vụ truyền luồng kết quả ngược lại; SDK có thể lưu cục bộ, gửi qua email, hoặc lưu lại trong Cloud Storage.

SDK trừu tượng hoá mọi chi tiết HTTP – bạn chỉ cần cung cấp App SID và App Key (token truy cập cá nhân). Tất cả giao tiếp được mã hoá bằng SSL/TLS, xử lý lỗi tuân theo mã trạng thái chuẩn HTTP, và dịch vụ tuân thủ các tiêu chuẩn bảo mật cấp doanh nghiệp. Vì xử lý diễn ra trên đám mây, cùng một mã Swift hoạt động trên iPhone, iPad, Mac hoặc bất kỳ nền tảng nào có thể thực thi mã Swift và thực hiện các yêu cầu mạng.

Các tab dưới đây cung cấp một tổng quan ngắn gọn về các tính năng được Assembly Cloud hỗ trợ cho Swift, danh sách đầy đủ các định dạng tài liệu, và 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 lắp ráp tài liệu REST API

Lắp ráp tài liệu dựa trên đám mây qua REST API

Các chỗ giữ chỗ mẫu để chèn dữ liệu

Ràng buộc biểu thức kiểu LINQ cho XML/JSON

Nhúng tài liệu, hình ảnh, biểu đồ bên ngoài

Các danh sách động, bảng và khối điều kiện

Công thức và phép tính bảng tính

Thuộc tính và tệp đính kèm của nội dung email

Tạo mã vạch (QR, Code128, v.v.)

Định dạng màu nền cho HTML

Ghép thư để tạo các lá thư cá nhân hoá hàng loạt

Truyền dữ liệu bảo mật bằng SSL/TLS

Tải mẫu lên Cloud Storage

Tạo tài liệu trong Swift

Đoạn mã dưới đây minh họa cách tạo báo cáo bằng Assembly Cloud SDK cho Swift. Nó tải lên một mẫu, đọc tệp dữ liệu, cấu hình các tùy chọn lắp ráp và gọi API.

Các bước

  1. Khởi tạo AssemblyApi với App SID và App Key của bạn.
  2. Tải tài liệu mẫu lên Cloud Storage.
  3. Tải dữ liệu báo cáo (XML/JSON) từ tệp cục bộ.
  4. Tạo TemplateFileInfo trỏ tới mẫu đã tải lên.
  5. Đặt định dạng đầu ra mong muốn (ví dụ: docx).
  6. Xây dựng đối tượng AssembleOptions với mẫu, dữ liệu và định dạng.
  7. Gọi assembleDocument và nhận 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)

Support and Learning Resources

GroupDocs.Assembly Cloud cũng cung cấp lắp ráp tài liệu riêng lẻ SDKs cho các ngôn ngữ khác như liệt kê dưới đây:

  Tiếng Việt
d54ae746f