GroupDocs.Assembly Cloud 是一项完全托管的、基于 REST 的服务,帮助你直接从 Ruby 应用程序创建高度自定义的文档。 平台采用模板‑数据模型:你设计一个模板文档(Word、Excel、PowerPoint、PDF、HTML 等),其中包含特殊占位字段和可编程结构。运行时,你提供 XML 或 JSON 格式的数据源,使用 LINQ 风格的表达式语法将数据绑定到模板,云服务即可组装出所需格式的最终文档。
这种方式消除了对本地 Office 安装、第三方库或复杂渲染引擎的需求–所有繁重工作都在安全的 GroupDocs 数据中心完成。你将获得对 邮件合并、动态表格、条件内容、条形码生成、图像和图表插入 以及丰富格式化选项的内置支持。服务还提供 SSL/TLS 加密 通信、个人访问密钥用于身份验证,以及基于角色的权限来保护你的数据安全。
gem install groupdocs_assembly_cloud)。app_sid 和 api_key。UploadFile 接口。AssembleOptions 对象,引用已上传的模板,指定所需的输出格式,并提供 XML/JSON 数据源(或包含该数据的文件)。assemble_document – API 返回组装好的文档,你可以直接下载或存回 Cloud Storage。通过这套简洁的步骤,你可以按需生成合同、发票、提案、运输报告、个性化信函或任何其他业务关键文档,并可从单次请求扩展到大批量处理场景,支持邮件合并。
Ruby SDK 还提供用于存储操作、错误处理和请求超时自定义的辅助类,使其能够无缝集成到 Rails、Sinatra 或任何基于 Ruby 的服务中。
下面的代码片段展示了如何使用 Assembly Cloud Ruby SDK 生成文档。执行的步骤:
AssembleOptions – 模板、输出格式和数据源。assemble_document 获取组装后的文件。require_relative '../lib/groupdocs_assembly_cloud'
GroupDocsAssemblyCloud.configure do |config|
config.client_data['app_sid'] = '####-####-####-####-####'
config.client_data['api_key'] = '##################'
end
@assembly_api = AssemblyApi.new
file_name = 'Input1.docx'
data_file = 'Input2.docx'
request_file_content = File.open(file_name)
upload_document_request = UploadFileRequest.new(
file_content: request_file_content, path: file_name)
@assembly_api.upload_file(upload_document_request)
template_file_info = TemplateFileInfo.new(:FilePath => file_name)
assemble_options = AssembleOptions.new(
:TemplateFileInfo => template_file_info,
:SaveFormat => "docx",
:ReportData => File.open(data_file, 'rb') { |f| f.read })
request = AssembleDocumentRequest.new assemble_options
@assembly_api.assemble_document request