צור קבצי Word דינמיים מתבנית דרך API Ruby חינמי

התחלה עם Ruby-Docx-Templater

הדרך המומלצת להתקנת Ruby-Docx-Templater היא באמצעות RubyGems. אנא השתמשו בפקודה הבאה להתקנה חלקה.

 gem install ruby-docx-templater 

 git clone https://github.com/jawspeak/ruby-docx-templater.git 

צור קובץ Word Docx מתבנית באמצעות Ruby

הפונקציונליות הבסיסית ביותר של Ruby-Docx-Templater היא החלפת טקסט פשוטה. ניתן למקם מצייני מיקום (placeholders) בכל מקום במסמך Word, והספרייה תחליף אותם בערכים אמיתיים. היופי של גישה זו הוא שהפורמט נשמר. אם תסמן $COMPANY_NAME$ כבולד ואדום בתבנית שלך, הוא יישאר כך בפלט. זה מעניק למעצבים שליטה מלאה על המראה של המסמך. בתבנית ה‑Word שלך, אתה מגדיר מפתחות באמצעות תחביר $KEY$. סימני הדולר משמשים כמפרידים, מה שמבהיר היכן יש לבצע את ההחלפות.

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

תמיכה בלולאות טבלאות מרובות שורות

אחת הפונקציות החזקות ביותר היא היכולת לייצר טבלאות דינמיות עם שורות מרובות. זה חיוני ליצירת רשימות פריטים בחשבוניות, קטלוגי מוצרים, או כל דוח עם נתונים חוזרים. אתה מגדיר אזור לולאה בטבלה והספרייה משכפלת את כל מה שנמצא בין הסמנים הללו עבור כל פריט במערך הנתונים שלך. אתה יכול לעצב כל תא בנפרד ב‑Word. לדוגמה, אתה עשוי ליישר את המספרים לימין, להפוך כותרות לבולד, או להחיל פונטים מסוימים. כל העיצוב ישמר בשורות שנוצרו.

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

עיבוד מבוסס זיכרון

ספריית Ruby-Docx-Templater בקוד פתוח קלה מאוד לטיפול ותומכת בעיבוד מבוסס זיכרון בתוך יישומי Ruby. כל שינוי במסמך מתבצע בזיכרון, מה שאומר שהמידע הרגיש שלך לעולם לא נוגע במערכת הקבצים במהלך תהליך התאמת התבנית. זה קריטי ליישומים שעוסקים במידע סודי כמו רשומות רפואיות, מסמכים פיננסיים או נתונים אישיים.

עבודה עם XML של Word

היבט ייחודי של Ruby-Docx-Templater הוא שלעתים תצטרך לערוך ידנית את קובץ ה‑XML הבסיסי של מסמך ה‑Word שלך. Word לעיתים מכניס סימוני עיצוב שיכולים לפצל את מפתחות התבנית, ולהפר את תהליך ההחלפה. כאשר אתה מקליד $CUSTOMER_NAME$ ב‑Word, ייתכן שזה יופיע נכון על המסך, אך ה‑XML הבסיסי עשוי להיראות כך.