REST APIを使用してRubyでWordドキュメントをPDFに変換

Ruby を使用して Word 文書を PDF に変換する方法

DOCX は、世界で最も人気のあるワード プロセッサの 1 つです。ただし、MS DOCX はドキュメントを再フォーマットするため、別のコンピュータ システムで開くと変更される可能性があります。 PDF ファイルはモバイル デバイスに適しており、読みやすく、変更できません。そのため、ユーザーはオンライン請求書、取引履歴、配布資料などの重要な情報を送信するときに、Word 文書を Ruby の PDF に変換します。

Word 文書を PDF ファイルに変換する必要がある理由がわかりました。 Microsoft Office が提供する組み込み機能を使用して Word DOCX を PDF に変換できますが、プログラムによって Word 文書 DOCX を PDF に変換する必要がある場合があります。 Groupdocs Conversion API を使用すると、Word 文書を PDF にすばやく簡単に変換できます。必要なのは、安定したインターネット接続とファイルだけです。この記事では、REST API を使用して Ruby で Word ドキュメントを PDF に変換する方法を学びます。

このブログ記事では次のトピックについて取り上げます。

Word から PDF への変換 REST API - Ruby API のインストール

GroupDocs.Conversion Cloud の Ruby SDK を使用すると、DOCX ファイルPDF に簡単に変換できます。サポートされているファイル形式のドキュメントを、わずか数秒で高品質に、迅速かつ確実に他のドキュメント形式に変換するのに役立ちます。 GroupDocs.Conversion Cloud REST API を使用すると、依存関係のあるソフトウェアを使用せずに、サポートされているファイル形式 の幅広いドキュメントを変換できます。すべての主要なオフィス ソフトウェアと互換性があり、オペレーティング システムから完全に独立しています。

GroupDocs.Conversion は、高品質のドキュメント変換ソリューションを提供します。クラウド REST API を使用してドキュメントを新しい形式に変換するには、利用可能な SDK リストを こちら で確認できます。 GroupDocs.Conversion Cloud API リファレンス Swagger UI を使用して、ブラウザからこの REST API を直接呼び出すこともできます。 gem groupdocsconversioncloud は rubygems で入手できます。 Rails コンソールで次のコマンドを使用して、この gem を使用して GroupDocs.Conversion Cloud API をインストールし、Ruby アプリケーションで Word ドキュメントを PDF に変換できます。

gem install groupdocs_conversion_cloud

Addressable ~> 2.5.0、>= 2.5.0 は、groupdocsconversioncloud の実行時依存関係 gem です。 GroupDocs.Conversion Cloud API と通信するために変換 gem を Gemfile にコピーしてから、バンドル インストールを実行することもできます。

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

次に、GroupDocs Conversion Cloud API にリクエストを行う前に、クライアント ID とクライアント シークレットを追加する必要があります。これは、既存のプロジェクトに GroupDocs Cloud API を呼び出すために使用されます。 Groupdocs ダッシュボード で新しい アプリケーション を作成することで、クライアント認証情報を取得できます。クライアント ID とクライアント シークレットを取得したら、以下に示すように、これらを Ruby コード スニペットに追加します。

# 無料登録後、https://dashboard.groupdocs.cloud から client_id と client_secret を取得します。
# http://api.groupdocs.cloud の Ruby アプリケーションに gem をロードします。

require 'groupdocs_conversion_cloud'
@client_id = "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
@client_secret = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
# ここにストレージ名を追加します
@groupdocs_storage = "MyStorage" 

REST APIを使用してRubyでWordドキュメントをPDFに変換

以下の簡単な手順に従って、クラウド上で Word 文書をプログラムで PDF に変換できます。

  1. DOCXファイルをクラウドにアップロード
  2. 変換 DOCXをPDFファイルに変換
  3. ダウンロード変換されたPDFファイル
  4. クラウドストレージから17ファイルを[削除]

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」として指定します。
  • 次に、出力ディレクトリのパスを「conversion」として指定します。
  • 次に、提供された設定を使用して ConvertDocumentRequest を作成します。
  • 最後に、ConvertDocumentRequest を引数として convert\document() メソッドを呼び出します。

次のコード スニペットは、Ruby の REST API を使用して DOCX を PDF に変換する方法を示しています。

# 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.")
Rubyを使用してDOCXを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 )

Ruby の詳細オプションを使用した Word から PDF への変換

以下に示す手順に従って、高度なオプションを使用して Word 文書を Ruby の PDF ファイルに変換することもできます。

  • まず、FileApi のインスタンスを作成します。
  • 次に、ConvertSettings を使用して ConvertDocumentRequest を作成します。
  • 次に、入力 DOCX ファイルのパスを設定します。
  • 結果のファイルの形式を「pdf」として指定します。
  • 次に、DocxLoadOptions のインスタンスを作成します。
  • loadOptions のパスワードを設定する
  • 次に、PdfConvertOptions のインスタンスを作成します。
  • 次に、center\window、display\doc\title、margin、image\quality、font などのさまざまな変換オプションを設定します。
  • ロード\オプション、変換\オプション、出力\パスの設定を指定します。
  • 最後に、ConvertDocumentRequest で convert\document() メソッドを呼び出して 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に変換するにはどうすればよいですか?当社の無料オンライン PDF コンバーターは、Word 文書から PDF を作成します。このオンライン PDF コンバーターは Groupdocs Conversion API を使用して開発されており、ファイルのレイアウトが保持されます。 ドキュメント DOCX を無料で PDF に変換、元の PDF ファイルとまったく同じです。

結論

この記事では、クラウド上で Word 文書を PDF ファイルに変換する方法を学びました。 Ruby を使用して高度なオプションを使用して DOCX を PDF に変換する方法についても説明しました。この記事では、プログラムによって DOCX ファイルをクラウドにアップロードし、変換された PDF ファイルをクラウドからダウンロードする方法についても説明しました。さらに、ドキュメント を使用して、GroupDocs.Conversion Cloud API について詳しく学ぶことができます。また、ブラウザーを通じて API を直接視覚化して操作できる API リファレンス セクションも提供しています。

質問する

DOCX to PDF コンバーターについてご質問がある場合は、フォーラムでお気軽にお問い合わせください。

関連項目

サポートされているドキュメント変換の関連リンクを参照することをお勧めします。