手順の概要

非インタラクティブ PDF ドキュメントを作成するには、次のタスクを実行します。

  1. プロジェクトファイルを含めます。
  2. PDF Assembler クライアントを作成します。
  3. 既存の DDX ドキュメントを参照します。
  4. インタラクティブ PDF ドキュメントを参照します。
  5. 実行時オプションを設定します。
  6. PDF ドキュメントをアセンブリします。
  7. 非インタラクティブ PDF ドキュメントを保存します。

プロジェクトファイルのインクルード

必要なファイルを開発プロジェクトに含めます。Java を使用してクライアントアプリケーションを作成する場合は、必要な JAR ファイルを含めます。Web サービスを使用している場合は、プロキシファイルを必ず含めてください。

次の JAR ファイルをプロジェクトのクラスパスに追加する必要があります。

  • adobe-livecycle-client.jar
  • adobe-usermanager-client.jar
  • adobe-assembler-client.jar
  • adobe-utilities.jar(AEM Forms が JBoss にデプロイされている場合に必要)
  • jbossall-client.jar(AEM Formsが JBoss にデプロイされている場合に必要)

AEM Forms が JBoss 以外のサポート対象の J2EE アプリケーションサーバーにデプロイされている場合は、adobe-utilities.jar ファイルと jbossall-client.jar ファイルを、AEM Forms がデプロイされている J2EE アプリケーションサーバーに固有の JAR ファイルに置き換える必要があります。

Assembler クライアントの作成

Assembler 操作をプログラムで実行する前に、Assembler サービスクライアントを作成する必要があります。

既存の DDX ドキュメントの参照

DDX ドキュメントを参照して、PDF ドキュメントをアセンブリする必要があります。この DDX ドキュメントには NoXFA 要素が含まれている必要があり、この要素は Assembler サービスに非インタラクティブ PDF ドキュメントを返すよう指示します。

インタラクティブ PDF ドキュメントの参照

非インタラクティブ PDF ドキュメントを取得するには、インタラクティブ PDF ドキュメントを参照して Assembler サービスに渡す必要があります。

実行時オプションの設定

ジョブを実行する際の Assembler サービスの動作を制御する実行時オプションを設定できます。例えば、エラーが発生した場合にジョブの処理を続行するよう Assembler サービスに指示するオプションを設定できます。

PDF ドキュメントの作成

Assembler サービスクライアントの作成、DDX ドキュメントの参照、インタラクティブ PDF ドキュメントの参照および実行時オプションの設定が完了したら、invokeOneDocument 操作を呼び出すことができます。Assembler サービスに渡す入力 PDF ドキュメントは 1 つだけで、返されるドキュメントも 1 つなので、invokeDDX 操作ではなく invokeOneDocument 操作を使用できます。

非インタラクティブ PDF ドキュメントの保存

Assembler サービスに渡す PDF ドキュメントが 1 つのみであれば、コレクションオブジェクトではなく 1 つのドキュメントが Assembler サービスから返されます。つまり、invokeOneDocument 操作を呼び出すと、1 つのドキュメントが返されます。このセクションで参照している DDX ドキュメントには、非インタラクティブ PDF ドキュメントを作成する指示が含まれているので、Assembler サービスは、PDF ファイルとして保存できる非インタラクティブ PDF ドキュメントを返します。

関連トピック

AEM Forms Java ライブラリファイルの追加

接続プロパティの設定

PDF ドキュメントをプログラムで組み立てる

Java API を使用した非インタラクティブ PDF ドキュメントの作成

Assembler サービス API(Java)を使用して、非インタラクティブ PDF ドキュメントを作成します。

  1. プロジェクトファイルを含めます。

    adobe-livecycle-client.jar などのクライアント JAR ファイルを Java プロジェクトのクラスパスに含めます。

  2. Assembler クライアントを作成します。

    • 接続プロパティを含む ServiceClientFactory オブジェクトを作成します。
    • コンストラクターを使用して ServiceClientFactory オブジェクトを渡すことにより、AssemblerServiceClient オブジェクトを作成します。
  3. 既存の DDX ドキュメントを参照します。

    • コンストラクタを使用し、DDX ファイルの場所を指定する文字列値を渡すことによって、その DDX ドキュメントを表す java.io.FileInputStream オブジェクトを作成します。
    • コンストラクタを使用して com.adobe.idp.Document オブジェクトを渡すことによって、java.io.FileInputStream オブジェクトを作成します。
  4. インタラクティブ PDF ドキュメントを参照します。

    • コンストラクターを使用し、インタラクティブ PDF ドキュメントの場所を渡すことにより、java.io.FileInputStream オブジェクトを作成します。
    • com.adobe.idp.Document オブジェクトを作成し、PDF ドキュメントを含んだ java.io.FileInputStream オブジェクトを渡します。この com.adobe.idp.Document オブジェクトが invokeOneDocument メソッドに渡されます。
  5. 実行時オプションを設定します。

    • コンストラクタを使用して、実行時オプションを格納する AssemblerOptionSpec オブジェクトを作成します。
    • AssemblerOptionSpec オブジェクトに属するメソッドを呼び出して、ビジネス要件を満たすよう実行時オプションを設定します。例えば、エラーが発生したときにジョブの処理を続行するように Assembler サービスに指示するには、AssemblerOptionSpec オブジェクトの setFailOnError メソッドを呼び出して false を渡します。
  6. PDF ドキュメントをアセンブリします。

    AssemblerServiceClient オブジェクトの invokeOneDocument メソッドを呼び出して、以下の値を渡します。

    • DDX ドキュメントを表す com.adobe.idp.Document オブジェクト。この DDX ドキュメントに PDF ソース要素の値 inDoc が含まれていることを確認してください。
    • インタラクティブ PDF ドキュメントを格納する com.adobe.idp.Document オブジェクト。
    • デフォルトのフォントやジョブログレベルを含む、実行時のオプションを指定する com.adobe.livecycle.assembler.client.AssemblerOptionSpec オブジェクト。

    invokeOneDocument メソッドは、非インタラクティブ PDF ドキュメントを含む com.adobe.idp.Document オブジェクトを返します。

  7. 非インタラクティブ PDF ドキュメントを保存します。

    • java.io.File オブジェクトを作成し、ファイル拡張子が .pdf であることを確認します。
    • Document オブジェクトの copyToFile メソッドを呼び出して、Document オブジェクトのコンテンツをファイルにコピーします。必ず invokeOneDocument メソッドが返した Document オブジェクトを使用するようにしてください。
  • 「クイックスタート(SOAP モード):Java API を使用した PDF ドキュメントのアセンブリ」