با استفاده از REST API اسناد Word را به PDF در Ruby تبدیل کنید

نحوه تبدیل اسناد Word به PDF با استفاده از روبی

DOCX یکی از محبوب ترین پردازشگرهای کلمه در جهان است. با این حال، MS DOCX اسناد را دوباره قالب‌بندی می‌کند و زمانی که در یک سیستم کامپیوتری دیگر باز می‌شود، می‌توان آنها را تغییر داد. در حالی که فایل‌های PDF سازگار با دستگاه همراه هستند، به راحتی قابل خواندن هستند و نمی‌توان آن‌ها را تغییر داد. به همین دلیل است که کاربران هنگام ارسال اطلاعات مهم مانند صورت‌حساب‌های آنلاین، تاریخچه تراکنش‌ها و برگه‌ها و غیره، اسناد word را به رنگ یاقوت به PDF تبدیل می‌کنند.

اکنون می دانید که چرا باید اسناد Word را به فایل PDF تبدیل کنید. می توانید Word DOCX را با استفاده از عملکرد داخلی ارائه شده توسط Microsoft Office به PDF تبدیل کنید، اما ممکن است لازم باشد اسناد Word خود را DOCX به PDF تبدیل کنید. استفاده از APIهای تبدیل Groupdocs برای تبدیل اسناد Word به PDF سریع، آسان و فوری است. تنها چیزی که نیاز دارید یک اتصال اینترنتی پایدار و فایل های خود است. در این مقاله نحوه تبدیل اسناد Word به PDF در Ruby با استفاده از REST API را خواهیم آموخت.

موضوعات زیر باید در این مقاله وبلاگ پوشش داده شود:

تبدیل Word به PDF REST API - Ruby API Installations

با استفاده از Ruby SDK of GroupDocs.Conversion Cloud به راحتی می توانید فایل های DOCX را به PDF تبدیل کنید. این به شما کمک می کند تا اسناد فرمت های فایل پشتیبانی شده را سریع و مطمئن به سایر فرمت های سند تبدیل کنید - فقط در چند ثانیه و با کیفیت بالا. GroupDocs.Conversion Cloud REST API به شما امکان می دهد اسناد را در طیف گسترده ای از فرمت های فایل پشتیبانی شده بدون هیچ گونه نرم افزار وابستگی تبدیل کنید. این با تمام نرم افزارهای اصلی آفیس سازگار است و کاملا مستقل از سیستم عامل است.

GroupDocs.Conversion راه حل های تبدیل سند با کیفیت بالا را ارائه می دهد. می‌توانید فهرست SDK‌های موجود ما را اینجا بررسی کنید تا با استفاده از API‌های Cloud REST، اسناد را به قالب جدیدی تبدیل کنید. همچنین می‌توانید این APIهای REST را مستقیماً از مرورگر خود با مرجع API GroupDocs.Conversion Cloud Swagger UI فراخوانی کنید. یک Gem groupdocsconversioncloud در rubygems موجود است. می‌توانید GroupDocs.Conversion Cloud API را برای تبدیل اسناد word به PDF در برنامه Ruby با استفاده از این gem با دستور زیر در کنسول rails نصب کنید:

gem install groupdocs_conversion_cloud

آدرس‌پذیر ~> 2.5.0، >= 2.5.0 گوهر وابستگی زمان اجرا برای groupdocsconversioncloud است. همچنین می‌توانید برای برقراری ارتباط با GroupDocs.Conversion Cloud API، gem تبدیل را در Gemfile خود کپی کنید و سپس نصب بسته را اجرا کنید:

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

در مرحله بعد، باید یک Client ID و یک Client Secret را قبل از هر درخواستی به GroupDocs Conversion Cloud API اضافه کنید. این برای فراخوانی GroupDocs Cloud API به پروژه موجود شما استفاده خواهد شد. می‌توانید با ایجاد یک Application جدید در داشبوردGroupdocs [اطلاعات مشتری11 را دریافت کنید. هنگامی که Client Id و Client Secret را دارید، آنها را در قطعه کد روبی مانند شکل زیر اضافه کنید:

# پس از ثبت نام رایگان، 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"

با استفاده از REST API اسناد Word را به PDF در Ruby تبدیل کنید

با دنبال کردن مراحل ساده زیر می توانید اسناد Word را به صورت برنامه نویسی در فضای ابری به PDF تبدیل کنید:

  1. آپلود فایل DOCX در ابر
  2. تبدیل DOCX به فایل PDF
  3. دانلود فایل PDF تبدیل شده
  4. حذف فایل از ذخیره سازی ابر

1. فایل DOCX را آپلود کنید

ابتدا فایل DOCX را با استفاده از نمونه کد زیر در فضای ذخیره سازی ابری آپلود کنید:

# مقداردهی اولیه API: یک نمونه از 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. با استفاده از Ruby DOCX را به PDF تبدیل کنید

با انجام مراحل ذکر شده در زیر می توانید DOCX را به صورت برنامه نویسی به فایل PDF تبدیل کنید:

  • اول از همه، یک نمونه از FileApi ایجاد کنید.
  • بعد، یک نمونه از ConvertSettings ایجاد کنید.
  • سپس، مسیر فایل ورودی DOCX را تنظیم کنید.
  • فرمت فایل خروجی را به صورت «pdf» ارائه دهید.
  • اکنون مسیر دایرکتوری خروجی را به عنوان “تبدیل” ارائه دهید.
  • بعد، ConvertDocumentRequest را با تنظیمات ارائه شده ایجاد کنید.
  • در نهایت، متد convert\document() را با ConvertDocumentRequest به عنوان آرگومان فراخوانی کنید.

قطعه کد زیر نحوه تبدیل DOCX به PDF را با استفاده از REST API در Ruby نشان می دهد.

# مقداردهی اولیه API: یک نمونه از 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 را با استفاده از Ruby به PDF تبدیل کرد

با استفاده از Ruby DOCX را به PDF تبدیل کنید

3. فایل تبدیل شده را دانلود کنید

فایل PDF تبدیل شده در فضای ابری ذخیره شده است. قطعه کد زیر نحوه دانلود یک فایل با استفاده از Ruby را نشان می دهد:

# مقداردهی اولیه API: یک نمونه از 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: یک نمونه از 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 ایجاد کنید
  • سپس، گزینه های مختلف تبدیل مانند مرکز \ پنجره ، نمایش \ سند \ عنوان ، حاشیه ، تصویر / کیفیت و فونت و غیره را تنظیم کنید.
  • تنظیمات بار/گزینه، تبدیل/گزینه و خروجی/مسیر را ارائه دهید.
  • در نهایت، با فراخوانی متد convert\document() با ConvertDocumentRequest، DOCX را تبدیل کنید.

نمونه کد زیر نحوه تبدیل یک سند Word به یک سند PDF را با گزینه های تبدیل پیشرفته نشان می دهد. لطفاً برای آپلود و دانلود یک فایل مراحل ذکر شده را دنبال کنید.

# مقداردهی اولیه API: یک نمونه از 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 تبدیل کنیم؟ مبدل پی دی اف رایگان و آنلاین ما از اسناد Word شما پی دی اف ایجاد می کند. این مبدل PDF آنلاین با استفاده از Groupdocs Conversion API توسعه یافته است و طرح بندی فایل شما را حفظ می کند. تبدیل اسناد DOCX به PDF رایگان دقیقاً مانند فایل PDF اصلی.

نتیجه

در این مقاله نحوه تبدیل اسناد Word به فایل های PDF در فضای ابری را یاد گرفتیم. شما همچنین نحوه تبدیل DOCX به PDF را با گزینه های پیشرفته با استفاده از Ruby مشاهده کرده اید. در این مقاله همچنین نحوه آپلود برنامه‌ای فایل DOCX بر روی ابر و سپس دانلود فایل PDF تبدیل شده از ابر توضیح داده شده است. علاوه بر این، می‌توانید با استفاده از مستندات درباره GroupDocs.Conversion Cloud API اطلاعات بیشتری کسب کنید. ما همچنین یک بخش API Reference ارائه می دهیم که به شما امکان می دهد API های ما را مستقیماً از طریق مرورگر تجسم کنید و با آنها تعامل داشته باشید.

سوال بپرس

اگر سؤالی در مورد مبدل DOCX به PDF دارید، لطفاً از ما در [فروم 25 بپرسید.

همچنین ببینید

توصیه می کنیم پیوند مربوط به تبدیل اسناد پشتیبانی شده را دنبال کنید: