Hasilkan Dokumen dengan Ruby SDK

REST API dan Ruby Cloud SDK untuk menyusun, menggabungkan, dan melakukan mail‑merge dokumen dari template dan sumber data.

  • GroupDocs.Assembly Cloud untuk cURL
  • GroupDocs.Assembly Cloud SDK untuk .NET
  • GroupDocs.Assembly Cloud SDK untuk Java
  • GroupDocs.Assembly Cloud SDK untuk PHP
  • GroupDocs.Assembly Cloud SDK untuk Python
  • GroupDocs.Assembly Cloud SDK untuk Node.js
  • GroupDocs.Assembly Cloud SDK untuk Go
  • GroupDocs.Assembly Cloud SDK untuk C++
  • GroupDocs.Assembly Cloud SDK untuk Swift
Mulai Uji Coba Gratis

GroupDocs.Assembly Cloud adalah layanan yang dikelola sepenuhnya, berbasis REST, yang memungkinkan Anda membuat dokumen yang sangat disesuaikan langsung dari aplikasi Ruby Anda. Platform ini bekerja dengan model templat‑dan‑data: Anda merancang dokumen templat (Word, Excel, PowerPoint, PDF, HTML, dll.) yang berisi bidang placeholder khusus dan konstruksi yang dapat diprogram. Saat runtime, Anda menyediakan sumber data dalam format XML atau JSON, mengikat data ke templat menggunakan sintaks ekspresi gaya LINQ, dan layanan cloud 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 proses berat dilakukan di pusat data GroupDocs yang aman. Anda mendapatkan dukungan bawaan untuk mail‑merge, tabel dinamis, konten bersyarat, pembuatan barcode, penyisipan gambar dan diagram, serta serangkaian opsi pemformatan yang kaya. 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. Pasang gem Ruby (gem install groupdocs_assembly_cloud).
  2. Konfigurasikan SDK dengan app_sid dan api_key Anda.
  3. Unggah file templat ke GroupDocs Cloud Storage melalui endpoint UploadFile.
  4. Siapkan objek AssembleOptions yang merujuk pada templat yang diunggah, menentukan format output yang diinginkan, dan menyediakan sumber data XML/JSON (atau file yang memuatnya).
  5. Panggil assemble_document – API mengembalikan dokumen yang telah disusun, yang dapat Anda unduh langsung atau simpan kembali ke Cloud Storage.

Dengan urutan sederhana ini, Anda dapat menghasilkan kontrak, faktur, proposal, laporan pengiriman, surat pribadi, atau dokumen penting bisnis lainnya sesuai permintaan, dengan skala mulai dari satu permintaan hingga skenario pemrosesan batch besar menggunakan mail‑merge.

Ruby SDK juga menyediakan kelas pembantu untuk bekerja dengan penyimpanan, menangani kesalahan, dan menyesuaikan batas waktu permintaan, sehingga integrasi ke Rails, Sinatra, atau layanan berbasis Ruby mana pun menjadi mulus.

Fitur Perakitan Dokumen REST API

Hasilkan dokumen dari templat dengan placeholder

binding data gaya LINQ untuk sumber XML dan JSON

Sisipkan gambar, diagram, dan grafik ke dalam output

Buat tabel dinamis dari data array

Blok konten bersyarat menggunakan ekspresi

Amankan akses API melalui kunci akses pribadi

Dukungan mail‑merge untuk surat pribadi secara massal

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

Atur warna latar belakang untuk output HTML

Transfer data terenkripsi SSL/TLS

Hasilkan dokumen dalam Ruby

Potongan kode di bawah menunjukkan cara menghasilkan dokumen menggunakan Assembly Cloud Ruby SDK. Langkah yang dilakukan:

  1. Konfigurasikan SDK dengan App SID dan Kunci API Anda.
  2. Unggah file templat ke Cloud Storage.
  3. Tentukan AssembleOptions – templat, format output, dan sumber data.
  4. Panggil assemble_document untuk mendapatkan file yang dirakit.
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 SDKs untuk bahasa lain:

  Indonesia
f5cc89c32