如何使用 Ruby 将 Excel 电子表格转换为 PDF

如何在 Ruby 中使用 REST API 将 Excel 电子表格转换为 PDF?

Excel 电子表格广泛用于创建收据、发票、分类账、库存、账户和其他报告。 XLS 或 XLSX 到 PDF 的转换 API 允许以可移植的形式与他人共享 Excel 数据。作为 Ruby 开发人员,您可以在云端以编程方式轻松地将 Excel 电子表格转换为 PDF 文档。在本文中,我们将学习如何使用 Ruby 将 Excel 电子表格转换为 PDF。

本文应涵盖以下主题:

Excel 到 PDF 转换 REST API 和 Ruby SDK

要将 XLSX 转换为 PDF,我们将使用 GroupDocs.Conversion Cloud API 的 Ruby SDK。 API 允许您将文档转换为您需要的任何格式。 Cloud API还支持Word、Excel、PowerPoint, PDF、HTML、JPG、PNG、CAD等50多种文档的转换。 REST API 还为 Cloud EST API 提供 .NET、Java、PHP、Node.js、Android 和 Python SDK 作为其文档转换家族成员

您可以在控制台中使用以下命令将 GroupDocs.Conversion Cloud 安装到您的 Ruby 应用程序:

gem install groupdocs_conversion_cloud

在开始执行步骤和可用代码示例之前,请从 仪表板 获取您的客户端 ID 和客户端密码。获得 ID 和密码后,添加如下所示的代码:

# 在你的 ruby 应用程序中为 http://api.groupdocs.cloud 加载 gem
require 'groupdocs_conversion_cloud'

# 免费注册后,从 https://dashboard.groupdocs.cloud 获取您的 client_id 和 client_secret。
@app_sid = "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
@app_key = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

使用 Ruby 中的 REST API 将 Excel 转换为 PDF

您可以按照下面给出的简单步骤将 Excel 电子表格转换为云上的 PDF 文档: 您可以按照下面提到的步骤以编程方式轻松地将 XLSX 转换为 PDF 文档:

  • 创建 ConvertApi 的实例
  • 创建 ConvertSettings 的实例
  • 设置 XLSX 文件路径
  • 将“pdf”分配给格式
  • 创建 SpreadsheetLoadOptions 的实例
  • 设置 hidecomments 和 one\page\per\sheet 值
  • 提供加载\选项和输出文件路径
  • 使用 ConvertSettings 创建 ConvertDocumentRequest
  • 通过使用 ConvertDocumentRequest 调用 ConvertApi.convertDocument() 方法进行转换

以下代码示例展示了如何使用 Ruby 中的 REST API 将 Excel 电子表格转换为 PDF 文档。

# 创建转化 API 实例
@apiInstance = GroupDocsConversionCloud::ConvertApi.from_keys(@app_sid, @app_key)
 
# 初始化并设置转换设置
@settings = GroupDocsConversionCloud::ConvertSettings.new
@settings.file_path = "xlsx-to-pdf/four-pages.xlsx"
@settings.format = "pdf"

# 设置电子表格转换 LoadOptions
@loadOptions = GroupDocsConversionCloud::SpreadsheetLoadOptions.new
@loadOptions.hide_comments = true
@loadOptions.one_page_per_sheet = true
 
@settings.load_options = @loadOptions
@settings.output_path = "xlsx-to-pdf"
 
# 将 XLSX 转换为 PDF
result = @apiInstance.convert_document(GroupDocsConversionCloud::ConvertDocumentRequest.new(@settings))

puts("Spreadsheet successfully converted to PDF")
使用 Ruby 中的 REST API 将 Excel 转换为 PDF

使用 Ruby 中的 REST API 将 Excel 转换为 PDF

在 Ruby 中将特定的 Excel 电子表格转换为 PDF

您可以按照下面提到的步骤以编程方式将特定的 Excel 电子表格转换为 PDF 文档:

  • 创建 ConvertApi 的实例
  • 创建 ConvertSettings 的实例
  • 设置 XLSX 文件路径
  • 将“pdf”分配给格式
  • 创建 PdfConvertOptions 的实例
  • 提供要转换的特定电子表格页面
  • 设置 PdfConvertOptions 并提供输出文件路径
  • 使用 ConvertSettings 创建 ConvertDocumentRequest
  • 通过使用 ConvertDocumentRequest 调用 ConvertApi.convertDocument() 方法进行转换

以下代码示例展示了如何使用 Ruby 中的 REST API 将特定的 Excel 电子表格转换为 PDF 文档。

# 在 Ruby 中将 XLSX 的特定页面转换为 PDF
# 创建必要的 API 实例
@apiInstance = GroupDocsConversionCloud::ConvertApi.from_keys(@app_sid, @app_key)
 
# 设置转换设置
@settings = GroupDocsConversionCloud::ConvertSettings.new
@settings.file_path = "xlsx-to-pdf/four-pages.xlsx"
@settings.format = "pdf"
@convertOptions = GroupDocsConversionCloud::PdfConvertOptions.new
@convertOptions.pages = [1, 3]
 
@settings.convert_options = @convertOptions
@settings.output_path = "xlsx-to-pdf"
 
# 将特定页面转换为 PDF
@result = @apiInstance.convert_document(GroupDocsConversionCloud::ConvertDocumentRequest.new(@settings))
puts("Spreadsheet pages successfully converted to PDF")
在 Ruby 中将特定的 Excel 电子表格转换为 PDF

在 Ruby 中将特定的 Excel 电子表格转换为 PDF

使用高级选项在 Ruby 中将 Excel 转换为 PDF

请按照下面提到的步骤使用一些高级设置将 XLSX 转换为 PDF 文档:

  • 创建 ConvertApi 的实例
  • 创建 ConvertSettings 的实例
  • 设置 XLSX 文件路径
  • 将“pdf”分配给格式
  • 创建 SpreadsheetLoadOptions 的实例
  • 设置各种加载选项,例如 hideComments、onePagePerSheet 等。
  • 创建 PdfConvertOptions 的实例
  • 为 convertOptions 设置不同的转换选项
  • 提供 load\options、convertOptions 和输出文件路径
  • 使用 ConvertSettings 创建 ConvertDocumentRequest
  • 通过使用 ConvertDocumentRequest 调用 ConvertApi.convertDocument() 方法进行转换

以下代码示例显示如何使用高级转换选项将 Excel 电子表格转换为 PDF 文档:

# 创建转化 API 实例
@apiInstance = GroupDocsConversionCloud::ConvertApi.from_keys(@app_sid, @app_key)
 
# 初始化并设置转换设置
@settings = GroupDocsConversionCloud::ConvertSettings.new
@settings.file_path = "xlsx-to-pdf/four-pages.xlsx"
@settings.format = "pdf"

# 设置电子表格转换 LoadOptions
@loadOptions = GroupDocsConversionCloud::SpreadsheetLoadOptions.new
@loadOptions.hide_comments = true
@loadOptions.one_page_per_sheet = true

@convertOptions = GroupDocsConversionCloud::PdfConvertOptions.new
@convertOptions.center_window = true
@convertOptions.compress_images = false
@convertOptions.display_doc_title = true
@convertOptions.dpi = 1024.0
@convertOptions.fit_window = false
@convertOptions.from_page = 1
@convertOptions.grayscale = false
@convertOptions.image_quality = 100
@convertOptions.linearize = false
@convertOptions.margin_top = 5
@convertOptions.margin_left = 5
@convertOptions.password = "password"
@convertOptions.unembed_fonts = true
@convertOptions.remove_unused_streams = true
@convertOptions.remove_unused_objects = true
@convertOptions.remove_pdfa_compliance = false

@settings.load_options = @loadOptions
@settings.convert_options = @convertOptions
@settings.output_path = "xlsx-to-pdf"
 
# 将 XLSX 转换为 PDF
result = @apiInstance.convert_document(GroupDocsConversionCloud::ConvertDocumentRequest.new(@settings))
puts("XLSX converted to PDF using advance options")
使用 Ruby 使用 REST API 将 Excel 转换为 PDF

使用高级选项将 Excel 转换为 PDF

将 Excel 转换为 PDF 并添加水印

您可以按照以下步骤将 Excel 电子表格转换为带水印的 PDF 文档:

  • 创建 ConvertApi 的实例
  • 创建 ConvertSettings 的实例
  • 设置 XLSX 文件路径
  • 将“pdf”分配给格式
  • 创建 WatermarkOptions 的实例
  • 设置水印文字、颜色、宽度、高度等。
  • 定义 PdfConvertOptions 并分配 WatermarkOptions
  • 设置转换选项和输出文件路径
  • 使用 ConvertSettings 创建 ConvertDocumentRequest
  • 通过使用 ConvertDocumentRequest 调用 ConvertApi.convertDocument() 方法进行转换

以下代码示例展示了如何使用 Ruby 中的 REST API 将 Excel 电子表格转换为 PDF 文档并向转换后的 PDF 文档添加水印。

#XLSX to PDF Conversion with Watermark using Ruby
# 创建必要的 API 实例
@apiInstance = GroupDocsConversionCloud::转变Api.from_keys(@app_sid, @app_key)
 
# 准备转换设置
@watermark = GroupDocsConversionCloud::WatermarkOptions.new       
@watermark.text = "CONFIDENTIAL"
@watermark.color = "Red"
@watermark.width = 100
@watermark.height = 100
@watermark.background = false
@watermark.bold = true;
@watermark.top = 300;
@watermark.left = 200;

@settings = GroupDocsConversionCloud::转变Settings.new
@settings.file_path = "xlsx-to-pdf/four-pages.xlsx"
@settings.format = "pdf"
@convertOptions = GroupDocsConversionCloud::Pdf转变Options.new
@convertOptions.watermark_options = @watermark
 
@settings.convert_options = @convertOptions
@settings.output_path = "xlsx-to-pdf"
 
# 转变
result = @apiInstance.convert_document(GroupDocsConversionCloud::转变DocumentRequest.new(@settings))
puts("Spreadsheet successfully converted to PDF with Watermark")
将 Excel 转换为 PDF 并添加水印

将 Excel 转换为 PDF 并添加水印

免费在线 XLSX 到 PDF 转换器

如何在线将 Excel 转换为 PDF?您可以尝试以下免费的在线 XLSX 到 PDF 转换器工具,它是使用上述 API 开发的。

结论

在本文中,您了解了如何在云端将 Excel 转换为 PDF 文档。您还学习了如何使用 Ruby 向转换后的 PDF 文档添加水印。此外,我们还学习了如何使用高级选项以编程方式将 XLSX 转换为云端的 PDF 文件。您可以使用 文档 了解有关 GroupDocs.Conversion Cloud API 的更多信息。我们还提供了一个 API 参考 部分,让您可以直接通过浏览器可视化我们的 API 并与之交互。

问一个问题

如果您对 XLSX 到 PDF 转换器有任何疑问,请随时在 论坛 上询问我们。

也可以看看