Перетворюйте документи Word у PDF у Ruby за допомогою REST API

Як конвертувати документи Word у PDF за допомогою Ruby

DOCX є одним із найпопулярніших текстових процесорів у світі. Однак MS DOCX переформатує документи та може бути змінено під час відкриття в іншій комп’ютерній системі. Хоча файли PDF зручні для мобільних пристроїв, їх легко читати та не можна змінити. Ось чому користувачі конвертують документи Word у PDF у форматі ruby, коли надсилають важливу інформацію, як-от онлайн-рахунки, історію транзакцій, роздаткові матеріали тощо.

Тепер ви знаєте, чому вам варто конвертувати документи Word у файл PDF. Ви можете конвертувати Word DOCX у PDF за допомогою вбудованих функцій Microsoft Office, але вам може знадобитися програмно конвертувати документи Word DOCX у PDF. Використання API перетворення Groupdocs для перетворення документів Word у формат PDF відбувається швидко, легко та миттєво. Все, що вам потрібно, це стабільне підключення до Інтернету та ваші файли. У цій статті ми дізнаємося, як конвертувати документи Word у PDF у Ruby за допомогою REST API.

У цій статті блогу будуть розглянуті такі теми:

REST API для перетворення Word у PDF – встановлення Ruby API

Ви можете легко конвертувати файли DOCX у PDF за допомогою Ruby SDK GroupDocs.Conversion Cloud. Це допомагає вам швидко та надійно конвертувати документи підтримуваних форматів файлів в інші формати документів - всього за кілька секунд і у високій якості. GroupDocs.Conversion Cloud REST API дозволяє конвертувати документи в широкий діапазон підтримуваних форматів файлів без будь-якого залежного програмного забезпечення. Він сумісний із усім основним офісним програмним забезпеченням і повністю не залежить від операційної системи.

GroupDocs.Conversion надає високоякісні рішення для конвертації документів. Ви можете переглянути наш список доступних SDK тут, щоб трансформувати документи в новий формат за допомогою наших хмарних REST API. Ви також можете викликати ці REST API безпосередньо зі свого браузера за допомогою GroupDocs.Conversion Cloud API посилання 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. Ви також можете скопіювати gem конверсії у свій Gemfile для зв’язку з GroupDocs.Conversion Cloud API, а потім запустити пакетне встановлення:

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

Далі вам потрібно додати ідентифікатор клієнта та секрет клієнта, перш ніж надсилати будь-які запити до GroupDocs Conversion Cloud API. Це буде використано для виклику GroupDocs Cloud API у вашому існуючому проекті. Ви можете отримати облікові дані клієнта, створивши нову програму на інформаційній панелі Groupdocs. Отримавши ідентифікатор клієнта та секрет клієнта, додайте їх у фрагмент коду ruby, як показано нижче:

# Отримайте свій client_id і client_secret на https://dashboard.groupdocs.cloud після безкоштовної реєстрації.
# Завантажте камінь у свою програму ruby для 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: створіть екземпляр 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: створіть екземпляр 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: створіть екземпляр 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 у форматі ruby із розширеними параметрами, виконавши наведені нижче дії.

  • Спочатку створіть екземпляр FileApi.
  • Тепер створіть ConvertDocumentRequest за допомогою ConvertSettings
  • Потім встановіть шлях до вхідного файлу DOCX.
  • Укажіть формат отриманого файлу як “pdf”.
  • Тепер створіть екземпляр DocxLoadOptions.
  • Встановити пароль для loadOptions
  • Далі створіть екземпляр PdfConvertOptions
  • Потім установіть різні параметри перетворення, такі як центр\вікно, відображення\документ\заголовок, поле, зображення\якість та шрифти тощо.
  • Надайте параметри завантаження\параметри, параметри\перетворення та параметри виведення\шляху.
  • Нарешті, перетворіть DOCX, викликавши метод convert\document() за допомогою ConvertDocumentRequest

У наведеному нижче прикладі коду показано, як перетворити документ 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 онлайн? Наш безкоштовний онлайн-конвертер PDF створить PDF-файли з ваших документів Word. Цей онлайн-конвертер PDF розроблено з використанням API перетворення Groupdocs і зберігає макет вашого файлу. Безкоштовно конвертуйте документи DOCX у PDF точно так само, як оригінальний файл PDF.

Висновок

У цій статті ми дізналися, як конвертувати документи Word у файли PDF у хмарі. Ви також бачили, як конвертувати DOCX у PDF із розширеними параметрами за допомогою Ruby. У цій статті також пояснюється, як програмно завантажити файл DOCX у хмару, а потім завантажити перетворений PDF-файл із хмари. Крім того, ви можете дізнатися більше про GroupDocs.Conversion Cloud API за допомогою документації. Ми також надаємо розділ API Reference, який дозволяє візуалізувати наші API та взаємодіяти з ними безпосередньо через браузер.

Задайте питання

Якщо у вас є будь-які запитання щодо конвертера DOCX у PDF, будь ласка, не соромтеся запитати нас на форумі.

Дивись також

Ми рекомендуємо перейти за відповідним посиланням для перетворення підтримуваних документів: