1. Προϊόντα
  2.   Επεξεργασίας κειμένου
  3.   Ruby
  4.   Ruby-Docx-Templater
 
  

Δημιουργία δυναμικών αρχείων Word από πρότυπο μέσω Δωρεάν Ruby API

Κορυφαία Ανοιχτής Πηγής Ruby βιβλιοθήκη σχεδιασμένη για τη δημιουργία δυναμικών εγγράφων Microsoft Word (.docx) από προ-σχεδιασμένα πρότυπα.

Τι είναι το Ruby-Docx-Templater;

Η δημιουργία δυναμικών εγγράφων Microsoft Word (.docx) από μια εφαρμογή Ruby μπορεί να είναι μια εκπληκτικά πολύπλοκη διαδικασία. Μπορεί να χρειαστείτε τη δημιουργία αναφορών, τιμολογίων ή γραμμάτων που έχουν σχεδιάσει μη τεχνικοί χρήστες. Αν και υπάρχουν πολλές λύσεις, συχνά απαιτούν βαριές εξαρτήσεις όπως LibreOffice ή τοπικές εγκαταστάσεις του Word. Εισάγουμε το Ruby-Docx-Templater, ένα ελαφρύ gem που υιοθετεί διαφορετική προσέγγιση. Επιτρέπει στους χρήστες να χρησιμοποιούν ένα τυπικό αρχείο .docx ως πρότυπο, επεξεργάζοντάς το εξολοκλήρου στη μνήμη για να εισάγουν τα δεδομένα τους. Αυτό το καθιστά μια γρήγορη, ασφαλή και φιλική στην ανάπτυξη επιλογή για κάθε προγραμματιστή Ruby.

Στην ουσία, η βιβλιοθήκη Ruby-Docx-Templater είναι μια μηχανή προτύπων ειδικά για αρχεία .docx. Είναι ένα ελαφρύ, ισχυρό Ruby gem σχεδιασμένο να δημιουργεί δυναμικά έγγραφα Microsoft Word (.docx) από προ-σχεδιασμένα πρότυπα. Λειτουργεί χρησιμοποιώντας ένα απλό σύστημα βασισμένο σε ετικέτες μέσα σε ένα τυπικό έγγραφο Word. Δημιουργείτε ένα πρότυπο στο Word, τοποθετείτε ειδικές ετικέτες εκεί όπου θέλετε να εμφανιστεί δυναμικό περιεχόμενο, και το gem αντικαθιστά αυτές τις ετικέτες με πραγματικά δεδομένα από την Ruby εφαρμογή σας. Η επεξεργασία με βάση τη μνήμη, η υποστήριξη σύνθετων δομών πινάκων και η διατήρηση της μορφοποίησης το καθιστούν ιδανικό για αυτοματοποίηση επιχειρηματικών εγγράφων.

Previous Next

Ξεκινώντας με το Ruby-Docx-Templater

Η συνιστώμενη μέθοδος εγκατάστασης του Ruby-Docx-Templater είναι μέσω RubyGems. Παρακαλώ χρησιμοποιήστε την παρακάτω εντολή για ομαλή εγκατάσταση.

Εγκατάσταση Ruby-Docx-Templater μέσω RubyGems

 gem install ruby-docx-templater

Εγκατάσταση Ruby-Docx-Templater μέσω GitHub

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

Δημιουργία αρχείου Word Docx από πρότυπο μέσω Ruby

Το πιο βασικό χαρακτηριστικό του Ruby-Docx-Templater είναι η απλή αντικατάσταση κειμένου. Μπορείτε να τοποθετήσετε σύμβολα κράτησης θέσης οπουδήποτε στο έγγραφο Word, και η βιβλιοθήκη θα τα αντικαταστήσει με πραγματικές τιμές. Η ομορφιά αυτής της προσέγγισης είναι ότι η μορφοποίηση διατηρείται. Αν κάνετε το $COMPANY_NAME$ έντονο και κόκκινο στο πρότυπό σας, θα παραμείνει έντονο και κόκκινο στην έξοδο. Αυτό δίνει στους σχεδιαστές πλήρη έλεγχο της εμφάνισης του εγγράφου. Στο πρότυπο Word, ορίζετε κλειδιά χρησιμοποιώντας τη σύνταξη $KEY$. Τα σύμβολα δολαρίου λειτουργούν ως οριοθέτες, καθιστώντας σαφές πού πρέπει να γίνουν οι αντικαταστάσεις.

Δημιουργία αρχείου Word Docx χρησιμοποιώντας αρχείο προτύπου μέσω 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')

Υποστήριξη βρόχων πίνακα πολλαπλών γραμμών

Ένα από τα πιο ισχυρά χαρακτηριστικά είναι η δυνατότητα δημιουργίας δυναμικών πινάκων με πολλαπλές γραμμές. Αυτό είναι ουσιώδες για τη δημιουργία στοιχειοθετημένων λιστών σε τιμολόγια, καταλόγους προϊόντων ή οποιαδήποτε αναφορά με επαναλαμβανόμενα δεδομένα. Ορίζετε μια περιοχή βρόχου στον πίνακά σας και η βιβλιοθήκη θα διπλασιάσει όλα τα στοιχεία μεταξύ αυτών των σημείων για κάθε αντικείμενο στον πίνακα δεδομένων σας. Μπορείτε να μορφοποιήσετε κάθε κελί ξεχωριστά στο Word. Για παράδειγμα, μπορείτε να ευθυγραμμίσετε δεξιά τους αριθμούς, να κάνετε τους τίτλους έντονους ή να εφαρμόσετε συγκεκριμένες γραμματοσειρές. Όλη η μορφοποίηση θα διατηρηθεί στις παραγόμενες γραμμές.

Πώς να δημιουργήσετε αναφορά προϊόντος με πολλαπλές γραμμές σε μορφή Docx μέσω της 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')

Επεξεργασία με βάση τη μνήμη

Η ανοιχτού κώδικα βιβλιοθήκη Ruby-Docx-Templater είναι πολύ εύκολη στη χρήση και υποστηρίζει επεξεργασία με βάση τη μνήμη μέσα σε εφαρμογές Ruby. Όλη η διαχείριση εγγράφων γίνεται στη μνήμη, πράγμα που σημαίνει ότι τα ευαίσθητα δεδομένα σας δεν αγγίζουν ποτέ το σύστημα αρχείων κατά τη διαδικασία προτύπωσης. Αυτό είναι κρίσιμο για εφαρμογές που χειρίζονται εμπιστευτικές πληροφορίες όπως ιατρικά αρχεία, οικονομικά έγγραφα ή προσωπικά δεδομένα.

Εργασία με Word XML

Ένα μοναδικό χαρακτηριστικό του Ruby-Docx-Templater είναι ότι μερικές φορές χρειάζεται να επεξεργαστείτε χειροκίνητα το υποκείμενο XML του εγγράφου Word. Το Word συχνά εισάγει σήμανση μορφοποίησης που μπορεί να χωρίσει τα κλειδιά του προτύπου, διασπώντας τη διαδικασία αντικατάστασης. Όταν πληκτρολογείτε $CUSTOMER_NAME$ στο Word, μπορεί να φαίνεται σωστό στην οθόνη, αλλά το υποκείμενο XML μπορεί να μοιάζει με αυτό.

 Ελληνικά