Ruby を使用して複数のファイルタイプを 1 つのドキュメントに結合およびマージする

Ruby を使用して複数のファイル タイプを 1 つのドキュメントに結合する

同じタイプまたは異なるタイプの異なるドキュメントを結合すると、分散したデータや情報を 1 つのファイルに収集できます。クラウド上で、異なるファイルタイプの複数のドキュメントを 1 つのファイルに簡単に結合できます。この記事では、Ruby REST API を使用して複数のファイル タイプを 1 つのドキュメントにマージする方法を学びます。

この記事では次のトピックについて説明します。

ファイルマージャー REST API と Ruby SDK

複数のファイルをマージするには、GroupDocs.Merger Cloud API の Ruby SDK を使用します。 サポートされている文書形式WordExcelPowerPointVisio 図面PDFHTML。コンソールで次のコマンドを使用してインストールしてください。

gem install groupdocs_conversion_cloud

上記の手順に従う前に、ダッシュボードからクライアント ID とシークレットを取得してください。 ID とシークレットを取得したら、以下に示すようにコードを追加します。

# 複数のファイルタイプの結合 gem をロードする
require 'groupdocs_merger_cloud'
@client_id = "xxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx"
@client_secret = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

# ストレージ名を定義します
@mystorage = "MYStorage"

Ruby を使用して複数のファイル タイプを 1 つのドキュメントに結合する

以下に示す手順に従って、クラウド上で複数のファイル タイプのドキュメントをプログラム的に結合できます。ドキュメントをクラウドにアップロードすることができ、その結果、アップロードされたファイルはクラウド上のダッシュボードのファイル セクションで利用できるようになります。ここで、以下の手順に従って、さまざまな種類のファイルを 1 つのファイルにマージできます。

  • まず、DocumentApiのインスタンスを作成します。
  • 次に、最初の JoinItem の入力ファイル パスを指定します。
  • 次に、2 番目の JoinItem の入力ファイル パスを指定します。
  • 必要に応じて、上記の手順を繰り返してさらにファイルを追加します。
  • その後、JoinOptions を定義し、出力ファイルのパスを設定します。
  • 最後に、join() メソッドを呼び出し、結合されたドキュメントを保存します。

次のコード サンプルは、Ruby で REST API を使用してさまざまなファイル タイプをマージする方法を示しています。

# PDF と Excel を結合して PDF にするにはどうすればよいですか?
# Document API のインスタンスを作成する
@documentApi = GroupDocsMergerCloud::DocumentApi.from_keys(@client_id, @client_secret)

@item1 = GroupDocsMergerCloud::JoinItem.new
@item1.file_info = GroupDocsMergerCloud::FileInfo.new
@item1.file_info.file_path = 'combine-multiple-files/two-pages.pdf'
@item1.file_info.password = 'password'

@item2 = GroupDocsMergerCloud::JoinItem.new
@item2.file_info = GroupDocsMergerCloud::FileInfo.new
@item2.file_info.file_path = 'combine-multiple-files/four-pages.docx'       

@options = GroupDocsMergerCloud::JoinOptions.new
@options.join_items = [@item1, @item2]
@options.output_path = "combine-multiple-files/combined.pdf"

@result = @documentApi.join(GroupDocsMergerCloud::JoinRequest.new(@options))

puts("Resultant file path: " + @result.path)
puts("Successfully combined multiple document types in Ruby.")

最後に、上記のコード サンプルは、結合された PDF ファイルをクラウド上に保存します。出力ドキュメントには、PDF ドキュメントのすべてのページが含まれ、次に Word ドキュメントのすべてのページが含まれます。

PDFとExcelを結合してPDFにする方法

前述の手順に従って、PDF と Excel ファイルを PDF に結合できます。ただし、最初と 2 番目の JoinItem として PDF および Excel ドキュメントのパスを指定する必要があるだけです。次のコード サンプルは、Ruby の REST API を使用して PDF ドキュメントと Excel シートを PDF ファイルに結合する方法を示しています。

# PDF と Excel を結合して PDF にするにはどうすればよいですか?
# Document API のインスタンスを作成する
@mergerApi = GroupDocsMergerCloud::DocumentApi.from_keys(@client_id, @client_secret)

@item1 = GroupDocsMergerCloud::JoinItem.new
@item1.file_info = GroupDocsMergerCloud::FileInfo.new
@item1.file_info.file_path = 'combine-multiple-files/two-pages.pdf'
@item1.file_info.password = 'password'

@item2 = GroupDocsMergerCloud::JoinItem.new
@item2.file_info = GroupDocsMergerCloud::FileInfo.new
@item2.file_info.file_path = 'combine-multiple-files/four-pages.xlsx'       

@options = GroupDocsMergerCloud::JoinOptions.new
@options.join_items = [@item1, @item2]
@options.output_path = "combine-multiple-files/combined.pdf"

@result = @documentApi.join(GroupDocsMergerCloud::JoinRequest.new(@options))

puts("Resultant file path: " + @result.path)
puts("Successfully combined PDF and Excel into PDF using Ruby.")

PDF と PowerPoint を結合して PDF にする方法

前述の手順に従って Ruby の REST API を融合することで、PDF ドキュメントと PowerPoint プレゼンテーションを PDF に結合することもできます。ただし、最初と 2 番目の JoinItem として PDF と PowerPoint のドキュメント パスを指定する必要があるだけです。次のコード サンプルは、Ruby の REST API を使用して PDF ドキュメントと PowerPoint プレゼンテーションを PDF ファイルに結合する方法を示しています。

# PDF と PowerPoint を PDF に結合するにはどうすればよいですか?
# Document API のインスタンスを作成する
@documentApi = GroupDocsMergerCloud::DocumentApi.from_keys(@client_id, @client_secret)

@item1 = GroupDocsMergerCloud::JoinItem.new
@item1.file_info = GroupDocsMergerCloud::FileInfo.new
@item1.file_info.file_path = 'combine-multiple-files/two-pages.pdf'
@item1.file_info.password = 'password'

@item2 = GroupDocsMergerCloud::JoinItem.new
@item2.file_info = GroupDocsMergerCloud::FileInfo.new
@item2.file_info.file_path = 'combine-multiple-files/five-pages.pptx'       

@options = GroupDocsMergerCloud::JoinOptions.new
@options.join_items = [@item1, @item2]
@options.output_path = "combine-multiple-files/combined.pdf"

@result = @documentApi.join(GroupDocsMergerCloud::JoinRequest.new(@options))

puts("Resultant file path: " + @result.path)
puts("Successfully combined PDF and PowerPoint into PDF using Ruby.")

Ruby で異なるファイルタイプの特定のページを結合する

以下の手順に従って、さまざまな種類のドキュメントから選択したページを 1 つのファイルに結合できます。

  • まず、DocumentApiのインスタンスを作成します。
  • 次に、最初の JoinItem の入力ファイル パスを指定します。
  • 次に、結合する特定のページ番号を指定します。
  • 次に、2 番目の JoinItem の入力ファイル パスを指定します。
  • 次に、結合するページ範囲を開始ページ番号と終了ページ番号で定義します。
  • その後、JoinOptions を定義し、出力ファイルのパスを設定します。
  • 最後に、join() メソッドを呼び出し、結合されたドキュメントを保存します。

次のコード サンプルは、Ruby の REST API を使用して、さまざまなファイル タイプの特定のページをマージする方法を示しています。

# Rubyで複数のファイルタイプの特定のページをマージするにはどうすればよいですか?
# Document API のインスタンスを作成する
@documentApi = GroupDocsMergerCloud::DocumentApi.from_keys(@client_id, @client_secret)

@item1 = GroupDocsMergerCloud::JoinItem.new
@item1.file_info = GroupDocsMergerCloud::FileInfo.new
@item1.file_info.file_path = 'combine-multiple-files/ten-pages.pdf'
@item1.pages = [3, 6, 8]

@item2 = GroupDocsMergerCloud::JoinItem.new
@item2.file_info = GroupDocsMergerCloud::FileInfo.new
@item2.file_info.file_path = 'combine-multiple-files/four-pages.docx'       
@item2.start_page_number = 1
@item2.end_page_number = 4

@options = GroupDocsMergerCloud::JoinOptions.new
@options.join_items = [@item1, @item2]
@options.output_path = "combine-multiple-files/combined.pdf"

@result = @documentApi.join(GroupDocsMergerCloud::JoinRequest.new(@options))

puts("Output file path: " + @result.path)
puts("Merged multiple types documents pages in Ruby.")

オンラインでの複数のファイルタイプの結合

上記の API を使用して開発された、次の無料のオンライン結合ツールをお試しください。 https://products.groupdocs.app/merger/

結論

この記事では、次のことを学びました。

  • Ruby で複数のファイルタイプのドキュメントをマージする方法。
  • PDF と Excel を結合して PDF にする方法;
  • PDF と PowerPoint を PDF に結合する方法;

さらに、GroupDocs.Merge Cloud API の詳細については、ドキュメント を使用して学習できます。また、ブラウザーを通じて API を直接視覚化して操作できる API リファレンス セクションも提供しています。

質問する

複数のファイル タイプの結合についてご質問がある場合は、フォーラム でお気軽にお問い合わせください。

関連項目