Générateur de documents pour Ruby

Ruby bibliothèque pour créer des rapports hautement personnalisés à l'aide de l'API REST

Intégrez de manière transparente la génération de divers documents Word, PDF et Web basés sur des modèles et des sources de données dans le logiciel Ruby de votre entreprise.

Automatisez la génération de documents sous Ruby, créez des rapports prêts à imprimer de toute complexité avec Ruby SDK. Cette solution basée sur le cloud est construite autour de modèles, de sources de données et d'une puissante syntaxe LINQ, offrant aux développeurs Ruby la flexibilité nécessaire pour répondre à des exigences techniques et commerciales précises.

À l'aide de cette bibliothèque Ruby, vous pouvez créer par programmation des rapports hautement personnalisés sur n'importe quel système d'exploitation. Des documents richement formatés tels que des contrats, des commandes, des factures, des rapports d'expédition, des propositions de vente, des inventaires peuvent être assemblés à la volée dans le cadre de votre logiciel Ruby.

Rationalisez la génération de documents à l'aide de Ruby

L'importance de l'automatisation des documents et de la génération de rapports a énormément augmenté au cours des dernières décennies. Presque toutes les entreprises ont besoin de générer des documents et de les livrer à temps à leurs partenaires ou clients. De plus, c'est généralement un facteur décisif de réussite financière. La mise en œuvre de telles technologies peut entraîner des économies financières importantes en réduisant la saisie manuelle des données, les erreurs humaines, la relecture et la paperasserie. Pour ces raisons, les outils d'automatisation des documents et de création de rapports font partie intégrante de nombreuses solutions logicielles modernes qui visent à fournir des fonctionnalités analytiques avancées aux utilisateurs.

De manière générale, la génération de rapports est un processus qui combine du texte, des données et des graphiques en une seule entité et exporte le résultat sous une forme visuelle pratique au format de document requis, tel que DOCX, PDF, ODT, HTML, PPTX, XLSX, etc.

Qu'est-ce que GroupDocs Assembly for Ruby

GroupDocs Assembly for Ruby est une solution basée sur le cloud pour générer des documents à l'aide de modèles et de sources de données. Le modèle de document agit comme un cadre de base qui, en plus du contenu standard (texte, tableaux, graphiques, etc.), comprend des champs d'espace réservé spéciaux pour insérer des valeurs à partir de la source de données. Non seulement des valeurs individuelles peuvent être insérées, mais également des tableaux entiers de données sous forme de tableaux et de graphiques.

Le modèle contient également des constructions de programmation - des règles de génération de documents - qui contrôlent la sélection des données et le traitement des conditions. La liaison de données à un modèle de document utilise la syntaxe d'expression LINQ, qui permet aux développeurs de traiter les données de manière générique, quel que soit le type de source de données utilisé. De cette manière, notre SDK Ruby Cloud vous offre une flexibilité dans la génération de contenu et un ensemble puissant de méthodes de traitement des données.

Ce produit prend également en charge la fonctionnalité Mail Merge au cas où vous voudriez créer et envoyer des lots de lettres personnalisées aux clients. Il vous suffit d'insérer des champs Mail Merge dans le modèle de document et de le transmettre à l'API Cloud avec une source de données.

Quels que soient l'échelle et le type d'automatisation de documents que vous allez mettre en œuvre, il existe trois étapes pour créer un rapport en Ruby :

  • Créez un modèle de document Word avec des champs d'espace réservé et des règles de génération de document qui réglementeront les variations de structure et de contenu
  • Créer une source de données au format XML ou JSON
  • Écrivez quelques lignes de code Ruby pour tout transmettre à l'API de création de documents et obtenir le résultat assemblé

Conception d'un modèle de document et utilisation des règles de génération de document

Concevoir des modèles est une tâche difficile. En plus d'une compréhension claire des exigences du document final, des compétences en analyse et en programmation sont requises. Une bonne conception de modèle doit refléter le point de vue du client sur un problème particulier. L'approche la plus efficace consiste à combiner des données tabulaires et des graphiques dans le bon équilibre, déterminé par les besoins de l'entreprise.

Comme mentionné ci-dessus, la structure du modèle contient généralement des blocs de contenu fixes (texte, images, logos, etc.) mélangés à des constructions de programmation spéciales qui contrôlent la logique d'assemblage du document. Ces règles de génération de documents sont définies avec une syntaxe d'expression spéciale, qui permet aux développeurs d'effectuer les opérations suivantes :

  • intégrer du contenu de document externe, des images, des graphiques, des listes, des tableaux, des hyperliens, des signets, etc.
  • travailler avec des données à l'aide de formules et d'opérations de données séquentielles
  • spécifier le format de présentation des éléments numériques, textuels, graphiques, graphiques et de date et heure
  • insérer des blocs de contenu en fonction d'expressions conditionnelles
  • définir des variables spéciales pour les calculs "coûteux" qui ne sont calculés qu'une seule fois
  • calculer des formules lors de l'assemblage de feuilles de calcul
  • attribuer des attributs de corps de message électronique et créer dynamiquement des pièces jointes
  • créer et insérer des codes-barres
  • définir la couleur d'arrière-plan des documents HTML

Vous pouvez en savoir plus sur la syntaxe des modèles dans notre Guide du développeur.

Conditions

GroupDocs Assembly for Ruby ne nécessite l'installation d'aucun logiciel externe ou outil tiers. Il s'agit d'une solution basée sur le cloud, où toutes les interactions de programmation sont effectuées sur le réseau à l'aide de l'API REST.

Formats de documents pris en charge

  • Word: DOCX, DOC, DOT, DOTX, DOTM, DOCM, RTF
  • Excel: XLSX, XLS, XLSM, XLSB, XLT, XLTM, XLTX
  • PowerPoint: PPTX, PPT, PPTM, PPS, PPSX, PPSM, POT, POTX, POTM
  • Outlook: MSG, EML, EMLXL
  • Open Office : ODT, OTT, ODS, ODP, OTP
  • Adobe Acrobat: PDF
  • Impression: PCL, PS, XPS, OXPS
  • Graphiques vectoriels: SVG, EMF
  • Graphiques bitmap : PNG, JPEG, GIF, TIFF, BMP
  • Autres formats de fichiers: HTML, MHTML, MHT, MD, XAML, EPUB, TXT

Pour plus d'informations sur les formats d'E/S pris en charge, veuillez consulter notre documentation.

Sécurité

Tous les produits GroupDocs sont entièrement conformes aux normes de sécurité de l'industrie : le transfert de données est effectué à l'aide du protocole SSL, ce qui élimine la possibilité que des informations soient interceptées par des tiers. Pour vous connecter aux GroupDocs Cloud Services, vous devez utiliser des clés d'accès personnelles. Veuillez vous référer au guide de démarrage rapide.

Générer un document en Ruby

L'exemple de code suivant montre comment générer des rapports à l'aide de Ruby.

Générer un document dans Ruby
Fichiers d'entrée
Télécharger un modèle de document
Format de sortie
Sélectionnez le format cible dans la liste
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
  
Copier le code Ruby dans le presse-papiers

Comment générer un document en utilisant Ruby

  1. Installez 'GroupDocs.Assembly Cloud SDK for Ruby'.
  2. Ajoutez une référence de bibliothèque (importez la bibliothèque) à votre projet Ruby.
  3. Créez un modèle de document, ajoutez des constructions de programmation qui contrôlent l'insertion de données à partir de la source de données.
  4. Créez une source de données.
  5. Téléchargez le modèle de document sur le GroupDocs Cloud Storage (vous devez vous connecter à votre compte personnel)..
  6. Générez un document en transmettant votre modèle et vos données à l'API Cloud.

Comment installer Cloud Report Generator pour Ruby

Installez GroupDocs.Assembly Cloud SDK for Ruby en utilisant le service d'hébergement RubyGems. Exécutez gem install groupdocs_assembly_cloud pour installer le package. Comme alternative, vous pouvez cloner manuellement GroupDocs.Assembly Cloud SDK for Ruby de GitHub et l'utiliser dans votre projet. Veuillez suivre ces Instructions pour obtenir rapidement les informations d'identification de sécurité nécessaires et accéder à notre REST API.

Configuration requise

Ruby 2.6 ou plus récent

Reportez-vous à la Repository Documentation pour voir les détails.

5%

Abonnez-vous aux mises à jour des produits Aspose

Recevez des newsletters mensuelles et des offres directement dans votre boîte mail.

© Aspose Pty Ltd 2001-2024. Tous les droits sont réservés.