Genera documenti con Ruby SDK
API REST e Ruby Cloud SDK per assemblare, unire e inviare tramite posta elettronica documenti da modelli e fonti dati.
API REST e Ruby Cloud SDK per assemblare, unire e inviare tramite posta elettronica documenti da modelli e fonti dati.
GroupDocs.Assembly Cloud è un servizio completamente gestito basato su REST che consente di creare documenti altamente personalizzati direttamente dalle applicazioni Ruby. La piattaforma funziona su un modello di dati e template: si progetta un documento template (Word, Excel, PowerPoint, PDF, HTML, ecc.) che contiene campi segnaposto speciali e costrutti programmabili. In fase di esecuzione, si fornisce un’origine dati in formato XML o JSON, si associano i dati al template utilizzando una sintassi di espressione in stile LINQ e il servizio cloud assembla il documento finale nel formato desiderato.
Questo approccio elimina la necessità di installazioni locali di Office, librerie di terze parti o motori di rendering complessi: tutto il lavoro pesante viene eseguito nel data center sicuro di GroupDocs. È disponibile il supporto integrato per stampa unione, tabelle dinamiche, contenuto condizionale, generazione di codici a barre, inserimento di immagini e grafici e un ricco set di opzioni di formattazione. Il servizio fornisce anche comunicazioni crittografate SSL/TLS, chiavi di accesso personali per l’autenticazione e autorizzazioni basate sui ruoli per proteggere i tuoi dati.
. Flusso di lavoro Ruby con l’SDK
GroupDocs.Assemblygem install groupdocs_assembly_cloud).app_sid e api_key.UploadFile.AssembleOptions che faccia riferimento al modello caricato, specifichi il formato di output desiderato e fornisca l’origine dati XML/JSON (o un file che la contenga).assemble_document: l’API restituisce il documento assemblato, che puoi scaricare direttamente o archiviare nuovamente su Cloud Storage.Utilizzando questa semplice sequenza è possibile generare contratti, fatture, proposte, report di spedizione, lettere personalizzate o qualsiasi altro documento aziendale critico su richiesta, passando da una singola richiesta a scenari di elaborazione batch di grandi dimensioni con stampa unione.
L’SDK Ruby offre anche classi di supporto per lavorare con l’archiviazione, gestire gli errori e personalizzare i timeout delle richieste, semplificando l’integrazione con Rails, Sinatra o qualsiasi servizio basato su Ruby.
Funzionalità principali dell’API Assembly Cloud.
Formati di documento supportati per Assembly Cloud.
Sistemi operativi e ambienti di sviluppo supportati da Ruby SDK.
Il frammento di codice seguente mostra come generare un documento utilizzando l’SDK Assembly Cloud Ruby. 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