منشئ المستندات لـ Ruby

مكتبة Ruby لإنشاء تقارير مخصصة للغاية باستخدام واجهة برمجة تطبيقات REST

دمج إنشاء العديد من مستندات Word و PDF والويب بسلاسة استنادًا إلى القوالب ومصادر البيانات في برنامج شركتك Ruby.

أتمتة إنشاء المستندات في Ruby، وإنشاء تقارير جاهزة للطباعة لأي تعقيد باستخدام Ruby SDK. تم بناء هذا الحل المستند إلى السحابة حول القوالب ومصادر البيانات وبناء جملة LINQ القوي، مما يمنح مطوري Ruby المرونة لتلائم المتطلبات الفنية والتجارية الدقيقة.

باستخدام مكتبة Ruby هذه، يمكنك برمجيًا إنشاء تقارير مخصصة للغاية على أي نظام تشغيل. يمكن تجميع المستندات المنسقة بشكل غني مثل العقود والأوامر والفواتير وتقارير الشحن وعروض المبيعات والمخزونات بشكل سريع كجزء من برنامج Ruby الخاص بك.

تبسيط إنشاء المستندات باستخدام Ruby

نمت أهمية أتمتة المستندات وإنشاء التقارير بشكل كبير خلال العقود الماضية. تحتاج كل شركة تقريبًا إلى إنشاء المستندات وتسليمها إلى الشركاء أو العملاء في الوقت المحدد. علاوة على ذلك، عادة ما يكون عاملا حاسما في النجاح المالي. يمكن أن يؤدي تطبيق هذه التقنيات إلى تحقيق وفورات مالية كبيرة عن طريق تقليل الإدخال اليدوي للبيانات والخطأ البشري والتدقيق اللغوي والأعمال الورقية. لهذه الأسباب، تعد أتمتة المستندات وأدوات إعداد التقارير جزءًا لا يتجزأ من العديد من حلول البرامج الحديثة التي تهدف إلى توفير ميزات تحليلية متقدمة للمستخدمين.

بشكل عام، يعد إنشاء التقارير عملية تجمع بين النص والبيانات والرسومات في كيان واحد وتصدير النتيجة في شكل مرئي مناسب إلى تنسيق المستند المطلوب، مثل DOCX و PDF و ODT و HTML و PPTX و XLSX وما إلى ذلك.

ما هي GroupDocs Assembly for Ruby

GroupDocs Assembly for Ruby هو حل قائم على السحابة لإنشاء المستندات باستخدام القوالب ومصادر البيانات. يعمل قالب المستند كإطار أساسي، والذي يتضمن، بالإضافة إلى المحتوى القياسي (نص وجداول ومخططات وما إلى ذلك)، حقول عناصر نائبة خاصة لإدراج القيم من مصدر البيانات. لا يمكن إدراج القيم الفردية فحسب، بل يمكن أيضًا إدراج مصفوفات كاملة من البيانات في شكل جداول ورسوم بيانية.

يحتوي القالب أيضًا على بنيات البرمجة - قواعد إنشاء المستندات - التي تتحكم في تحديد البيانات ومعالجة الحالة. يستخدم ربط البيانات بقالب المستند بناء جملة تعبير LINQ، والذي يسمح للمطورين بمعالجة البيانات بطريقة عامة، بغض النظر عن نوع مصدر البيانات المستخدم. بهذه الطريقة، يمنحك Ruby Cloud SDK الخاص بنا المرونة في إنشاء المحتوى ومجموعة قوية من الأساليب لمعالجة البيانات.

يدعم هذا المنتج أيضًا وظيفة Mail Merge في حالة رغبتك في إنشاء مجموعات من الرسائل الشخصية وإرسالها إلى العملاء. تحتاج فقط إلى إدراج حقول Mail Merge في قالب المستند وتمريرها إلى Cloud API مع مصدر البيانات.

بغض النظر عن حجم ونوع أتمتة المستندات التي ستنفذها، هناك ثلاث خطوات لإنشاء تقرير في Ruby:

  • قم بإنشاء قالب مستند Word مع حقول العناصر النائبة وقواعد إنشاء المستندات التي ستنظم اختلافات الهيكل والمحتوى
  • تكوين مصدر بيانات بتنسيق XML أو JSON
  • اكتب بضعة أسطر من كود Ruby لتمرير كل شيء إلى Document Building API واستعادة النتيجة المجمعة

تصميم قالب مستند واستخدام قواعد إنشاء المستند

تصميم القوالب مهمة صعبة. بالإضافة إلى الفهم الواضح لمتطلبات الوثيقة النهائية، فإن المهارات التحليلية والبرمجة مطلوبة. يجب أن يعكس التصميم الجيد للقالب وجهة نظر العميل حول مشكلة معينة. النهج الأكثر فاعلية هو الجمع بين البيانات الجدولية والرسومات في التوازن الصحيح، والتي تحددها متطلبات العمل.

كما ذكرنا سابقًا، تحتوي بنية القالب عادةً على بعض الكتل الثابتة من المحتوى (نصوص، صور، شعارات، إلخ) ممزوجة بتركيبات برمجة خاصة تتحكم في منطق تجميع المستندات. يتم تعريف قواعد إنشاء المستندات هذه باستخدام صيغة تعبير خاصة، والتي تمكن المطورين من القيام بما يلي:

  • قم بتضمين محتوى مستند خارجي، صور، مخططات، قوائم، جداول، ارتباطات تشعبية، إشارات مرجعية، إلخ.
  • العمل مع البيانات باستخدام الصيغ وعمليات البيانات المتسلسلة
  • تحديد تنسيق العرض التقديمي للعناصر الرقمية والنصية والرسوم البيانية والتاريخ والوقت
  • أدخل كتل المحتوى بناءً على التعبيرات الشرطية
  • تحديد متغيرات خاصة للحسابات "المكلفة" التي يتم حسابها مرة واحدة فقط
  • حساب الصيغ عند تجميع مستندات جداول البيانات
  • تعيين سمات نص رسالة البريد الإلكتروني وإنشاء المرفقات ديناميكيًا
  • إنشاء وإدراج الباركود
  • تعيين لون الخلفية لمستندات HTML

يمكنك معرفة المزيد حول بنية النموذج في دليل المطور الخاص بنا.

متطلبات

لا تتطلب GroupDocs Assembly for Ruby تثبيت أي برامج خارجية أو أدوات خارجية. هذا حل قائم على السحابة، حيث يتم تنفيذ جميع تفاعلات البرمجة عبر الشبكة باستخدام واجهة برمجة تطبيقات REST.

تنسيقات المستندات المدعومة

  • Word: DOCX، DOC، DOT، DOTX، DOTM، DOCM، RTF
  • إكسل: XLSX، XLS، XLSM، XLSB، XLT، XLTM، XLTX
  • PowerPoint: PPTX، PPT، PPTM، PPS، PPSX، PPSM، POT، POTX، POTM
  • Outlook: MSG، EML، EMLXL
  • أوبن أوفيس: ODT، OTT، ODS، ODP، OTP
  • أدوبي أكروبات: PDF
  • الطباعة: PCL، PS، XPS، OXPS
  • الرسومات المتجهة: SVG، EMF
  • الرسومات النقطية: PNG، JPEG، GIF، TIFF، BMP
  • تنسيقات الملفات الأخرى: HTML، MHTML، MHT، MD، XAML، EPUB، TXT

لمزيد من المعلومات حول تنسيقات الإدخال / الإخراج المدعومة، يرجى زيارة التوثيق.

حماية

جميع منتجات GroupDocs متوافقة تمامًا مع معايير أمان الصناعة: يتم نقل البيانات باستخدام بروتوكول SSL، الذي يلغي إمكانية اعتراض المعلومات من قبل أطراف ثالثة. للاتصال بخدمات GroupDocs Cloud Services، تحتاج إلى استخدام مفاتيح الوصول الشخصية. يرجى الرجوع إلى دليل البدء السريع.

قم بإنشاء مستند في Ruby

يوضح مثال التعليمات البرمجية التالي كيفية إنشاء التقارير باستخدام Ruby.

قم بإنشاء مستند في Ruby
ملفات الإدخال
قم بتحميل قالب مستند
تنسيق الإخراج
حدد التنسيق الهدف من القائمة
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
  
انسخ الرمز Ruby إلى الحافظة

كيفية إنشاء مستند باستخدام Ruby

  1. ثبّت 'GroupDocs.Assembly Cloud SDK for Ruby'.
  2. أضف مرجع مكتبة (استيراد المكتبة) إلى مشروع Ruby الخاص بك.
  3. قم بإنشاء مستند نموذج، وأضف بنيات البرمجة التي تتحكم في إدراج البيانات من مصدر البيانات.
  4. قم بإنشاء مصدر بيانات.
  5. قم بتحميل قالب المستند إلى GroupDocs Cloud Storage (تحتاج إلى تسجيل الدخول إلى حسابك الشخصي) ..
  6. قم بإنشاء مستند عن طريق تمرير النموذج والبيانات الخاصة بك إلى Cloud API.

كيفية تثبيت Cloud Report Generator لـ Ruby

قم بتثبيت GroupDocs.Assembly Cloud SDK for Ruby باستخدام خدمة استضافة RubyGems. قم بتشغيل gem install groupdocs_assembly_cloud لتثبيت الحزمة. كبديل، يمكنك استنساخ GroupDocs.Assembly Cloud SDK for Ruby المصدرية يدويًا من GitHub واستخدامها في مشروعك. يرجى اتباع هذه Instructions للحصول بسرعة على بيانات اعتماد الأمان الضرورية والوصول إلى REST API.

متطلبات النظام

Ruby 2.6 أو أحدث

الرجوع إلى Repository Documentation لمعرفة التفاصيل.

التنسيقات الأكثر شيوعًا لإنشاء المستندات

5%

اشترك في Aspose Product Updates

احصل على رسائل إخبارية وعروض شهرية يتم تسليمها مباشرة إلى صندوق البريد الخاص بك.

© Aspose Pty Ltd 2001-2024. كل الحقوق محفوظة.