قم بتحويل مستندات Word إلى PDF في Ruby باستخدام REST API

كيفية تحويل مستندات Word إلى PDF باستخدام Ruby

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

أنت الآن تعرف لماذا يجب عليك تحويل مستندات Word إلى ملف PDF. يمكنك تحويل Word DOCX إلى PDF باستخدام الوظائف المضمنة التي يوفرها Microsoft Office ، ولكن قد تحتاج إلى تحويل مستندات Word DOCX إلى PDF برمجيًا. يعد استخدام واجهات برمجة تطبيقات التحويل Groupdocs لتحويل مستندات Word إلى PDF سريعًا وسهلاً وفوريًا. كل ما تحتاجه هو اتصال إنترنت ثابت وملفاتك. في هذه المقالة ، سوف نتعلم كيفية تحويل مستندات Word إلى PDF في Ruby باستخدام REST API.

سيتم تغطية الموضوعات التالية في مقال المدونة هذا:

Word to PDF Conversion REST API - تثبيتات Ruby API

يمكنك بسهولة تحويل ملفات DOCX إلى PDF باستخدام Ruby SDK من GroupDocs.Conversion Cloud. يساعدك على تحويل المستندات ذات تنسيقات الملفات المدعومة إلى تنسيقات ملفات أخرى بسرعة وموثوقية - فقط في بضع ثوانٍ وبجودة عالية. GroupDocs.Conversion Cloud REST API تسمح لك بتحويل المستندات عبر نطاق واسع من تنسيقات الملفات المدعومة بدون أي برنامج تبعية. إنه متوافق مع جميع برامج المكتب الرئيسية ومستقل تمامًا عن نظام التشغيل.

GroupDocs.Conversion توفر حلول تحويل مستندات عالية الجودة. يمكنك التحقق من قائمة SDKs المتوفرة لدينا هنا لتحويل المستندات إلى تنسيق جديد باستخدام واجهات برمجة تطبيقات REST السحابية الخاصة بنا. يمكنك أيضًا استدعاء واجهات برمجة تطبيقات REST مباشرة من متصفحك باستخدام مرجع GroupDocs.Conversion Cloud API Swagger UI. A gem groupdocsconversioncloud متاح في rubygems. يمكنك تثبيت GroupDocs.Conversion Cloud API لتحويل مستندات Word إلى PDF في تطبيق Ruby باستخدام هذه الأحجار الكريمة مع الأمر التالي في وحدة التحكم في القضبان:

gem install groupdocs_conversion_cloud

Addressable ~> 2.5.0،> = 2.5.0 هو جوهرة تبعية وقت التشغيل لـ groupdocsconversioncloud. يمكنك أيضًا نسخ جوهرة التحويل إلى ملف Gemfile الخاص بك للتواصل مع GroupDocs.Conversion Cloud API ثم تشغيل تثبيت الحزمة:

gem "groupdocs_conversion_cloud", "~> 22.3"
bundle install

بعد ذلك ، تحتاج إلى إضافة معرف العميل وسر العميل قبل إجراء أي طلبات إلى GroupDocs Conversion Cloud API. سيتم استخدام هذا لاستدعاء GroupDocs Cloud API في مشروعك الحالي. يمكنك الحصول على بيانات اعتماد العميل من خلال إنشاء [تطبيق] جديد 12 على Groupdocs dashboard. بمجرد حصولك على معرف العميل وسر العميل ، أضفهما في مقتطف رمز روبي كما هو موضح أدناه:

# احصل على client_id و client_secret من https://dashboard.groupdocs.cloud بعد التسجيل المجاني.
# قم بتحميل الأحجار الكريمة في تطبيق الياقوت الخاص بك على http://api.groupdocs.cloud

require 'groupdocs_conversion_cloud'
@client_id = "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
@client_secret = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
# أضف اسم التخزين الخاص بك هنا
@groupdocs_storage = "MyStorage"

قم بتحويل مستندات Word إلى PDF في Ruby باستخدام REST API

يمكنك تحويل مستندات Word إلى PDF برمجيًا على السحابة باتباع الخطوات البسيطة الموضحة أدناه:

  1. تحميل ملف DOCX إلى السحابة
  2. تحويل DOCX إلى ملف PDF
  3. تنزيل ملف PDF المحول
  4. حذف ملف من التخزين السحابي

1 . قم بتحميل ملف DOCX

أولاً ، قم بتحميل ملف DOCX إلى التخزين السحابي باستخدام نموذج الكود أدناه:

# تهيئة API: إنشاء مثيل من واجهات برمجة التطبيقات للتحويل
@fileApi = GroupDocsConversionCloud::FileApi.from_keys(@client_id, @client_secret)

# تحميل الملف إلى التخزين السحابي

@wordfile = "#{Rails.root}/public/groupdocs-files/four-pages.docx"
@fileStream = File.new(@wordfile, "r")

@request = GroupDocsConversionCloud::UploadFileRequest.new('conversion/four-pages.docx', @fileStream, @groupdocs_storage)
@response = @fileApi.upload_file(@request)

@fileStream.close()

puts("File Uploading completed." + (@response).to_s )

نتيجة لذلك ، سيكون ملف DOCX الذي تم تحميله متاحًا في قسم الملفات من لوحة القيادة على السحابة.

2 . قم بتحويل DOCX إلى PDF باستخدام Ruby

يمكنك تحويل ملف DOCX إلى ملف PDF برمجيًا باتباع الخطوات المذكورة أدناه:

  • بادئ ذي بدء ، قم بإنشاء مثيل لـ FileApi.
  • بعد ذلك ، قم بإنشاء مثيل لـ ConvertSettings.
  • ثم قم بتعيين مسار ملف DOCX للإدخال.
  • قم بتوفير تنسيق لملف الإخراج كـ “pdf”.
  • الآن ، قم بتوفير مسار دليل الإخراج كـ “تحويل”.
  • بعد ذلك ، قم بإنشاء ConvertDocumentRequest بالإعدادات المتوفرة.
  • أخيرًا ، قم باستدعاء أسلوب convert \ document() باستخدام ConvertDocumentRequest كوسيطة.

يوضح مقتطف الشفرة التالي كيفية تحويل DOCX إلى PDF باستخدام REST API في Ruby.

# تهيئة API: إنشاء مثيل من واجهات برمجة التطبيقات للتحويل
@fileApi = GroupDocsConversionCloud::FileApi.from_keys(@client_id, @client_secret)

# تحضير إعدادات تحويل الملف
settings = GroupDocsConversionCloud::يتحولSettings.new
settings.file_path = "four-pages.docx"
settings.format = "pdf"
settings.output_path = "conversion"

# يتحول
result = @fileApi.convert_document(GroupDocsConversionCloud::يتحولDocumentRequest.new(settings))

puts("Word file successfully converted to pdf file.")
تم تحويل DOCX إلى PDF باستخدام Ruby

قم بتحويل DOCX إلى PDF باستخدام Ruby

3 . قم بتنزيل الملف المحول

تم حفظ ملف PDF المحول على السحابة. يوضح مقتطف الشفرة التالي كيفية تنزيل ملف باستخدام Ruby:

# تهيئة API: إنشاء مثيل من واجهات برمجة التطبيقات للتحويل
@fileApi = GroupDocsConversionCloud::FileApi.from_keys(@client_id, @client_secret)

# طلب تحميل الملف

@request = GroupDocsConversionCloud::DownloadFileRequest.new("conversion/four-pages.pdf", @groupdocs_storage)
@response = @fileApi.download_file(@request)
    
puts("File downloading successfully completed." + (@response).to_s )

4 . حذف ملف من التخزين السحابي

يمكنك حذف ملف PDF المحول باستخدام نموذج التعليمات البرمجية كما هو موضح أدناه:

# تهيئة API: إنشاء مثيل من واجهات برمجة التطبيقات للتحويل
@fileApi = GroupDocsConversionCloud::FileApi.from_keys(@client_id, @client_secret)

# حذف ملف طلب من التخزين

@request = GroupDocsConversionCloud::DeleteFileRequest.new("conversion/four-pages.docx", @groupdocs_storage)
@response = @fileApi.delete_file(@request)

puts("File successfully deleted from storage." + (@response).to_s )

تحويل Word إلى PDF مع خيارات متقدمة في Ruby

يمكنك أيضًا تحويل مستندات Word إلى ملفات PDF بالياقوت باستخدام الخيارات المتقدمة باتباع الخطوات الموضحة أدناه:

  • أولاً ، قم بإنشاء مثيل لـ FileApi.
  • الآن ، قم بإنشاء ConvertDocumentRequest باستخدام ConvertSettings
  • ثم قم بتعيين مسار ملف DOCX للإدخال.
  • قم بتوفير تنسيق الملف الناتج كـ “pdf”.
  • الآن ، قم بإنشاء مثيل لـ DocxLoadOptions.
  • تعيين كلمة مرور للخيارات loadOptions
  • بعد ذلك ، قم بإنشاء مثيل لـ PdfConvertOptions
  • بعد ذلك ، قم بتعيين خيارات التحويل المختلفة مثل المركز \ النافذة ، والعرض \ المستند \ العنوان ، والهامش ، والصورة \ الجودة والخطوط وما إلى ذلك.
  • توفير تحميل \ خيارات ، تحويل \ خيارات وإخراج \ إعدادات المسار.
  • أخيرًا ، قم بتحويل DOCX عن طريق استدعاء الأسلوب convert \ document() باستخدام ConvertDocumentRequest

يوضح نموذج التعليمات البرمجية التالي كيفية تحويل مستند Word إلى مستند PDF باستخدام خيارات التحويل المتقدمة. يرجى اتباع الخطوات المذكورة سابقاً لتحميل وتنزيل ملف.

# تهيئة API: إنشاء مثيل من واجهات برمجة التطبيقات للتحويل
@fileApi = GroupDocsConversionCloud::FileApi.from_keys(@client_id, @client_secret)

# خيارات الملف المتقدمة
# تحضير وضبط إعدادات التحويل

settings = GroupDocsConversionCloud::ConvertSettings.new
settings.file_path = "four-pages.docx"
settings.format = "pdf"
 
loadOptions = GroupDocsConversionCloud::DocxLoadOptions.new
loadOptions.password = "password"

convertOptions = GroupDocsConversionCloud::PdfConvertOptions.new
convertOptions.center_window = true
convertOptions.compress_images = false
convertOptions.display_doc_title = true
convertOptions.dpi = 1024.0
convertOptions.fit_window = false
convertOptions.from_page = 1
convertOptions.grayscale = false
convertOptions.image_quality = 100
convertOptions.linearize = false
convertOptions.margin_top = 5
convertOptions.margin_left = 5
convertOptions.password = "password"
convertOptions.unembed_fonts = true
convertOptions.remove_unused_streams = true
convertOptions.remove_unused_objects = true
convertOptions.remove_pdfa_compliance = false
 
settings.load_options = loadOptions
settings.convert_options = convertOptions
settings.output_path = "advance_options"
 
# تحويل المستند 
result = @fileApi.convert_document(GroupDocsConversionCloud::ConvertDocumentRequest.new(settings))

puts("Word file successfully converted to pdf file with advance file options.")

نتيجة لذلك ، سيتم تحويل ملف Word DOCX إلى ملف PDF باستخدام خيارات الملفات المتقدمة.

DOCX مجاني لتحويل PDF عبر الإنترنت

كيفية تحويل Word إلى PDF عبر الإنترنت؟ سيقوم محول PDF المجاني والمتوفر عبر الإنترنت بإنشاء ملفات PDF من مستندات Word الخاصة بك. تم تطوير محول PDF عبر الإنترنت باستخدام Groupdocs Conversion API مع الحفاظ على تخطيط ملفك. تحويل المستندات من DOCX إلى PDF مجانًا تمامًا مثل ملف PDF الأصلي.

خاتمة

في هذه المقالة ، تعلمنا كيفية تحويل مستندات Word إلى ملفات PDF على السحابة. لقد رأيت أيضًا كيفية تحويل DOCX إلى PDF باستخدام خيارات متقدمة باستخدام Ruby. توضح هذه المقالة أيضًا كيفية تحميل ملف DOCX برمجيًا على السحابة ثم تنزيل ملف PDF المحول من السحابة. بالإضافة إلى ذلك ، يمكنك معرفة المزيد حول GroupDocs.Conversion Cloud API باستخدام التوثيق. نوفر أيضًا قسم مرجع واجهة برمجة التطبيقات الذي يتيح لك تصور واجهات برمجة التطبيقات الخاصة بنا والتفاعل معها مباشرةً من خلال المتصفح.

طرح سؤال

إذا كان لديك أي استفسارات حول محول DOCX إلى PDF ، فلا تتردد في سؤالنا على المنتدى.

أنظر أيضا

نوصي باتباع الارتباط ذي الصلة بتحويلات المستندات المدعومة: