GroupDocs.Assembly Cloud 是一项完全托管的、基于 REST 的服务,可让您直接从 Ruby 应用程序创建高度自定义的文档。 该平台采用模板和数据模型:您可以设计一个包含特殊占位符字段和可编程结构的模板文档(Word、Excel、PowerPoint、PDF、HTML 等)。在运行时,您可以提供 XML 或 JSON 格式的数据源,使用 LINQ 风格的表达式语法将数据绑定到模板,然后云服务会以您需要的格式组装最终文档。
这种方法无需任何本地 Office 安装、第三方库或复杂的渲染引擎——所有繁重的工作都在安全的 GroupDocs 数据中心完成。您将获得对邮件合并、动态表格、条件内容、条形码生成、图像和图表插入以及丰富的格式选项的内置支持。该服务还提供SSL/TLS 加密通信、用于身份验证的个人访问密钥以及基于角色的权限,以确保您的数据安全。
. 使用 SDK 的 Ruby 工作流程
gem install groupdocs_assembly_cloud)。app_sid 和 api_key 配置 SDK。UploadFile 端点上传模板文件到 GroupDocs 云存储。AssembleOptions 对象,该对象引用已上传的模板,指定所需的输出格式,并提供 XML/JSON 数据源(或包含该数据源的文件)。assemble_document – 该 API 返回组装好的文档,您可以直接下载或将其存储回云存储。使用这个简单的序列,您可以按需生成合同、发票、提案、运输报告、个性化信函或任何其他业务关键文档,并从单个请求扩展到使用邮件合并的大型批处理场景。
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'] = '......'
结束
@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 })
请求 = AssembleDocumentRequest.new assemble_options
@assembly_api.assemble_document 请求