Ruby 的 Word 文檔生成器

Ruby 庫,用於使用 REST API 構建高度自定義的 Word 報告

將基於模板和數據源的 Word 文檔生成無縫集成到您的 Ruby 軟件中。

在 Ruby 中自動生成 Word 文檔,使用 Ruby SDK 創建任何復雜的可打印的 Word 報告。這種基於雲的解決方案圍繞模板、數據源和強大的 LINQ 語法構建,使 Ruby 開發人員能夠靈活地滿足精確的技術和業務需求。

使用這個 Ruby 庫,您可以在任何操作系統上以編程方式構建高度自定義的 Word 報告。格式豐富的 Word 文檔(如合同、訂單、發票、裝運報告、銷售建議、庫存)可以作為 Ruby 軟件的一部分即時組裝。

使用 Ruby 簡化 Word 文檔的生成

在過去的幾十年中,文檔自動化和報告生成的重要性已經大大提高。幾乎每家公司都需要生成文檔並按時交付給合作夥伴或客戶。此外,它通常是財務成功的決定性因素。實施此類技術可以減少人工數據輸入、人為錯誤、校對和文書工作,從而節省大量資金。由於這些原因,文檔自動化和報告工具是許多旨在為用戶提供高級分析功能的現代軟件解決方案的組成部分。

一般來說,Word 報告生成是將文本、數據和圖形組合成一個實體,並將結果以方便的可視形式導出為 Word 文件格式的過程。有關支持的 I/O 格式的信息,請訪問我們的文檔

什麼是 GroupDocs Assembly for Ruby

GroupDocs Assembly for Ruby 是一個基於雲的解決方案,用於使用模板和數據源生成 Word 文檔。文檔模板充當基本框架,除了標準內容(文本、表格、圖表等)之外,還包括用於插入來自數據源的值的特殊佔位符字段。不僅可以插入單個值,還可以插入表格和圖形形式的整個數據數組。

該模板還包含控制數據選擇和條件處理的編程結構— Word 文檔生成規則。將數據綁定到文檔模板使用 LINQ 表達式語法,它允許開發人員以通用方式處理數據,而不管使用的數據源類型如何。通過這種方式,我們的 Ruby Cloud SDK 為您提供了 Word 內容生成的靈活性和一組強大的數據處理方法。

該產品還支持 Mail Merge 功能,以防您希望以 Word 格式創建批量個性化信件並將其發送給客戶。您只需將 Mail Merge 字段插入文檔模板並將其與數據源一起傳遞給 Cloud API。

無論您要實現的 Word 文檔自動化的規模和類型如何,在 Ruby 中構建報告都需要三個步驟:

  • 創建一個帶有佔位符字段和文檔生成規則的 Word 文檔模板,以規範結構和內容的變化
  • 創建 Word 或 JSON 格式的數據源
  • 編寫幾行 Ruby 代碼,將所有內容傳遞給 Document Building API,並以 Word 格式返回組裝結果

設計文檔模板並使用 Word 文檔生成規則

設計模板是一項艱鉅的任務。除了清楚地了解最終 Word 文檔的要求外,還需要分析和編程技能。一個好的模板設計應該反映客戶對特定問題的看法。最有效的方法是將表格數據和圖形以適當的平衡結合起來,由業務需求決定。

如上所述,模板結構通常包含一些固定的內容塊(文本、圖像、徽標等),並混合了控制 Word 文檔組裝邏輯的特殊編程結構。這些 Word 文檔生成規則是使用特殊的表達式語法定義的,它使開發人員能夠執行以下操作:

  • 嵌入外部文檔內容、圖像、圖表、列表、表格、超鏈接、書籤等。
  • 使用公式和順序數據操作處理數據
  • 指定數字、文本、圖形、圖形以及日期和時間元素的表示格式
  • 根據條件表達式插入內容塊
  • 為只計算一次的"昂貴"計算定義特殊變量
  • 組裝電子表格文檔時計算公式
  • 分配電子郵件正文屬性並動態創建附件
  • 創建和插入條形碼
  • 為 HTML 文檔設置背景顏色

您可以在我們的開發人員指南中了解有關模板語法的更多信息。

要求

GroupDocs Assembly for Ruby 不需要安裝任何外部軟件或第三方工具。這是一個基於雲的 Word 解決方案,其中所有編程交互都使用 REST API 通過網絡執行。

安全

所有 GroupDocs 產品都完全符合行業安全標準:數據傳輸使用 SSL 協議進行,消除了信息被第三方截獲的可能性。要連接到 GroupDocs 雲服務,您需要使用個人訪問密鑰。請參閱快速入門指南。

在 Ruby 中生成 Word 文檔

以下代碼示例展示瞭如何使用 Ruby 生成 Word 報告。

在 Ruby 中生成 DOCX 文檔
輸入文件
上傳文檔模板
輸出格式
從列表中選擇目標格式
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
  
將代碼Ruby複製到剪貼板

如何使用 Ruby 生成 Word 文檔

  1. 安裝'GroupDocs.Assembly Cloud SDK for Ruby' 。
  2. 將庫引用(導入庫)添加到您的 Ruby 項目。
  3. 創建一個模板文檔,添加控制從數據源插入數據的編程結構。
  4. 創建數據源。
  5. 將文檔模板上傳至 GroupDocs 雲存儲(需要登錄個人賬戶)。
  6. 通過將模板和數據傳遞給 Cloud API 來生成文檔。

如何為 Ruby 安裝 DOCX 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. 版權所有。