Générez des documents avec Ruby SDK

REST API et Ruby Cloud SDK pour assembler, fusionner et réaliser une fusion de courrier de documents à partir de modèles et de sources de données.

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

GroupDocs.Assembly Cloud est un service entièrement géré, basé sur REST, qui vous permet de créer des documents hautement personnalisés directement depuis vos applications Ruby. La plateforme fonctionne selon un modèle modèle‑et‑données : vous concevez un document modèle (Word, Excel, PowerPoint, PDF, HTML, etc.) contenant des champs de substitution spéciaux 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 dans le format dont vous avez besoin.

Cette approche élimine le besoin d’installations locales de Office, de bibliothèques tierces ou de moteurs de rendu complexes - tout le travail intensif est effectué dans le centre de données sécurisé GroupDocs. Vous bénéficiez d’une prise en charge intégrée de la fusion de courrier, des tables dynamiques, du contenu conditionnel, de la génération de codes-barres, de l’insertion d’images et de graphiques, ainsi qu’un large éventail d’options de mise en forme. Le service offre é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 le gem Ruby (gem install groupdocs_assembly_cloud).
  2. Configurez le SDK avec vos app_sid et api_key.
  3. Téléversez le fichier modèle vers GroupDocs Cloud Storage via le point de terminaison UploadFile.
  4. Préparez un objet AssembleOptions qui référence le modèle téléversé, 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 – le API renvoie le document assemblé, que vous pouvez télécharger directement ou stocker à nouveau dans Cloud Storage.

En suivant cette séquence simple, vous pouvez générer des contrats, factures, propositions, rapports d’expédition, lettres personnalisées ou tout autre document essentiel pour l’entreprise à la demande, en passant d’une requête unique à des scénarios de traitement par lots importants avec la fusion de courrier.

Le Ruby SDK propose également des classes d’assistance pour travailler avec le stockage, gérer les erreurs et personnaliser les délais d’attente des requêtes, rendant l’intégration à Rails, Sinatra ou tout service basé sur Ruby fluide.

Fonctionnalités d’assemblage de documents REST API

Générez des documents à partir de modèles contenant des espaces réservés

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

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

Créez des tableaux dynamiques à partir de données de tableau

Blocs de contenu conditionnels utilisant des expressions

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

Prise en charge du publipostage pour des lettres personnalisées en lot

Générez et intégrez des codes-barres (QR, Code128, …)

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

Transfert de données chiffrées SSL/TLS

Générez un document en Ruby

Le fragment ci-dessous montre comment générer un document en utilisant l’Assembly Cloud Ruby SDK. Étapes effectuées :

  1. Configurez le SDK avec votre SID d’application et la clé API.
  2. Téléversez le fichier modèle vers le stockage Cloud.
  3. Définissez le AssembleOptions – modèle, format de sortie et source de données.
  4. Appelez le 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 SDKs pour d’autres langages :

  Français
894b7c2f6