1. Məhsullar
  2.   Söz emalı
  3.   Ruby
  4.   Ruby-Docx-Templater
 
  

Pulsuz Ruby API vasitəsilə Şablondan Dinamik Word Faylları Yaratmaq

Əvvəlcədən hazırlanmış şablonlardan dinamik Microsoft Word (.docx) sənədləri yaratmaq üçün nəzərdə tutulmuş aparıcı açıq mənbə Ruby kitabxanası.

Ruby-Docx-Templater nədir?

Ruby tətbiqindən dinamik Microsoft Word sənədləri (.docx) yaratmaq gözlənilməz dərəcədə mürəkkəb bir iş ola bilər. Texniki olmayan istifadəçilərin hazırladığı hesabatlar, fakturalar və ya məktublar yaratmaq lazım gələ bilər. Mövcud bir çox həll var, lakin onlar tez-tez LibreOffice və ya yerli Word quraşdırmaları kimi ağır asılılıqlar tələb edir. Ruby-Docx-Templater burada ortaya çıxır – fərqli bir yanaşma tətbiq edən yüngül gem. İstifadəçilərə standart .docx faylını şablon kimi istifadə etməyə, bütün əməliyyatı yaddaşda həyata keçirməyə və öz məlumatlarını daxil etməyə imkan verir. Bu, hər bir Ruby inkişaf etdiricisi üçün sürətli, təhlükəsiz və yerləşdirməyə uyğun bir seçimdir.

Əsas konsepsiyası olaraq Ruby-Docx-Templater kitabxanası xüsusi olaraq .docx faylları üçün şablon mühərrikidir. O, əvvəlcədən hazırlanmış şablonlardan dinamik Microsoft Word (.docx) sənədləri yaratmaq üçün nəzərdə tutulmuş yüngül, güclü Ruby gem‑idir. Standart Word sənədində sadə etiket‑əsaslı sistemdən istifadə edərək işləyir. Word‑də şablon yaradırsınız, dinamik məzmunun görünməsini istədiyiniz yerlərə xüsusi etiketlər əlavə edirsiniz və sonra gem bu etiketləri Ruby tətbiqinizdən əldə edilən real məlumatlarla əvəz edir. Yaddaşa əsaslanan emalı, mürəkkəb cədvəl strukturlarının dəstəyi və formatlamanın qorunması onu biznes sənədlərinin avtomatlaşdırılması üçün ideal edir.

Previous Next

Ruby-Docx-Templater ilə Başlamaq

Ruby-Docx-Templater‑i quraşdırmağın tövsiyə olunan yolu RubyGems istifadə etməkdir. Problemsiz quraşdırma üçün aşağıdakı əmri istifadə edin.

RubyGems vasitəsilə Ruby-Docx-Templater quraşdırın

 gem install ruby-docx-templater

GitHub vasitəsilə Ruby-Docx-Templater quraşdırın

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

Ruby vasitəsilə Şablondan Word Docx Faylı Yaratmaq

Ruby-Docx-Templater‑in ən əsas funksiyası sadə mətn əvəzləməsidir. Word sənədinizdə istənilən yerdə yer tutucular yerləşdirə bilərsiniz, kitabxana isə onları real dəyərlərlə əvəz edəcək. Bu yanaşmanın gözəlliyi odur ki, formatlama qorunur. Şablonunuzda $COMPANY_NAME$ mətnini qalın və qırmızı etsəniz, çıxışda da qalın və qırmızı qalacaq. Bu, dizaynerlərə sənəd görünüşü üzərində tam nəzarət verir. Word şablonunuzda $KEY$ sintaksisi ilə açarları təyin edirsiniz. Dollar işarələri ayrıcı kimi işləyir, əvəzləmələrin harada baş verməli olduğunu açıq göstərir.

Ruby vasitəsilə Şablon Faylı istifadə edərək Word Docx Faylı yaratmaq?

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

Çox Sətirli Cədvəl Döngüləri Dəstəyi

Ən güclü funksiyalardan biri, çox sətirli dinamik cədvəllər yaratma qabiliyyətidir. Bu, fakturalarda, məhsul kataloqlarında və ya təkrarlanan məlumatlarla hesabatlarda maddələnmiş siyahılar yaratmaq üçün vacibdir. Cədvəlinizdə döngü sahəsini təyin edirsiniz və kitabxana bu markerlər arasındakı hər şeyi məlumat massivinizi hər bir element üçün təkrarlayır. Word‑də hər hüceyrəni ayrıca formatlaya bilərsiniz. Məsələn, ədədləri sağa düzəldə, başlıqları qalın edə və ya xüsusi şriftlər tətbiq edə bilərsiniz. Bütün formatlama yaradılan sətirlərdə qorunacaq.

Ruby kitabxanası vasitəsilə Docx formatında çox sətirli Məhsul Hesabatı necə yaratmaq?

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

Yaddaşa əsaslanan emal

Açıq mənbə Ruby-Docx-Templater kitabxanası Ruby tətbiqlərində yaddaşa əsaslanan emalı dəstəkləmək və idarə etmək baxımından çox asandır. Bütün sənəd manipulyasiyası yaddaşda baş verir, bu o deməkdir ki, şablonlaşdırma prosesi zamanı həssas məlumatlarınız fayl sisteminə toxunmur. Bu, tibbi qeydlər, maliyyə sənədləri və ya şəxsi məlumatlar kimi məxfi məlumatlarla işləyən tətbiqlər üçün vacibdir.

Word XML ilə işləmək

Ruby-Docx-Templater‑in unik bir cəhəti odur ki, bəzən Word sənədinizin əsas XML‑ini əl ilə redaktə etməli olursunuz. Word tez-tez formatlama işarələri əlavə edir ki, bu da şablon açarlarınızın bölünməsinə və əvəzləmə prosesinin pozulmasına səbəb ola bilər. Word‑də $CUSTOMER_NAME$ yazdığınızda, ekranda düzgün görünə bilər, lakin əsas XML‑də bu cür görünə bilər.

 Azəri