1. Ürün:% s
  2.   Kelime İşleme
  3.   Ruby
  4.   Ruby-Docx-Templater
 
  

Ücretsiz Ruby API ile Şablondan Dinamik Word Dosyaları Oluştur

Önceden tasarlanmış şablonlardan dinamik Microsoft Word (.docx) belgeleri oluşturmak için tasarlanmış lider Açık Kaynak Ruby Kütüphanesi.

Ruby-Docx-Templater Nedir?

Bir Ruby uygulamasından dinamik Microsoft Word belgeleri (.docx) üretmek şaşırtıcı derecede karmaşık bir görev olabilir. Teknik olmayan kullanıcıların tasarladığı raporlar, faturalar ya da mektuplar üretmeniz gerekebilir. Çoğu çözüm mevcut olsa da, genellikle LibreOffice gibi ağır bağımlılıklar ya da yerel Word kurulumları gerektirir. İşte Ruby-Docx-Templater devreye giriyor; farklı bir yaklaşım sunan hafif bir gem. Kullanıcıların standart bir .docx dosyasını şablon olarak kullanmasına, verilerini tamamen bellekte işleyerek enjekte etmesine olanak tanır. Bu, herhangi bir Ruby geliştiricisi için hızlı, güvenli ve dağıtıma hazır bir seçenek olur.

Ruby-Docx-Templater kütüphanesinin temelinde, özellikle .docx dosyaları için tasarlanmış bir şablon motoru vardır. Önceden tasarlanmış şablonlardan dinamik Microsoft Word (.docx) belgeleri oluşturmak için hafif, güçlü bir Ruby gem'idir. Standart bir Word belgesi içinde basit bir etiket tabanlı sistem kullanarak çalışır. Word içinde bir şablon oluşturur, dinamik içeriğin görünmesini istediğiniz yere özel etiketler koyar ve ardından gem bu etiketleri Ruby uygulamanızdaki gerçek verilerle değiştirir. Bellek tabanlı işleme, karmaşık tablo yapılarını desteklemesi ve biçimlendirmeyi koruması onu iş belge otomasyonu için ideal kılar.

Previous Next

Ruby-Docx-Templater ile Başlarken

Ruby-Docx-Templater'ı kurmanın önerilen yolu RubyGems kullanmaktır. Sorunsuz bir kurulum için lütfen aşağıdaki komutu kullanın.

RubyGems ile Ruby-Docx-Templater Kur

 gem install ruby-docx-templater

GitHub ile Ruby-Docx-Templater Kur

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

Ruby ile Şablondan Word Docx Dosyası Oluştur

Ruby-Docx-Templater'ın en temel özelliği basit metin değiştirmedir. Word belgenizin herhangi bir yerine yer tutucular koyabilir ve kütüphane bunları gerçek değerlerle değiştirir. Bu yaklaşımın güzelliği, biçimlendirmenin korunmasıdır. Şablonunuzda $COMPANY_NAME$ ifadesini kalın ve kırmızı yaparsanız, çıktı dosyasında da kalın ve kırmızı kalır. Bu, tasarımcılara belge görünümü üzerinde tam kontrol sağlar. Word şablonunuzda $KEY$ sözdizimini kullanarak anahtarlar tanımlarsınız. Dolar işaretleri ayırıcı görevi görür, böylece değişikliklerin nerede yapılacağı açıkça belirtilir.

Ruby ile Şablon Dosyasını Kullanarak Word Docx Dosyası Oluşturma?

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

Çok Satırlı Tablo Döngüsü Desteği

En güçlü özelliklerden biri, çok satırla dinamik tablolar oluşturabilme yeteneğidir. Bu, faturalarda, ürün kataloglarında veya yinelenen verileri içeren raporlarda maddeli listeler oluşturmak için esastır. Tablonuzda bir döngü bölgesi tanımlarsınız ve kütüphane, veri dizinizdeki her öğe için bu işaretçiler arasındaki her şeyi çoğaltır. Her hücreyi Word içinde ayrı ayrı biçimlendirebilirsiniz; örneğin sayıları sağa hizalayabilir, başlıkları kalın yapabilir veya belirli yazı tipleri uygulayabilirsiniz. Tüm biçimlendirme oluşturulan satırlarda korunur.

Ruby Kütüphanesi ile Docx Formatlarında Çoklu Satır İçeren Ürün Raporu Nasıl Oluşturulur?

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

Bellek Tabanlı İşleme

Açık kaynaklı Ruby-Docx-Templater kütüphanesi, Ruby uygulamaları içinde bellek tabanlı işlemeyi destekleyerek çok kolaydır. Tüm belge manipülasyonu bellek içinde gerçekleşir, bu da hassas verilerinizin şablonlama sürecinde dosya sistemine dokunmayacağı anlamına gelir. Bu, tıbbi kayıtlar, finansal belgeler veya kişisel veriler gibi gizli bilgilerle uğraşan uygulamalar için kritik öneme sahiptir.

Word XML ile Çalışma

Ruby-Docx-Templater'ın benzersiz bir yönü, bazen Word belgenizin temel XML'ini manuel olarak düzenlemeniz gerekmesidir. Word, şablon anahtarlarınızı bölebilecek biçimleme işaretlemeleri ekler ve bu da değiştirme sürecini bozar. Word'de $CUSTOMER_NAME$ yazdığınızda, ekranda doğru görünebilir, ancak temel XML şöyle görünebilir.

 Türkçe