Thư viện Python để 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 SDK cho Python cho phép các nhà phát triển tự động tạo ra các tài liệu được định dạng phong phú như hợp đồng, hoá đơn, báo cáo giao hàng, đề xuất bán hàng, tồn kho và nhiều tài liệu quan trọng khác cho doanh nghiệp. Giải pháp hoàn toàn dựa trên đám mây và được truy cập thông qua một REST API, có nghĩa là bất kỳ ứng dụng Python nào có khả năng gửi yêu cầu HTTP đều có thể tạo tài liệu theo yêu cầu mà không cần cài đặt phần mềm phía máy chủ hay công cụ của bên thứ ba.
Ở lõi, nền tảng hoạt động với document templates chứa các trường placeholder đặc biệt và các cấu trúc lập trình. Các placeholder này tự động được thay thế bằng giá trị lấy từ nguồn dữ liệu (XML hoặc JSON) bằng cú pháp biểu thức kiểu LINQ. Cách tiếp cận mạnh mẽ này cho phép bạn nhúng hình ảnh, biểu đồ, mã vạch, đặt màu nền cho đầu ra HTML, tạo bảng và danh sách động từ dữ liệu mảng, và áp dụng logic điều kiện để bao gồm hoặc loại bỏ các phần của tài liệu. Vì SDK hỗ trợ đa dạng các định dạng đầu vào và đầu ra, bạn có thể tạo một PDF từ mẫu DOCX, tạo báo cáo HTML, hoặc xuất file OpenDocument mà không cần bước chuyển đổi thêm.
Quy trình điển hình trong Python bao gồm ba bước đơn giản:
1️⃣ Tạo mẫu – thiết kế một file Word, Excel, PowerPoint hoặc bất kỳ file Office/OpenOffice nào được hỗ trợ và chèn các trường placeholder cùng quy tắc tạo.
2️⃣ Chuẩn bị nguồn dữ liệu – cung cấp dữ liệu của bạn ở định dạng XML hoặc JSON, phù hợp với các placeholder đã định nghĩa trong mẫu.
3️⃣ Viết một vài dòng mã Python – sử dụng gói groupdocsassemblycloud để tải mẫu lên GroupDocs Cloud Storage, truyền nguồn dữ liệu cùng định dạng đầu ra mong muốn, và gọi thao tác AssembleDocument. API sẽ trả về tài liệu đã lắp ráp trực tiếp trong phản hồi hoặc lưu nó trong Cloud để truy xuất sau.
Tất cả các tương tác đều được bảo mật bằng mã hóa SSL/TLS, và xác thực được thực hiện qua App SID cá nhân của bạn và App Key. Điều này đảm bảo tài liệu và dữ liệu của bạn luôn được bảo vệ trong quá trình xử lý trên đám mây. Tính đa nền tảng của SDK cho phép bạn tích hợp việc tạo tài liệu vào dịch vụ web, công việc batch, ứng dụng desktop, hoặc hàm serverless, cung cấp các tài liệu có thể in, sẵn sàng cho web hoặc email ngay lập tức và đáng tin cậy.
Ví dụ Python này minh họa cách tải lên một mẫu, liên kết tệp dữ liệu và tạo tài liệu đầu ra bằng Assembly GroupDocs Cloud SDK.
Steps
AssemblyApi với App SID và App Key của bạn.TemplateFileInfo và AssembleOptions.assemble_document để tạo kết quả.import groupdocsassemblycloud
# Initialize API client (replace with your credentials)
assembly_api = groupdocsassemblycloud.AssemblyApi('####################', '####################')
# 1️⃣ Upload the template
file_name = 'Input1.docx'
with open(file_name, 'rb') as request_file_content:
upload_request = groupdocsassemblycloud.models.requests.UploadFileRequest(
file_content=request_file_content,
path=file_name
)
assembly_api.upload_file(upload_request)
# 2️⃣ Load data source (could be XML, JSON or DOCX)
data_file = 'Input2.docx'
with open(data_file, 'rb') as data:
template_info = groupdocsassemblycloud.models.TemplateFileInfo(file_name)
# 3️⃣ Set assemble options (output format: docx)
assemble_options = groupdocsassemblycloud.models.AssembleOptions(
template_info,
"docx",
data
)
# 4️⃣ Assemble the document
request = groupdocsassemblycloud.models.requests.AssembleDocumentRequest(assemble_options)
result = assembly_api.assemble_document(request)
print("Document generated successfully:", result.path)