Générer des documents avec Ruby SDK
API REST et Ruby Cloud SDK pour assembler, fusionner et publiposter des documents à partir de modèles et de sources de données.
API REST et Ruby Cloud SDK pour assembler, fusionner et publiposter des documents à partir de modèles et de sources de données.
GroupDocs.Assembly Cloud est un service REST entièrement géré qui vous permet de créer des documents hautement personnalisés directement depuis vos applications Ruby. La plateforme fonctionne selon un modèle de données et de modèles : vous concevez un document modèle (Word, Excel, PowerPoint, PDF, HTML, etc.) contenant des champs d’espace réservé spécifiques et des constructions programmables. À l’exécution, vous fournissez une source de données au format XML ou JSON, liez les données au modèle à l’aide d’une syntaxe d’expression de type LINQ, et le service cloud assemble le document final au format souhaité.
Cette approche élimine le besoin d’installations Office locales, de bibliothèques tierces ou de moteurs de rendu complexes : toutes les tâches lourdes sont effectuées dans le centre de données sécurisé de GroupDocs. Vous bénéficiez d’une prise en charge intégrée du publipostage, des tableaux dynamiques, du contenu conditionnel, de la génération de codes-barres, de l’insertion d’images et de graphiques, ainsi que d’un large éventail d’options de mise en forme. Le service fournit également une communication chiffrée SSL/TLS, des clés d’accès personnelles pour l’authentification et des autorisations basées sur les rôles pour protéger vos données.
Flux de travail Ruby avec le SDK
GroupDocs.Assemblygem install groupdocs_assembly_cloud).app_sid et api_key.UploadFile.AssembleOptions qui référence le modèle téléchargé, spécifie le format de sortie souhaité et fournit la source de données XML/JSON (ou un fichier la contenant).assemble_document : l’API renvoie le document assemblé, que vous pouvez télécharger directement ou stocker sur Cloud Storage.Grâce à cette séquence simple, vous pouvez générer des contrats, des factures, des propositions, des rapports d’expédition, des lettres personnalisées ou tout autre document stratégique à la demande, allant d’une simple requête à des scénarios de traitement par lots volumineux avec publipostage.
Le SDK Ruby propose également des classes d’assistance pour gérer le stockage, gérer les erreurs et personnaliser les délais d’expiration des requêtes, facilitant ainsi l’intégration à Rails, Sinatra ou tout autre service basé sur Ruby.
Fonctionnalités principales de l’API Assembly Cloud.
Formats de documents pris en charge pour Assembly Cloud.
Systèmes d’exploitation et environnements de développement pris en charge par le SDK Ruby.
L’extrait ci-dessous montre comment générer un document avec le SDK Assembly Cloud Ruby. Étapes :
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