GroupDocs.Assembly Cloud SDK 为 Python 提供，帮助开发者自动创建格式丰富的文档，例如合同、发票、发货报告、销售提案、库存以及其他许多业务关键文档。该解决方案完全基于云，并通过 REST API 进行访问，这意味着任何能够发送 HTTP 请求的 Python 应用都可以按需生成文档，无需安装服务器端软件或第三方工具。
平台核心基于 document templates（文档模板），这些模板包含特殊的占位字段和编程结构。这些占位符会使用 LINQ 风格的表达式语法，自动替换为来自数据源（XML 或 JSON）的值。这种强大的方式让你能够嵌入图像、图表、条形码，为 HTML 输出设置背景颜色，从数组数据创建动态表格和列表，并使用条件逻辑来包含或排除文档的特定章节。由于 SDK 支持多种输入和输出格式，你可以从 DOCX 模板生成 PDF，生成 HTML 报告，或直接输出 OpenDocument 文件，而无需额外的转换步骤。
在 Python 中的典型工作流包括以下三步：
1️⃣ 创建模板 – 设计一个 Word、Excel、PowerPoint 或任何受支持的 Office/OpenOffice 文件，并插入占位字段和生成规则。
2️⃣ 准备数据源 – 提供符合模板中占位符的 XML 或 JSON 格式数据。
3️⃣ 编写少量 Python 代码 – 使用 groupdocsassemblycloud 包将模板上传至 GroupDocs Cloud Storage，将数据源与期望的输出格式一起传递，并调用 AssembleDocument 操作。API 会在响应中直接返回组装好的文档，或将其存储在云端以供后续检索。
所有交互均采用 SSL/TLS 加密，身份验证通过你的个人 App SID 和 App Key 完成。这确保了文档和数据在云端处理时始终受到保护。SDK 的跨平台特性使你能够将文档生成集成到 Web 服务、批处理任务、桌面应用或无服务器函数中，实时可靠地输出可打印、Web 就绪或邮件就绪的文档。
Assembly Cloud API 支持的功能概览。
Assembly Cloud API 支持的文档格式。
支持的操作系统和开发环境
此 Python 示例演示如何上传模板、绑定数据文件，并使用 GroupDocs Assembly Cloud SDK 生成输出文档。
步骤
AssemblyApi。TemplateFileInfo 和 AssembleOptions。assemble_document 生成结果。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)