REST APIを使用してRubyでWordドキュメントを結合する方法

REST APIを使用してRubyでWordドキュメントを結合する方法

REST API を使用して、クラウド上でプログラム的に Word ドキュメントを単一の Word ファイルに結合できます。すべてのファイルを 1 つずつ処理するのではなく、複数のドキュメントを 1 つのファイルに結合して共有したり印刷したりする場合に便利です。 Ruby 開発者は、Ruby アプリケーションで 2 つ以上の Word ファイルを 1 つのファイルに結合できます。この記事では、REST API を使用して Ruby で Word ドキュメントを結合する方法を学習します。

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

Word Merger REST API と Ruby SDK

2 つ以上の Word ファイルを結合するには、GroupDocs.Merger Cloud API の Ruby SDK を使用します。 2 つ以上のドキュメントを 1 つのドキュメントに結合したり、1 つのソース ドキュメントを複数の結果ドキュメントに分割したりできます。また、ページ全体または優先範囲に対して、ページの向きを移動、削除、交換、回転、または縦または横に変更することもできます。 SDK は、Word、Excel、PowerPoint, Visio、OneNote、PDF、HTML などのすべての一般的なドキュメント形式の結合と分割をサポートしています。

コンソールで次のコマンドを使用して、GroupDocs.Merger Cloud を Ruby アプリケーションにインストールできます。

gem install groupdocs_merger_cloud

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

# ドキュメント結合 gem をロードする
require 'groupdocs_merger_cloud'
@client_id = "xxxxxxxxx-xxxxx-xxxx-xxxxxxxxxx"
@client_secret = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

# ここにストレージ名を追加します
@mystorage = "LocalStorage"

Ruby の REST API を使用して複数の Word ドキュメントを結合する

以下に説明する簡単な手順に従って、クラウド上で 2 つ以上の Word ファイルをプログラム的に結合できます。以下の手順に従って、複数の Word 文書をプログラムで単一のファイルに結合する安全かつ迅速な方法です。

  • DocumentApi のインスタンスを作成します。
  • JoinItem のインスタンスを作成する
  • FileInfo の最初の JoinItem の入力ファイル パスを設定します。
  • 2 番目のドキュメントの JoinItem の新しいインスタンスを作成します。
  • FileInfo の 2 番目の JoinItem の入力ファイル パスを指定します。
  • JoinItem をさらに追加して、より多くの DOCX ファイルをマージします
  • JoinOptions のインスタンスを作成する
  • 作成された結合項目のカンマ区切りリストを追加します
  • クラウド上の出力ファイルのパスを設定する
  • JoinOptions を使用して JoinRequest のインスタンスを作成する
  • JoinRequest を使用して DocumentAPI の join() メソッドを呼び出して結果を取得します

次のコード スニペットは、Ruby で REST API を使用して複数の Word ファイルを結合する方法を示しています。

@mergerApi = GroupDocsMergerCloud::DocumentApi.from_keys(@client_id, @client_secret)
 
@item1 = GroupDocsMergerCloud::JoinItem.new
@item1.file_info = GroupDocsMergerCloud::FileInfo.new
@item1.file_info.file_path = 'merge/four-pages.docx'
 
@item2 = GroupDocsMergerCloud::JoinItem.new
@item2.file_info = GroupDocsMergerCloud::FileInfo.new
@item2.file_info.file_path = 'merge/one-page.docx'       
 
@options = GroupDocsMergerCloud::JoinOptions.new
@options.join_items = [@item1, @item2]
@options.output_path = "merge/join.docx"
 
@result = @mergerApi.join(GroupDocsMergerCloud::JoinRequest.new(@options))

puts("Successfully merged word documents pages using Ruby.")

Ruby を使用して複数の Word 文書の特定のページを結合する

以下の手順に従って、複数の Word ファイルの特定のページをプログラムで簡単に 1 つのファイルに結合できます。

  • DocumentApi のインスタンスを作成します。
  • JoinItem のインスタンスを作成する
  • FileInfo の最初の JoinItem の入力ファイル パスを設定します。
  • 結合するページ番号のリストを定義する
  • JoinItem の別のインスタンスを作成する
  • FileInfo の 2 番目の JoinItem の入力ファイル パスを設定します。
  • 開始ページ番号と終了ページ番号を定義する
  • ページ範囲モードを OddPages として定義します。
  • JoinOptions のインスタンスを作成する
  • 作成された結合項目のカンマ区切りリストを追加します
  • クラウド上の出力ファイルのパスを設定する
  • JoinOptions を使用して JoinRequest のインスタンスを作成する
  • 最後に、JoinRequest を使用して DocumentAPI の join() メソッドを呼び出してドキュメントを結合します。

次のコード スニペットは、Ruby の REST API を使用して、複数の Word ファイルから特定のページを結合する方法を示しています。

# 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 = 'merge/ten-pages.docx'
@item1.pages = [3, 6, 8]
 
@item2 = GroupDocsMergerCloud::JoinItem.new
@item2.file_info = GroupDocsMergerCloud::FileInfo.new
@item2.file_info.file_path = 'merge/four-pages.docx'       
@item2.start_page_number = 1
@item2.end_page_number = 4
@item2.range_mode = "OddPages"
 
@options = GroupDocsMergerCloud::JoinOptions.new
@options.join_items = [@item1, @item2]
@options.output_path = "merge/join-pages.docx"
 
@result = @mergerApi.join(GroupDocsMergerCloud::JoinRequest.new(@options))

puts("Merge multiple word documents pages in Ruby.")

オンライン Word マージ | DOCXオンラインを組み合わせる

上記の API を使用して開発された、次の 無料のオンライン Word 結合ツール をお試しください。 Word Merger ツールを使用すると、どのデバイスからでもオンラインで DOCX を結合できます。

複数のドキュメントをオンラインで結合および結合するための API

DOCX ファイルをオンラインでマージするにはどうすればよいですか?

まとめ

このブログ投稿では、クラウド上で複数の Word ファイルを結合する方法を学びました。また、Ruby を使用して複数の Word 文書の特定のページを 1 つのファイルに結合する方法も学びました。 DOCX マージ REST API は、クラウド API の ドキュメント マージャ ファミリー メンバー として .NET、Java、PHP、Python、Android、および Node.js SDK も提供します。 GroupDocs.Merge Cloud API の詳細については、ドキュメント を使用して学習できます。また、ブラウザーを通じて API を直接視覚化して操作できる API リファレンス セクションも提供しています。

質問する

複数の Word 文書を結合する方法についてご質問がある場合は、無料サポート フォーラム でお気軽にお問い合わせください。数時間以内に回答いたします。

関連項目