Cruthaigh Comhaid Word Dinimiciúla ó Theimpléad trí API Ruby Saor

Tús a Chur le Ruby-Docx-Templater

Is é an bealach molta chun Ruby-Docx-Templater a shuiteáil ná a úsáid le RubyGems. Úsáid an t‑ordú seo a leanas le haghaidh suiteáil réidh.

 gem install ruby-docx-templater 

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

Cruthaigh Comhad Word Docx ó Theimpléad trí Ruby

Is í an ghné bhunúsach is lú de Ruby-Docx-Templater ná ionadú simplí téacs. Is féidir leat ionadchoinneálaithe a chur i ngach áit i do cháipéis Word, agus cuirfidh an leabharlann isteach luachanna fíor ina áit. Is í áilleacht an chur chuige seo go gcoimeádfar an formáidiú. Má déanann tú $COMPANY_NAME$ trom agus dearg i d’teimpléad, fanfaidh sé trom agus dearg sa téacs easpórtáilte. Tugann sé seo deis do dhearthóirí smacht iomlán a bheith acu ar chuma an doiciméid. Sa teimpléad Word, sainmhíníonn tú eochairí ag baint úsáide den chórais $KEY$. Feidhmíonn na comharthaí dollar mar theorainneacha, rud a chuireann i soiléiriú cá háit a chaithfidh ionadú a dhéantar.

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

Tacaíocht do Lúbaí Tábla Il-Rónna

Ceann de na gnéithe is cumhachtaí ná an cumas táblaí dinimiciúla a ghiniúint le il-rónna. Tá sé riachtanach chun liostaí míreanna i sonrascanna, catalóga táirgí, nó aon tuarascáil le sonraí athchurtha a chruthú. Sainmhíníonn tú réigiún lúb i d’tábla agus tá an leabharlann ábalta gach rud idir na marcóirí sin a chomhcheangal le haghaidh gach mír i do shraith sonraí. Is féidir gach chill a fhoirméiriú go dtíláimh i Word. Mar shampla, d’fhéadfá uimhreacha a ailíniú go deas, ceannairí a chur i bhfont trom, nó clónna áirithe a chur i bhfeidhm. Beidh an formáidiú uile coimeádta sna rónna a ghintear.

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

Próiseáil Bunaithe ar Chuimhne

Tá leabharlann Ruby-Docx-Templater foinse oscailte an-éasca le láimhseáil agus tacaíonn sé le próiseáil bunaithe ar chuimhne laistigh de fheidhmchláir Ruby. Déantar gach láimhseáil doiciméid sa chuimhne, rud a chiallaíonn nach mbuairear do shonraí íogaire riamh ar an gcóras comhad le linn an phróisis teimpléadaithe. Tá sé seo ríthábhachtach do fheidhmchláir a bhaintear le faisnéis dhlúite mar thaifid mhíochaine, doiciméid airgeadais, nó sonraí pearsanta.

Oibriú le XML Word

Ábhar uathúil amháin de Ruby-Docx-Templater ná go mbraitheann uait uaireanta an XML bunúsach de d’chaipéis Word a chur in eagar de láimh. Cuirtear marcáil formáidiúcháin isteach go minic i Word a d’fhéadfadh d’eochairí teimpléad a roinnt, ag briseadh an phróisis ionadú. Nuair a scríobhann tú $CUSTOMER_NAME$ i Word, d’fhéadfadh sé a bheith le feiceáil ceart ar an scáileán, ach d’fhéadfadh an XML bunúsach breathnú mar seo.