Open Source Ruby biblioteka Word dokumentų kūrimui ir lentelių pridėjimui

Pradžia su OpenXml::Docx

Rekomenduojamas OpenXml::Docx įdiegimo būdas – RubyGems. Norėdami sklandžiai įdiegti, naudokite šią komandą.

gem 'sablon' 

Pirmojo DOCX dokumento kūrimas

Open source OpenXml::Docx pateikė pilną palaikymą kurti ir valdyti naujus Word dokumentus Java programų viduje. Pagrindinis Word dokumento statinio blokas – paragrafas. Iš kelių kodo eilučių kūrėjai gali pridėti tekstą ir paveikslėlius į Word dokumentus. Štai paprastas pavyzdys, kuris rodo, kaip kūrėjai gali pasiekti dokumento turinį, pridėti paragrafą su teksto sekcija, pritaikyti formatavimą ir išsaugoti failą.

require 'sablon'

template = Sablon.template(File.expand_path('~/template.docx'))
context = {
  name: "Sarah Connor"
}

template.render_to_file(File.expand_path('~/output.docx'), context)

Template:

Hello, «name»! Welcome to our platform.

Output:
Hello, Sarah Connor! Welcome to our platform.

Advanced Text Formatting via Java

Open source OpenXml::Docx biblioteka pateikė pilną palaikymą tiek paprastam, tiek pažangių teksto formatų Word dokumentuose. Be paprastų pusjuodžių ir kursyvo, biblioteka palaiko sudėtingą teksto formatavimą. Toliau pateiktas Java kodo pavyzdys rodo pabraukimą, perbraukimą, paryškinimą ir kelių efektų kombinacijas. Spalvų savybė priima šešių skaitmenų heksadeciminius kodus, leidžiančius tiksliai atitikti prekės ženklo reikalavimus.

require "sablon"

template = Sablon.template(File.expand_path("template.docx"))

html_content = "
Lentelių kūrimas duomenims Word failuose su Java
Lentelės yra būtinos struktūruotai informacijai pateikti. OpenXml::Docx biblioteka leidžia kūrėjams kurti lenteles Word dokumentuose, kad duomenys būtų tvarkingai valdomi Java programų viduje. Štai praktiškas pavyzdys, kuriantis profesionalią pardavimų lentelę su antraštės eilute pusjuodžiu ir trimis duomenų eilutėmis. Kodas rodo, kaip pasiekti konkrečias ląsteles ir jas užpildyti turiniu. Galima iteruoti duomenų struktūras ir dinamiškai užpildyti lenteles, todėl puikiai tinka ataskaitų generavimui.
OpenXml::Docx
Second item
"

context = {
  article_content: Sablon.content(:html, html_content)
}

template.render_to_file(File.expand_path("output.docx"), context)

Conditional Rendering

Automatizuotų ataskaitų ir sąskaitų faktūrų generavimas

Įmonės gali naudoti OpenXml::Docx biblioteką generuoti mėnesines ataskaitas, finansines ataskaitas ar analitines santraukas automatiškai. Ištraukdamos duomenis iš duomenų bazių ir formatuodamos juos į profesionalius dokumentus, organizacijos taupo neapskaičiuojamas valandų rankinio darbo. Be to, el. prekybos platformos ir paslaugų įmonės gali dinamiškai kurti sąskaitas faktūras ir sutartis. Klientų informacija, eilučių elementai ir terminai gali būti automatiškai įkelti iš duomenų bazių, užtikrinant tikslumą ir nuoseklumą visų dokumentų.

// You would have a placeholder image in your template with a special filename like «=company_logo».

context = {
  company_logo: Sablon.content(:image, "path/to/your/logo.png")
}

Conditional Rendering via Ruby

The Sablon library supports conditional blocks, allowing users to show or hide parts of their Word document based on the presence or value of a variable. This is perfect for customizing documents based on specific conditions. For instance the following example shows how users can set commands to hide or show specific information inside a word document. If show_extra_info is true, the content between the if and endIf tags will be included in the final document. If it's false or nil, the content will be removed.

context = {
  show_extra_info: true # or false
}