REST API và Ruby Cloud SDK để lắp ráp, hợp nhất và trộn thư tài liệu từ các mẫu và nguồn dữ liệu.
Bắt đầu dùng thử miễn phíGroupDocs.Assembly Cloud là một dịch vụ được quản lý hoàn toàn, dựa trên REST, cho phép bạn tạo các tài liệu được tùy chỉnh cao trực tiếp từ các ứng dụng Ruby của mình. Nền tảng này hoạt động trên mô hình mẫu và dữ liệu: bạn thiết kế một tài liệu mẫu (Word, Excel, PowerPoint, PDF, HTML, v.v.) chứa các trường giữ chỗ đặc biệt và các cấu trúc có thể lập trình. Khi chạy, bạn cung cấp nguồn dữ liệu ở định dạng XML hoặc JSON, liên kết dữ liệu với mẫu bằng cú pháp biểu thức kiểu LINQ, và dịch vụ đám mây sẽ biên dịch tài liệu cuối cùng theo định dạng bạn cần.
Phương pháp này loại bỏ nhu cầu cài đặt Office cục bộ, thư viện của bên thứ ba hoặc công cụ kết xuất phức tạp - mọi công việc nặng nhọc đều được thực hiện trong trung tâm dữ liệu GroupDocs an toàn. Bạn được hỗ trợ tích hợp cho gộp thư, bảng động, nội dung có điều kiện, tạo mã vạch, chèn hình ảnh và biểu đồ, cùng một bộ tùy chọn định dạng phong phú. Dịch vụ này cũng cung cấp giao tiếp được mã hóa SSL/TLS, khóa truy cập cá nhân để xác thực và quyền dựa trên vai trò để giữ an toàn cho dữ liệu của bạn.
. Quy trình làm việc Ruby với SDK
gem install groupdocs_assembly_cloud
).app_sid
và api_key
của bạn.UploadFile
.AssembleOptions
tham chiếu đến mẫu đã tải lên, chỉ định định dạng đầu ra mong muốn và cung cấp nguồn dữ liệu XML/JSON (hoặc tệp chứa nó).assemble_document
– API trả về tài liệu đã được biên dịch, bạn có thể tải xuống trực tiếp hoặc lưu trữ lại vào Cloud Storage.Sử dụng trình tự đơn giản này, bạn có thể tạo hợp đồng, hóa đơn, đề xuất, báo cáo vận chuyển, thư cá nhân hóa hoặc bất kỳ tài liệu quan trọng nào khác cho doanh nghiệp theo yêu cầu, mở rộng từ một yêu cầu đơn lẻ đến các kịch bản xử lý hàng loạt lớn với tính năng trộn thư.
Bộ công cụ phát triển phần mềm Ruby (Ruby SDK) cũng cung cấp các lớp trợ giúp để làm việc với bộ nhớ, xử lý lỗi và tùy chỉnh thời gian chờ yêu cầu, giúp việc tích hợp vào Rails, Sinatra hoặc bất kỳ dịch vụ nào dựa trên Ruby trở nên liền mạch.
Đoạn mã dưới đây hướng dẫn cách tạo tài liệu bằng Assembly Cloud Ruby SDK. Các bước thực hiện:
AssembleOptions
– mẫu, định dạng đầu ra và nguồn dữ liệu.assemble_document
để lấy tệp đã biên dịch.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