إنشاء مستندات باستخدام Ruby SDK
واجهة برمجة التطبيقات REST وRuby Cloud SDK لتجميع المستندات ودمجها ودمجها عبر البريد من القوالب ومصادر البيانات.
واجهة برمجة التطبيقات REST وRuby Cloud SDK لتجميع المستندات ودمجها ودمجها عبر البريد من القوالب ومصادر البيانات.
GroupDocs.Assembly Cloud هي خدمة مُدارة بالكامل، تعتمد على REST، تُمكّنك من إنشاء مستندات عالية التخصيص مباشرةً من تطبيقات Ruby.
تعمل المنصة على نموذج قالب وبيانات: تُصمّم مستند قالب (Word، Excel، PowerPoint، PDF، HTML، إلخ) يحتوي على حقول خاصة وعناصر قابلة للبرمجة. أثناء التشغيل، تُوفّر مصدر بيانات بصيغة XML أو JSON، وتربط البيانات بالقالب باستخدام صيغة تعبير بنمط LINQ، وتُجمّع الخدمة السحابية المستند النهائي بالتنسيق الذي تحتاجه.
يُغني هذا النهج عن تثبيت أي برامج Office محلية، أو مكتبات خارجية، أو محركات عرض مُعقدة - حيث يتم تنفيذ جميع المهام الشاقة في مركز بيانات GroupDocs الآمن. ستحصل على دعم مُدمج لدمج البريد، والجداول الديناميكية، والمحتوى الشرطي، وإنشاء الباركود، وإدراج الصور والمخططات، ومجموعة غنية من خيارات التنسيق. توفر الخدمة أيضًا اتصالاً مشفّرًا ببروتوكول SSL/TLS، ومفاتيح وصول شخصية للمصادقة، وأذونات قائمة على الأدوار للحفاظ على أمان بياناتك.
سير عمل روبي مع حزمة تطوير البرامج (SDK)
ثبّت أداة Ruby gem (gem install groupdocs_assembly_cloud).
هيئ حزمة تطوير البرامج باستخدام app_sid وapi_key.
حمّل ملف القالب إلى خدمة التخزين السحابي GroupDocs عبر نقطة النهاية UploadFile.
جهّز كائن AssembleOptions الذي يشير إلى القالب المحمّل، ويحدد تنسيق الإخراج المطلوب، ويوفر مصدر بيانات XML/JSON (أو ملفًا يحتوي عليه).
استدعاء assemble_document - تُعيد واجهة برمجة التطبيقات المستند المُجمّع، والذي يمكنك تنزيله مباشرةً أو حفظه في خدمة التخزين السحابي.
باستخدام هذا التسلسل البسيط، يمكنك إنشاء عقود، وفواتير، وعروض، وتقارير شحن، ورسائل شخصية، أو أي مستند آخر بالغ الأهمية للأعمال عند الطلب، مع إمكانية التوسع من طلب واحد إلى سيناريوهات معالجة دفعات كبيرة باستخدام دمج البريد.
كما توفر مجموعة تطوير برامج Ruby فئات مساعدة للتعامل مع التخزين، ومعالجة الأخطاء، وتخصيص مهلة الطلبات، مما يجعل التكامل مع Rails أو Sinatra أو أي خدمة تعتمد على Ruby سلسًا.
القدرات الأساسية لـ Assembly Cloud API.
تنسيقات المستندات المدعومة لـ Assembly Cloud.
أنظمة التشغيل وبيئات التطوير التي تدعمها Ruby SDK.
يوضح المقطع أدناه كيفية إنشاء مستند باستخدام مجموعة أدوات تطوير برمجيات Ruby من Assembly Cloud. الخطوات المتبعة:
GroupDocs.Assemblyrequire_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