1. Produk
  2.   Pemprosesan perkataan
  3.   Ruby
  4.   Ruby-Docx-Templater
 
  

Buat Fail Word Dinamik dari Templat melalui API Ruby Percuma

Perpustakaan Ruby Sumber Terbuka Teratas Direka untuk Membuat Dokumen Microsoft Word (.docx) Dinamik daripada Templat Pra-reka.

Apa itu Ruby-Docx-Templater?

Menjana dokumen Microsoft Word (.docx) dinamik daripada aplikasi Ruby boleh menjadi tugas yang amat kompleks. Anda mungkin perlu menjana laporan, invois, atau surat yang direka oleh pengguna bukan teknikal. Walaupun banyak penyelesaian wujud, mereka sering memerlukan kebergantungan berat seperti LibreOffice atau pemasangan Word tempatan. Memperkenalkan Ruby-Docx-Templater, gem ringan yang mengambil pendekatan berbeza. Ia membolehkan pengguna menggunakan fail .docx standard sebagai templat, memanipulasikannya sepenuhnya dalam memori untuk menyuntik data mereka. Ini menjadikannya pilihan yang pantas, selamat, dan mesra penyebaran untuk mana-mana pembangun Ruby.

Pada intinya, perpustakaan Ruby-Docx-Templater adalah enjin templat khusus untuk fail .docx. Ia merupakan gem Ruby ringan dan berkuasa yang direka untuk mencipta dokumen Microsoft Word (.docx) dinamik daripada templat pra-reka. Ia berfungsi dengan menggunakan sistem berasaskan tag sederhana dalam dokumen Word standard. Anda membuat templat dalam Word, meletakkan tag khusus di tempat anda mahu kandungan dinamik muncul, dan kemudian membiarkan gem menggantikan tag tersebut dengan data sebenar daripada aplikasi Ruby anda. Pemprosesan berasaskan memori, sokongan untuk struktur jadual kompleks, dan pemeliharaan format menjadikannya ideal untuk automasi dokumen perniagaan.

Previous Next

Mula Menggunakan Ruby-Docx-Templater

Cara yang disarankan untuk memasang Ruby-Docx-Templater ialah menggunakan RubyGems. Sila gunakan perintah berikut untuk pemasangan yang lancar.

Pasang Ruby-Docx-Templater melalui RubyGems

 gem install ruby-docx-templater

Pasang Ruby-Docx-Templater melalui GitHub

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

Cipta Fail Word Docx daripada Templat melalui Ruby

Ciri paling asas Ruby-Docx-Templater ialah penggantian teks ringkas. Anda boleh meletakkan tempat pemegang di mana-mana dalam dokumen Word anda, dan perpustakaan akan menggantikannya dengan nilai sebenar. Keindahan pendekatan ini ialah format dipelihara. Jika anda menjadikan $COMPANY_NAME$ tebal dan merah dalam templat anda, ia akan kekal tebal dan merah dalam output. Ini memberi pereka kawalan penuh ke atas penampilan dokumen. Dalam templat Word anda, anda mendefinisikan kunci menggunakan sintaks $KEY$. Tanda dolar berfungsi sebagai pemisah, menjadikan jelas di mana penggantian harus berlaku.

Cipta Fail Word Docx menggunakan Fail Templat melalui 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')

Sokongan Gelung Jadual Berbilang Baris

Salah satu ciri paling kuat ialah kebolehan untuk menjana jadual dinamik dengan berbilang baris. Ini penting untuk mencipta senarai item dalam invois, katalog produk, atau mana-mata laporan dengan data yang berulang.\nAnda mendefinisikan kawasan gelung dalam jadual anda dan perpustakaan akan menyalin semua antara penanda ini untuk setiap item dalam susunan data anda. Anda boleh memformat setiap sel secara individu dalam Word. Contohnya, anda mungkin menyelaraskan nombor ke kanan, menjadikan tajuk tebal, atau menggunakan fon tertentu. Semua format akan dipelihara dalam baris yang dijana.

Bagaimana Membuat Laporan Produk dengan Berbilang Baris dalam Format Docx melalui 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')

Pemprosesan Berasaskan Memori

Perpustakaan Ruby-Docx-Templater sumber terbuka sangat mudah dikendalikan dan menyokong pemprosesan berasaskan memori dalam aplikasi Ruby. Semua manipulasi dokumen berlaku dalam memori, yang bermaksud data sensitif anda tidak pernah menyentuh sistem fail semasa proses templat. Ini penting untuk aplikasi yang mengendalikan maklumat sulit seperti rekod perubatan, dokumen kewangan, atau data peribadi.

Bekerja dengan Word XML

Satu aspek unik Ruby-Docx-Templater ialah anda kadang-kadang perlu mengedit secara manual XML asas dokumen Word anda. Word sering memasukkan markup format yang boleh memecahkan kunci templat anda, mengganggu proses penggantian. Apabila anda menaip $CUSTOMER_NAME$ dalam Word, ia mungkin kelihatan betul di skrin, tetapi XML asasnya boleh kelihatan seperti ini.

 Melayu