REST API dan Ruby Cloud SDK untuk menyusun, menggabungkan, dan melakukan mail‑merge dokumen dari template dan sumber data.
Mulai Uji Coba GratisGroupDocs.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.
gem install groupdocs_assembly_cloud).app_sid dan api_key Anda.UploadFile.AssembleOptions yang merujuk pada templat yang diunggah, menentukan format output yang diinginkan, dan menyediakan sumber data XML/JSON (atau file yang memuatnya).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.
Potongan kode di bawah menunjukkan cara menghasilkan dokumen menggunakan Assembly Cloud Ruby SDK. Langkah yang dilakukan:
AssembleOptions – templat, format output, dan sumber data.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