1. Produk
  2.   Pemrosesan Kata
  3.   Ruby
  4.   Ruby-Docx-Templater
 
  

Buat File Word Dinamis dari Template via API Ruby Gratis

Perpustakaan Ruby Open Source Terdepan yang Dirancang untuk Membuat Dokumen Microsoft Word (.docx) Dinamis Dari Templat yang Telah Dirancang Sebelumnya.

Apa itu Ruby-Docx-Templater?

Menghasilkan dokumen Microsoft Word (.docx) dinamis dari aplikasi Ruby dapat menjadi tugas yang cukup kompleks. Anda mungkin perlu menghasilkan laporan, faktur, atau surat yang dirancang oleh pengguna non-teknis. Meskipun banyak solusi ada, mereka sering memerlukan ketergantungan berat seperti LibreOffice atau instalasi Word lokal. Masuklah Ruby-Docx-Templater, sebuah gem ringan yang mengambil pendekatan berbeda. Ini memungkinkan pengguna menggunakan file .docx standar sebagai templat, memanipulasinya sepenuhnya di memori untuk menyuntikkan data mereka. Hal ini menjadikannya opsi yang cepat, aman, dan ramah deployment bagi setiap pengembang Ruby.

Pada intinya, perpustakaan Ruby-Docx-Templater adalah mesin templating khusus untuk file .docx. Ini adalah gem Ruby ringan namun kuat yang dirancang untuk membuat dokumen Microsoft Word (.docx) dinamis dari templat yang telah dirancang sebelumnya. Ia bekerja dengan menggunakan sistem berbasis tag sederhana di dalam dokumen Word standar. Anda membuat templat di Word, menempatkan tag khusus di tempat Anda menginginkan konten dinamis muncul, lalu gem menggantikan tag tersebut dengan data nyata dari aplikasi Ruby Anda. Pemrosesan berbasis memori, dukungan untuk struktur tabel kompleks, dan pelestarian format membuatnya ideal untuk otomasi dokumen bisnis.

Previous Next

Memulai dengan Ruby-Docx-Templater

Cara yang disarankan untuk menginstal Ruby-Docx-Templater adalah menggunakan RubyGems. Silakan gunakan perintah berikut untuk instalasi yang lancar.

Instal Ruby-Docx-Templater via RubyGems

 gem install ruby-docx-templater

Instal Ruby-Docx-Templater via GitHub

 git clone https://github.com/jawspeak/ruby-docx-templater.git
You can also download it directly from GitHub.

Buat File Word Docx dari Template via Ruby

Fitur paling dasar Ruby-Docx-Templater adalah penggantian teks sederhana. Anda dapat menempatkan placeholder di mana saja dalam dokumen Word Anda, dan perpustakaan akan menggantinya dengan nilai sebenarnya. Keindahan pendekatan ini adalah format tetap terjaga. Jika Anda membuat $COMPANY_NAME$ tebal dan merah dalam templat Anda, itu akan tetap tebal dan merah dalam output. Ini memberi desainer kontrol penuh atas tampilan dokumen. Dalam templat Word Anda, Anda mendefinisikan kunci menggunakan sintaks $KEY$. Tanda dolar berfungsi sebagai pembatas, sehingga jelas di mana substitusi harus terjadi.

Buat File Word Docx menggunakan File Templat via Ruby?

require 'docx_templater'

# Load your template file
doc = DocxTemplater::TemplateProcessor.new('invoice_template.docx')

# Define your data as a hash
data = {
  'COMPANY_NAME' => 'Acme Corporation',
  'INVOICE_NUMBER' => 'INV-2024-001',
  'INVOICE_DATE' => '2024-11-04',
  'CLIENT_NAME' => 'John Smith',
  'TOTAL_AMOUNT' => '$1,250.00'
}

# Render the document with your data
doc.render(data)

# Save the output
doc.save('output_invoice.docx')

Dukungan Loop Tabel Multi-Baris

Salah satu fitur paling kuat adalah kemampuan menghasilkan tabel dinamis dengan banyak baris. Ini penting untuk membuat daftar itemisasi dalam faktur, katalog produk, atau laporan apa pun dengan data yang berulang. Anda menentukan wilayah loop dalam tabel Anda dan perpustakaan akan menggandakan semuanya di antara penanda ini untuk setiap item dalam array data Anda. Anda dapat memformat setiap sel secara individual di Word. Misalnya, Anda dapat meratakan angka ke kanan, membuat header tebal, atau menerapkan font khusus. Semua pemformatan akan dipertahankan dalam baris yang dihasilkan.

Bagaimana Membuat Laporan Produk dengan Multi-Baris dalam Format Docx via Perpustakaan Ruby?

require 'docx_templater'

doc = DocxTemplater::TemplateProcessor.new('product_report.docx')

# Define items as an array of hashes
data = {
  'REPORT_TITLE' => 'Monthly Sales Report',
  'REPORT_DATE' => 'November 2024',
  'ITEMS_LIST' => [
    {
      'PRODUCT_NAME' => 'Laptop Pro 15"',
      'QUANTITY' => '5',
      'UNIT_PRICE' => '$1,200.00',
      'TOTAL' => '$6,000.00'
    },
    {
      'PRODUCT_NAME' => 'Wireless Mouse',
      'QUANTITY' => '12',
      'UNIT_PRICE' => '$25.00',
      'TOTAL' => '$300.00'
    },
    {
      'PRODUCT_NAME' => 'USB-C Cable',
      'QUANTITY' => '20',
      'UNIT_PRICE' => '$15.00',
      'TOTAL' => '$300.00'
    }
  ]
}

doc.render(data)
doc.save('output_sales_report.docx')

Pemrosesan Berbasis Memori

Perpustakaan Ruby-Docx-Templater open source sangat mudah dihandle dan mendukung pemrosesan berbasis memori di dalam aplikasi Ruby. Semua manipulasi dokumen terjadi di memori, yang berarti data sensitif Anda tidak pernah menyentuh sistem file selama proses templating. Ini sangat penting untuk aplikasi yang menangani informasi rahasia seperti rekam medis, dokumen keuangan, atau data pribadi.

Bekerja dengan Word XML

Salah satu aspek unik Ruby-Docx-Templater adalah Anda kadang harus mengedit secara manual XML dasar dokumen Word Anda. Word sering menyisipkan markup format yang dapat memisahkan kunci templat Anda, mengganggu proses substitusi. Ketika Anda mengetik $CUSTOMER_NAME$ di Word, mungkin terlihat benar di layar, namun XML dasarnya bisa terlihat seperti ini.

 Indonesia