Ruby 的 PDF 文档生成器

Ruby 库,用于使用 REST API 构建高度自定义的 PDF 报告

将基于模板和数据源的 PDF 文档生成无缝集成到您的 Ruby 软件中。

在 Ruby 中自动生成 PDF 文档,使用 Ruby SDK 创建任何复杂的可打印的 PDF 报告。这种基于云的解决方案围绕模板、数据源和强大的 LINQ 语法构建,使 Ruby 开发人员能够灵活地满足精确的技术和业务需求。

使用这个 Ruby 库,您可以在任何操作系统上以编程方式构建高度自定义的 PDF 报告。格式丰富的 PDF 文档(如合同、订单、发票、装运报告、销售建议、库存)可以作为 Ruby 软件的一部分即时组装。

使用 Ruby 简化 PDF 文档的生成

在过去的几十年中,文档自动化和报告生成的重要性已经大大提高。几乎每家公司都需要生成文档并按时交付给合作伙伴或客户。此外,它通常是财务成功的决定性因素。实施此类技术可以减少人工数据输入、人为错误、校对和文书工作,从而节省大量资金。由于这些原因,文档自动化和报告工具是许多旨在为用户提供高级分析功能的现代软件解决方案的组成部分。

一般而言,PDF 报告生成是将文本、数据和图形组合成一个实体并将结果以方便的可视形式导出为 PDF 文件格式的过程。有关支持的 I/O 格式的信息,请访问我们的文档

什么是 GroupDocs Assembly for Ruby

GroupDocs Assembly for Ruby 是一个基于云的解决方案,用于使用模板和数据源生成 PDF 文档。文档模板充当基本框架,除了标准内容(文本、表格、图表等)之外,还包括用于插入来自数据源的值的特殊占位符字段。不仅可以插入单个值,还可以插入表格和图形形式的整个数据数组。

该模板还包含控制数据选择和条件处理的编程结构— PDF 文档生成规则。将数据绑定到文档模板使用 LINQ 表达式语法,它允许开发人员以通用方式处理数据,而不管使用的数据源类型如何。通过这种方式,我们的 Ruby Cloud SDK 为您提供了 PDF 内容生成的灵活性和一组强大的数据处理方法。

该产品还支持 Mail Merge 功能,以防您希望以 PDF 格式创建批量个性化信件并将其发送给客户。您只需将 Mail Merge 字段插入文档模板并将其与数据源一起传递给 Cloud API。

无论您要实现的 PDF 文档自动化的规模和类型如何,在 Ruby 中构建报告都需要三个步骤:

  • 创建一个带有占位符字段和文档生成规则的 Word 文档模板,以规范结构和内容的变化
  • 创建 PDF 或 JSON 格式的数据源
  • 编写几行 Ruby 代码,将所有内容传递给 Document Building API,并以 PDF 格式返回组装结果

设计文档模板并使用 PDF 文档生成规则

设计模板是一项艰巨的任务。除了清楚地了解最终 PDF 文档的要求外,还需要分析和编程技能。一个好的模板设计应该反映客户对特定问题的看法。最有效的方法是将表格数据和图形以适当的平衡结合起来,由业务需求决定。

如上所述,模板结构通常包含一些固定的内容块(文本、图像、徽标等),并混合了控制 PDF 文档组装逻辑的特殊编程结构。这些 PDF 文档生成规则是使用特殊的表达式语法定义的,它使开发人员能够执行以下操作:

  • 嵌入外部文档内容、图像、图表、列表、表格、超链接、书签等。
  • 使用公式和顺序数据操作处理数据
  • 指定数字、文本、图形、图形以及日期和时间元素的表示格式
  • 根据条件表达式插入内容块
  • 为只计算一次的"昂贵"计算定义特殊变量
  • 组装电子表格文档时计算公式
  • 分配电子邮件正文属性并动态创建附件
  • 创建和插入条形码
  • 为 HTML 文档设置背景颜色

您可以在我们的开发人员指南中了解有关模板语法的更多信息。

要求

GroupDocs Assembly for Ruby 不需要安装任何外部软件或第三方工具。这是一个基于云的 PDF 解决方案,其中所有编程交互都使用 REST API 通过网络执行。

安全

所有 GroupDocs 产品都完全符合行业安全标准:数据传输使用 SSL 协议进行,消除了信息被第三方截获的可能性。要连接到 GroupDocs 云服务,您需要使用个人访问密钥。请参阅快速入门指南。

在 Ruby 中生成 PDF 文档

以下代码示例展示了如何使用 Ruby 生成 PDF 报告。

在 Ruby 中生成 PDF 文档
输入文件
上传文档模板
输出格式
从列表中选择目标格式
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.pdf'
data_file= 'Input2.pdf'

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 => "pdf", 
		    :ReportData => File.open(data_file, 'rb') { |f| f.read })
request = AssembleDocumentRequest.new assemble_options
@assembly_api.assemble_document request
  
将代码Ruby复制到剪贴板

如何使用 Ruby 生成 PDF 文档

  1. 安装'GroupDocs.Assembly Cloud SDK for Ruby' 。
  2. 将库引用(导入库)添加到您的 Ruby 项目。
  3. 创建一个模板文档,添加控制从数据源插入数据的编程结构。
  4. 创建数据源。
  5. 将文档模板上传至 GroupDocs 云存储(需要登录个人账户)。
  6. 通过将模板和数据传递给 Cloud API 来生成文档。

如何为 Ruby 安装 PDF Report Builder

使用 RubyGems 托管服务安装 GroupDocs.Assembly Cloud SDK for Ruby 。运行 gem install groupdocs_assembly_cloud 来安装包。作为替代方案,您可以从 GitHub 手动克隆 GroupDocs.Assembly Cloud SDK for Ruby 源代码并在您的项目中使用它。请按照这些 Instructions 快速获取必要的安全凭证并访问我们的 REST API。

系统要求

Ruby 2.6 或更新版本

请参阅 Repository Documentation 以查看详细信息。

其他支持的文档格式

您可以生成其他文件格式的报告:

5%

订阅 Aspose 产品更新

获取直接发送到您的邮箱的每月通讯和优惠。

© Aspose Pty Ltd 2001-2024. 版权所有。