Generator de documente Word pentru Ruby

Ruby pentru a crea rapoarte Word foarte personalizate folosind API-ul REST

Integrați fără probleme generarea de documente Word bazate pe șabloane și surse de date în software-ul dvs. Ruby.

Automatizați generarea de documente Word în Ruby, creați rapoarte Word gata de imprimare de orice complexitate cu Ruby SDK. Această soluție bazată pe cloud este construită în jurul șabloanelor, surselor de date și a unei puternice sintaxe LINQ, oferind dezvoltatorilor Ruby flexibilitatea de a se potrivi cerințelor tehnice și de afaceri precise.

Folosind această bibliotecă Ruby, puteți crea în mod programatic rapoarte Word foarte personalizate pe orice sistem de operare. Documentele Word formatate bogat, cum ar fi contracte, comenzi, facturi, rapoarte de expediere, propuneri de vânzări, inventare pot fi asamblate din mers ca parte a software-ului dumneavoastră Ruby.

Simplificați generarea de documente Word folosind Ruby

Importanța automatizării documentelor și a generării de rapoarte a crescut enorm în ultimele decenii. Aproape fiecare companie are nevoie să genereze documente și să le livreze partenerilor sau clienților la timp. Mai mult, este de obicei un factor decisiv în succesul financiar. Implementarea unor astfel de tehnologii poate duce la economii financiare semnificative prin reducerea introducerii manuale a datelor, a erorilor umane, a corecturii și a documentelor. Din aceste motive, instrumentele de automatizare și raportare a documentelor sunt o parte integrantă a multor soluții software moderne care urmăresc să ofere utilizatorilor caracteristici analitice avansate.

În general, generarea de rapoarte Word este un proces care combină text, date și grafică într-o singură entitate și exportă rezultatul într-o formă vizuală convenabilă în format de fișier Word. Pentru informații despre formatele I/O acceptate, vă rugăm să vizitați documentația noastră.

Ce este GroupDocs Assembly for Ruby

GroupDocs Assembly for Ruby este o soluție bazată pe cloud pentru generarea de documente Word folosind șabloane și surse de date. Șablonul de document acționează ca un cadru de bază, care, pe lângă conținutul standard (text, tabele, diagrame etc.), include câmpuri speciale de substituent pentru inserarea valorilor din sursa de date. Pot fi inserate nu numai valori individuale, ci și matrice întregi de date sub formă de tabele și grafice.

Șablonul conține, de asemenea, constructe de programare - reguli de generare a documentelor Word - care controlează selecția datelor și procesarea condițiilor. Legarea datelor la un șablon de document folosește sintaxa expresiei LINQ, care permite dezvoltatorilor să proceseze datele într-un mod generic, indiferent de tipul de sursă de date utilizată. În acest fel, Ruby Cloud SDK vă oferă flexibilitate în generarea de conținut Word și un set puternic de metode pentru procesarea datelor.

Acest produs acceptă și funcționalitatea Mail Merge în cazul în care doriți să creați și să trimiteți clienților loturi de scrisori personalizate în format Word. Trebuie doar să inserați câmpuri Mail Merge în șablonul de document și să îl transmiteți API-ului Cloud împreună cu o sursă de date.

Indiferent de amploarea și tipul de automatizare a documentelor Word pe care urmează să o implementați, există trei pași pentru a crea un raport în Ruby:

  • Creați un șablon de document Word cu câmpuri de substituent și reguli de generare a documentelor care vor reglementa variațiile de structură și conținut
  • Creați o sursă de date în format Word sau JSON
  • Scrieți câteva rânduri de cod Ruby pentru a trece totul către API-ul de construcție a documentelor și a obține înapoi rezultatul asamblat în format Word

Proiectarea unui șablon de document și utilizarea regulilor de generare a documentelor Word

Proiectarea șabloanelor este o sarcină dificilă. Pe lângă o înțelegere clară a cerințelor pentru documentul Word final, sunt necesare abilități analitice și de programare. Un design bun de șablon ar trebui să reflecte punctul de vedere al clientului cu privire la o anumită problemă. Cea mai eficientă abordare este combinarea datelor tabelare și a graficelor într-un echilibru corect, determinat de cerințele afacerii.

După cum am menționat mai sus, structura șablonului conține de obicei câteva blocuri fixe de conținut (text, imagini, logo-uri etc.) amestecate cu constructe speciale de programare care controlează logica de asamblare a documentelor Word. Aceste reguli de generare a documentelor Word sunt definite cu o sintaxă de expresie specială, care permite dezvoltatorilor să facă următoarele:

  • încorporați conținut de document extern, imagini, diagrame, liste, tabele, hyperlinkuri, marcaje etc.
  • lucrați cu date folosind formule și operații secvențiale de date
  • specificați formatul de prezentare pentru elementele numerice, text, grafice, grafice și date și oră
  • inserați blocuri de conținut în funcție de expresiile condiționate
  • definiți variabile speciale pentru calcule "costisitoare" care sunt calculate o singură dată
  • calculați formule la asamblarea documentelor de foi de calcul
  • atribuiți atributele corpului mesajului de e-mail și creați în mod dinamic atașamente
  • creați și introduceți coduri de bare
  • setați culoarea de fundal pentru documentele HTML

Puteți afla mai multe despre sintaxa șablonului în Ghidul nostru pentru dezvoltatori.

Cerințe

GroupDocs Assembly for Ruby nu necesită instalarea niciunui software extern sau instrumente terțe. Aceasta este o soluție bazată pe cloud pentru Word, în care toate interacțiunile de programare sunt efectuate în rețea folosind API-ul REST.

Securitate

Toate produsele GroupDocs sunt pe deplin conforme cu standardele de securitate din industrie: transferul de date se realizează folosind protocolul SSL, care elimină posibilitatea ca informațiile să fie interceptate de terți. Pentru a vă conecta la GroupDocs Cloud Services, trebuie să utilizați chei de acces personale. Vă rugăm să consultați ghidul de pornire rapidă.

Generați document Word în Ruby

Următorul exemplu de cod arată cum să generați rapoarte Word folosind Ruby.

Generați document DOCX în Ruby
Fișiere de intrare
Încărcați un șablon de document
Format de iesire
Selectați formatul țintă din listă
require_relative '../lib/groupdocs_assembly_cloud'

GroupDocsAssemblyCloud.configure do |config|
  config.client_data['app_sid'] = '####-####-####-####-####'
  config.client_data['api_key'] = '##################'
end
@assembly_api = AssemblyApi.new
file_name= 'Input1.docx'
data_file= 'Input2.docx'

request_file_content = File.open(file_name)
upload_document_request = UploadFileRequest.new(
    file_content: request_file_content, path: file_name)
@assembly_api.upload_file(upload_document_request)

template_file_info = TemplateFileInfo.new(:FilePath => file_name)
assemble_options = AssembleOptions.new(
    :TemplateFileInfo => template_file_info, 
	    :SaveFormat => "docx", 
		    :ReportData => File.open(data_file, 'rb') { |f| f.read })
request = AssembleDocumentRequest.new assemble_options
@assembly_api.assemble_document request
  
Copiați codul Ruby în clipboard

Cum se generează un document Word utilizând Ruby

  1. Instalați 'GroupDocs.Assembly Cloud SDK for Ruby'.
  2. Adăugați o referință la bibliotecă (importați biblioteca) în proiectul dvs. Ruby.
  3. Creați un document șablon, adăugați constructe de programare care controlează inserarea datelor din sursa de date.
  4. Creați o sursă de date.
  5. Încărcați șablonul de document în GroupDocs Cloud Storage (trebuie să vă conectați la contul personal).
  6. Generați un document prin transmiterea șablonului și a datelor către API-ul Cloud.

Cum se instalează DOCX Report Builder pentru Ruby

Instalați GroupDocs.Assembly Cloud SDK for Ruby folosind serviciul de găzduire RubyGems. Rulați gem install groupdocs_assembly_cloud pentru a instala pachetul. Ca alternativă, puteți clona manual GroupDocs.Assembly Cloud SDK for Ruby din GitHub și îl puteți utiliza în proiectul dvs. Vă rugăm să urmați aceste Instructions pentru a obține rapid acreditările de securitate necesare și pentru a accesa API-ul nostru REST.

Cerințe de sistem

Ruby 2.6 sau mai nou

Consultați Repository Documentation pentru a vedea detaliile.

Alte formate de document acceptate

Puteți genera rapoarte în alte formate de fișiere:

5%

Abonați-vă la Actualizări de produse Aspose

Primiți buletine informative lunare și oferte livrate direct în căsuța dvs. poștală.

© Aspose Pty Ltd 2001-2024. Toate drepturile rezervate.