在 Ruby 中自動生成 Word 文檔,使用 Ruby SDK 創建任何復雜的可打印的 Word 報告。這種基於雲的解決方案圍繞模板、數據源和強大的 LINQ 語法構建,使 Ruby 開發人員能夠靈活地滿足精確的技術和業務需求。
使用這個 Ruby 庫,您可以在任何操作系統上以編程方式構建高度自定義的 Word 報告。格式豐富的 Word 文檔(如合同、訂單、發票、裝運報告、銷售建議、庫存)可以作為 Ruby 軟件的一部分即時組裝。
在過去的幾十年中,文檔自動化和報告生成的重要性已經大大提高。幾乎每家公司都需要生成文檔並按時交付給合作夥伴或客戶。此外,它通常是財務成功的決定性因素。實施此類技術可以減少人工數據輸入、人為錯誤、校對和文書工作,從而節省大量資金。由於這些原因,文檔自動化和報告工具是許多旨在為用戶提供高級分析功能的現代軟件解決方案的組成部分。
一般來說,Word 報告生成是將文本、數據和圖形組合成一個實體,並將結果以方便的可視形式導出為 Word 文件格式的過程。有關支持的 I/O 格式的信息,請訪問我們的文檔。
GroupDocs Assembly for Ruby 是一個基於雲的解決方案,用於使用模板和數據源生成 Word 文檔。文檔模板充當基本框架,除了標準內容(文本、表格、圖表等)之外,還包括用於插入來自數據源的值的特殊佔位符字段。不僅可以插入單個值,還可以插入表格和圖形形式的整個數據數組。
該模板還包含控制數據選擇和條件處理的編程結構— Word 文檔生成規則。將數據綁定到文檔模板使用 LINQ 表達式語法,它允許開發人員以通用方式處理數據,而不管使用的數據源類型如何。通過這種方式,我們的 Ruby Cloud SDK 為您提供了 Word 內容生成的靈活性和一組強大的數據處理方法。
該產品還支持 Mail Merge 功能,以防您希望以 Word 格式創建批量個性化信件並將其發送給客戶。您只需將 Mail Merge 字段插入文檔模板並將其與數據源一起傳遞給 Cloud API。
無論您要實現的 Word 文檔自動化的規模和類型如何,在 Ruby 中構建報告都需要三個步驟:
設計模板是一項艱鉅的任務。除了清楚地了解最終 Word 文檔的要求外,還需要分析和編程技能。一個好的模板設計應該反映客戶對特定問題的看法。最有效的方法是將表格數據和圖形以適當的平衡結合起來,由業務需求決定。
如上所述,模板結構通常包含一些固定的內容塊(文本、圖像、徽標等),並混合了控制 Word 文檔組裝邏輯的特殊編程結構。這些 Word 文檔生成規則是使用特殊的表達式語法定義的,它使開發人員能夠執行以下操作:
您可以在我們的開發人員指南中了解有關模板語法的更多信息。
GroupDocs Assembly for Ruby 不需要安裝任何外部軟件或第三方工具。這是一個基於雲的 Word 解決方案,其中所有編程交互都使用 REST API 通過網絡執行。
所有 GroupDocs 產品都完全符合行業安全標準:數據傳輸使用 SSL 協議進行,消除了信息被第三方截獲的可能性。要連接到 GroupDocs 雲服務,您需要使用個人訪問密鑰。請參閱快速入門指南。
以下代碼示例展示瞭如何使用 Ruby 生成 Word 報告。
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
使用 RubyGems 託管服務安裝 GroupDocs.Assembly Cloud SDK for Ruby 。運行 gem install groupdocs_assembly_cloud 來安裝包。作為替代方案,您可以從 GitHub 手動克隆 GroupDocs.Assembly Cloud SDK for Ruby 源代碼並在您的項目中使用它。請按照這些 Instructions 快速獲取必要的安全憑證並訪問我們的 REST API。