Java で Word 文書を結合する - MS Word 文書をオンラインで連結する

Microsoft Word は、職場のコンピューター、学校のコンピューター、自宅の PC など、ほぼどこでも利用できます。私たちは word 形式で手紙やレポートなどを作成し、クリップ アートを使用したり、さまざまなフォントやサイズで書き込んだりします。時間の経過とともに、大量のドキュメントが生成され、長期アーカイブのためにこれらのドキュメントを結合する必要があります。そこで、この記事では、Java でドキュメントを結合する手法を学習します。

• ドキュメント結合 API
• JavaでWord文書を結合する
• cURL コマンドを使用して Word 文書を結合する

ドキュメント結合 API

Aspose.Words Cloud は、MS Word および OpenOffice ドキュメントを作成、編集、レンダリングし、さまざまな サポートされている形式 で保存する機能を提供します。また、Word ドキュメントを読み込んで 1 つの統合ドキュメントに結合する機能もサポートしています。そこで、Maven ビルド タイプの pom.xml に次の詳細を追加して、Aspose.Words Cloud SDK for Java がプロジェクトに追加されるようにします。

<repositories>
    <repository>
        <id>AsposeJavaAPI</id>
        <name>Aspose Java API</name>
        <url>https://repository.aspose.cloud/repo/</url>
    </repository>
</repositories>

<dependency>
    <groupId>com.aspose</groupId>
         <artifactId>aspose-words-cloud</artifactId>
        <version>22.5.0</version>
</dependency>

まだアカウントをお持ちでない場合は、GitHub または Google アカウントを使用して Aspose.Cloud ダッシュボード で無料アカウントを登録するか、サインアップしてクライアント資格情報を取得してください。

JavaでWord文書を結合する

ドキュメントを結合するには、以下の手順に従ってください。

• まず、クライアントIDとクライアントシークレットの情報を指定します。
• 次に、ApiClient クラスのオブジェクトを作成し、ClientID と ClientSecret をコンストラクターの引数として渡します。3 番目の引数は baseUrl で、デフォルトでは https://api.aspose.cloud/ を指します。
• 3 番目に、コンストラクターへの引数として ApiClient オブジェクトを受け入れる WordsApi クラスのオブジェクトを作成します。
• ここで、DocumentEntry クラスのインスタンスを作成し、ソース Word ドキュメントの href を指定し、ドキュメントのインポート形式を KeepSourceFormatting に設定します。
• DocumentEntryList クラスのインスタンスを作成し、DocumentEntry オブジェクト (前の手順で作成) を addDocumentEntriesItem(…) メソッドに渡します。
• 次のステップは、AppendDocumentRequest クラスのインスタンスを作成し、入力 Word 文書、DocumentEntryList オブジェクト、および結果の結合ファイル名を引数としてコンストラクターに渡すことです。
• 最後に、WordsApi クラスのメソッド appendDocument(…) を呼び出して変換操作を実行します。

// https://dashboard.aspose.cloud/ から clientId と clientSecret を取得します。
String clientId = "c235e685-1aab-4cda-a95b-54afd63eb87f";
String clientSecret = "b8da4ee37494f2ef8da3c727f3a0acb9";

// baseUrlがnullの場合、WordsApiはデフォルトのhttps://api.aspose.cloudを使用します。 
// ユーザー固有のClientIDとClient Secretを指定してApiClientのオブジェクトを作成する
ApiClient apiClient = new ApiClient(clientId,clientSecret,null);

// ApiClientを引数として指定してWordsApiのオブジェクトを作成する
WordsApi wordsApi = new WordsApi(apiClient);

// 入力PDF文書
String inputFile = "file-sample.docx";
String firstFileToAppend = "test_multi_pages.docx";				
String resultantFile = "Resultant.docx";
				
// 追加する最初のドキュメントを指定します
DocumentEntry docEntry = new DocumentEntry().href(firstFileToAppend).importFormatMode("KeepSourceFormatting");

// 追加する文書のリストを指定する
DocumentEntryList documentList = new DocumentEntryList().addDocumentEntriesItem(docEntry);
								
// 変換パラメータを指定する
AppendDocumentRequest request = new AppendDocumentRequest(inputFile, documentList, null, null, null, null, resultantFile, null, null);

// 結果として得られた結合されたDOCXファイルを保存する
DocumentResponse result = wordsApi.appendDocument(request);

cURL コマンドを使用して Word 文書を結合する

cURL コマンドは、複雑なタスクを柔軟に実行できるため、広く普及しています。また、cURL コマンドを使用して Word 文書を結合することもできます。先に進む前に、REST API は許可されたユーザーのみがアクセスできるため、JWT アクセス トークンを生成する必要があります。以下のコマンドを実行して、JWT アクセス トークンを生成してください。

curl -v "https://api.aspose.cloud/connect/token" \
-X POST \
-d "grant_type=client_credentials&client_id=c235e685-1aab-4cda-a95b-54afd63eb87f&client_secret=b8da4ee37494f2ef8da3c727f3a0acb9" \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Accept: application/json"

詳細については、クライアントIDとクライアントシークレットキーを使用してJWTトークンを取得する方法をご覧ください。

JWTが作成されたら、以下のコマンドを実行してfile-sample.docxとtestmultipages.docxファイルを結合してください。その結果、Resultant.docxという名前の最終的な結合ファイルが生成されます。

curl -v "https://api.aspose.cloud/v4.0/words/test_doc.docx/appendDocument?destFileName=Resultant.docx" \
-X PUT \
-d "{'DocumentEntries':[{'Href':'test_multi_pages.docx', 'ImportFormatMode':'KeepSourceFormatting'}]}" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-H "Authorization: Bearer <JWT Token>"

結論

Java コード スニペットを使用して Word 文書を結合する手順について学習しました。同時に、cURL コマンドを使用して Word 文書を結合する方法の詳細も学習しました。Web ブラウザーで Swagger インターフェイス を介して API の魅力的な機能を調べることも検討できます。

さらに、当社のクラウド SDK はオープンソースであり、完全なソース コードは GitHub からダウンロードできます。API で提供されるその他の魅力的な機能の詳細については、製品の ドキュメント を参照することもお勧めします。お客様からのフィードバックは当社にとって非常に重要です。サポート フォーラム からお気軽にお問い合わせください。

関連記事

以下のリンクにアクセスして詳細を確認することを強くお勧めします。

• JavaでPDFをWordに変換する
• Java SDK を使用してオンライン PDF コンバーターを開発する
• JavaでWord文書をオンラインで比較する