Nástroj na tvorbu dokumentov Word pre Ruby

Knižnica Ruby na vytváranie vysoko prispôsobených správ Word pomocou REST API

Bezproblémovo integrujte generovanie dokumentov Word na základe šablón a zdrojov údajov do svojho softvéru Ruby.

Automatizujte generovanie dokumentov Word v systéme Ruby, vytvorte zostavy Word pripravené na tlač akejkoľvek zložitosti pomocou súpravy Ruby SDK. Toto cloudové riešenie je postavené na šablónach, zdrojoch údajov a výkonnej syntaxi LINQ, čo dáva vývojárom Ruby flexibilitu, aby vyhovovali presným technickým a obchodným požiadavkám.

Pomocou tejto knižnice Ruby môžete programovo vytvárať vysoko prispôsobené zostavy Word na akomkoľvek operačnom systéme. Bohato formátované dokumenty Word, ako sú zmluvy, objednávky, faktúry, správy o zásielkach, predajné ponuky, inventáre, je možné zostaviť za chodu ako súčasť vášho softvéru Ruby.

Zjednodušte generovanie dokumentov Word pomocou Ruby

Význam automatizácie dokumentov a generovania správ za posledné desaťročia nesmierne vzrástol. Takmer každá spoločnosť má potrebu generovať dokumenty a doručovať ich partnerom alebo zákazníkom včas. Navyše je to zvyčajne rozhodujúci faktor finančného úspechu. Implementácia takýchto technológií môže viesť k významným finančným úsporám znížením manuálneho zadávania údajov, ľudských chýb, korektúr a papierovania. Z týchto dôvodov sú nástroje na automatizáciu dokumentov a reportovanie neoddeliteľnou súčasťou mnohých moderných softvérových riešení, ktorých cieľom je poskytnúť používateľom pokročilé analytické funkcie.

Všeobecne povedané, generovanie správ Word je proces, ktorý kombinuje text, údaje a grafiku do jednej entity a exportuje výsledok vo vhodnej vizuálnej forme do formátu súboru Word. Informácie o podporovaných I/O formátoch nájdete v našej dokumentácii.

Čo je to GroupDocs Assembly for Ruby

GroupDocs Assembly for Ruby je cloudové riešenie na generovanie dokumentov Word pomocou šablón a zdrojov údajov. Šablóna dokumentu funguje ako základný rámec, ktorý okrem štandardného obsahu (text, tabuľky, grafy atď.) obsahuje špeciálne zástupné polia na vkladanie hodnôt zo zdroja údajov. Je možné vkladať nielen jednotlivé hodnoty, ale aj celé polia údajov vo forme tabuliek a grafov.

Šablóna obsahuje aj programovacie konštrukcie – pravidlá generovania dokumentov Word – ktoré riadia výber údajov a spracovanie podmienok. Väzba údajov na šablónu dokumentu využíva syntax výrazov LINQ, ktorá umožňuje vývojárom spracovávať údaje všeobecným spôsobom bez ohľadu na typ použitého zdroja údajov. Týmto spôsobom vám naša Ruby Cloud SDK poskytuje flexibilitu pri generovaní obsahu Word a výkonnú sadu metód na spracovanie údajov.

Tento produkt tiež podporuje funkciu Mail Merge v prípade, že chcete zákazníkom vytvárať a odosielať dávky personalizovaných listov vo formáte Word. Stačí vložiť polia Mail Merge do šablóny dokumentu a odovzdať ju do Cloud API spolu so zdrojom údajov.

Bez ohľadu na rozsah a typ automatizácie dokumentov Word, ktoré sa chystáte implementovať, existujú tri kroky na vytvorenie zostavy v jazyku Ruby:

  • Vytvorte šablónu dokumentu programu Word so zástupnými poľami a pravidlami generovania dokumentov, ktoré budú regulovať variácie štruktúry a obsahu
  • Vytvorte zdroj údajov vo formáte Word alebo JSON
  • Napíšte niekoľko riadkov kódu Ruby, aby ste všetko odovzdali do API na vytváranie dokumentov a získali zostavený výsledok vo formáte Word späť

Návrh šablóny dokumentu a používanie pravidiel generovania dokumentov Word

Navrhovanie šablón je náročná úloha. Okrem jasného pochopenia požiadaviek na výsledný dokument Word sa vyžadujú analytické a programovacie schopnosti. Dobrý návrh šablóny by mal odrážať pohľad zákazníka na konkrétny problém. Najúčinnejším prístupom je skombinovať tabuľkové údaje a grafiku v správnej rovnováhe, určenej obchodnými požiadavkami.

Ako bolo uvedené vyššie, štruktúra šablóny zvyčajne obsahuje niekoľko pevných blokov obsahu (text, obrázky, logá atď.) zmiešaných so špeciálnymi programovými konštrukciami, ktoré riadia logiku zostavovania dokumentov Word. Tieto pravidlá generovania dokumentov Word sú definované pomocou špeciálnej syntaxe výrazu, ktorá umožňuje vývojárom vykonávať nasledovné:

  • vložiť obsah externého dokumentu, obrázky, grafy, zoznamy, tabuľky, hypertextové odkazy, záložky atď.
  • prácu s údajmi pomocou vzorcov a sekvenčných operácií s údajmi
  • určiť formát prezentácie pre číselné, textové, grafické, grafické prvky a prvky dátumu a času
  • vkladať bloky obsahu v závislosti od podmienených výrazov
  • definujte špeciálne premenné pre "drahé" výpočty, ktoré sa počítajú iba raz
  • vypočítať vzorce pri zostavovaní tabuľkových dokumentov
  • priraďovať atribúty tela e-mailovej správy a dynamicky vytvárať prílohy
  • vytvárať a vkladať čiarové kódy
  • nastaviť farbu pozadia pre HTML dokumenty

Viac informácií o syntaxi šablóny nájdete v našej príručke pre vývojárov.

Požiadavky

GroupDocs Assembly for Ruby nevyžaduje inštaláciu žiadneho externého softvéru alebo nástrojov tretích strán. Ide o cloudové riešenie pre Word, kde sa všetky programovacie interakcie vykonávajú cez sieť pomocou REST API.

Bezpečnosť

Všetky produkty GroupDocs sú plne v súlade s priemyselnými bezpečnostnými štandardmi: prenos údajov sa vykonáva pomocou protokolu SSL, ktorý eliminuje možnosť zachytenia informácií tretími stranami. Ak sa chcete pripojiť ku cloudovým službám GroupDocs, musíte použiť osobné prístupové kľúče. Pozrite si príručku pre rýchly štart.

Vytvorte Word dokument v Ruby

Nasledujúci príklad kódu ukazuje, ako generovať správy Word pomocou Ruby.

Vygenerovať dokument DOCX v Ruby
Vstupné súbory
Nahrajte šablónu dokumentu
Výstupný formát
Vyberte cieľový formát zo zoznamu
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
  
Skopírujte kód Ruby do schránky

Ako vygenerovať dokument Word pomocou Ruby

  1. Nainštalujte 'GroupDocs.Assembly Cloud SDK for Ruby'.
  2. Pridajte odkaz na knižnicu (importujte knižnicu) do svojho projektu Ruby.
  3. Vytvorte dokument šablóny, pridajte programové konštrukcie, ktoré riadia vkladanie údajov zo zdroja údajov.
  4. Vytvorte zdroj údajov.
  5. Nahrajte šablónu dokumentu do cloudového úložiska GroupDocs (musíte sa prihlásiť do svojho osobného účtu).
  6. Vytvorte dokument odoslaním šablóny a údajov do Cloud API.

Ako nainštalovať DOCX Report Builder pre Ruby

Nainštalujte GroupDocs.Assembly Cloud SDK for Ruby pomocou hostingovej služby RubyGems. Spustite gem install groupdocs_assembly_cloud a nainštalujte balík. Ako alternatívu môžete manuálne naklonovať GroupDocs.Assembly Cloud SDK for Ruby z GitHub a použiť ho vo svojom projekte. Postupujte podľa týchto Instructions, aby ste rýchlo získali potrebné bezpečnostné poverenia a získali prístup k nášmu REST API.

Požiadavky na systém

Ruby 2.6 alebo novší

Podrobnosti nájdete v Repository Documentation.

Ďalšie podporované formáty dokumentov

Prehľady môžete generovať v iných formátoch súborov:

5%

Prihláste sa na odber aktualizácií produktov Aspose

Získajte mesačné bulletiny a ponuky priamo do vašej poštovej schránky.

© Aspose Pty Ltd 2001-2024. Všetky práva vyhradené.