1. Produkty
  2.   Przetwarzanie tekstu
  3.   Ruby
  4.   OpenXml::Docx
 
  

Biblioteka Ruby Open Source do tworzenia dokumentów Word i dodawania tabel

Darmowy Ruby Gem (biblioteka), który umożliwia tworzenie plików Microsoft Word .docx przy użyciu formatu Office Open XML (OOXML) oraz dodawanie akapitów tekstu, tabel i obrazów do plików DOCX.

Czym jest OpenXml::Docx?

Dokumenty Microsoft Word stały się standardem w komunikacji biznesowej, raportowaniu i dokumentacji w różnych branżach. Podczas gdy ręczne tworzenie dokumentów sprawdza się przy małych zadaniach, automatyzacja generowania dokumentów staje się niezbędna przy pracy z szablonami, masowymi operacjami lub dynamiczną zawartością. Właśnie tutaj pojawia się OpenXml::Docx – biblioteka Ruby, która umożliwia programistom tworzenie profesjonalnych dokumentów Word programowo. Biblioteka działa wszędzie tam, gdzie działa Ruby, bez zewnętrznych zależności. Posiada wiele istotnych funkcji, takich jak tworzenie nowych dokumentów Word, stosowanie formatowania i stylizacji tekstu, prezentacja tabel i danych, integracja obrazów i mediów i wiele innych.

OpenXml::Docx to gem Ruby, który zapewnia czysty i intuicyjny interfejs do generowania dokumentów Word w formacie Open XML (rozszerzenie .docx, które wszyscy znamy). W przeciwieństwie do ciężkich rozwiązań, które wymagają instalacji Microsoft Office, ta biblioteka działa niezależnie, tworząc dokumenty od podstaw przy użyciu czystego kodu Ruby. Opiera się na standardzie Office Open XML, zapewniając kompatybilność z Microsoft Word, Google Docs, LibreOffice i innymi nowoczesnymi edytorami tekstu. Biblioteka koncentruje się na prostocie i czytelności, co sprawia, że generowanie dokumentów jest dostępne nawet dla programistów, którzy nie znają skomplikowanej struktury XML dokumentów Word. Zamiast walczyć z przestrzeniami nazw i schematami XML, możesz pisać prosty kod Ruby, który jest naturalny i łatwy w utrzymaniu.

Previous Next

Rozpoczęcie pracy z OpenXml::Docx

Zalecany sposób instalacji OpenXml::Docx to użycie RubyGems. Proszę użyć poniższego polecenia, aby przeprowadzić płynną instalację.

Instalacja OpenXml::Docx przy użyciu RubyGems

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

Tworzenie pierwszego dokumentu DOCX

Open source OpenXml::Docx zapewnia pełne wsparcie dla tworzenia i zarządzania nowymi dokumentami Word w aplikacjach Java. Podstawowym budulcem dokumentu Word jest akapit. Dzięki kilku linijkom kodu programiści mogą dodawać tekst i obrazy do dokumentów Word. Poniżej prosty przykład, który demonstruje, jak programiści mogą uzyskać dostęp do ciała dokumentu, dodać akapit z ciągiem tekstowym, zastosować formatowanie i zapisać plik.

Jak stworzyć dokument Word i dodać akapit z tekstem przy użyciu Java API?

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')

Zaawansowane formatowanie tekstu przy użyciu Javy

Open source OpenXml::Docx zapewnia pełne wsparcie zarówno dla podstawowego, jak i zaawansowanego formatowania tekstu w dokumentach Word. Poza podstawowym pogrubieniem i kursywą, biblioteka obsługuje zaawansowane formatowanie tekstu. Poniższy przykład kodu Java prezentuje podkreślenia, przekreślenia, podświetlenia i kombinacje wielu efektów. Właściwość koloru akceptuje wartości szesnastkowe, pozwalając na precyzyjne dopasowanie do wytycznych marki.

Jak zastosować formatowanie tekstu w dokumentach Word przy użyciu Java API?

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')

Tworzenie tabel dla danych w plikach Word przy użyciu Javy

Tabele są niezbędne do prezentacji uporządkowanych informacji. OpenXml::Docx ułatwia programistom tworzenie tabel w dokumentach Word, aby prawidłowo zarządzać danymi w aplikacjach Java. Oto praktyczny przykład, który tworzy profesjonalną tabelę sprzedaży z wierszem nagłówka pogrubionym i trzema wierszami danych. Kod pokazuje, jak uzyskać dostęp do konkretnych komórek i wypełnić je zawartością. Możesz iterować po strukturach danych i dynamicznie wypełniać tabele, co czyni go idealnym do generowania raportów.

Jak stworzyć tabelę z wierszami i kolumnami w aplikacjach 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')

Automatyczne generowanie raportów i faktur

Firmy mogą używać OpenXml::Docx do automatycznego generowania miesięcznych raportów, sprawozdań finansowych lub podsumowań analitycznych. Pobierając dane z baz danych i formatując je w profesjonalne dokumenty, organizacje oszczędzają niepoliczalne godziny ręcznej pracy. Ponadto platformy e‑commerce i firmy usługowe mogą dynamicznie generować faktury i umowy. Informacje o klientach, pozycje i warunki mogą być wypełniane z baz danych, zapewniając dokładność i spójność we wszystkich dokumentach.

 Polski