Преобразование документов Word в PDF в Ruby с использованием REST API

Как конвертировать документы Word в PDF с помощью Ruby

DOCX — один из самых популярных текстовых процессоров в мире. Однако документы MS DOCX переформатируются и могут быть изменены при открытии в другой компьютерной системе. В то время как файлы PDF удобны для мобильных устройств, легко читаются и не могут быть изменены. Вот почему пользователи конвертируют текстовые документы в PDF на ruby при отправке важной информации, такой как онлайн-счета, история транзакций, раздаточные материалы и т. д.

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

В этой статье блога должны быть освещены следующие темы:

Преобразование Word в PDF REST API — установка Ruby API

Вы можете легко преобразовать файлы DOCX в PDF с помощью Ruby SDK of 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 для преобразования текстовых документов в PDF в приложении Ruby с помощью этого драгоценного камня с помощью следующей команды в консоли rails:

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

Затем вам нужно добавить идентификатор клиента и секрет клиента, прежде чем делать какие-либо запросы к API GroupDocs Conversion Cloud. Это будет использоваться для вызова облачного API GroupDocs в ваш существующий проект. Вы можете получить учетные данные клиента, создав новое Приложение на панели инструментов 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.
  • Затем установите различные параметры преобразования, такие как центр\окно, отображение\документ\заголовок, поля, изображение\качество, шрифты и т. д.
  • Предоставьте настройки load\options, convert\options и output\path.
  • Наконец, преобразуйте 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 преобразования групповых документов и сохраняет макет вашего файла. Конвертируйте документы DOCX в PDF бесплатно точно так же, как исходный файл PDF.

Заключение

В этой статье мы узнали, как конвертировать документы Word в файлы PDF в облаке. Вы также видели, как преобразовать DOCX в PDF с дополнительными параметрами с помощью Ruby. В этой статье также объясняется, как программно загрузить файл DOCX в облако, а затем загрузить преобразованный файл PDF из облака. Кроме того, вы можете узнать больше о GroupDocs.Conversion Cloud API, воспользовавшись документацией. Мы также предоставляем раздел Справочник по API, который позволяет визуализировать наши API и взаимодействовать с ними непосредственно через браузер.

Задайте вопрос

Если у вас есть какие-либо вопросы о конвертере DOCX в PDF, задайте их нам на Форуме.

Смотрите также

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