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

REST API และ Ruby Cloud SDK สำหรับประกอบ รวม และรวมเอกสารทางไปรษณีย์จากเทมเพลตและแหล่งข้อมูล

  • 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
เริ่มทดลองใช้งานฟรี

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

วิธีการนี้ช่วยลดความจำเป็นในการติดตั้ง Office ภายในเครื่อง ไลบรารีของบุคคลที่สาม หรือเอ็นจิ้นการเรนเดอร์ที่ซับซ้อน การทำงานหนักทั้งหมดจะดำเนินการในศูนย์ข้อมูล GroupDocs ที่ปลอดภัย คุณจะได้รับการสนับสนุนในตัวสำหรับ การผสานจดหมาย ตารางแบบไดนามิก เนื้อหาแบบมีเงื่อนไข การสร้างบาร์โค้ด การแทรกรูปภาพและแผนภูมิ และชุดตัวเลือกการจัดรูปแบบที่หลากหลาย บริการนี้ยังรองรับการสื่อสารแบบ เข้ารหัส SSL/TLS คีย์การเข้าถึงส่วนบุคคลสำหรับการตรวจสอบสิทธิ์ และสิทธิ์ตามบทบาทเพื่อรักษาข้อมูลของคุณให้ปลอดภัย

เวิร์กโฟลว์ Ruby กับ SDK

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

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

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

ฟีเจอร์ REST API ของการประกอบเอกสาร

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

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

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

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

บล็อกเนื้อหาแบบมีเงื่อนไขโดยใช้การแสดงออก

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

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

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

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

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

สร้างเอกสารใน Ruby

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

  1. กำหนดค่า SDK ด้วย App SID และ API Key ของคุณ
  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 ยังเสนอ SDK สำหรับภาษาอื่นๆ อีกด้วย:

  แบบไทย