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.

  • GroupDocs.Assembly Cloud for cURL
  • GroupDocs.Assembly Cloud SDK for .NET
  • GroupDocs.Assembly Cloud SDK for Java
  • GroupDocs.Assembly Cloud SDK for PHP
  • GroupDocs.Assembly Cloud SDK for Python
  • GroupDocs.Assembly Cloud SDK for Node.js
  • GroupDocs.Assembly Cloud SDK for Go
  • GroupDocs.Assembly Cloud SDK for C++
  • GroupDocs.Assembly Cloud SDK for Swift
Commencer l'essai gratuit

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

  1. Installez la gemme Ruby (gem install groupdocs_assembly_cloud).
  2. Configurez le SDK avec vos identifiants app_sid et api_key.
  3. Téléchargez le fichier modèle sur GroupDocs Cloud Storage via le point de terminaison UploadFile.
  4. Préparez un objet 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).
  5. Appelez 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 de l’API REST d’assemblage de documents

Générer des documents à partir de modèles avec des espaces réservés

Liaison de données de style LINQ pour les sources XML et JSON

Insérer des images, des graphiques et des diagrammes dans la sortie

Créer des tables dynamiques à partir de données de tableau

Blocs de contenu conditionnels utilisant des expressions

Accès API sécurisé via des clés d’accès personnelles

Prise en charge du publipostage pour les lettres personnalisées par lots

Générer et intégrer des codes-barres (QR, Code128, …)

Définir les couleurs d’arrière-plan pour la sortie HTML

Transfert de données crypté SSL/TLS

Générer un document en Ruby

L’extrait ci-dessous montre comment générer un document avec le SDK Assembly Cloud Ruby. Étapes :

  1. Configurez le SDK avec le SID de votre application et votre clé API.
  2. Téléchargez le fichier modèle sur Cloud Storage.
  3. Définissez « AssembleOptions » : modèle, format de sortie et source de données.
  4. Appelez « assemble_document » pour obtenir le fichier assemblé.
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

Ressources d'assistance et d'apprentissage

GroupDocs.Assembly Cloud propose également des SDK pour d’autres langages :

  Français