Hasilkan Dokumen dengan Ruby SDK

REST API dan Ruby Cloud SDK untuk merakit, menggabungkan, dan mengirim dokumen melalui surat dari templat dan sumber data.

  • 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
Mulai Uji Coba Gratis

GroupDocs.Assembly Cloud adalah layanan berbasis REST yang terkelola sepenuhnya, memungkinkan Anda membuat dokumen yang sangat dikustomisasi langsung dari aplikasi Ruby Anda. Platform ini bekerja berdasarkan model templat dan data: Anda merancang dokumen templat (Word, Excel, PowerPoint, PDF, HTML, dll.) yang berisi kolom placeholder khusus dan konstruksi yang dapat diprogram. Saat runtime, Anda menyediakan sumber data dalam format XML atau JSON, mengikat data ke templat menggunakan sintaksis ekspresi bergaya LINQ, dan layanan cloud akan menyusun dokumen akhir dalam format yang Anda butuhkan.

Pendekatan ini menghilangkan kebutuhan akan instalasi Office lokal, pustaka pihak ketiga, atau mesin rendering yang kompleks – semua pekerjaan berat dilakukan di pusat data GroupDocs yang aman. Anda mendapatkan dukungan bawaan untuk gabungan surat, tabel dinamis, konten bersyarat, pembuatan kode batang, penyisipan gambar dan bagan, serta serangkaian opsi pemformatan yang lengkap. Layanan ini juga menyediakan komunikasi terenkripsi SSL/TLS, kunci akses pribadi untuk autentikasi, dan izin berbasis peran untuk menjaga keamanan data Anda.

Alur kerja Ruby dengan SDK

  1. Instal gem Ruby (gem install groupdocs_assembly_cloud).
  2. Konfigurasikan SDK dengan app_sid dan api_key Anda.
  3. Unggah berkas templat ke GroupDocs Cloud Storage melalui titik akhir UploadFile.
  4. Siapkan objek AssembleOptions yang merujuk pada templat yang diunggah, menentukan format keluaran yang diinginkan, dan menyediakan sumber data XML/JSON (atau berkas yang memuatnya).
  5. Panggil assemble_document – API akan mengembalikan dokumen yang telah dirakit, yang dapat Anda unduh langsung atau simpan kembali ke Cloud Storage.

Dengan urutan yang mudah dipahami ini, Anda dapat membuat kontrak, faktur, proposal, laporan pengiriman, surat personal, atau dokumen penting bisnis lainnya sesuai permintaan, mulai dari satu permintaan hingga skenario pemrosesan batch besar dengan gabungan surat.

Ruby SDK juga menawarkan kelas pembantu untuk menangani penyimpanan, menangani kesalahan, dan menyesuaikan batas waktu permintaan, sehingga integrasi ke dalam Rails, Sinatra, atau layanan berbasis Ruby lainnya menjadi lancar.

Fitur REST API Perakitan Dokumen

Hasilkan dokumen dari templat dengan placeholder

Pengikatan data gaya LINQ untuk sumber XML dan JSON

Masukkan gambar, bagan, dan grafik ke dalam output

Membuat tabel dinamis dari data array

Blok konten bersyarat menggunakan ekspresi

Akses API aman melalui kunci akses pribadi

Dukungan gabungan surat untuk surat yang dipersonalisasi secara batch

Hasilkan dan tanamkan kode batang (QR, Code128, …)

Mengatur warna latar belakang untuk keluaran HTML

Transfer data terenkripsi SSL/TLS

Hasilkan dokumen dalam Ruby

Cuplikan kode di bawah ini menunjukkan cara membuat dokumen menggunakan Assembly Cloud Ruby SDK. Langkah-langkah yang dilakukan:

  1. Konfigurasikan SDK dengan App SID dan API Key Anda.
  2. Unggah berkas templat ke Cloud Storage.
  3. Tentukan AssembleOptions – templat, format keluaran, dan sumber data.
  4. Panggil assemble_document untuk mendapatkan berkas rakitan.
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

Dukungan dan Sumber Belajar

GroupDocs.Assembly Cloud juga menawarkan SDK untuk bahasa lain:

  Indonesia