非インタラクティブ PDF ドキュメントの作成 assembling-non-interactive-pdf-documents
非インタラクティブ PDF ドキュメントは、インタラクティブ PDF フォームを入力として使用することで作成できます。つまり、ユーザーがフィールドにデータを入力できるフォームがあるとします。そのフォームを Assembler サービスに渡すと、ユーザーがフィールドにデータを入力できない PDF ドキュメントを Assembler サービスから受け取ることができます。このドキュメントが非インタラクティブ PDF フォームです。例えば、インタラクティブなフォームである住宅ローン申し込みフォームを次の図に示します。
この説明では、次の DDX ドキュメントが使用されていると仮定します。
<?xml version="1.0" encoding="UTF-8"?>
<DDX xmlns="https://ns.adobe.com/DDX/1.0/">
<PDF result="out.pdf">
<PDF source="inDoc"/>
<NoXFA/>
</PDF>
</DDX>
この DDX ドキュメント内では、source 属性に値 inDoc が割り当てられていることに着目してください。Assembler サービスに渡す入力 PDF ドキュメントが 1 つのみで、返されるのも 1 つの PDF ドキュメントであり、invokeOneDocument 操作を呼び出す場合は、値 inDoc を PDF の source 属性に割り当てます。invokeOneDocument 操作を呼び出す際は、inDoc 値が、DDX ドキュメントに指定する必要がある事前定義済みキーです。
これに対し、2 つ以上の入力 PDF ドキュメントを Assembler サービスに渡す場合は、invokeDDX 操作を呼び出すことができます。この場合は、入力 PDF ドキュメントのファイル名を source 属性に割り当てます。
この DDX ドキュメントには NoXFA 要素が含まれており、この要素は Assembler サービスに非インタラクティブ PDF ドキュメントを返すよう指示します。
Assembler サービスは、入力 PDF ドキュメントが Acrobat フォームまたは静的 XFA フォームに基づいていれば、Output サービスが AEM Forms インストール環境に含まれていなくても、非インタラクティブ PDF ドキュメントを作成することができます。ただし、入力 PDF ドキュメントが動的 XFA フォームの場合は、Output サービスが AEM Forms インストール環境に含まれている必要があります。動的 XFA フォームの作成時に Output サービスが AEM Forms インストール環境に含まれていない場合は、例外がスローされます。詳しくは、ドキュメント Output ストリームの作成を参照してください。
手順の概要 summary-of-steps
非インタラクティブ PDF ドキュメントを作成するには、次のタスクを実行します。
- プロジェクトファイルを含めます。
- PDF Assembler クライアントを作成します。
- 既存の DDX ドキュメントを参照します。
- インタラクティブ PDF ドキュメントを参照します。
- 実行時オプションを設定します。
- PDF ドキュメントをアセンブリします。
- 非インタラクティブ 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 ドキュメントを返します。
関連トピック
Java API を使用した非インタラクティブ PDF ドキュメントの作成 assemble-a-non-interactive-pdf-document-using-the-java-api
Assembler サービス API(Java)を使用して、非インタラクティブ PDF ドキュメントを作成します。
-
プロジェクトファイルを含めます。
adobe-livecycle-client.jar などのクライアント JAR ファイルを Java プロジェクトのクラスパスに含めます。
-
Assembler クライアントを作成します。
- 接続プロパティを含む
ServiceClientFactoryオブジェクトを作成します。 - コンストラクターを使用して
ServiceClientFactoryオブジェクトを渡すことにより、AssemblerServiceClientオブジェクトを作成します。
- 接続プロパティを含む
-
既存の DDX ドキュメントを参照します。
- コンストラクタを使用し、DDX ファイルの場所を指定する文字列値を渡すことによって、その DDX ドキュメントを表す
java.io.FileInputStreamオブジェクトを作成します。 - コンストラクタを使用して
com.adobe.idp.Documentオブジェクトを渡すことによって、java.io.FileInputStreamオブジェクトを作成します。
- コンストラクタを使用し、DDX ファイルの場所を指定する文字列値を渡すことによって、その DDX ドキュメントを表す
-
インタラクティブ PDF ドキュメントを参照します。
- コンストラクターを使用し、インタラクティブ PDF ドキュメントの場所を渡すことにより、
java.io.FileInputStreamオブジェクトを作成します。 com.adobe.idp.Documentオブジェクトを作成し、PDF ドキュメントを含んだjava.io.FileInputStreamオブジェクトを渡します。このcom.adobe.idp.DocumentオブジェクトがinvokeOneDocumentメソッドに渡されます。
- コンストラクターを使用し、インタラクティブ PDF ドキュメントの場所を渡すことにより、
-
実行時オプションを設定します。
- コンストラクタを使用して、実行時オプションを格納する
AssemblerOptionSpecオブジェクトを作成します。 AssemblerOptionSpecオブジェクトに属するメソッドを呼び出して、ビジネス要件を満たすよう実行時オプションを設定します。例えば、エラーが発生したときにジョブの処理を続行するように Assembler サービスに指示するには、AssemblerOptionSpecオブジェクトのsetFailOnErrorメソッドを呼び出してfalseを渡します。
- コンストラクタを使用して、実行時オプションを格納する
-
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オブジェクトを返します。 - DDX ドキュメントを表す
-
非インタラクティブ PDF ドキュメントを保存します。
java.io.Fileオブジェクトを作成し、ファイル拡張子が .pdf であることを確認します。DocumentオブジェクトのcopyToFileメソッドを呼び出して、Documentオブジェクトのコンテンツをファイルにコピーします。必ずinvokeOneDocumentメソッドが返したDocumentオブジェクトを使用するようにしてください。
- 「クイックスタート(SOAP モード):Java API を使用した PDF ドキュメントのアセンブリ」
Web サービス API を使用した非インタラクティブ PDF ドキュメントのアセンブリ assemble-a-non-interactive-pdf-document-using-the-web-service-api
Assembler Service API(web サービス)を使用して、非インタラクティブ PDF ドキュメントをアセンブリします。
-
プロジェクトファイルを含めます。
MTOM を使用する Microsoft .NET プロジェクトを作成します。WSDL 定義
http://localhost:8080/soap/services/AssemblerService?WSDL&lc_version=9.0.1を使用するようにします。note note NOTE localhostを、AEM Forms をホストするサーバーの IP アドレスに置換します。 -
Assembler クライアントを作成します。
-
デフォルトのコンストラクターを使用して
AssemblerServiceClientオブジェクトを作成します。 -
System.ServiceModel.EndpointAddressコンストラクターを使用して、AssemblerServiceClient.Endpoint.Addressオブジェクトを作成します。WSDL を指定する文字列値を AEM Forms サービスに渡します(例:http://localhost:8080/soap/services/AssemblerService?blob=mtom)。lc_version属性を使用する必要はありません。この属性は、サービス参照を作成する際に使用されます。 -
AssemblerServiceClient.Endpoint.Bindingフィールドの値を取得してSystem.ServiceModel.BasicHttpBindingオブジェクトを作成します。戻り値をBasicHttpBindingにキャストします。 -
System.ServiceModel.BasicHttpBindingオブジェクトのMessageEncodingフィールドをWSMessageEncoding.Mtomに設定します。この値により、MTOM が確実に使用されます。 -
次のタスクを実行して、HTTP 基本認証を有効にします。
AssemblerServiceClient.ClientCredentials.UserName.UserNameフィールドに AEM Forms ユーザー名を割り当てます。- 対応するパスワード値を
AssemblerServiceClient.ClientCredentials.UserName.Passwordフィールドに割り当てます。 - 定数値
HttpClientCredentialType.BasicをBasicHttpBindingSecurity.Transport.ClientCredentialTypeフィールドに割り当てます。 - 定数値
BasicHttpSecurityMode.TransportCredentialOnlyをフィールドBasicHttpBindingSecurity.Security.Modeに割り当てます。
-
-
既存の DDX ドキュメントを参照します。
- コンストラクターを使用して
BLOBオブジェクトを作成します。このBLOBオブジェクトは、DDX ドキュメントの保存に使用されます。 System.IO.FileStreamオブジェクトを作成するには、そのコンストラクターを呼び出し、DDX ドキュメントのファイルの場所とファイルを開くモードを表す文字列値を渡します。System.IO.FileStreamオブジェクトのコンテンツを保存するバイト配列を作成します。System.IO.FileStreamオブジェクトのLengthプロパティを取得して、バイト配列のサイズを決定することができます。System.IO.FileStreamオブジェクトのReadメソッドを呼び出して、バイト配列にストリームデータを入力します。読み取り対象のバイト配列、開始位置、ストリーム長を渡します。MTOMフィールドにバイト配列のコンテンツを割り当てて、BLOBオ ブジェクトを入力します。
- コンストラクターを使用して
-
インタラクティブ PDF ドキュメントを参照します。
- コンストラクタを使用して
BLOBオブジェクトを作成します。BLOBオブジェクトは、入力 PDF ドキュメントを格納するために使用します。このBLOBオブジェクトは引数としてinvokeOneDocumentに渡されます。 - コンストラクターを呼び出し、入力 PDF ドキュメントのファイルの場所とファイルを開くモードを表す文字列値を渡すことにより、
System.IO.FileStreamオブジェクトを作成します。 System.IO.FileStreamオブジェクトのコンテンツを格納するバイト配列を作成します。System.IO.FileStreamオブジェクトのLengthプロパティを取得して、バイト配列のサイズを決定することができます。System.IO.FileStreamオブジェクトのReadメソッドを呼び出して、バイト配列にストリームデータを入力します。読み取り対象のバイト配列、開始位置、ストリーム長を渡します。MTOMフィールドを割り当てることにより、BLOBオブジェクトにバイト配列の内容を入力します。
- コンストラクタを使用して
-
実行時オプションを設定します。
- ランタイムオプションを格納する
AssemblerOptionSpecオブジェクトをコンストラクタで作成します。 AssemblerOptionSpecオブジェクトに属するデータメンバーに値を割り当てることで、ビジネス要件に応じたランタイムオプションを設定します。例えば、エラーが発生した場合にジョブの処理を続行するように Assembler サービスに指示するには、falseをAssemblerOptionSpecオブジェクトのfailOnErrorデータメンバーに割り当てます。
- ランタイムオプションを格納する
-
PDF ドキュメントをアセンブリします。
AssemblerServiceClientオブジェクトのinvokeOneDocumentメソッドを呼び出して、以下の値を渡します。- DDX ドキュメントを表す
BLOBオブジェクト - インタラクティブ PDF ドキュメントを表す
BLOBオブジェクト - 実行時のオプションを指定する
AssemblerOptionSpecオブジェクト
invokeOneDocumentメソッドは、非インタラクティブ PDF キュメントを含むBLOBオブジェクトを返します。 - DDX ドキュメントを表す
-
非インタラクティブ PDF ドキュメントを保存します。
System.IO.FileStreamオブジェクトを作成するには、そのコンストラクターを呼び出し、非インタラクティブ PDF ドキュメントのファイルの場所とファイルを開くモードを表す文字列値を渡します。invokeOneDocumentメソッドから返されたBLOBオブジェクトのコンテンツを格納するバイト配列を作成します。BLOBオブジェクトのMTOMフィールドの値を取得して、バイト配列にデータを入力します。- コンストラクターを呼び出して
System.IO.FileStreamオブジェクトを渡すことによって、System.IO.BinaryWriterオブジェクトを作成します。 System.IO.BinaryWriterオブジェクトのWriteメソッドを呼び出してバイト配列を渡すことにより、バイト配列の内容を PDF ファイルに書き込みます。
- 「クイックスタート(MTOM):web サービス API を使用した非インタラクティブ PDF ドキュメントのアセンブリ」
関連トピック