1. Prodotti
  2.   Elaborazione di testi
  3.   Ruby
  4.   OpenXml::Docx
 
  

Libreria Ruby Open Source per Creare Documenti Word e Aggiungere Tabelle

Gem (Libreria) Ruby gratuita che consente la creazione di file Microsoft Word .docx usando il formato Office Open XML (OOXML) e aggiunge paragrafi di testo, tabelle e immagini all'interno dei file DOCX.

Cos'è OpenXml::Docx?

I documenti Microsoft Word sono diventati lo standard per le comunicazioni aziendali, i report e la documentazione in tutti i settori. Mentre la creazione manuale di documenti funziona per piccoli compiti, l'automazione della generazione dei documenti diventa essenziale quando si lavora con template, operazioni di massa o contenuti dinamici. È qui che entra in gioco OpenXml::Docx — una libreria Ruby che permette agli sviluppatori di creare documenti Word professionali in modo programmatico. La libreria funziona ovunque Ruby sia installato, senza dipendenze esterne. Tra le numerose caratteristiche importanti della libreria ci sono la creazione di nuovi documenti Word, l'applicazione di formattazione e stili del testo, la presentazione di tabelle e dati, l'integrazione di immagini e media e così via.

OpenXml::Docx è un gem Ruby che fornisce un'interfaccia pulita e intuitiva per generare documenti Word nel formato Open XML (l'estensione .docx che tutti conosciamo). A differenza di soluzioni ingombranti che richiedono l'installazione di Microsoft Office, questa libreria funziona in modo indipendente, creando documenti da zero usando codice Ruby puro. Segue lo standard Office Open XML, garantendo compatibilità con Microsoft Word, Google Docs, LibreOffice e altri moderni editor di testo. La libreria si concentra sulla semplicità e sulla leggibilità, rendendo la generazione di documenti accessibile anche agli sviluppatori che non conoscono la complessa struttura XML sottostante dei documenti Word. Invece di lottare con i namespace e gli schemi XML, puoi scrivere codice Ruby diretto che sembra naturale e mantenibile.

Previous Next

Iniziare con OpenXml::Docx

Il modo consigliato per installare OpenXml::Docx è utilizzare RubyGems. Si prega di usare il comando seguente per un'installazione senza problemi.

Installa OpenXml::Docx via RubyGems

 gem install openxml-docx
You can also download it directly from GitHub.

Creare il tuo Primo Documento DOCX

La libreria open source OpenXml::Docx include il supporto completo per creare e gestire nuovi documenti Word all'interno di applicazioni Java. L'elemento fondamentale di un documento Word è il paragrafo. Con solo un paio di righe di codice, gli sviluppatori possono aggiungere testo e immagini ai documenti Word. Ecco un semplice esempio che dimostra come gli sviluppatori possono accedere al corpo del documento, aggiungere un paragrafo con una sequenza di testo, applicare formattazione e salvare il file.

Come Creare un Documento Word e Aggiungere un Paragrafo con Testo via API Java?

require 'openxml/docx'

# Create a new document package
package = OpenXml::Docx::Package.new

# Access the main document
doc = package.document

# Add a paragraph with text
paragraph = doc.add_paragraph
run = paragraph.add_run
run.text = "Welcome to OpenXml::Docx"
run.bold = true
run.font_size = 24

# Save the document
package.save('welcome.docx')

Formattazione Avanzata del Testo via Java

La libreria open source OpenXml::Docx include il supporto completo per la formattazione del testo, sia di base che avanzata, all'interno dei documenti Word. Oltre al grassetto e al corsivo di base, la libreria supporta formattazioni testuali sofisticate. Il seguente esempio di codice Java mostra sottolineature, barature, evidenziazione e combinazioni di più effetti. La proprietà colore accetta valori esadecimali, consentendo una corrispondenza precisa del colore con le linee guida del brand.

Come Applicare la Formattazione del Testo ai Documenti Word via API Java?

require 'openxml/docx'

package = OpenXml::Docx::Package.new
doc = package.document

# Demonstrate various text effects
para1 = doc.add_paragraph
run1 = para1.add_run
run1.text = "This text is underlined"
run1.underline = :single

para2 = doc.add_paragraph
run2 = para2.add_run
run2.text = "This text has a strikethrough"
run2.strike = true

para3 = doc.add_paragraph
run3 = para3.add_run
run3.text = "This text is highlighted"
run3.highlight = "yellow"

para4 = doc.add_paragraph
run4 = para4.add_run
run4.text = "This combines multiple effects"
run4.bold = true
run4.italic = true
run4.color = "FF0000"
run4.font_size = 16

package.save('formatted_text.docx')

Creare Tabelle per Dati nei File Word via Java

Le tabelle sono essenziali per presentare informazioni strutturate. La libreria OpenXml::Docx semplifica per gli sviluppatori la creazione di tabelle all'interno dei documenti Word per gestire i dati in modo corretto nelle applicazioni Java. Ecco un esempio pratico che crea una tabella di vendita professionale con una riga di intestazione in grassetto e tre righe di dati. Il codice dimostra come accedere a celle specifiche e riempirle con contenuti. È possibile iterare attraverso strutture dati e popolari dinamicamente le tabelle, rendendolo ideale per la generazione di report.

Come Creare una Tabella con Righe e Colonne all'interno di Applicazioni Java?

require 'openxml/docx'

package = OpenXml::Docx::Package.new
doc = package.document

# Add a heading
heading = doc.add_paragraph
heading_run = heading.add_run
heading_run.text = "Sales Summary"
heading_run.bold = true
heading_run.font_size = 18

# Create a table with 3 columns and 4 rows
table = doc.add_table(rows: 4, cols: 3)

# Header row
table.rows[0].cells[0].add_paragraph.add_run.text = "Product"
table.rows[0].cells[1].add_paragraph.add_run.text = "Units Sold"
table.rows[0].cells[2].add_paragraph.add_run.text = "Revenue"

# Make header row bold
table.rows[0].cells.each do |cell|
  cell.paragraphs[0].runs[0].bold = true
end

# Data rows
products = [
  ["Widget A", "1,250", "$25,000"],
  ["Widget B", "890", "$17,800"],
  ["Widget C", "2,100", "$42,000"]
]

products.each_with_index do |product, index|
  row = table.rows[index + 1]
  product.each_with_index do |value, col_index|
    row.cells[col_index].add_paragraph.add_run.text = value
  end
end

package.save('sales_summary.docx')

Generazione Automatizzata di Report e Fatture

Le aziende possono utilizzare la libreria OpenXml::Docx per generare automaticamente report mensili, bilanci finanziari o riepiloghi analitici. Estrarre dati dai database e formattarli in documenti professionali consente alle organizzazioni di risparmiare innumerevoli ore di lavoro manuale. Inoltre, le piattaforme di e‑commerce e le aziende di servizi possono generare fatture e contratti in modo dinamico. Informazioni clienti, voci di linea e termini possono essere popolati dai database, garantendo precisione e coerenza in tutti i documenti.

 Italiano