Generieren Sie Dokumente mit dem Ruby SDK

REST-API und Ruby Cloud SDK zum Zusammenstellen, Zusammenführen und Seriendrucken von Dokumenten aus Vorlagen und Datenquellen.

  • 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
Kostenlos testen

GroupDocs.Assembly Cloud ist ein vollständig verwalteter, REST-basierter Dienst, mit dem Sie hochgradig individuelle Dokumente direkt aus Ihren Ruby-Anwendungen erstellen können. Die Plattform basiert auf einem Vorlagen- und Datenmodell: Sie erstellen ein Vorlagendokument (Word, Excel, PowerPoint, PDF, HTML usw.), das spezielle Platzhalterfelder und programmierbare Konstrukte enthält. Zur Laufzeit stellen Sie eine Datenquelle im XML- oder JSON-Format bereit, binden die Daten mithilfe einer LINQ-ähnlichen Ausdruckssyntax an die Vorlage, und der Cloud-Dienst erstellt das endgültige Dokument im gewünschten Format.

Dieser Ansatz macht lokale Office-Installationen, Drittanbieterbibliotheken oder komplexe Rendering-Engines überflüssig – die gesamte Arbeit wird im sicheren GroupDocs-Rechenzentrum erledigt. Sie erhalten integrierte Unterstützung für Seriendruck, dynamische Tabellen, bedingte Inhalte, Barcode-Generierung, Bild- und Diagrammeinfügung sowie zahlreiche Formatierungsoptionen. Der Dienst bietet außerdem SSL/TLS-verschlüsselte Kommunikation, persönliche Zugriffsschlüssel zur Authentifizierung und rollenbasierte Berechtigungen zum Schutz Ihrer Daten.

. Ruby-Workflow mit dem SDK

  1. Installieren Sie das Ruby-Gem (gem install groupdocs_assembly_cloud).
  2. Konfigurieren Sie das SDK mit Ihrer app_sid und Ihrem api_key.
  3. Laden Sie die Vorlagendatei über den Endpunkt UploadFile in den GroupDocs Cloud Storage hoch.
  4. Bereiten Sie ein AssembleOptions-Objekt vor, das auf die hochgeladene Vorlage verweist, das gewünschte Ausgabeformat angibt und die XML/JSON-Datenquelle (oder eine Datei, die diese enthält) bereitstellt.
  5. Rufen Sie assemble_document auf – die API gibt das assemblierte Dokument zurück, das Sie direkt herunterladen oder wieder im Cloud Storage speichern können.

Mit dieser einfachen Abfolge können Sie Verträge, Rechnungen, Angebote, Versandberichte, personalisierte Briefe oder andere geschäftskritische Dokumente auf Abruf erstellen – von einer einzelnen Anfrage bis hin zu umfangreichen Stapelverarbeitungsszenarien mit Serienbrieffunktion.

Das Ruby SDK bietet außerdem Hilfsklassen für die Arbeit mit Speicher, die Fehlerbehandlung und die Anpassung von Anfrage-Timeouts. Dadurch ist die Integration in Rails, Sinatra oder andere Ruby-basierte Dienste nahtlos möglich.

Funktionen der Document Assembly REST-API

Generieren Sie Dokumente aus Vorlagen mit Platzhaltern

Datenbindung im LINQ-Stil für XML- und JSON-Quellen

Fügen Sie Bilder, Diagramme und Grafiken in die Ausgabe ein

Erstellen Sie dynamische Tabellen aus Array-Daten

Bedingte Inhaltsblöcke mit Ausdrücken

Sicherer API-Zugriff über persönliche Zugriffsschlüssel

Serienbriefunterstützung für personalisierte Briefe im Stapel

Barcodes (QR, Code128, …) generieren und einbetten

Hintergrundfarben für die HTML-Ausgabe festlegen

SSL/TLS-verschlüsselte Datenübertragung

Generieren Sie ein Dokument in Ruby

Der folgende Codeausschnitt zeigt, wie Sie mit dem Assembly Cloud Ruby SDK ein Dokument erstellen. Erforderliche Schritte:

  1. Konfigurieren Sie das SDK mit Ihrer App-SID und Ihrem API-Schlüssel.
  2. Laden Sie die Vorlagendatei in den Cloud-Speicher hoch.
  3. Definieren Sie „AssembleOptions“ – Vorlage, Ausgabeformat und Datenquelle.
  4. Rufen Sie „assemble_document“ auf, um die assemblierte Datei abzurufen.
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

Support- und Lernressourcen

GroupDocs.Assembly Cloud bietet auch SDKs für andere Sprachen:

  Deutsch