1. Produk
  2.   Pemrosesan Kata
  3.   Ruby
  4.   OpenXml::Docx
 
  

Perpustakaan Ruby Open Source untuk Membuat Dokumen Word & Menambahkan Tabel

Gem (Perpustakaan) Ruby Gratis yang memungkinkan Pembuatan File Microsoft Word .docx menggunakan Format Office Open XML (OOXML) dan Menambahkan Paragraf Teks, Tabel, serta Gambar di dalam file DOCX.

Apa itu OpenXml::Docx?

Dokumen Microsoft Word telah menjadi standar untuk komunikasi bisnis, laporan, dan dokumentasi di berbagai industri. Sementara pembuatan dokumen manual cocok untuk tugas kecil, mengotomatisasi pembuatan dokumen menjadi penting ketika berurusan dengan templat, operasi massal, atau konten dinamis. Di sinilah OpenXml::Docx berperan — sebuah perpustakaan Ruby yang memberi kekuatan kepada pengembang perangkat lunak untuk membuat dokumen Word profesional secara programatis. Perpustakaan ini dapat dijalankan di mana saja Ruby dijalankan, tanpa ketergantungan eksternal. Ada beberapa fitur penting dalam perpustakaan ini, seperti membuat dokumen word baru, menerapkan pemformatan dan gaya teks, tabel dan penyajian data, integrasi gambar dan media, dan sebagainya.

OpenXml::Docx adalah gem Ruby yang menyediakan antarmuka yang bersih dan intuitif untuk menghasilkan dokumen Word dalam format Open XML (ekstensi .docx yang kita semua kenal). Tidak seperti solusi berat yang memerlukan instalasi Microsoft Office, perpustakaan ini bekerja secara independen, membuat dokumen dari awal menggunakan kode Ruby murni. Ia mengikuti standar Office Open XML, memastikan kompatibilitas dengan Microsoft Word, Google Docs, LibreOffice, dan pengolah kata modern lainnya. Perpustakaan ini menekankan kesederhanaan dan keterbacaan, membuat pembuatan dokumen dapat diakses bahkan bagi pengembang yang tidak familiar dengan struktur XML yang kompleks di balik dokumen Word. Alih-alih berjuang dengan namespace dan skema XML, Anda dapat menulis kode Ruby yang langsung, alami, dan mudah dipelihara.

Previous Next

Memulai dengan OpenXml::Docx

Cara yang disarankan untuk menginstal OpenXml::Docx adalah menggunakan RubyGems. Silakan gunakan perintah berikut untuk instalasi yang lancar.

Instal OpenXml::Docx via RubyGems

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

Membuat Dokumen DOCX Pertama Anda

OpenXml::Docx open source telah menyertakan dukungan lengkap untuk membuat dan mengelola dokumen Word baru di dalam aplikasi Java. Blok bangunan dasar sebuah dokumen Word adalah paragraf. Dengan hanya beberapa baris kode, pengembang perangkat lunak dapat menambahkan teks dan gambar ke dalam dokumen Word. Berikut contoh sederhana yang menunjukkan bagaimana pengembang perangkat lunak dapat mengakses isi dokumen, menambahkan paragraf dengan rangkaian teks, menerapkan pemformatan, dan menyimpan file.

Bagaimana Membuat Dokumen Word dan Menambahkan Paragraf dengan Teks 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')

Pemformatan Teks Lanjutan via Java

Perpustakaan OpenXml::Docx open source telah menyertakan dukungan lengkap untuk pemformatan teks dasar maupun lanjutan di dalam dokumen Word. Selain teks tebal dan miring dasar, perpustakaan ini mendukung pemformatan teks yang canggih. Contoh kode Java berikut menampilkan garis bawah, coretan, penyorotan, dan kombinasi beberapa efek. Properti warna menerima nilai hex, memungkinkan pencocokan warna yang tepat dengan panduan merek.

Bagaimana Menerapkan Pemformatan Teks ke Dokumen 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')

Membuat Tabel untuk Data dalam File Word via Java

Tabel sangat penting untuk menyajikan informasi terstruktur. Perpustakaan OpenXml::Docx memudahkan pengembang perangkat lunak untuk membuat tabel di dalam dokumen Word guna mengelola data dengan cara yang tepat dalam aplikasi Java. Berikut contoh praktis yang dapat membuat tabel penjualan profesional dengan baris header tebal dan tiga baris data. Kode tersebut menunjukkan cara mengakses sel tertentu dan mengisi mereka dengan konten. Anda dapat mengiterasi struktur data dan secara dinamis mengisi tabel, menjadikannya sempurna untuk pembuatan laporan.

Bagaimana Membuat Tabel dengan Baris dan Kolom dalam Aplikasi 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')

Pembuatan Laporan & Faktur Otomatis

Perusahaan dapat menggunakan perpustakaan OpenXml::Docx untuk menghasilkan laporan bulanan, laporan keuangan, atau ringkasan analitik secara otomatis. Dengan mengambil data dari basis data dan memformatnya menjadi dokumen profesional, organisasi menghemat banyak jam kerja manual. Selain itu, platform e-commerce dan bisnis layanan dapat menghasilkan faktur serta kontrak secara dinamis. Informasi pelanggan, item baris, dan ketentuan dapat diisi dari basis data, memastikan akurasi dan konsistensi di semua dokumen.

 Indonesia