Tvůrce dokumentů pro Ruby

Knihovna Ruby pro vytváření vysoce přizpůsobených sestav pomocí REST API

Bezproblémově integrujte generování různých dokumentů Word, PDF a webových dokumentů na základě šablon a zdrojů dat do svého firemního softwaru Ruby.

Automatizujte generování dokumentů v Ruby, vytvářejte sestavy připravené pro tisk jakékoli složitosti pomocí Ruby SDK. Toto cloudové řešení je postaveno na šablonách, zdrojích dat a výkonné syntaxi LINQ, což vývojářům Ruby poskytuje flexibilitu, aby vyhovovali přesným technickým a obchodním požadavkům.

Pomocí této knihovny Ruby můžete programově vytvářet vysoce přizpůsobené sestavy v jakémkoli operačním systému. Bohatě formátované dokumenty, jako jsou smlouvy, objednávky, faktury, zprávy o zásilkách, prodejní návrhy, inventáře, lze sestavit za chodu jako součást vašeho softwaru Ruby.

Zjednodušte generování dokumentů pomocí Ruby

Význam automatizace dokumentů a generování zpráv v posledních desetiletích nesmírně vzrostl. Téměř každá společnost má potřebu generovat dokumenty a dodávat je partnerům nebo zákazníkům včas. Navíc je to obvykle rozhodující faktor finančního úspěchu. Implementace takových technologií může vést k významným finančním úsporám snížením ručního zadávání dat, lidských chyb, korektur a papírování. Z těchto důvodů jsou nástroje pro automatizaci dokumentů a vytváření sestav nedílnou součástí mnoha moderních softwarových řešení, jejichž cílem je poskytovat uživatelům pokročilé analytické funkce.

Obecně řečeno, generování sestav je proces, který kombinuje text, data a grafiku do jediné entity a výsledek exportuje ve vhodné vizuální podobě do požadovaného formátu dokumentu, jako je DOCX, PDF, ODT, HTML, PPTX, XLSX atd.

Co je GroupDocs Assembly for Ruby

GroupDocs Assembly for Ruby je cloudové řešení pro generování dokumentů pomocí šablon a zdrojů dat. Šablona dokumentu funguje jako základní rámec, který kromě standardního obsahu (text, tabulky, grafy atd.) obsahuje speciální zástupná pole pro vkládání hodnot ze zdroje dat. Vkládat lze nejen jednotlivé hodnoty, ale i celá pole dat ve formě tabulek a grafů.

Šablona také obsahuje programovací konstrukty – pravidla pro generování dokumentů – které řídí výběr dat a zpracování podmínek. Vazba dat na šablonu dokumentu používá syntaxi výrazu LINQ, která vývojářům umožňuje zpracovávat data obecným způsobem bez ohledu na typ použitého zdroje dat. Tímto způsobem vám naše Ruby Cloud SDK poskytuje flexibilitu při generování obsahu a výkonnou sadu metod pro zpracování dat.

Tento produkt také podporuje funkci Mail Merge v případě, že chcete vytvářet a odesílat dávky personalizovaných dopisů zákazníkům. Stačí vložit pole Mail Merge do šablony dokumentu a předat ji Cloud API spolu se zdrojem dat.

Bez ohledu na rozsah a typ automatizace dokumentů, které se chystáte implementovat, existují tři kroky k vytvoření sestavy v Ruby:

  • Vytvořte šablonu dokumentu aplikace Word se zástupnými poli a pravidly generování dokumentů, která budou regulovat variace struktury a obsahu
  • Vytvořte zdroj dat ve formátu XML nebo JSON
  • Napište několik řádků kódu Ruby, abyste vše předali rozhraní API pro tvorbu dokumentů a získali sestavený výsledek zpět

Návrh šablony dokumentu a použití pravidel pro generování dokumentu

Navrhování šablon je obtížný úkol. Kromě jasného porozumění požadavkům na výsledný dokument jsou vyžadovány analytické a programátorské dovednosti. Dobrý návrh šablony by měl odrážet pohled zákazníka na konkrétní problém. Nejúčinnějším přístupem je kombinace tabulkových dat a grafiky ve správné rovnováze, určené obchodními požadavky.

Jak bylo uvedeno výše, struktura šablony obvykle obsahuje některé pevné bloky obsahu (text, obrázky, loga atd.) smíchané se speciálními programovacími konstrukcemi, které řídí logiku sestavení dokumentu. Tato pravidla generování dokumentů jsou definována pomocí speciální syntaxe výrazu, která vývojářům umožňuje provádět následující:

  • vložit obsah externího dokumentu, obrázky, grafy, seznamy, tabulky, hypertextové odkazy, záložky atd.
  • práce s daty pomocí vzorců a sekvenčních operací s daty
  • určete formát prezentace pro číselné, textové, grafické, grafické prvky a prvky data a času
  • vkládat bloky obsahu v závislosti na podmíněných výrazech
  • definovat speciální proměnné pro "nákladné" výpočty, které se počítají pouze jednou
  • vypočítat vzorce při sestavování tabulkových dokumentů
  • přiřadit atributy těla e-mailové zprávy a dynamicky vytvářet přílohy
  • vytvářet a vkládat čárové kódy
  • nastavit barvu pozadí pro HTML dokumenty

Další informace o syntaxi šablony naleznete v naší příručce pro vývojáře.

Požadavky

GroupDocs Assembly for Ruby nevyžaduje instalaci žádného externího softwaru nebo nástrojů třetích stran. Jedná se o cloudové řešení, kde jsou všechny programovací interakce prováděny přes síť pomocí REST API.

Podporované formáty dokumentů

  • Word: DOCX, DOC, DOT, DOTX, DOTM, DOCM, RTF
  • Excel: XLSX, XLS, XLSM, XLSB, XLT, XLTM, XLTX
  • PowerPoint: PPTX, PPT, PPTM, PPS, PPSX, PPSM, POT, POTX, POTM
  • Outlook: MSG, EML, EMLXL
  • OpenOffice: ODT, OTT, ODS, ODP, OTP
  • Adobe Acrobat: PDF
  • Tisk: PCL, PS, XPS, OXPS
  • Vektorová grafika: SVG, EMF
  • Bitmapová grafika: PNG, JPEG, GIF, TIFF, BMP
  • Další formáty souborů: HTML, MHTML, MHT, MD, XAML, EPUB, TXT

Další informace o podporovaných I/O formátech naleznete v naší dokumentaci.

Bezpečnostní

Všechny produkty GroupDocs jsou plně v souladu s průmyslovými bezpečnostními standardy: přenos dat se provádí pomocí protokolu SSL, který eliminuje možnost zachycení informací třetími stranami. Chcete-li se připojit ke cloudovým službám GroupDocs, musíte použít osobní přístupové klíče. Přečtěte si prosím stručnou příručku.

Vygenerujte dokument v Ruby

Následující příklad kódu ukazuje, jak generovat sestavy pomocí Ruby.

Vygenerovat dokument v Ruby
Vstupní soubory
Nahrajte šablonu dokumentu
Výstupní formát
Vyberte cílový formát ze seznamu
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
  
Zkopírujte kód Ruby do schránky

Jak vygenerovat dokument pomocí Ruby

  1. Nainstalujte 'GroupDocs.Assembly Cloud SDK for Ruby'.
  2. Přidejte odkaz na knihovnu (importujte knihovnu) do svého projektu Ruby.
  3. Vytvořte dokument šablony, přidejte programovací konstrukce, které řídí vkládání dat ze zdroje dat.
  4. Vytvořte zdroj dat.
  5. Nahrajte šablonu dokumentu do cloudového úložiště GroupDocs (musíte se přihlásit ke svému osobnímu účtu).
  6. Vygenerujte dokument předáním šablony a dat do Cloud API.

Jak nainstalovat Cloud Report Generator pro Ruby

Nainstalujte GroupDocs.Assembly Cloud SDK for Ruby pomocí hostingové služby RubyGems. Spusťte gem install groupdocs_assembly_cloud a nainstalujte balíček. Alternativně můžete ručně naklonovat GroupDocs.Assembly Cloud SDK for Ruby z GitHubu a použít jej ve svém projektu. Postupujte podle těchto Instructions, abyste rychle získali potřebné bezpečnostní údaje a získali přístup k našemu REST API.

Požadavky na systém

Ruby 2.6 nebo novější

Podrobnosti naleznete v Repository Documentation.

5%

Přihlaste se k odběru aktualizací produktu Aspose

Získejte měsíční zpravodaje a nabídky přímo do vaší poštovní schránky.

© Aspose Pty Ltd 2001-2024. Všechna práva vyhrazena.