使用 Ruby SDK 生成文档

REST API 与 Ruby Cloud SDK 用于从模板和数据源组装、合并以及邮件合并文档

  • 适用于 cURL 的 GroupDocs.Assembly Cloud
  • GroupDocs.Assembly Cloud SDK 用于 .NET
  • GroupDocs.Assembly Cloud SDK 用于 Java
  • GroupDocs.Assembly Cloud SDK 用于 PHP
  • GroupDocs.Assembly Cloud SDK 用于 Python
  • GroupDocs.Assembly Cloud SDK 用于 Node.js
  • GroupDocs.Assembly Cloud SDK 用于 Go
  • GroupDocs.Assembly Cloud SDK 用于 C++
  • 用于Swift的GroupDocs.Assembly Cloud SDK
开始免费试用

GroupDocs.Assembly Cloud 是一项完全托管的、基于 REST 的服务,帮助你直接从 Ruby 应用程序创建高度自定义的文档。 平台采用模板‑数据模型:你设计一个模板文档(Word、Excel、PowerPoint、PDF、HTML 等),其中包含特殊占位字段和可编程结构。运行时,你提供 XML 或 JSON 格式的数据源,使用 LINQ 风格的表达式语法将数据绑定到模板,云服务即可组装出所需格式的最终文档。

这种方式消除了对本地 Office 安装、第三方库或复杂渲染引擎的需求–所有繁重工作都在安全的 GroupDocs 数据中心完成。你将获得对 邮件合并动态表格条件内容条形码生成图像和图表插入 以及丰富格式化选项的内置支持。服务还提供 SSL/TLS 加密 通信、个人访问密钥用于身份验证,以及基于角色的权限来保护你的数据安全。

Ruby 工作流与 SDK

  1. 安装 Ruby gemgem install groupdocs_assembly_cloud)。
  2. 配置 SDK,使用你的 app_sidapi_key
  3. 上传 模板文件到 GroupDocs Cloud Storage,通过 UploadFile 接口。
  4. 准备 一个 AssembleOptions 对象,引用已上传的模板,指定所需的输出格式,并提供 XML/JSON 数据源(或包含该数据的文件)。
  5. 调用 assemble_document – API 返回组装好的文档,你可以直接下载或存回 Cloud Storage。

通过这套简洁的步骤,你可以按需生成合同、发票、提案、运输报告、个性化信函或任何其他业务关键文档,并可从单次请求扩展到大批量处理场景,支持邮件合并。

Ruby SDK 还提供用于存储操作、错误处理和请求超时自定义的辅助类,使其能够无缝集成到 Rails、Sinatra 或任何基于 Ruby 的服务中。

文档组装 REST API 功能

从带占位符的模板生成文档

LINQ‑风格的数据绑定,适用于 XML 和 JSON 源

将图像、图表和图形插入输出

从数组数据创建动态表格

使用表达式的条件内容块

通过个人访问密钥安全访问 API

支持批量个性化信函的邮件合并

生成并嵌入条形码(QR、Code128 等)

为 HTML 输出设置背景颜色

SSL/TLS 加密数据传输

在 Ruby 中生成文档

下面的代码片段展示了如何使用 Assembly Cloud Ruby SDK 生成文档。执行的步骤:

  1. 使用你的 App SID 和 API 密钥配置 SDK。
  2. 将模板文件上传至云存储。
  3. 定义 AssembleOptions – 模板、输出格式和数据源。
  4. 调用 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

支持和学习资源

GroupDocs.Assembly Cloud 还提供针对其他语言的 SDKs:

  中文
700acfb5f