Tạo tài liệu với Ruby SDK
REST API và Ruby Cloud SDK để lắp ráp, hợp nhất và thực hiện mail‑merge tài liệu từ mẫu và nguồn dữ liệu.
REST API và Ruby Cloud SDK để lắp ráp, hợp nhất và thực hiện mail‑merge tài liệu từ mẫu và nguồn dữ liệu.
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 bạn. Nền tảng hoạt động dựa 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 chỗ giữ đặ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, gắn dữ liệu vào mẫu bằng cú pháp biểu thức kiểu LINQ, và dịch vụ đám mây sẽ lắp ráp tài liệu cuối cùng theo định dạng bạn cần.
Cách tiếp cận này loại bỏ nhu cầu cài đặt Office cục bộ, thư viện bên thứ ba hoặc các engine render phức tạp – mọi công việc nặng được thực hiện trong trung tâm dữ liệu an toàn GroupDocs. Bạn sẽ nhận được hỗ trợ tích hợp cho mail‑merge, bảng động, nội dung có điều kiện, tạo mã vạch, chèn hình ảnh và biểu đồ, và một bộ tùy chọn định dạng phong phú. Dịch vụ cũng cung cấp giao tiếp được mã hoá SSL/TLS, khóa truy cập cá nhân để xác thực, và quyền dựa trên vai trò để bảo vệ dữ liệu của bạn.
GroupDocs.Assemblygem install groupdocs_assembly_cloud).app_sid và api_key của bạn.UploadFile.AssembleOptions tham chiếu tới 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 sẽ trả về tài liệu đã lắp ráp, bạn có thể tải xuống trực tiếp hoặc lưu lại vào Cloud Storage.Bằng cách sử dụng chuỗi thao tác đơn giản này, bạn có thể tạo hợp đồng, hoá đơn, đề xuất, báo cáo vận chuyển, thư cá nhân hoá, hoặc bất kỳ tài liệu kinh doanh quan trọng nào 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 mail‑merge.
Ruby SDK cũng cung cấp các lớp trợ giúp để làm việc với lưu trữ, 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.
Các khả năng cốt lõi của Assembly Cloud API.
Các định dạng tài liệu được hỗ trợ cho Assembly Cloud.
Hệ điều hành và môi trường phát triển được hỗ trợ bởi Ruby SDK.
Đoạn mã dưới đây cho thấy 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 để nhận tệp đã lắp ráp.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