Genera documenti con Ruby SDK
REST API e Ruby Cloud SDK per assemblare, unire e fare mail‑merge di documenti da modelli e fonti di dati.
REST API e Ruby Cloud SDK per assemblare, unire e fare mail‑merge di documenti da modelli e fonti di dati.
GroupDocs.Assembly Cloud è un servizio completamente gestito, basato su REST, che ti consente di creare documenti altamente personalizzati direttamente dalle tue applicazioni Ruby. La piattaforma funziona con un modello template‑e‑dati: progetti un documento modello (Word, Excel, PowerPoint, PDF, HTML, ecc.) che contiene campi segnaposto speciali e costrutti programmabili. A runtime fornisci una fonte di dati in formato XML o JSON, associ i dati al modello usando una sintassi di espressione in stile LINQ, e il servizio cloud assembla il documento finale nel formato di cui hai bisogno.
Questo approccio elimina la necessità di installazioni locali di Office, librerie di terze parti o motori di rendering complessi – tutta l’elaborazione pesante avviene nel sicuro data centre GroupDocs. Ottieni il supporto integrato per mail‑merge, tabelle dinamiche, contenuti condizionali, generazione di codici a barre, inserimento di immagini e grafici, e un ampio set di opzioni di formattazione. Il servizio fornisce inoltre comunicazione crittografata SSL/TLS, chiavi di accesso personali per l’autenticazione e permessi basati sui ruoli per mantenere i tuoi dati al sicuro.
GroupDocs.Assemblygem install groupdocs_assembly_cloud).app_sid e api_key.UploadFile.AssembleOptions che fa riferimento al modello caricato, specifica il formato di output desiderato e fornisce la fonte di dati XML/JSON (o un file che la contiene).assemble_document – il API restituisce il documento assemblato, che puoi scaricare direttamente o salvare nuovamente su Cloud Storage.Utilizzando questa sequenza semplice puoi generare contratti, fatture, proposte, report di spedizione, lettere personalizzate o qualsiasi altro documento critico per il business su richiesta, scalando da una singola richiesta a scenari di elaborazione batch di grandi dimensioni con mail‑merge.
Il Ruby SDK offre anche classi di supporto per lavorare con lo storage, gestire gli errori e personalizzare i timeout delle richieste, rendendo l’integrazione in Rails, Sinatra o qualsiasi servizio basato su Ruby fluida.
Funzionalità principali di Assembly Cloud API.
Formati di documento supportati da Assembly Cloud.
Sistemi operativi e ambienti di sviluppo supportati da Ruby SDK.
Lo snippet qui sotto mostra come generare un documento usando Assembly Cloud Ruby SDK. Passaggi eseguiti:
AssembleOptions – modello, formato di output e origine dati.assemble_document per ottenere il file assemblato.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