สร้างเอกสารด้วย Ruby SDK

REST API และ Ruby Cloud SDK เพื่อประกอบ ผสาน และทำการรวมจดหมายเอกสารจากแม่แบบและแหล่งข้อมูล

  • GroupDocs.Assembly Cloud สำหรับ cURL
  • GroupDocs.Assembly Cloud SDK สำหรับ .NET
  • GroupDocs.Assembly Cloud SDK สำหรับ Java
  • GroupDocs.Assembly Cloud SDK สำหรับ PHP
  • GroupDocs.Assembly Cloud SDK สำหรับ Python
  • GroupDocs.Assembly Cloud SDK สำหรับ Node.js
  • GroupDocs.Assembly Cloud SDK สำหรับ Go
  • GroupDocs.Assembly Cloud SDK สำหรับ C++
  • GroupDocs.Assembly Cloud SDK สำหรับ Swift
เริ่มทดลองใช้งานฟรี

GroupDocs.Assembly Cloud เป็นบริการที่จัดการเต็มรูปแบบโดยอิงจาก REST ซึ่งช่วยให้คุณสร้างเอกสารที่ปรับแต่งได้สูงโดยตรงจากแอปพลิเคชัน Ruby ของคุณ แพลตฟอร์มทำงานบนโมเดลเทมเพลตและข้อมูล: คุณออกแบบเอกสารเทมเพลต (Word, Excel, PowerPoint, PDF, HTML เป็นต้น) ที่มีฟิลด์ตัวแทนพิเศษและโครงสร้างที่เขียนโปรแกรมได้ ในขณะทำงานคุณจะให้แหล่งข้อมูลในรูปแบบ XML หรือ JSON ผูกข้อมูลเข้ากับเทมเพลตด้วยไวยากรณ์การแสดงผลสไตล์ LINQ และบริการคลาวด์จะประกอบเอกสารขั้นสุดท้ายในรูปแบบที่คุณต้องการ

วิธีการนี้ขจัดความจำเป็นในการติดตั้ง Office ในเครื่อง, ไลบรารีของบุคคลที่สาม หรือเอนจินการเรนเดอร์ที่ซับซ้อน – งานหนักทั้งหมดจะดำเนินการในศูนย์ข้อมูลที่ปลอดภัยของ GroupDocs คุณจะได้รับการสนับสนุนในตัวสำหรับ mail‑merge, dynamic tables, conditional content, barcode generation, image and chart insertion และชุดตัวเลือกการจัดรูปแบบที่หลากหลาย บริการยังให้การสื่อสารที่เข้ารหัส SSL/TLS, กุญแจเข้าถึงส่วนบุคคลสำหรับการยืนยันตัวตน, และสิทธิ์ตามบทบาทเพื่อรักษาข้อมูลของคุณให้ปลอดภัย

กระบวนการทำงานของ Ruby กับ SDK

  1. ติดตั้ง gem ของ Ruby (gem install groupdocs_assembly_cloud).
  2. กำหนดค่า SDK ด้วย app_sid และ api_key ของคุณ.
  3. อัปโหลด ไฟล์เทมเพลตไปยัง GroupDocs Cloud Storage ผ่าน endpoint UploadFile.
  4. เตรียม วัตถุ AssembleOptions ที่อ้างอิงเทมเพลตที่อัปโหลด, ระบุรูปแบบผลลัพธ์ที่ต้องการ, และให้แหล่งข้อมูล XML/JSON (หรือไฟล์ที่บรรจุข้อมูลนั้น).
  5. เรียก assemble_document – API จะคืนเอกสารที่ประกอบแล้ว, ซึ่งคุณสามารถดาวน์โหลดโดยตรงหรือเก็บกลับไปยัง Cloud Storage.

โดยใช้ลำดับขั้นตอนที่ง่ายนี้คุณสามารถสร้างสัญญา, ใบแจ้งหนี้, ข้อเสนอ, รายงานการจัดส่ง, จดหมายส่วนบุคคล, หรือเอกสารสำคัญทางธุรกิจอื่น ๆ ตามความต้องการ, สามารถขยายจากคำขอเดียวจนถึงการประมวลผลเป็นชุดใหญ่ด้วย mail‑merge.

Ruby SDK ยังมีคลาสช่วยเหลือสำหรับการทำงานกับ storage, การจัดการข้อผิดพลาด, และการปรับแต่งเวลา timeout ของคำขอ, ทำให้การรวมเข้ากับ Rails, Sinatra หรือบริการใด ๆ ที่อิง Ruby เป็นเรื่องราบรื่น.

คุณสมบัติการประกอบเอกสาร REST API

สร้างเอกสารจากเทมเพลตที่มีตัวแปรแทน

การผูกข้อมูลสไตล์ LINQ สำหรับแหล่งข้อมูล XML และ JSON

แทรกรูปภาพ แผนภูมิ และกราฟิกลงในผลลัพธ์

สร้างตารางแบบไดนามิกจากข้อมูลอาเรย์

บล็อกเนื้อหาแบบมีเงื่อนไขโดยใช้นิพจน์

เข้าถึง API อย่างปลอดภัยผ่านคีย์การเข้าถึงส่วนบุคคล

รองรับการรวมจดหมายสำหรับจดหมายส่วนบุคคลแบบชุด

สร้างและฝังบาร์โค้ด (QR, Code128, …)

ตั้งค่าสีพื้นหลังสำหรับผลลัพธ์ HTML

การโอนย้ายข้อมูลที่เข้ารหัสด้วย SSL/TLS

สร้างเอกสารในรูปแบบ Ruby

โค้ดตัวอย่างด้านล่างแสดงวิธีการสร้างเอกสารโดยใช้ Assembly Cloud Ruby SDK ขั้นตอนที่ทำ:

  1. กำหนดค่า SDK ด้วย App SID และคีย์ API ของคุณ
  2. อัปโหลดไฟล์เทมเพลตไปยัง Cloud Storage
  3. กำหนด AssembleOptions – เทมเพลต, รูปแบบผลลัพธ์และแหล่งข้อมูล
  4. เรียก assemble_document เพื่อรับไฟล์ที่ประกอบเสร็จ
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 ยังมี SDKs สำหรับภาษาอื่น:

  แบบไทย
dcd632280