Tạo tài liệu bằng Ruby SDK

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.

  • 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
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

  1. Cài đặt gem Ruby (gem install groupdocs_assembly_cloud).
  2. Cấu hình SDK với app_sidapi_key của bạn.
  3. Tải tệp mẫu lên GroupDocs Cloud Storage thông qua điểm cuối UploadFile.
  4. Chuẩn bị một đối tượng 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ó).
  5. Gọi 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.

Các tính năng của API REST của Document Assembly

Tạo tài liệu từ các mẫu có chỗ giữ chỗ

Liên kết dữ liệu theo kiểu LINQ cho các nguồn XML và JSON

Chèn hình ảnh, biểu đồ và đồ họa vào đầu ra

Tạo bảng động từ dữ liệu mảng

Khối nội dung có điều kiện sử dụng biểu thức

Truy cập API an toàn thông qua khóa truy cập cá nhân

Hỗ trợ trộn thư cho hàng loạt thư cá nhân hóa

Tạo và nhúng mã vạch (QR, Code128, …)

Đặt màu nền cho đầu ra HTML

Truyền dữ liệu được mã hóa SSL/TLS

Tạo một tài liệu trong Ruby

Đ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:

  1. Cấu hình SDK với App SID và API Key của bạn.
  2. Tải tệp mẫu lên Cloud Storage.
  3. Định nghĩa AssembleOptions – mẫu, định dạng đầu ra và nguồn dữ liệu.
  4. Gọi 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

Support and Learning Resources

GroupDocs.Assembly Cloud cũng cung cấp SDK cho các ngôn ngữ khác:

  Tiếng Việt