このドキュメントのサンプルと例は、JEE 環境の AEM Forms のみを対象としています。
Assembler サービスで使用される DDX ドキュメントをプログラムで検証できます。つまり、Assembler サービス API を使用して、DDX ドキュメントが有効かどうかを判断できます。例えば、以前の AEM Forms バージョンからアップグレードした場合に、DDX ドキュメントが有効であることを確認するには、Assembler サービス API を使用してドキュメントを検証します。
Assembler サービスについて詳しくは、AEM Forms サービスリファレンスを参照してください。
DDX ドキュメントについて詳しくは、Assembler サービスと DDX リファレンスを参照してください。
DDX ドキュメントを検証するには、次のタスクを実行します。
プロジェクトファイルを含める
必要なファイルを開発プロジェクトに含めます。Java を使用してクライアントアプリケーションを作成する場合は、必要な JAR ファイルを含めます。Web サービスを使用している場合は、プロキシファイルを必ず含めてください。
次の JAR ファイルをプロジェクトのクラスパスに追加する必要があります。
AEM Forms が JBoss 以外のサポート対象の J2EE アプリケーションサーバーにデプロイされている場合は、adobe-utilities.jar ファイルと jbossall-client.jar ファイルを、AEM Forms がデプロイされている J2EE アプリケーションサーバーに固有の JAR ファイルに置き換える必要があります。
Assembler クライアントの PDF を作成
Assembler 操作をプログラムで実行する前に、Assembler サービスクライアントを作成する必要があります。
既存の DDX ドキュメントの参照
DDX ドキュメントを検証するには、既存の DDX ドキュメントを参照する必要があります。
DDX ドキュメントを検証するための実行時オプションの設定
DDX ドキュメントを検証する場合は、DDX ドキュメントを実行するのではなく、Assembler サービスに DDX ドキュメントを検証するよう指示する特定の実行時オプションを設定する必要があります。また、Assembler サービスがログファイルに書き込む情報の量を増やすこともできます。
検証の実行
Assembler サービスクライアントを作成し、DDX ドキュメントを参照し、実行時オプションを設定したら、invokeDDX
操作を呼び出して DDX ドキュメントを検証します。DDX ドキュメントを検証する際に、null
をマップパラメーターとして渡すことができます(通常、このパラメーターは DDX ドキュメントで指定された操作を行うために Assembler が必要とする PDF ドキュメントが格納されます)。
検証に失敗した場合は例外が発生し、DDX ドキュメントが無効な理由を説明する詳細を含むログファイルが OperationException
インスタンスから取得できます。基本的な XML 解析とスキーマチェックを経て、DDX 仕様に対する検証が実行されます。DDX ドキュメントに含まれるすべてのエラーは、ログに記録されます。
検証結果をログファイルに保存
Assembler サービスは、XML ログファイルに書き込むことができる検証結果を返します。Assembler サービスがログファイルに書き込む詳細の量は、設定した実行時オプションによって異なります。
関連トピック
Web サービス API を使用した DDX ドキュメントの検証
Assembler サービス API(Java)を使用して DDX ドキュメントを検証します。
プロジェクトファイルを含めます。
adobe-livecycle-client.jar などのクライアント JAR ファイルを Java プロジェクトのクラスパスに含めます。
PDF Assembler クライアントを作成します。
ServiceClientFactory
オブジェクトを作成します。ServiceClientFactory
オブジェクトを渡すことにより、AssemblerServiceClient
オブジェクトを作成します。既存の DDX ドキュメントを参照します。
java.io.FileInputStream
オブジェクトを作成します。com.adobe.idp.Document
オブジェクトを渡すことによって、java.io.FileInputStream
オブジェクトを作成します。DDX ドキュメントを検証するための実行時オプションを設定します。
AssemblerOptionSpec
オブジェクトを作成します。AssemblerOptionSpec
オブジェクトの setValidateOnly メソッドを呼び出して、true
を渡します。AssemblerOptionSpec
オブジェクトの getLogLevel
メソッドを呼び出して、要件を満たす文字列値を渡します。DDX ドキュメントを検証する場合、検証プロセスに役立つより多くの情報をログファイルに書き込みます。その結果、FINE
または FINER
という値を渡すことができます。検証を実行します。
AssemblerServiceClient
オブジェクトの invokeDDX
メソッドを呼び出して、次の値を渡します。
com.adobe.idp.Document
オブジェクトです。null
です。com.adobe.livecycle.assembler.client.AssemblerOptionSpec
オブジェクトです。invokeDDX
メソッドは、DDX ドキュメントが有効かどうかを指定する情報が格納される AssemblerResult
オブジェクトを返します。
検証結果をログファイルに保存します。
java.io.File
オブジェクトを作成し、ファイル名拡張子が .xml であることを確認します。AssemblerResult
オブジェクトの getJobLog
メソッドを呼び出します。このメソッドは、検証情報を含む com.adobe.idp.Document
インスタンスを返します。com.adobe.idp.Document
オブジェクトの copyToFile
メソッドを呼び出して、com.adobe.idp.Document
オブジェクトの内容をファイルにコピーします。DDX ドキュメントが無効な場合、OperationException
がスローされます。catch ステートメント内で、OperationException
オブジェクトの getJobLog
メソッドを呼び出すことができます。
関連トピック
クイックスタート(SOAP モード):Java API を使用した DDX ドキュメントの検証(SOAP モード)
Assembler Service API(web サービス)を使用して DDX ドキュメントを検証します。
プロジェクトファイルを含めます。
MTOM を使用する Microsoft .NET プロジェクトを作成します。WSDL 定義 http://localhost:8080/soap/services/AssemblerService?WSDL&lc_version=9.0.1
を使用するようにします。
localhost をFormsサーバーの IP アドレスに置き換えます。
PDF 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
オブジェクトを入力します。DDX ドキュメントを検証するための実行時オプションを設定します。
AssemblerOptionSpec
オブジェクトを作成します。AssemblerOptionSpec
オブジェクトの validateOnly
データメンバーに true の値を割り当てることにより、DDX ドキュメントを検証するように Assembler サービスに指示する実行時オプションを設定します。AssemblerOptionSpec
オブジェクトの logLevel
データメンバーに文字列値を割り当てて、Assembler サービスがログファイルに書き込む情報の量を設定します。DDX ドキュメントを検証する場合、検証プロセスに役立つ詳細情報をログファイルに書き込みます。その結果、FINE
または FINER
の値を指定できます。設定できる実行時オプションについて詳しくは、AEM Forms API リファレンスの AssemblerOptionSpec
クラス参照を参照してください。検証を実行します。
AssemblerServiceClient
オブジェクトの invokeDDX
メソッドを呼び出して、次の値を渡します。
BLOB
オブジェクト。Map
オブジェクトの値 null
。AssemblerOptionSpec
オブジェクト。invokeDDX
メソッドは、DDX ドキュメントが有効かどうかを示す情報が格納される AssemblerResult
オブジェクトを返します。
検証結果をログファイルに保存します。
System.IO.FileStream
オブジェクトを作成します。ファイル名の拡張子が .xml であることを確認します。AssemblerResult
オブジェクトの jobLog
データメンバーの値を取得して、ログ情報を格納する BLOB
オブジェクトを作成します。BLOB
オブジェクトのコンテンツを格納するバイト配列を作成します。BLOB
オブジェクトの MTOM
フィールドの値を取得して、バイト配列に入力します。System.IO.FileStream
オブジェクトを渡すことによって、System.IO.BinaryWriter
オブジェクトを作成します。System.IO.BinaryWriter
オブジェクトの Write
メソッドを呼び出して、バイト配列を渡してください。DDX ドキュメントが無効な場合、OperationException
がスローされます。catch ステートメント内で、OperationException
オブジェクトの jobLog
メンバーの値を取得できます。
関連トピック