複数のPDFを1つに結合する方法

複数のPDFをまとめる場面

複数のPDFを1つの文書にまとめたいときは、結合したいファイルを入力リストに並べて処理します。この機能は、2つ以上のBase64エンコード済みPDFを読み取り、各ファイルのページを1つのPDFへ順に追加します。請求書と明細、表紙と本文、資料と付録など、あらかじめ決めた順番でまとめたい場面に向いています。ファイルを渡すときは、PDFの内容を表すBase64値を用意してください。処理が成功すると、結合後のPDFを表すBase64値を確認できます。

入力して結合する手順

結合するPDFを2つ以上用意し、それぞれをBase64でエンコードされたファイル値として準備します。
入力リストにファイル値を追加し、先に置きたいPDFを前に、後に続けたいPDFを後ろに並べます。
並べたリストを使って処理を実行します。渡された各ファイルはBase64から復元され、PDFとして読み取られたページが結合文書へ追加されます。
成功結果に含まれる結合後PDFのBase64値を確認し、必要に応じて処理したページ数と結合したファイル数も確認します。入力リストを作り直す場合は、ファイルの順番を変えてから再度処理してください。

成功結果と失敗結果の確認

結果に成功が示されていれば、結合後のPDFを表すBase64値と、処理したページ数、結合したファイル数を確認できます。ページは入力リストの先頭にあるPDFから始まり、各PDFの内部にあるページ順を保ったまま次のファイルへ進みます。そのため、表紙を最初に置く構成では、表紙のファイルをリストの先頭に設定します。入力が2つ未満の場合、入力値をPDFとして読み取れない場合、PDF処理に必要な依存関係を利用できない場合、または処理中に例外が発生した場合は、成功した結合PDFではなく失敗結果になります。

使用例

請求書を先に置き、その後へ明細を続けた1つのPDFを作成するため、2つのPDFを指定順で結合します。

請求書PDFと明細PDFを用意し、請求書、明細の順で入力リストに設定して処理します。

成功時は、結合後PDFを表すBase64値、処理したページ数、結合したファイル数を含む結果になります。

制限事項

2つ未満の入力、PDFとして読めない値、利用できないPDF処理用依存関係、処理中の例外がある場合は、結合に成功したPDFは返りません。

よくある間違い

ファイルを1つだけ、または使えるファイル値のないリストで実行すると成功しません。PDFを2つ以上リストに入れ、各値がPDFとして読み取れることを確認してから処理してください。

よくある質問

PDFは何ファイルから結合できますか？

結合を成功させるには、入力リストに2つ以上のファイル値が必要です。入力がない場合や1つだけの場合は、成功結果になりません。

結合後のページ順はどうなりますか？

ページは入力リストに並べたファイルの順に追加され、同じファイル内では元のページ順が使われます。先に表示したいPDFをリストの前へ置いてください。

結合後に何を受け取れますか？

成功結果には、結合後PDFを表すBase64値のほか、処理したページ数と結合したファイル数が含まれます。