使用 Ruby SDK 生成文档

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

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

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

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

. 使用 SDK 的 Ruby 工作流程

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

使用这个简单的序列,您可以按需生成合同、发票、提案、运输报告、个性化信函或任何其他业务关键文档,并从单个请求扩展到使用邮件合并的大型批处理场景。

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

文档组装 REST API 功能

使用占位符从模板生成文档

XML 和 JSON 源的 LINQ 样式数据绑定

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

从数组数据创建动态表

使用表达式的条件内容块

通过个人访问密钥保护 API 访问

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

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

设置 HTML 输出的背景颜色

SSL/TLS加密数据传输

使用 Ruby 生成文档

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

  1. 使用您的应用 SID 和 API 密钥配置 SDK。
  2. 将模板文件上传到 Cloud Storage。
  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'] = '......'
结束

@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 请求

支持和学习资源

GroupDocs.Assembly Cloud 还提供其他语言的 SDK:

  中文