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

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

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

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

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

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

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

بشكل عام، يعد إنشاء تقارير Word عملية تجمع بين النص والبيانات والرسومات في كيان واحد وتقوم بتصدير النتيجة في نموذج مرئي مناسب إلى تنسيق ملف Word. للحصول على معلومات حول تنسيقات الإدخال / الإخراج المدعومة، يرجى زيارة التوثيق.

ما هو GroupDocs Assembly for Ruby

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

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

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

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

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

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

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

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

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

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

متطلبات

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

حماية

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

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

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

إنشاء مستند DOCX في 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 إلى الحافظة

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

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

كيفية تثبيت DOCX Report Builder لـ 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. كل الحقوق محفوظة.